Replace the in-memory store with PostgreSQL 18.6: SQLAlchemy 2.1 async engine on asyncpg, alembic migrations with an async env.py, repos on AsyncSession and services that own the transaction. Username uniqueness is enforced by the database (ON CONFLICT), a chat and its members are created in one transaction, member order is kept in chat_members.position, and a composite foreign key makes the sender a member of the chat. History and chat lists use keyset pagination on (chat_id, created_at, id) and (user_id, created_at, chat_id). The compose stand runs postgres, a one-shot migrate service on the API image and the API. All Postgres addresses come from .env without literals; only the 127.0.0.1 publish address stays literal. make run_dev starts Postgres and applies migrations before the server, and make env_setup generates a random Postgres password. Unavailable PostgreSQL yields 503: get_db_session bounds the request with asyncio and classifies driver errors. BoundedCloseConnection limits asyncpg's graceful close, which otherwise waited without limit on a frozen server and held the request until it was resumed. Add scripts/restart.sh for make test-persistence and make test_isolated, which runs the image on a throwaway test database. Remove make run_no_compose. X-User-Id identification is unchanged until the session-auth change. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2.3 KiB
2.3 KiB
Spec Delta
ADDED Requirements
Requirement: Подключение к PostgreSQL
Параметры подключения SHALL задаваться в секции [database]: адрес,
порт, пользователь, пароль, имя базы, размер пула и таймауты. Пароль
SHALL иметь один источник — POSTGRES_PASSWORD в .env, который
читает и контейнер Postgres. Значения параметров MUST NOT печататься в
журнал целиком: пароль и строка подключения с паролем в журнал не
попадают.
Scenario: Пароль в одном месте
- WHEN в
.envменяетсяPOSTGRES_PASSWORD, и стенд пересоздаётся на новом volume - THEN и Postgres, и сервис в консоли и в docker используют новый пароль без правки других файлов
Scenario: Пароль не в журнале
- WHEN сервис стартует и подключается к Postgres
- THEN в журнале нет значения пароля
Requirement: Консоль и docker без правки конфигурации
Переключение между запуском в консоли и в docker MUST NOT требовать
правки .env, config.toml или compose, в том числе
комментирования и раскомментирования блоков. В консоли сервис SHALL
подключаться к Postgres по адресу публикации на хосте из .env, в
docker — по адресу и порту Postgres внутри сети compose, которые compose
передаёт в окружение контейнера из переменных .env.
Scenario: Консоль, затем docker
- WHEN выполнен
make run_dev, затем он остановлен и выполненmake run_docker, а файлы конфигурации между запусками не менялись - THEN оба запуска доходят до
/health/ready200 и видят одни и те же данные