Files
mtusi2026lab2-fork/infra/DATABASE.md
T

3.3 KiB

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

Проект схемы составлен перед реализацией 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; поздно закоммиченная конкурентная запись с ключом до курсора может не попасть в уже начатый обход. Для неизменной истории гарантируется отсутствие повторов и пропусков.