Files
mtusi2026lab2/docs/DATABASE.md
T

5.7 KiB
Raw Blame History

Хранение и транзакции

Схема спроектирована для одного локального стенда: API → PostgreSQL для бизнес-данных; API → Redis для сессий. PostgreSQL и Redis — независимые источники истины для своих данных. История сообщений не кэшируется.

Таблицы PostgreSQL

Таблица Назначение и ограничения
schema_migrations Имя и SHA-256 применённой миграции; изменение уже применённого SQL запрещено
users UUID PK, уникальный username, display_name, scrypt-хеш, время регистрации
chats UUID PK, title, время создания, внутренняя последняя метка сообщения
chat_members Составной PK (chat_id, user_id), FK на чаты и пользователей
messages UUID PK, chat_id, sender_id, text, created_at; составной FK (chat_id, sender_id) на членство

Индекс chat_members(user_id, chat_id) выбирает доступные чаты. Индекс messages(chat_id, created_at, id) обслуживает равенство по чату, диапазон после курсора и сортировку. Следующая страница использует (created_at, id) > (%s, %s) и LIMIT limit + 1, без OFFSET и загрузки всей истории. Приложение запрашивает только нужную страницу.

Границы транзакций

  • Регистрация: один INSERT, уникальность обеспечивается БД, проигравшая конкурентная запись получает 409.
  • Создание чата: INSERT чата и всех участников в одной транзакции. Неизвестный участник нарушает FK; вся операция откатывается, включая уже вставленный чат.
  • Отправка: блокировка строки чата, проверка членства, назначение метки времени, обновление метки и INSERT сообщения в одной транзакции. COMMIT заканчивается до HTTP 201. Составной FK дополнительно запрещает сообщение неучастника.
  • Чтение: READ COMMITTED. Между HTTP-страницами snapshot отсутствует. В одном чате запись сериализуется блокировкой строки: max(clock_timestamp(), last_message_at + 1 microsecond) сохраняет возрастающий порядок даже при совпадении времени или откате часов. Соседние чаты не делят эту блокировку. При откате часов логическое время может опережать часы. Параллельно создаваемые чаты сортируются по назначенному времени; общий snapshot их списка не обещается.
  • Миграции: advisory lock, проверка контрольной суммы, SQL и регистрация версии в одной транзакции. Для checksum окончания строк приводятся к LF, поэтому checkout Windows не меняет версию миграции. Повторный запуск ничего не вставляет. Миграция запускается отдельным одноразовым сервисом до API.

Сессии Redis

Клиент получает 32 случайных байта в URL-safe base64. Ключ Redis — session:<sha256(token)>, значение — UUID пользователя и абсолютное expires_at; исходный токен на сервере не сохраняется. SET ... PXAT назначает срок в момент создания, чтение его не продлевает. API дополнительно проверяет абсолютную дату. Logout удаляет ключ до ответа 204. При отказе Redis защищённый запрос получает 503, вход по X-User-Id или локальному запасному словарю отсутствует.

Redis использует именованный volume, AOF, appendfsync always и maxmemory-policy noeviction. Обычный рестарт и аварийное завершение Redis проверяются отдельно. Потеря/удаление volume не покрывается; PostgreSQL не содержит резервной копии сессий. Потеря любого источника истины делает readiness равным 503; liveness остаётся 200.

Пределы ожидания

PostgreSQL: pool 1–10 соединений, очередь максимум 20, ожидание pool 1 s, connect 2 s, SQL 2 s, блокировка 1 s, TCP keepalive/TCP_USER_TIMEOUT. Redis: максимум 10 соединений, connect/read 1 s, без повторов команды. Общий бюджет HTTP-обработки 5 s. KDF выполняется вне event loop, не более четырёх параллельных вычислений. Секреты читаются из локальных файлов; в логах нет SQL, DSN, паролей, токенов и текстов сообщений.