4.1 KiB
Схема PostgreSQL и связь с S3
Основной источник истины — PostgreSQL. В S3 находятся только исходные bytes вложения. Valkey содержит временные копии публичных пользователей, TTL60, без сессий и истории.
| Таблица | Ключи и назначение |
|---|---|
| users | UUID PK, username UNIQUE, Argon2id password_hash, UTF-8 display_name в bytea |
| chats | UUID PK, UTF-8 title в bytea, server UTC created_at |
| members | PK(chat_id,user_id), FK к chats/users, UNIQUE(chat_id,position) |
| messages | UUID PK, FK(chat_id,sender_id)→members, UTF-8 text в bytea, UTC created_at |
| message_requests | Уникальный scope(actor_id,chat_id,key), body_digest, точный JSON response в bytea, expires_at24h |
| sessions | SHA-256 token_digest PK, user FK, абсолютный expires_at |
| attachments | UUID PK, chat/owner FK, filename/MIME/size/SHA-256, status/error, created_at/updated_at, object_key UNIQUE |
| message_attachments | PK(message_id,attachment_id), FK к message/attachment, UNIQUE(message_id,position), position0..9 |
| upload_intents | UUID PK, object_key UNIQUE, created_at; durable запись до PUT |
| attachment_reconcile_audit | Генерируемый PK, безопасный event, внутренний object_key и время apply |
| schema_migrations | Имя SQL-файла PK и SHA-256 применённого содержимого |
Миграции
- 001_initial: базовые таблицы/ограничения/индексы ЛР2.
- 002_idempotency: общий результат POST message для всех API-реплик.
- 003_unicode_storage: lossless UTF-8 в bytea для полей, допускающих NUL; старому runtime нужна остановка на переход.
- 004_attachments: attachments, links, durable intents и audit.
- 005_attachment_only_message: допускает нулевую длину bytea text; API требует хотя бы одно вложение для пустого/пробельного текста.
Мигратор применяет файлы последовательно в транзакции под advisory lock. Повторный запуск пропускает неизменившиеся миграции; изменённый применённый файл вызывает ошибку.
Индексы и транзакции
История читается keyset по (chat_id,created_at,id) с соответствующим B-tree. ID разрешает совпадения времени. Cursor scoped к чату и валидируется до SQL; он не создаёт snapshot между страницами.
message_attachments_attachment_idx помогает находить ссылки на вложение. upload_intents_created_idx поддерживает обход старых intent через (created_at,id) без OFFSET. Публичный порядок вложений берётся из position, не сортируется по UUID.
Создание чата с участниками атомарно. Отправка сообщения, проверка вложений того же чата под row lock, связи и сохранённый ответ идемпотентности выполняются одной транзакцией. Read-after-write обеспечивается чтением общего PostgreSQL, история не кэшируется.
Upload сначала фиксирует intent, затем держит его FOR UPDATE во время S3 PUT и финализации ready metadata. PostgreSQL и S3 не имеют общей транзакции. Неопределённый COMMIT не запускает delete; только консервативная сверка после grace может убрать abandoned остаток. Публичный API не раскрывает object_key, внутренние адреса или credentials.