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>
7.1 KiB
Spec Delta
ADDED Requirements
Requirement: Хранение в PostgreSQL
Пользователи, чаты, участники чатов и сообщения SHALL храниться в PostgreSQL, он — источник истины. Сервис MUST NOT хранить эти данные в памяти процесса, файлах или SQLite. Подтверждённая запись (ответ 201) SHALL быть зафиксирована в БД до ответа и видна следующему чтению.
Scenario: Созданное видно сразу
- WHEN клиент создал пользователя и следующим запросом использует
его
idвX-User-Id - THEN пользователь найден
Requirement: Данные переживают рестарт
После перезапуска сервиса и PostgreSQL с сохранённым volume все ранее подтверждённые пользователи, чаты, участники и сообщения SHALL быть доступны в прежнем виде.
Scenario: Прежний пользователь после рестарта
- WHEN стенд перезапущен
scripts/restart.sh, и клиент используетX-User-Id, созданный до рестарта - THEN ответ 200, а история чата этого пользователя содержит те же сообщения в том же порядке
Requirement: Целостность данных в БД
Ограничения SHALL проверяться самой БД, а не только сервисом:
уникальность username, существование пользователей и чатов, на
которые ссылаются участники и сообщения, уникальность участника в
чате, членство отправителя в чате сообщения. Порядок member_ids,
заданный при создании чата, SHALL сохраняться.
Scenario: Порядок участников
- WHEN чат создан с
member_idsв порядке[bob, alice] - THEN
GETэтого чата и список чатов возвращаютmember_idsв том же порядке, в том числе после рестарта стенда
Requirement: Составная операция в одной транзакции
Создание чата вместе с участниками SHALL выполняться одной транзакцией: при ошибке на любом шаге в БД MUST NOT остаться ни чата, ни части его участников.
Scenario: Сбой при добавлении участников
- WHEN чат уже записан в транзакции, а запись участников завершается ошибкой
- THEN транзакция откатывается, чата нет ни в
GETпо егоid, ни в списках чатов участников
Requirement: Недоступность PostgreSQL
Если PostgreSQL недоступен или не ответил за отведённое время,
запрос SHALL завершаться ответом 503 с code unavailable в формате
ошибки, а не 500 и не зависанием. Частично выполненная операция MUST
NOT фиксироваться. Когда PostgreSQL снова доступен, сервис SHALL
обслуживать запросы без перезапуска.
Scenario: БД остановлена
- WHEN PostgreSQL остановлен, и клиент отправляет сообщение
- THEN ответ 503
unavailableбез деталей вmessage
Scenario: БД вернулась
- WHEN PostgreSQL остановлен, затем снова запущен, а сервис не перезапускался
- THEN следующие запросы после готовности БД обслуживаются штатно
Requirement: Ограниченный пул соединений и таймауты
Число соединений сервиса с PostgreSQL SHALL быть ограничено настройкой.
Ожидание свободного соединения, подключение и выполнение запроса SHALL
иметь таймауты из настроек. Истёкший таймаут SHALL давать 503
unavailable.
Scenario: Соединения исчерпаны
- WHEN все соединения пула заняты дольше таймаута ожидания
- THEN новый запрос получает 503
unavailableне позже этого таймаута, а не ждёт бесконечно
MODIFIED Requirements
Requirement: Параллельные запросы не повреждают состояние
Параллельные запросы MUST NOT терять, дублировать или повреждать
записи. Уникальность username SHALL обеспечиваться ограничением БД,
а не проверкой перед вставкой, поэтому одновременная регистрация
одного имени создаёт ровно одного пользователя.
Scenario: 100 сообщений от 10 клиентов
- WHEN 10 клиентов одновременно отправляют по 10 сообщений в один чат
- THEN получено 100 ответов 201, а полный обход истории возвращает
ровно 100 сообщений с уникальными
id
Scenario: Гонка за username
- WHEN несколько клиентов одновременно регистрируют одинаковый
username - THEN создан ровно один пользователь
REMOVED Requirements
Requirement: Состояние только в памяти одного процесса
Reason: лаба 2 требует PostgreSQL как источник истины; память процесса больше не хранит данные. Migration: требование «Хранение в PostgreSQL». Сценарий «Созданное видно сразу» перенесён туда без изменений.
Requirement: Потеря состояния при рестарте
Reason: на лабе 2 подтверждённые данные обязаны переживать рестарт; пустое состояние после рестарта теперь дефект. Migration: требование «Данные переживают рестарт», сценарий «Прежний пользователь после рестарта» теперь ждёт 200.