Files
mtusi2026lab2-fork/db

Схема БД — обоснование (до запросов)

Таблицы и миграции лежат в src/migrations/0001_init.{up,down}.sql (embed-ятся в бинарь через go:embed, поэтому читать их нужно оттуда — здесь только обоснование решений).

Таблицы

  • users (id uuid PK, username text, display_name text, password_hash text, created_at timestamptz). username уникален через UNIQUE INDEX, а не просто UNIQUE-constraint в тексте — Postgres всё равно реализует UNIQUE через индекс, явный индекс просто читаемее. Этот индекс — единственная защита от гонки двух параллельных регистраций одного username: оба INSERT идут параллельно, Postgres сериализует их на уровне индекса, второй получает unique_violation (SQLSTATE 23505) → приложение превращает это в 409 conflict. Проверка "username свободен?" на уровне приложения перед INSERT не нужна и была бы лишней — она не устраняет гонку (TOCTOU), а только маскирует её на неудачный тест-кейс. CHECK на формат username и непустой display_name — defense in depth: основная валидация всё равно в Go (там читаемее текст ошибки), но даже если Go-код ошибётся, в БД не попадут заведомо некорректные строки.

  • chats (id uuid PK, title text, created_at timestamptz).

  • chat_members (chat_id uuid, user_id uuid, PK(chat_id, user_id)) — участники отдельной таблицей-связью, а не массивом uuid[] в chats: так членство проверяется через FOREIGN KEY ... REFERENCES users(id) силами БД (неизвестный участник = нарушение FK, не нужно вручную проверять существование каждого id в Go), а "мои чаты" читаются обычным JOIN с использованием индекса, а не разворачиванием массива. Отдельный индекс (user_id, chat_id) — потому что user_id не ведущий столбец первичного ключа (chat_id, user_id), и без своего индекса поиск "чаты пользователя X" был бы последовательным сканом.

  • messages (id uuid PK, chat_id uuid, sender_id uuid, text text, created_at timestamptz). Индекс (chat_id, created_at, id) — под конкретный запрос keyset-пагинации истории:

    SELECT * FROM messages
     WHERE chat_id = $1 AND (created_at, id) > ($2, $3)
     ORDER BY created_at, id
     LIMIT $4;
    

    Без этого индекса Postgres делает Seq Scan по всей таблице сообщений на каждый запрос страницы; с ним — Index Scan в диапазоне одного чата. EXPLAIN (ANALYZE, BUFFERS) на ≥10 000 строках — в evidence/.

  • sessions (token_hash bytea PK, user_id uuid, created_at timestamptz, expires_at timestamptz, revoked_at timestamptz NULL). Хранится SHA-256 от токена, а не сам токен: утечка таблицы сессий не даёт немедленно действующие bearer-токены (тот же принцип, что и для паролей — токен и так случайный с ≥256 бит энтропии, хешируем на всякий случай, не ради stretching). expires_at/revoked_at проверяются в каждом запросе; sessions_expires_at_idx — для будущей фоновой очистки истёкших строк (не обязателен для корректности логики, сама проверка всегда идёт по token_hash через PK).

Транзакционные границы

  • Регистрация — один INSERT; атомарность не обсуждается, границу задаёт уникальный индекс (см. выше).
  • Создание чата — отдельная транзакция: INSERT chats + INSERT chat_members (по одной строке на участника) одним BEGIN…COMMIT. Если participant неизвестен — INSERT chat_members упирается в FK-нарушение, вся транзакция откатывается целиком (ни чат, ни частичный список участников не остаются в БД). Явно проверено тестом TestCreateChatRollsBackOnUnknownMember — создаётся чат с одним существующим и одним несуществующим участником, затем убеждаемся, что ни один чат с таким title не появился в списке существующего участника.
  • Отправка сообщения — один INSERT; sender_id берётся из сессии, не из тела запроса.
  • Вход (сессия) — SELECT пользователя + проверка пароля вне транзакции (CPU-bound работа, держать транзакцию открытой незачем), затем один INSERT sessions.
  • Выход — UPDATE sessions SET revoked_at = now() по token_hash (плюс отдельное удаление из Redis-кэша, если он включён — см. раздел про кэш в REPORT.md).