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