Files
mtusi2026lab2/openspec/changes/fix-lab3-postgres-pool-recovery/proposal.md
T

2.5 KiB

Why

Прогон уровня «3» после перехода на SQLAlchemy обнаружил 503 на регистрации сразу после возвращения PostgreSQL и успешной readiness (evidence/grade3-faults.txt). Пул может выдать закрытое сервером соединение другому запросу. Нужно восстановить чтение и запись без рестарта API, сохранив минимум lab2 и критерии 3.1/3.5 README.md.

What Changes

  • Проверять соединение пула перед началом операции и заменять закрытое; не повторять уже начатые транзакции и неидемпотентные POST.
  • Добавить регрессионную проверку разрыва простаивающего соединения и усилить проверку записей после возвращения PostgreSQL через LB.
  • Исправить выявленные проблемы запуска собственных тестов: коллизию порта gunicorn с LB и стартовую гонку тестовой БД.
  • Переснять уровень «3» и обновить строки «Перенос lab2: отказы PostgreSQL» и «3.5» в REPORT.md, сохранив неуспешный прогон.

Capabilities

Modified Capabilities

  • lab2-dependency-failures: восстановление после возвращения PostgreSQL включает запись, даже если в пуле осталось закрытое соединение.

Impact

Платформенный адаптер shared/infrastructure/postgres.py, собственные проверки пула и стенда, evidence и отчёт. SQLAlchemy 2.0.45 остаётся закреплённым; схема БД, доменные зоны, контракты и публичные тесты не меняются. Проверка соединения добавляет обращение к БД; её стоимость требует новых замеров трека.

Non-goals

Уровень «4», замеры трека «5», расширение HTTP-контракта, повтор транзакций, HA PostgreSQL и всё из Out of scope openspec/config.yaml выполняются вне этого изменения.