3.6 KiB
Модель хранения и границы транзакций
| Таблица | Ключи и ограничения | Назначение |
|---|---|---|
| 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 по часам.