Files
mtusi2026lab2/docs/schema.md
T

39 lines
3.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Модель хранения и границы транзакций
| Таблица | Ключи и ограничения | Назначение |
| --- | --- | --- |
| 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:<UUID>, TTL 60 s.
Профиль в обязательном API неизменяемый, поэтому инвалидация при обновлении
не нужна. Будущее редактирование профиля потребует удаления/версионирования
этого ключа. Сессия всегда проверяется в PostgreSQL до обращения к кэшу.
История сообщений не кэшируется: SELECT из primary после подтверждённого
COMMIT обеспечивает read-after-write. Потеря Redis безопасна; потеря БД — 503.
Курсор кодирует ресурс и последнюю пару (created_at,id) в base64url JSON.
Список чатов также привязан к пользователю. Курсор не является credential.
При конкурентных вставках это последовательный обход, а не общий snapshot:
сообщение с ключом <= последнего курсора может не попасть в следующие страницы.
Это возможно при задержанном COMMIT/коррекции часов; для неизменной истории
потерь и повторений нет. Приложение не обещает глобальный порядок COMMIT по часам.