Files
mtusi2026lab3/infra/schema.md

2.7 KiB

Общая схема и транзакции

Из lab2: users (UUID, UNIQUE username, scrypt password_hash), chats, memberships (составной PK и FK), messages (FK на чат и членство), sessions (SHA-256 токена, user_id, expires_at), settings (общий ключ HMAC cursor), schema_migrations (номер файла и SHA-256). История индексирована по (chat_id, created_at, id), членство — по (user_id, chat_id).

Lab3 добавляет message_keys: PK (user_id, chat_id, key), FK user/chat/message, expires_at = часы БД + 24 часа. Таблица обслуживает только POST messages; метод и путь чата заданы её назначением и chat_id.

POST сообщения: проверка сессии → блокировка доступного чата FOR UPDATE → валидация JSON/ключа → удаление истёкшего ключа данной области → поиск результата → replay либо INSERT сообщения + INSERT ключа → COMMIT → HTTP 201. Другой текст с прежним действующим ключом даёт 409. Блокировка PostgreSQL общая для всех реплик. Сообщения неизменяемы, FK ключа сохраняет точный результат. Ошибка откатывает всю транзакцию. Text сравнивается после JSON decode.

Все API читают один primary без кэша истории/сессий. Проверка expiry идёт по clock_timestamp() PostgreSQL, токен после рестарта не продлевается. Создание чата и участников атомарно. Ответы о записи идут после COMMIT. Монотонное время внутри чата под блокировкой: max(часы БД, предыдущее + 1 мкс). Cursor связан с ресурсом, подписан общим ключом. Snapshot между страницами не гарантируется. Список разных чатов зависит от часов БД и порядка завершения транзакций, как в lab2.

Миграции запускает отдельный сервис migrate; API не меняют схему. Advisory lock 2026002 защищает от одновременных migration jobs; DDL и журнал миграций коммитятся вместе. Checksum применённого файла неизменяем. 001_initial.sql перенесён без изменения; новое DDL находится в 002.