5.1 KiB
Бинарные данные и два независимых хранилища
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 этого не устраняет.