Files
mtusi2026lab4/SCHEMA.md
T

5.1 KiB
Raw Blame History

Бинарные данные и два независимых хранилища

flowchart LR
    C[Клиент] --> L[HAProxy :8084]
    L --> A[API × 2]
    A --> P[(PostgreSQL)]
    A --> S[(Приватный MinIO)]
    A --> V[(Valkey: кэш пользователей)]
    R[Reconciler: 60 секунд] --> P
    R --> S

users/chats/members/messages/sessions/idempotency перенесены из собственной ЛР3. Новые таблицы: attachments и message_attachments. Состав участников чата неизменяемый. PostgreSQL хранит metadata и ACL, S3 — оригинальные bytes. Временный файл в API ограничен размером, удаляется при закрытии запроса и не является источником истины. API-процессы не обмениваются локальными файлами.

sequenceDiagram
    participant C as Клиент
    participant A as API
    participant P as PostgreSQL
    participant S as S3
    C->>A: Bearer, filename, PNG/JPEG bytes
    A->>A: ACL, лимиты bytes/pixels, decode, SHA-256
    A->>P: COMMIT pending intent, UUID/key, срок 120 с
    A->>S: PUT оригинала
    A->>P: COMMIT ready при действующем намерении
    A-->>C: 201 ready

Общей транзакции PostgreSQL+S3 нет. Если INSERT намерения не прошёл, PUT не выполняется. Если PUT не прошёл, остаётся pending без объекта. Если PUT прошёл, а ready UPDATE/COMMIT нет, остаётся pending с bytes. Неопределённый результат COMMIT нельзя исправлять безусловным DELETE файла: COMMIT мог успешно завершиться, хотя клиент потерял ответ.

Reconciler по умолчанию выполняет dry-run. --apply разрешает изменения. Автоматический процесс запускает apply каждые 60 секунд. Grace не менее 300 секунд; возраст берётся из PostgreSQL clock и S3 LastModified.

Состояние Действие после grace
Объект без metadata Повторная проверка metadata и HEAD; удалить старый orphan
pending + корректные размер/SHA-256 bytes ready
pending без bytes / с другим размером/checksum failed с безопасной причиной
ready с bytes, включая файл без Message Сохранить
ready без bytes failed, сохранить ID, metadata и Message links
failed, связанный с Message Сохранить
failed без Message со старым объектом Повторно проверить свежесть HEAD; удалить bytes
Свежий объект Сохранить
AccessDenied / 5xx / network error Завершить проход с ошибкой; не считать объект отсутствующим

Во внешнем контракте ЛР4 Attachment имеет только статус ready. Внутренние pending/failed возвращают 409 conflict, после проверки ACL. ЛР5 меняет этот контракт на четыре публичных состояния и требует другого обработчика.

Связь Message↔Attachment вставляется в одной PostgreSQL-транзакции с Message и Idempotency-Key. Композитные FK проверяют одинаковый chat_id; FOR SHARE на вложении защищает проверку ready от конкурентного изменения состояния. Несколько сообщений могут использовать одно вложение своего чата.

S3 app-user разрешены ListBucket/GetBucketLocation и object CRUD только messenger/objects/*. Root credentials доступны лишь серверу и bootstrap. Bucket private, S3-порт не опубликован на host, console слушает container loopback. Авторизованный download проксируется через API; случайный key не заменяет проверку membership.

Ограничения: полный LIST и выборка metadata имеют стоимость O(objects+rows) и линейную память reconciler. Ready-проверка использует HEAD, не полный периодический аудит битовой целостности. Metadata failed сохраняются для диагностики. Reconciler обнаруживает пропажу bytes, но не восстанавливает данные из checksum. Единственный Docker-host, LB, PostgreSQL и MinIO — общие точки отказа; репликация API этого не устраняет.