Схема БД — обоснование (до запросов)
Таблицы и миграции лежат в 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(SQLSTATE23505) → приложение превращает это в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).