3.0 KiB
Схема и транзакционные границы
Клиент → 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.