Исходная точка lab3: код из solution/bvt2302-bodanyuk лабы 2, коммит ef44e48 (PR mtusi2026/mtusi2026lab2#42 принят). README, COURSE, contracts/ и tests/ преподавателя не тронуты; к Makefile дописан студенческий раздел lab2, .env.example — версия lab2. Исследование трека 2 lab2 (bench/track2) не переносилось. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
7.0 KiB
Модель данных lab2
Схема: migrations/0001_init.sql. Источник истины для пользователей, чатов, участников и сообщений — PostgreSQL 18. Для сессий источник истины — хранилище, выбранное через SESSION_STORE. По умолчанию это Valkey с AOF, его можно переключить на таблицу sessions в PostgreSQL.
Таблицы и ограничения
| Таблица | Ключ | Ограничения | Зачем |
|---|---|---|---|
users |
id uuid |
UNIQUE (username), CHECK формата username, длина display_name |
уникальность имени держит БД, а не код: гонку регистрации разрешает уникальный индекс |
chats |
id uuid |
FK created_by → users, длина title |
last_message_at — «часы» чата для упорядочивания сообщений |
chat_members |
(chat_id, user_id) |
FK на chats и users, UNIQUE (chat_id, position) |
position хранит порядок member_ids; chat_created_at — копия времени чата для keyset-списка чатов |
messages |
id uuid |
FK (chat_id, sender_id) → chat_members, длина text |
отправитель обязан быть участником — это гарантирует сама БД |
sessions |
token_hash bytea |
FK user_id → users, длина хеша 32 байта |
хранится SHA-256 токена; сам токен не хранится нигде |
schema_migrations |
version |
checksum файла | какие миграции применены; изменённую задним числом миграцию мигратор не применит |
Почему bytea для текста. Контракт разрешает символ U+0000, а тип text в PostgreSQL не может содержать байт NUL (DataError). Поэтому display_name, title и text хранятся как байты UTF-8. Длину в code points проверяет API, а CHECK в байтах — страховка (1 code point ≤ 4 байта).
Индексы и запросы
messages_chat_keyset (chat_id, created_at, id). Первая страница —WHERE chat_id=$1 ORDER BY created_at, id LIMIT n, следующая —WHERE chat_id=$1 AND (created_at, id) > ($2, $3) ORDER BY ... LIMIT n. Сравнение строк(created_at, id) > (...)попадает вIndex Cond: поиск начинается прямо с позиции cursor и читает толькоn+1строк. Запросов два, а не один с($2 IS NULL OR ...): иначе при generic plan условие cursor уходит вFilter, и поздняя страница сканирует всю историю чата до неё.chat_members_user_keyset (user_id, chat_created_at, chat_id)— список чатов пользователя тем же keyset-способом.users_username_key— вход по username и уникальность.sessions_expires_at— очистка истёкших сессий.
Транзакционные границы
| Операция | Транзакция | Что гарантирует |
|---|---|---|
| Регистрация | один INSERT |
UniqueViolation → 409; ровно одна строка при гонке |
| Создание чата | INSERT chats → INSERT chat_members (все участники одним запросом) → COMMIT |
неизвестный участник вызывает FK-ошибку после вставки чата; откат удаляет и чат, и частичное членство |
| Сообщение | проверка членства → UPDATE chats SET last_message_at = greatest(clock_timestamp(), last_message_at + 1 мкс) RETURNING → INSERT messages → COMMIT |
строка чата заблокирована до конца транзакции, поэтому писатели одного чата идут по очереди. Время сообщений строго растёт в порядке коммитов: страница по cursor не пропустит сообщение, закоммиченное «задним числом» |
| Вход | SELECT пользователя, проверка Argon2id, запись сессии |
неверный пароль ничего не пишет |
| Logout | DELETE сессии (или DEL в Valkey) |
повтор с тем же токеном — 401 |
Чтение истории не требует snapshot между HTTP-запросами (так в контракте): новое сообщение появится на следующей странице. Список чатов сортируется по chats.created_at = clock_timestamp() без блокировки. Два чата, создаваемые одновременно, могут закоммититься не в порядке времени. Тогда у обхода, который уже начался, такой чат может оказаться «до» cursor; новый обход его увидит. Чаты создаются редко, поэтому мы не сериализуем их глобальным замком; это ограничение описано в REPORT.md.
Сессии
- Токен:
secrets.token_urlsafe(32)— 256 бит случайности, в ответе 43 символа. В хранилище лежит только SHA-256 токена. Для случайного 256-битного значения быстрого хеша достаточно, медленный KDF нужен только для низкоэнтропийных паролей. SESSION_STORE=valkey(по умолчанию): ключsession:<sha256-hex>, значение{user_id, expires_at}. Срок жизни задаётся абсолютнымPXAT expires_at, поэтому рестарт его не продлевает. Включёнappendonly yes+appendfsync always: подтверждённые вход и logout сохраняются до ответа клиенту. Valkey — единственное хранилище сессий, это не кэш над PostgreSQL. Поэтому нет второй копии, которая могла бы «оживить» отозванный токен после отказа. Если Valkey недоступен, проверить сессию нельзя: защищённые запросы и logout получают 503, анонимный доступ не открывается.SESSION_STORE=postgres: таблицаsessions, проверкаexpires_at > now()в запросе.