Files
mtusi2026lab2/SCHEMA.md
T

35 lines
3.4 KiB
Markdown

# Схема и границы транзакций — до реализации запросов
Источник истины — PostgreSQL. Все подтверждения записи выдаются после успешного
COMMIT. Пользователи, чаты, участники, сообщения и сессии находятся в одной БД.
Valkey хранит только восстанавливаемую копию неизменяемой карточки пользователя
для активной сессии; наличие ключа никогда не заменяет проверку сессии в БД.
| Таблица | Ограничения | Индексы и назначение |
| --- | --- | --- |
| users | UUID PK, UNIQUE username, hash Argon2id, ограничения длины | уникальный username для регистрации/входа |
| chats | UUID PK, title, created_at UTC | PK для метаданных |
| chat_members | FK chat/user, PK(chat_id,user_id), UNIQUE(chat_id,position) | (user_id,chat_id) для списка доступных чатов |
| messages | UUID PK, FK chat, составной FK(chat_id,sender_id) в участников | (chat_id,created_at,id) для keyset-страницы |
| sessions | SHA-256 случайного токена PK, FK user, expires_at | expires_at для будущей очистки |
Одна операция repository — одна транзакция READ COMMITTED. Создание чата и всех
его участников выполняется целиком: ошибка FK откатывает уже вставленный чат.
Уникальность username обеспечивается UNIQUE, а не предварительным SELECT.
Отправка сообщения фиксируется до HTTP 201; чтение идёт на основной PostgreSQL,
кэша истории нет. Несколько HTTP-страниц не образуют общий snapshot.
Сессия создаётся после проверки пароля. Хранятся только digest токена и абсолютный
expires_at, вычисленный часами БД. На каждом защищённом запросе БД проверяет expiry
и отзыв. Logout удаляет сессию транзакционно, затем пытается удалить кэш. Даже при
ошибке Valkey старый ключ не даёт доступа. После flush/restart кэш заполняется заново;
после отказа PostgreSQL запрос отклоняется с 503, без доверия к кэшу.
Миграции имеют номера и SHA-256 содержимого. Их применение и запись версии идут
в одной транзакции под advisory lock. Повторное применение ничего не дублирует;
изменение уже применённого файла считается ошибкой.
Durability: fsync=on, synchronous_commit=on, full_page_writes=on; постоянный named
volume. Это сохранность при проверяемом перезапуске, а не HA или защита от потери
диска/хоста. Backup и проверка восстановления выполняются отдельно.