Files
mtusi2026lab2/ARCHITECTURE.md

3.1 KiB

План хранения и транзакций

PostgreSQL — источник истины для пользователей, сессий, чатов, членства и сообщений. Данные пользователей неизменяемы в обязательном API. Valkey кэширует именно их публичное представление на 60 секунд; действительность сессии проверяется в PostgreSQL при каждом запросе. Поэтому отказ кэша не отменяет logout/expiry и не даёт доступ анонимному клиенту. При отказе PostgreSQL защищённые запросы получают 503.

users: UUID PK, UNIQUE username, display_name, password_hash (Argon2id), created_at. sessions: SHA-256 случайного 256-битного токена PK, user FK, expires_at, created_at. chats: UUID PK, title, created_at. members: (chat_id, user_id) PK и внешние ключи на chats/users. messages: UUID PK, chat FK, sender FK, text, created_at; составной FK на members не позволяет записать отправителя вне чата даже при ошибке в приложении.

Создание чата и всех его участников — одна транзакция. Создание сообщения — одна транзакция после проверки доступа. Регистрация защищена UNIQUE, гонка завершается одним 201 и остальными 409. Logout удаляет сессию в транзакции; Valkey не хранит разрешение на вход. Ранее начавшийся запрос может завершиться одновременно с logout.

История: индекс (chat_id, created_at, id), keyset по (created_at,id), LIMIT n+1. Отдельный индекс members(user_id,chat_id) ускоряет список доступных чатов. Часы БД единые, но страницы между запросами не являются snapshot: конкурентная незавершённая транзакция может стать видимой позднее курсора. Для неизменной истории пропусков нет.

Пул ограничен 5 соединениями, ожидание 2 секунды; statement_timeout=2s, lock_timeout=1s. KDF ограничен четырьмя параллельными задачами. Cursor подписан общим локально генерируемым секретом, который сохраняется при рестарте.

Миграции нумеруются, учитываются в schema_migrations, защищены advisory lock. Отдельный одноразовый сервис migrate запускается до API. Повторный запуск проверяет хеши применённых миграций, не пересоздаёт таблицы и не seed-ит данные.