Files
mtusi2026lab3/src/migrations/0001_init.up.sql
T

72 lines
3.9 KiB
SQL

-- Лаб2: пользователи, чаты, участники, сообщения, сессии.
-- Транзакционные границы и обоснование индексов — см. db/README.md.
CREATE TABLE users (
id uuid PRIMARY KEY,
username text NOT NULL,
display_name text NOT NULL,
password_hash text NOT NULL,
created_at timestamptz NOT NULL DEFAULT now(),
CONSTRAINT users_username_format CHECK (username ~ '^[a-z0-9_]{3,32}$'),
CONSTRAINT users_display_name_not_blank CHECK (btrim(display_name) <> '')
);
-- Уникальность username на уровне БД — это и есть защита от гонки двух
-- параллельных регистраций одного имени: кто вставился первым, тот и
-- выиграл, второй получает unique_violation (23505) -> 409 conflict.
CREATE UNIQUE INDEX users_username_key ON users (username);
CREATE TABLE chats (
id uuid PRIMARY KEY,
title text NOT NULL,
created_at timestamptz NOT NULL DEFAULT now(),
CONSTRAINT chats_title_not_blank CHECK (btrim(title) <> '')
);
-- Участники чата: отдельная таблица связи, а не массив в chats —
-- позволяет FK-проверку существования пользователя силами БД и
-- normалized lookup "мои чаты" через индекс по user_id.
CREATE TABLE chat_members (
chat_id uuid NOT NULL REFERENCES chats(id) ON DELETE CASCADE,
user_id uuid NOT NULL REFERENCES users(id) ON DELETE RESTRICT,
PRIMARY KEY (chat_id, user_id)
);
-- "Чаты пользователя" читаются по user_id, а не по chat_id (который ведущий
-- столбец первичного ключа) — нужен отдельный индекс в обратном порядке.
CREATE INDEX chat_members_user_id_idx ON chat_members (user_id, chat_id);
CREATE TABLE messages (
id uuid PRIMARY KEY,
chat_id uuid NOT NULL REFERENCES chats(id) ON DELETE CASCADE,
sender_id uuid NOT NULL REFERENCES users(id) ON DELETE RESTRICT,
text text NOT NULL,
created_at timestamptz NOT NULL DEFAULT now(),
CONSTRAINT messages_text_not_blank CHECK (btrim(text) <> '')
);
-- Ключевой индекс лабы: keyset-пагинация истории чата делает
-- WHERE chat_id = $1 AND (created_at, id) > ($2, $3)
-- ORDER BY created_at, id LIMIT $4
-- Композитный индекс (chat_id, created_at, id) превращает это в range scan
-- по одному чату вместо full scan всей таблицы сообщений на каждую
-- страницу. EXPLAIN (ANALYZE, BUFFERS) на ≥10k строк — в evidence/.
CREATE INDEX messages_chat_created_idx ON messages (chat_id, created_at, id);
CREATE TABLE sessions (
-- Храним не сам токен, а SHA-256 от него: утечка таблицы сессий не
-- выдаёт действующие bearer-токены напрямую (та же логика, что и для
-- паролей — только тут это "ещё один слой", а не KDF: токен сам по
-- себе уже 256 бит случайности).
token_hash bytea PRIMARY KEY,
user_id uuid NOT NULL REFERENCES users(id) ON DELETE CASCADE,
created_at timestamptz NOT NULL DEFAULT now(),
expires_at timestamptz NOT NULL,
revoked_at timestamptz
);
-- Периодическая очистка истёкших/отозванных сессий (не обязательна для
-- корректности — expires_at/revoked_at проверяются в каждом запросе —
-- но нужна, чтобы таблица не росла бесконечно).
CREATE INDEX sessions_expires_at_idx ON sessions (expires_at);