docs: record pipeline-reliability evidence and report

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-31 16:51:29 +03:00
co-authored by Claude Opus 5.5
parent e2a6427c24
commit 6bd60532aa
38 changed files with 2802 additions and 484 deletions
@@ -573,4 +573,5 @@ Replay `invalid_image` разрешён: оператор мог поправи
- `test_reconcile_keeps_current_work` — красный один раз: за настройкой, ожиданием G + 1 и длинным проходом срок хранения `failed` на стенде (60 с) истёк, и уборщик штатно убрал staging. Тест зависел от времени; проверяет он сверку, поэтому уборщик на его время остановлен;
- `test_defense_faults` (через `crash_after_objects`) — красный один раз: запрос `messages_unacknowledged` из п. 7 длиннее окна триггера 4 с, фиксация успела, `attempt` 1 вместо 2. Перед запросом worker теперь заморожен: COMMIT он не отправит. Регрессия ack до фиксации проверена заново — красный.
16. **Полный `make failure_checks`:** 140 проверок, pytest 2313 с (38,5 мин), PostgreSQL без признаков аварии, стенд и volumes удалены, у рабочего стенда прежний `StartedAt`. Последний полный прогон: 139 зелёных, красный один (п. 15, первый подпункт); правка этого теста проверена выборкой, полный прогон на commit — задача 15.4. Запас времени к концу набора мал: bucket стенда растёт, и проход сверки при 0,25 CPU длится десятки секунд.
17. **Не удалено:** `src/utils/thumbnail.py` и `src/infra/broker/instance.py` на диске без импортов. Автоматическая проверка отклонила цепочку команд с их удалением (в ней по ошибке были и команды `git`), обход другой формулировкой запрещён условиями прогона. Удаляет основная сессия; до этого `grep PIL src` показывает и `thumbnail.py`.
17. **Удалено при коммите:** `src/utils/thumbnail.py` и `src/infra/broker/instance.py` без импортов удалила основная сессия, вошло в `e2a6427`.
18. **Группа 15 на `e2a6427`:** полный `make failure_checks` при остановленном рабочем стенде — 140 из 140, pytest 2373 с, правок тестов нет, правка п. 15 прошла в полном наборе. Метка `pipeline-reliability` снята первой, на чистом дереве: `git.dirty` false, `swapouts_delta` 0, файлы `evidence/` из дерева выносить не пришлось. Образ контейнера на стенде сравнивается по метке `com.docker.compose.image`: `.Image` у контейнеров с одной меткой может расходиться и не годится для сравнения (`docker.md`); у реплик, relay, worker и уборщика метка одна.
@@ -279,10 +279,10 @@ evidence и `REPORT.md`: её запускает основная сессия
Снимать на закоммиченном коде: рабочий стенд собран из `HEAD` (`make run_docker`), рабочее дерево чистое, в шапке каждого файла команда, дата, commit и стенд. Без токенов, паролей, ключей и секретов. Новые файлы `evidence/` на время замеров `bench/` выносить из дерева, чтобы паспорта не получили ложный `dirty: true` (design архива `async-attachments`, «Уточнения apply», п. 17).
- [ ] 15.1 Коммит кода групп 1–14 на ветке `feat/pipeline-reliability`, стенд на этом commit: `make run_docker`, `make replicas`.
- [x] 15.1 Коммит кода групп 1–14 на ветке `feat/pipeline-reliability`, стенд на этом commit: `make run_docker`, `make replicas`.
Проверка: `git status` чист; `docker compose ps` — как в задаче 9.6; `make test` — `PASS: lab5`.
- [ ] 15.2 Защита и стенд:
- [x] 15.2 Защита и стенд:
- `evidence/attachments/defense-faults.md` — `driver.py --port <LB> defense-faults`;
- `evidence/attachments/defense.md` — `driver.py --port <LB> defense-scenario`;
- `evidence/relay/process.md` — `driver.py --port <LB> relay-process`;
@@ -291,17 +291,17 @@ evidence и `REPORT.md`: её запускает основная сессия
- `evidence/attachments/storage.md`, `evidence/attachments/failover.md`, `evidence/attachments/consistency.md`, `evidence/replicas/test-persistence.md` — команды уровня 3 заново.
Проверка: `test_exclusion_evidence_exists` называет только файлы старых исключений последнего шага прогона.
- [ ] 15.3 Журнал, ключи, схема:
- [x] 15.3 Журнал, ключи, схема:
- `evidence/worker/logs.md`, `evidence/relay/logs.md` — журнал готового и `failed` вложения одного `request_id`, проход relay, replay с отказом; `filename` и секретов нет;
- `evidence/s3/cleaner-staging.md` — `make s3_check` и строки списка staging;
- `evidence/migrations/pipeline-reliability.md` — проба задач 2.2–2.3 и откат с возвратом задачи 14.1;
- `evidence/uploads/lb-timeouts.md` — `driver.py lb-upload-timeouts`.
Проверка: `grep` значений секретов из `.env` по `evidence/` пуст (значения не печатаются).
- [ ] 15.4 Прогоны наборов на этом commit: `evidence/tests/student-test-lb.md`, `evidence/tests/test-isolated.md`, `evidence/tests/failure-checks.md` (полный `make failure_checks`, число проверок и время, красные прогоны задачи 10.9), `evidence/failover/test-failover.md`; метка `make bench_rollout ROLLOUT_LABEL=pipeline-reliability`.
- [x] 15.4 Прогоны наборов на этом commit: `evidence/tests/student-test-lb.md`, `evidence/tests/test-isolated.md`, `evidence/tests/failure-checks.md` (полный `make failure_checks`, число проверок и время, красные прогоны задачи 10.9), `evidence/failover/test-failover.md`; метка `make bench_rollout ROLLOUT_LABEL=pipeline-reliability`.
Проверка: числа в файлах совпадают с выводом команд; красное только `missing_evidence` по файлам последнего шага прогона.
- [ ] 15.5 `REPORT.md`, разделы уровня 4 (отчёт уровня 3 остаётся верным, то, что было ограничением и закрыто, обновлено):
- [x] 15.5 `REPORT.md`, разделы уровня 4 (отчёт уровня 3 остаётся верным, то, что было ограничением и закрыто, обновлено):
- состояние отчёта и commit: строки таблицы уровня 3, снятые заново, называют новый commit, а метка `evidence/uploads/baseline` остаётся со своим `ff1a83b`; архитектура стенда с relay, таблица ролей и сумма лимитов, расчёт соединений PostgreSQL; запуск с `make run_relay`; `STAGING_RETENTION_SECONDS` и новые настройки;
- таблица критериев уровня 4 с командой, наблюдением и файлом — по каждому пункту рубрики;
- параметры вариантов (`quality`, `method`, отсутствие EXIF и ICC); лимиты обработки и бюджет памяти контейнера worker с числами из задачи 9.6;
@@ -312,4 +312,4 @@ evidence и `REPORT.md`: её запускает основная сессия
- вопросы преподавателю: из `QUESTIONS.md`, `## pipeline-reliability`, а №4 и №5 раздела — с отметкой, как закрыты этим уровнем; раздел «Что остаётся открытым на уровне 3» и «Следующие шаги» обновить.
Проверка: у каждой новой строки таблицы доказательств есть команда, наблюдение и файл; `make lint`, `make check`, `openspec validate pipeline-reliability --strict`.
- [ ] 15.6 Коммит evidence и `REPORT.md` основной сессией. Проверка: `git status` чист; `git log -2` — commit кода назван в шапках файлов evidence.
- [x] 15.6 Коммит evidence и `REPORT.md` основной сессией. Проверка: `git status` чист; `git log -2` — commit кода назван в шапках файлов evidence.