Дмитрий
56 lines
4.5 KiB
Markdown
56 lines
4.5 KiB
Markdown
# Фиксация в репозитории документов диагностики бэкап-сервера
|
|
|
|
## Цель
|
|
|
|
Зафиксировать в системе контроля версий два документа проведённой диагностики резервного
|
|
сервера Gitea — спеку пробы и её рабочий план — чтобы результат работы сохранился в истории
|
|
репозитория и в резервных копиях. Это документально-фиксирующая задача: содержимое файлов уже
|
|
готово, требуется только аккуратно занести ровно эти два файла в индекс, создать коммит и
|
|
отправить его в удалённый репозиторий. Никакие другие файлы не затрагиваются.
|
|
|
|
## Контракт фиксации {#D1}
|
|
|
|
Фиксируются ровно два файла:
|
|
|
|
- `docs/superpowers/specs/2026-06-16-gitea-backup-status-probe.md` — спека пробы состояния
|
|
сервера;
|
|
- `docs/superpowers/plans/2026-06-16-gitea-backup-status-probe-v3.md` — её рабочий план.
|
|
|
|
Порядок: (1) занести оба файла в индекс командой `git add` с явным перечислением путей —
|
|
никаких массовых `add -A`, чтобы не зацепить посторонние изменения рабочего дерева; (2) создать
|
|
коммит с описательным сообщением без круглых скобок и с трейлером соавторства; (3) отправить
|
|
коммит в удалённый репозиторий командой `git push`. Каждая команда — одиночная, без цепочек.
|
|
|
|
Блок проверенного контекста ниже цитирует заголовки обоих фиксируемых файлов — это подтверждает,
|
|
что файлы существуют и содержат ожидаемые разделы, то есть фиксируется именно подготовленная
|
|
работа, а не пустышки.
|
|
|
|
## Крайние случаи {#D2}
|
|
|
|
- **Отправка отклонена удалённым.** Если `git push` падёт с ошибкой доступа (по прежним записям
|
|
внешний GitHub-аккаунт мог быть заблокирован, код 403), коммит всё равно остаётся в локальной
|
|
истории, а полная копия истории хранится на резервном Gitea-сервере. Тогда отправку повторяют
|
|
позже либо через резервный канал; данные не теряются.
|
|
- **Посторонние изменения в дереве.** В рабочем дереве есть прочие незакоммиченные файлы; явное
|
|
перечисление путей в `git add` и изоляция коммита по этим же путям гарантируют, что в коммит
|
|
попадут только два целевых документа.
|
|
|
|
## Критерий успеха {#D3}
|
|
|
|
Задача завершена, когда создан коммит, содержащий ровно два перечисленных файла, с корректным
|
|
сообщением, и предпринята попытка отправки в удалённый репозиторий. Результат отправки (успех или
|
|
отказ доступа) сообщается владельцу как есть, без приукрашивания.
|
|
|
|
## Конвенция оформления {#D4}
|
|
|
|
Сообщение коммита — без круглых скобок, с обязательным трейлером
|
|
`Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>`. Отчёт владельцу — простым языком: что
|
|
закоммичено и прошла ли отправка.
|
|
|
|
```verified-context-json
|
|
[
|
|
{"id":"vc1","kind":"EXTRACTED","ref":"docs/superpowers/specs/2026-06-16-gitea-backup-status-probe.md","anchor":"Контракт пробы"},
|
|
{"id":"vc2","kind":"EXTRACTED","ref":"docs/superpowers/plans/2026-06-16-gitea-backup-status-probe-v3.md","anchor":"три независимых read-only сигнала"}
|
|
]
|
|
```
|