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>
51 lines
3.0 KiB
Markdown
51 lines
3.0 KiB
Markdown
# Spec Delta
|
|
|
|
## ADDED Requirements
|
|
|
|
### Requirement: Прогон на временной базе
|
|
|
|
`make test_isolated` SHALL проверять образ, собранный из рабочего
|
|
дерева, в связке compose на временной базе `test_<имя рабочей базы>` в
|
|
PostgreSQL стенда. Команда SHALL: собрать образ, создать базу заново,
|
|
применить к ней миграции сервисом миграций compose, запустить отдельный
|
|
контейнер API из определения сервиса compose, в котором подменено только
|
|
имя базы, опубликовать его на `127.0.0.1:TEST_APP_PORT` из `.env`,
|
|
дождаться готовности, выполнить публичный smoke (`make test`) и весь
|
|
набор (`make student_test`) против этого контейнера, затем остановить и
|
|
удалить контейнер и удалить базу. Код выхода SHALL быть ненулевым, если
|
|
не прошёл smoke, набор или уборка. Рабочая база и рабочий контейнер API
|
|
MUST NOT затрагиваться. Параллельный запуск двух прогонов не
|
|
поддерживается.
|
|
|
|
#### Scenario: Успешный прогон
|
|
|
|
- **WHEN** в рабочей базе есть данные, рабочий стенд запущен, и
|
|
выполнен `make test_isolated`
|
|
- **THEN** smoke и набор прошли, код выхода 0, ни базы `test_<db>`, ни
|
|
тестового контейнера после команды нет, число строк в таблицах
|
|
рабочей базы не изменилось, а рабочий API продолжает отвечать
|
|
|
|
#### Scenario: Упавшие тесты
|
|
|
|
- **WHEN** во время `make test_isolated` падает хотя бы один тест
|
|
- **THEN** код выхода ненулевой, журнал тестового контейнера выведен,
|
|
контейнер удалён, база `test_<db>` удалена
|
|
|
|
#### Scenario: Прерывание
|
|
|
|
- **WHEN** `make test_isolated` прерван Ctrl+C
|
|
- **THEN** тестовый контейнер остановлен и удалён, база `test_<db>`
|
|
удалена
|
|
|
|
#### Scenario: Хвост прошлого прогона
|
|
|
|
- **WHEN** тестовый контейнер или база `test_<db>` остались от прогона,
|
|
убитого без уборки
|
|
- **THEN** следующий `make test_isolated` удаляет их и начинает заново
|
|
|
|
#### Scenario: Сохранить базу для разбора
|
|
|
|
- **WHEN** выполнен `make test_isolated KEEP_TEST_DB=1`
|
|
- **THEN** после прогона тестовый контейнер удалён, база `test_<db>`
|
|
остаётся, а команда печатает её имя
|