Files
mtusi2026lab2/docs/schema.md
T

3.6 KiB
Raw Blame History

Модель хранения и границы транзакций

Таблица Ключи и ограничения Назначение
users UUID PK; UNIQUE username; CHECK username/display_name Неизменяемый публичный профиль и Argon2id hash
chats UUID PK; CHECK title Чат
members PK(chat_id,user_id); FK chats, users Доступ пользователя к чату
messages UUID PK; NOT NULL FK chat_id, sender_id; CHECK text Подтверждённые сообщения
sessions SHA-256(token) PK; FK user_id; NOT NULL expires_at Источник истины для сессий
schema_migrations version PK Применённые версии миграций

UUID создаются приложением, время — PostgreSQL clock_timestamp(). Индекс messages(chat_id,created_at,id) соответствует равенству chat_id, диапазону пары (created_at,id), ORDER BY и LIMIT. members(user_id,chat_id) помогает списку чатов. Индекс sessions(expires_at) предусмотрен для будущей пакетной очистки; expiry уже проверяется на каждом запросе и не зависит от фоновой очистки.

Одна HTTP-операция использует одну транзакцию READ COMMITTED. COMMIT происходит при успешном выходе из pool.connection() до передачи HTTP-ответа Flask. Исключение откатывает все действия, включая уже вставленный чат. Чат и все members вставляются вместе. UNIQUE PostgreSQL, а не проверка в Python, разрешает гонку username. SQL параметризован. Каждый worker ограничен восемью соединениями; два worker дают максимум 16. Pool wait/connect timeout — 3 s, statement timeout — 3 s, lock timeout — 2 s.

Redis содержит только JSON публичного пользователя user:, TTL 60 s. Профиль в обязательном API неизменяемый, поэтому инвалидация при обновлении не нужна. Будущее редактирование профиля потребует удаления/версионирования этого ключа. Сессия всегда проверяется в PostgreSQL до обращения к кэшу. История сообщений не кэшируется: SELECT из primary после подтверждённого COMMIT обеспечивает read-after-write. Потеря Redis безопасна; потеря БД — 503.

Курсор кодирует ресурс и последнюю пару (created_at,id) в base64url JSON. Список чатов также привязан к пользователю. Курсор не является credential. При конкурентных вставках это последовательный обход, а не общий snapshot: сообщение с ключом <= последнего курсора может не попасть в следующие страницы. Это возможно при задержанном COMMIT/коррекции часов; для неизменной истории потерь и повторений нет. Приложение не обещает глобальный порядок COMMIT по часам.