4.8 KiB
Схема и транзакционные границы ЛР3
Основные таблицы: users, chats, members, messages, sessions. PostgreSQL — источник истины. Valkey содержит только публичные карточки пользователей TTL60s, не историю и не сессии.
Схема
- users: UUID PK, username UNIQUE, display_name UTF-8 bytea, password_hash Argon2id, created_at timestamptz.
- chats: UUID PK, title UTF-8 bytea, created_at.
- members: PK(chat_id,user_id), FK к users/chats, UNIQUE(chat_id,position).
- messages: UUID PK, chat_id, sender_id, text UTF-8 bytea, created_at; составной FK(chat_id,sender_id) к members.
- sessions: token_digest PK, user_id FK, expires_at; случайный token256bit хранится у клиента, только SHA256digest в БД.
- message_requests: PK(actor_id,chat_id,key), body_digest, response bytea, expires_at. HTTP-метод и маршрут фиксированы единственным поддерживаемым POST сообщения; область дополнительно включает actor и chat.
- schema_migrations: имя и SHA256 SQL-файла, контроль изменённых применённых миграций.
Индексы: messages(chat_id,created_at,id), members(user_id,chat_id), sessions(expires_at), message_requests(expires_at), автоматически созданные PK/UNIQUE.
Unicode
PostgreSQL text не принимает U+0000. Контракт не разрешает терять или заменять этот символ. Поэтому display_name/title/message.text и сериализованный replay-ответ хранятся как UTF-8 bytes. API проверяет длину в Unicode code points, БД дополнительно ограничивает octet_length. Чтение lossless декодирует UTF-8. Username ограничен ASCII и остаётся text.
Идемпотентность
Одна транзакция: текущий ACL → advisory lock на hash(actor,POST,chat,key) → действительный replay либо конфликт body → INSERT message → INSERT сохранённого ответа → COMMIT. Ключ живёт 24 часа. Сбой до COMMIT отменяет оба эффекта. После COMMIT повтор возвращает тот же Message и201. 5xx не сохраняется как результат. Старый ключ, сессия и ACL проверяются заново. Канонический digest учитывает text и attachment_ids=[]; отсутствие массива и пустой массив эквивалентны.
64-битная advisory hash-коллизия может только лишний раз сериализовать два разных запроса: чтение результата всё равно использует полный PK, поэтому не смешивает ответы.
Миграции и обновление
Мигратор запускается отдельным service, берёт advisory transaction lock; API запускается после успеха. Повтор не дублирует объекты. Миграция003 меняет типы наbytea и не совместима со старым runtime ЛР2: первоначальный переход требует остановки старой версии. Проверенный rolling update заменяет реплики с одной и той же схемой. Автоматическую безопасную миграцию произвольных будущих схем мы не заявляем.
Транзакция создания чата включает всех участников. Неизвестный участник откатывает весь чат. UNIQUE username разрешает гонку регистрации в самой БД.
Отказы и ограничения
Client-side wait deadline3s на закреплённой psycopg3.3.6 закрывает зависшее соединение. Пул1..8, очередь32, timeout2s; connect2s, SQL2.5s, lock1.5s. Это отдельные бюджеты, не единыйHTTPdeadline. При неопределённом POST клиент повторяет исходный Idempotency-Key.
Readiness проверяет доступность всех обязательных таблиц/полей; liveness — только жизнь процесса. API не имеют опубликованных портов. LB имеет доступ к frontend, PostgreSQL/Valkey — к backend, API — к обеим сетям. Один LB, одна PostgreSQL, storage и один host остаются SPOF.