Files
mtusi2026lab2/docs/design.md

3.6 KiB
Raw Permalink Blame History

Схема и границы транзакций

План до реализации SQL: пользователи → участники ← чаты → сообщения; пользователи → сессии. PostgreSQL — источник истины всех этих данных. UUID назначает приложение, UTC-время — PostgreSQL. Пароль — Argon2id; сессия содержит только SHA-256 случайного 256-битного токена и абсолютный expiry.

Ограничения: PK у объектов, UNIQUE username, составной PK членства, FK сообщений на чат и членство отправителя, NOT NULL и ограничения длины. Индексы: members(user_id,chat_id) для списка чатов; messages(chat_id,created_at,id) для истории; sessions(token_hash) для входа.

Транзакции: регистрация; создание сессии; отзыв сессии; создание чата вместе со всеми участниками; запись сообщения. Ответ 201 формируется после COMMIT. Ошибка FK участника откатывает чат и уже вставленных участников. Уникальность username разрешает гонку на уровне БД, проигравший получает 409. Миграции сериализованы advisory lock, версия и checksum сохраняются в БД.

История: keyset (created_at,id) > (...), LIMIT n+1, без OFFSET. Cursor содержит область запроса (чат либо пользователь списка чатов), время и UUID. Cursor не предоставляет права доступа. Каждое чтение повторно проверяет членство. READ COMMITTED не даёт snapshot между страницами: поздно завершившаяся вставка с более ранним временем может оказаться позади cursor. Подтверждённые записи видны новому чтению с начала истории; часы не заменяют уникальность UUID.

Redis кэширует только публичный неизменяемый профиль на 60 секунд. В API нет редактирования профиля: инвалидация по TTL и версии ключа profile:v1. Если добавить редактирование, понадобится отдельная стратегия инвалидации. Авторизация всегда проверяет PostgreSQL, даже при cache hit. Logout удаляет сессию из БД; кэш профиля не является доказательством входа. Redis не требует persistence: cache miss/рестарт/отказ дают чтение из PostgreSQL. Socket timeout Redis 0.2 с. Дополнительно wall timeout 0.25 с на GET/SET включает зависание DNS: не более двух фоновых операций на worker, без очереди. При занятых слотах кэш пропускается. История сообщений не кэшируется.

Пул: максимум 8 соединений на worker, 2 worker, очередь до 32 на worker, ожидание до 3 секунд. connect/statement timeout 3 секунды, lock timeout 2. Недоступная БД — 503, readiness — 503, liveness остаётся 200.