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