Files
mtusi2026lab2/SCHEMA.md
T

3.4 KiB

Схема и границы транзакций — до реализации запросов

Источник истины — 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 и проверка восстановления выполняются отдельно.