docs: update expected test counts and notes after fix-known-issues verify

REPORT: 133 and 129 + 4 in the clean clone section, the postgres log
summary of failure_checks, the isolated count on the final code.
AGENTS: do not copy lab 3 evidence, cache-check --require-test-keys.
script-failures: the closed KNOWN_ISSUES entry points to decision 7.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-13 18:23:23 +03:00
co-authored by Claude Opus 5.5
parent 8be58ce046
commit f02694e102
3 changed files with 16 additions and 5 deletions
+5 -2
View File
@@ -497,13 +497,16 @@ KNOWN_ISSUES.md # найденные попутно дефекты,
- Доказательства исключений сверки покрытия снять заново на стенде новой
лабы, иначе `make student_test` красный (`test_exclusion_evidence_exists`
называет сценарий и путь): `make test_isolated`, затем `driver.py
--port <LB> cache-check` → `evidence/cache/hits.md`; `driver.py --port
--port <LB> cache-check --require-test-keys` →
`evidence/cache/hits.md`; `driver.py --port
<LB> auth-storage` → `evidence/auth/passwords-and-tokens.md`; `make
test-persistence ACTION_SCRIPT=scripts/restart.sh` →
`evidence/replicas/test-persistence.md` (или путь, который назовёт
исключение); повтор отправки с ключом после `docker compose up -d
--force-recreate api` → `evidence/idempotency/replay-after-restart.md`
(`student-tests.md`).
(`student-tests.md`). Файлы `evidence/` лабы 3 в новую лабу не
копировать, даже эти четыре: сверка проверяет только наличие файла и
с копией останется зелёной без пересъёмки.
- Сначала прочитать переходы API в `COURSE.md` и `contracts/README.md`
нового skeleton, потом править код. Обновить этот файл: номер лабы,
таблицу важных файлов, новые правила.
+5 -3
View File
@@ -107,8 +107,10 @@ make test_isolated # образ на временной базе test_messeng
Ожидаемо: `make check`, `make validate`, `make test`,
`make test-persistence` и оба `make test-failover` — `PASS`;
`make instances` — `instances: 2`; `make student_test` — `131 passed`;
`make failure_checks` — `17 passed`; `make test_isolated` — `127
`make instances` — `instances: 2`; `make student_test` — `133 passed`;
`make failure_checks` — `17 passed` и строка сводки журнала PostgreSQL
стенда отказов `[failure_checks] postgres log: … crash markers 0`
(признаков аварийного перезапуска нет); `make test_isolated` — `129
passed, 4 skipped` (тесты реплик против одного процесса пропускаются с
причиной). Строка `STOP_ONE_LOG` называет `TARGET_INSTANCE_ID`, который
выбрал тест, и полный ID остановленного контейнера; `docker compose ps
@@ -630,7 +632,7 @@ SHA-256 тела; `created_at` с индексом; `CHECK` формата и д
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
| --- | --- | --- | --- |
| Публичный smoke | `make test` через LB на стенде `make run_docker`; `make test_isolated` (образ из `a4ca9ef`, временная база, один контейнер): `make test` + `make student_test EXPECT_REPLICAS=1`; `make test` через LB стенда из настоящего `git clone` на нестандартных портах | `PASS: lab3 public API scenario` во всех трёх; в изоляции 127 passed, 4 теста реплик пропущены с причиной «one API process»; сверка покрытия на итоговом коде: 137 сценариев, 125 тестом (18 — `make failure_checks`), 12 исключений (на `a4ca9ef` было 135 / 123) | `evidence/tests/student-test-lb.md`, `evidence/tests/test-isolated.md`, `evidence/replicas/clean-clone-ports.md`, `evidence/tests/clean-clone-final.md` |
| Публичный smoke | `make test` через LB на стенде `make run_docker`; `make test_isolated` (образ из `a4ca9ef`, временная база, один контейнер): `make test` + `make student_test EXPECT_REPLICAS=1`; `make test` через LB стенда из настоящего `git clone` на нестандартных портах | `PASS: lab3 public API scenario` во всех трёх; в изоляции на `a4ca9ef` 127 passed, 4 теста реплик пропущены с причиной «one API process» (на итоговом коде `fix-known-issues` — 129 passed + 4 пропуска: два новых теста сверки ссылок, `evidence/tests/clean-clone-final.md`); сверка покрытия на итоговом коде: 137 сценариев, 125 тестом (18 — `make failure_checks`), 12 исключений (на `a4ca9ef` было 135 / 123) | `evidence/tests/student-test-lb.md`, `evidence/tests/test-isolated.md`, `evidence/replicas/clean-clone-ports.md`, `evidence/tests/clean-clone-final.md` |
| «3»: стенд одной командой, ≥2 API, одна точка входа, общие БД и сессии | `make run_docker` (рабочий стенд и настоящий `git clone`); `docker compose ps`, `docker port`, `docker compose config` | `haproxy` — единственный порт API на хосте (`127.0.0.1:8080`), `api` × 2 без портов и `container_name`; общие Postgres (сессии, данные, ключи) и Valkey; миграции — один прогон `migrate` на каждый up, в журналах реплик `alembic` нет; из клона стенд поднимается одной командой, `.env` и `config.toml` создаются сами | `evidence/replicas/stand.md`, `evidence/replicas/clean-clone-ports.md` |
| «3»: разные запросы одного пользователя — разными репликами без повторного входа | `make instances` (один вход, 12 × `GET /users/me` с одним токеном); `test_load_balancing.py` | ответы чередуются `3681880fc55f` / `8100f940a5fa` по 6; 20 запросов сессии — по 10; запись через одну реплику видна в чтениях через другую | `evidence/replicas/distribution.md`, `evidence/tests/student-test-lb.md` |
| «3»: отказ любой одной реплики — ≤10 с до новых чтений и записей; `make test-failover` | `make test-failover ACTION_SCRIPT=scripts/stop-one.sh` для каждой реплики, `make replicas` и сдвиг очереди round-robin одним запросом между прогонами; `STOP_ONE_LOG` — какой `TARGET_INSTANCE_ID` выбрал тест; `docker compose ps -a` и `StartedAt` до и после | 2 × `PASS`: остановлены `8100f940a5fa`, затем `3681880fc55f`; первая запись через 1,10–1,11 с, 0 неудачных попыток, по 2 запроса перенаправлены LB; ID остановленного контейнера = `TARGET_INSTANCE_ID`, остальные контейнеры с прежним `StartedAt`; через 20 с реплика всё ещё `exited`. С цепочкой таймаутов `graceful-failover` (commit `459f84c`) — снова `PASS` для каждой реплики: `stop` — 0 неудачных попыток, первая запись через 1,62 с; `kill` — 1 неудачная попытка (запрос в полёте), повторена с тем же ключом, первая запись через 0,23 с | `evidence/failover/test-failover.md`, `evidence/tests/graceful-failover-checks.md` |
+6
View File
@@ -100,6 +100,12 @@ make: *** [rolling_update] Error 1
(`KNOWN_ISSUES.md`), и `docker stop` ждал бы все 10 с. Если DNS уже
отдал ей слот, он сначала уходит в `maint`.
> Позже: запись `KNOWN_ISSUES.md` закрыта change `fix-known-issues`
> (решение 7): ранний обработчик SIGTERM, неготовая реплика со слотом
> останавливается штатно (`maint` → `docker stop` → `rm -f` → `ready`),
> без слота — по-прежнему `rm -f`, как в этом случае
> (`evidence/failover/stop-at-start.md`). Выше — снимок на `84161c0`.
## 5. Ctrl+C во время дренажа под нагрузкой
Настоящий Ctrl+C: `make rolling_update` запущен в псевдотерминале