Files
mtusi2026lab3/infra/DATABASE.md
T
nothingredmouth 7d506a0587 Поднять балансировочный стенд из двух реплик за HAProxy
Dockerfile, compose (api1, api2, postgres, migrate, lb), haproxy.cfg с
round-robin и healthcheck на /health/ready, secrets с DATABASE_URL и
инициализация локальной БД (scripts/init_local.py).
2026-11-16 22:19:07 +00:00

5.9 KiB
Raw Blame History

Схема и транзакционные границы

Проект схемы составлен перед реализацией SQL-адаптера. PostgreSQL — единый источник истины, включая сессии.

Таблица Ключи и ограничения Индексы и назначение
users UUID PK, username UNIQUE, NOT NULL для имени/хеша/времени UNIQUE username для регистрации и входа
chats UUID PK, title NOT NULL (created_at, id) для списка
chat_members (chat_id, user_id) PK, два FK, position для порядка участников (user_id, chat_id) для доступных чатов
messages UUID PK, chat_id FK, sender_id FK, составной FK на членство (chat_id, created_at, id) для истории
sessions token_hash PK, user_id FK, expires_at NOT NULL expiry для возможной очистки
app_settings name PK, value NOT NULL постоянный случайный ключ подписи курсоров
schema_migrations version PK только учёт применённых миграций

Каждый метод записи репозитория — одна транзакция с COMMIT до HTTP-ответа. Создание чата: проверить существование всех пользователей, вставить чат и всех участников, COMMIT; ошибка откатывает всё. Регистрация защищена UNIQUE, конфликт возвращает 409. Сообщение вставляется после проверки членства; FK также не позволяет записать отправителя вне чата. Создание/отзыв сессии — отдельные транзакции. Сессия проверяется на каждом защищённом запросе по времени БД; рестарт не меняет expiry.

Миграции нумеруются в migrations/*.sql. Runner выполняет новые файлы и запись версии в одной транзакции под advisory lock. Повторный запуск не выполняет уже учтённую версию. Пароли — Argon2id; в sessions лежит SHA-256 случайного 256-битного токена, а не пароль. SHA-256 здесь служит индексом высокоэнтропийного токена и не заменяет password KDF.

Пагинация SQL keyset, LIMIT + 1; offset не используется. Курсор сохраняет область ресурса и подписан постоянным ключом из БД, поэтому продолжение работает после рестарта. Часы PostgreSQL задают created_at. Между страницами нет snapshot; поздно закоммиченная конкурентная запись с ключом до курсора может не попасть в уже начатый обход. Для неизменной истории гарантируется отсутствие повторов и пропусков.

Lab3: общий результат отправки

Миграция 002 добавляет message_requests с PK (user_id, chat_id, idempotency_key), FK на сообщение и expires_at. Таблица относится только к POST сообщений: HTTP-метод и тип пути заданы её назначением. В ключ не входят имя реплики или сессия, поэтому новый вход того же пользователя не меняет область идемпотентности.

Перед записью PostgreSQL advisory transaction lock блокирует только хеш области ключа. Все реплики вычисляют его одинаково через SHA-256; совпадение 64-битных хешей может лишь сериализовать независимые операции, но не объединяет их результаты: lookup всегда по полному составному ключу. После ожидания блокировки новый statement в READ COMMITTED видит результат победившей транзакции.

При существующей действующей записи сравнивается текст: тот же текст возвращает исходное Message с 201, другой — 409. Поля и типы валидируются до этого; в lab3 единственное поле CreateMessage — text. Создание Message и message_requests происходит в одной транзакции, поэтому 5xx/rollback не оставляет отдельного подтверждённого результата. После COMMIT потерянный HTTP-ответ можно восстановить повтором. Expiry не продлевается повтором; TTL не менее 24 часов. Просроченная запись ключа удаляется при повторном использовании этой области, старое сообщение остаётся в истории.

Реплики не запускают миграции при старте. Единственный Compose job migrate выполняет их перед API; advisory lock runner дополнительно защищает ручной повтор запуска. Существующие миграции 001 сохранены без изменения. В lab3 нет автоматического обновления работающего стенда с несовместимым DDL.