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>
50 lines
2.5 KiB
Markdown
50 lines
2.5 KiB
Markdown
# Spec Delta
|
|
|
|
## MODIFIED Requirements
|
|
|
|
### Requirement: Сборка из чистого clone
|
|
|
|
`docker build` в корне свежего clone SHALL собирать образ без
|
|
предварительных шагов: без `make env_setup`, без `config.toml` и `.env`.
|
|
Зависимости SHALL устанавливаться строго по `uv.lock`. Если lock не
|
|
соответствует `pyproject.toml`, сборка MUST завершаться ошибкой, а не
|
|
пересчитывать версии.
|
|
|
|
#### Scenario: Свежий clone
|
|
|
|
- **WHEN** в новом clone репозитория выполняется
|
|
`docker build -t mtusi-messenger:lab2 .`
|
|
- **THEN** образ собирается без ошибок
|
|
|
|
#### Scenario: Устаревший lock
|
|
|
|
- **WHEN** в `pyproject.toml` добавлена зависимость, а `uv.lock` не
|
|
обновлён
|
|
- **THEN** сборка завершается ошибкой проверки lock
|
|
|
|
### Requirement: Состав образа
|
|
|
|
Образ SHALL содержать только то, что нужно для работы сервиса и
|
|
применения миграций: интерпретатор, зависимости времени выполнения,
|
|
исходники `src/`, каталог миграций и конфигурацию инструмента миграций.
|
|
В образе MUST NOT быть `config.toml`, `.env`, публичных и собственных
|
|
тестов, контрактов, файлов `.claude` и `openspec`, а также инструментов
|
|
сборки: uv и компиляторов.
|
|
|
|
#### Scenario: Нет конфигов и лишних каталогов
|
|
|
|
- **WHEN** в образе просматривается рабочий каталог приложения
|
|
- **THEN** в нём есть только исходники, миграции с их конфигурацией и
|
|
окружение зависимостей, а `config.toml` и `.env` отсутствуют
|
|
|
|
#### Scenario: Нет uv в runtime
|
|
|
|
- **WHEN** в контейнере запрашивается `uv`
|
|
- **THEN** команда не найдена
|
|
|
|
#### Scenario: Миграции из образа
|
|
|
|
- **WHEN** контейнер из этого образа запускается командой применения
|
|
миграций с настройками подключения к Postgres
|
|
- **THEN** миграции применяются без доступа к исходникам на хосте
|