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.5 KiB
2.5 KiB
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 миграции применяются без доступа к исходникам на хосте