forked from mtusi2026/mtusi2026lab2
37 lines
3.0 KiB
Markdown
37 lines
3.0 KiB
Markdown
# Схема и транзакционные границы
|
|
|
|
Клиент → HTTP API → PostgreSQL. Все данные и сессии — в PostgreSQL.
|
|
|
|
- users: UUID PK, UNIQUE username, Argon2id hash, display_name, created_at.
|
|
- chats: UUID PK, title, created_at.
|
|
- memberships: PK(chat_id,user_id), FK на users/chats; индекс(user_id,chat_id).
|
|
- messages: UUID PK, FK chat/sender и составной FK на membership;
|
|
text, created_at; B-tree(chat_id,created_at,id).
|
|
- sessions: SHA-256 случайного токена как PK, FK user_id, абсолютный expires_at.
|
|
SHA-256 применяется только к случайному токену, пароли защищает Argon2id.
|
|
- schema_migrations: имя файла и SHA-256 SQL, applied_at. Уже применённый файл
|
|
изменять нельзя; следующая версия — новый SQL-файл.
|
|
|
|
Создание чата и всех memberships — одна транзакция. Неизвестный участник
|
|
вызывает FK violation и откат, включая уже вставленные строки. Регистрация
|
|
опирается на UNIQUE, поэтому конкурентный проигравший получает 409.
|
|
Вставка сообщения, создание/удаление сессии — отдельные транзакции.
|
|
HTTP 201/204 отправляется только после выхода из connection() и COMMIT.
|
|
PostgreSQL fsync/synchronous_commit остаются по умолчанию включены.
|
|
|
|
Параметризованные SQL; pool 1–8 соединений, ожидание 2 s, очередь до 32;
|
|
connect 2 s, statement 2.5 s, lock 1.5 s. Ошибка зависимости → 503 без SQL
|
|
и credentials. Readiness зависит от PostgreSQL, liveness — только от API.
|
|
|
|
Проверка Bearer и expiry всегда в PostgreSQL. Logout удаляет сессию в БД.
|
|
Перезапуск API не меняет токен и срок сессии; volume сохраняет строки БД.
|
|
Redis для уровня 3 не используется.
|
|
|
|
История: WHERE chat_id=? AND (created_at,id)>(?,?) ORDER BY created_at,id
|
|
LIMIT limit+1. Cursor содержит chat UUID, timestamp и message UUID, кодированные
|
|
base64url; подделка cursor не заменяет membership-проверку. Список чатов
|
|
аналогичен и привязан к пользователю. Уровень изоляции READ COMMITTED:
|
|
при неизменной истории нет повторов/потерь; при конкурентных транзакциях поздно
|
|
закоммиченная запись с ключом раньше cursor может быть пропущена. Snapshot
|
|
между HTTP-страницами не обещается; UTC server clock не является уникальным ID.
|