Files
mtusi2026lab2/openspec/changes/close-lab3-second-review-gaps/proposal.md
T
ArtyomandClaude Opus 5.5 13e856ebd4 Propose closing the second lab 3 review gaps as an openspec change
The second review found that a request cancelled at the end of the
graceful shutdown gets uvicorn's plain 500 without the contract headers,
that readiness reaches the PostgreSQL adapter and a global flag of the
HTTP layer past the ports, that the drain window is logged past the
Logger port, that make up returns with one replica in rotation and that
the CI non-root check can never fail. The retry of an unconfirmed write
was never exercised on the stand either.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01V1d3RLHNBBMA6UqBLLJv27
2026-10-30 05:37:31 +03:00

3.8 KiB

Why

Второе независимое ревью нашло расхождения с контрактом и рубрикой. Запрос, который не завершился за срок дообработки после SIGTERM, uvicorn прерывает ответом text/plain 500 без X-Request-Id и X-Instance-Id. Это нарушает contracts/README.md, хотя по смыслу это плановая остановка, то есть 503 unavailable. Readiness импортирует адаптер PostgreSQL и глобальный флаг HTTP-слоя в обход портов. Окно вывода из ротации пишется в журнал мимо порта Logger. make up возвращает управление, когда в ротации только одна реплика. Проверка non-root в CI ничего не проверяет. Повтор неподтверждённой записи на стенде ни разу не выполнялся: во всех прогонах failover 0 ошибок. Закрывает строки «3.4», «4.1» и «4.4» REPORT.md и пункты уровней «3» и «4» README.md: безопасный повтор неподтверждённой записи, согласованные SIGTERM и readiness.

What Changes

  • Запрос, прерванный по истечении срока дообработки, получает 503 unavailable в общем формате ошибки с X-Request-Id и X-Instance-Id; отмена задачи не подавляется.
  • Порт Readiness в shared/application/ports.py. Адаптер — PostgreSQL плюс флаг вывода из ротации процесса в shared/infrastructure/readiness.py, сборка — PlatformProvider. Маршрут /health/ready знает только порт.
  • Событие service.draining через StructlogLogger.
  • make up ждёт, пока LB покажет все запущенные реплики UP.
  • CI проверяет числовой uid процессов (docker top -eo pid,uid,comm).
  • make retry-check воспроизводит потерянный ответ на стенде: запись ждёт блокировку строки чата дольше таймаута клиента, клиент повторяет её с тем же ключом. Вариант 1: реплика жива. Вариант 2: реплику убивают, пока запрос ждёт.
  • Обвязка доказательств: started трека в UTC, снимок CPU/RAM и размера БД в прогонах уровня «4», тег и ID образа в rolling*/action.txt.

Capabilities

Modified Capabilities

  • lab1-service-operability: ответ на запрос, прерванный при остановке.
  • lab3-idempotent-messages: сценарий потерянного ответа на стенде.
  • lab3-load-balancing: make up завершается, когда в ротации все реплики.

Impact

  • Код: shared/entrypoints/{pipeline,health}.py, shared/application/ports.py, shared/infrastructure/readiness.py, shared/entrypoints/ioc.py, gunicorn_conf.py.
  • Тесты: test_drain.py, test_bounded_contexts.py.
  • Обвязка: Makefile, .github/workflows/application.yml, scripts/{probe,scaling}.py, scripts/{failover-each,failover-evidence,rolling-update,stand-usage}.sh.
  • Доказательства уровней «3» и «4», REPORT.md, openspec/config.yaml.

Non-goals

Контракт, публичные тесты, профиль нагрузки и трек 1 не меняются. Ограничения Out of scope из config.yaml в силе.