Files
mtusi2026lab5/SCHEMA.md
T

49 lines
2.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# PostgreSQL / S3 / broker — ЛР5
```mermaid
flowchart LR
C[Client] --> LB[HAProxy]
LB --> A[API 1/2]
A --> S[Private S3 staging]
A --> P[(PG attachment + job + outbox)]
P --> R[Relay + watchdog]
R --> B[(Valkey Streams + AOF)]
B --> W[Worker 2 bounded child slots]
W --> V[S3 versioned original + 3 variants]
W --> E[(PG fenced atomic publication)]
E --> A
```
Core: users→sessions; chats↔members; chats→messages; message_attachments
имеет составные FK chat/message и chat/attachment. Сессии и idempotency
сохраняются в PG; cache не является источником истины. Row locks и unique
(user,method,path,key) сохраняют Message+result атомарно.
Attachment хранит свойства original, target pipeline_version и
published_version. Jobs unique(attachment_id,pipeline_version), UUID logical ID,
state,attempt/cycle,fence,lease/owner,next_at,safeerror. Outbox содержит только
schema-valid envelope, due/published. Consumer group хранит pending entries,
но окончательные решения находятся в PG. Failed registry — jobs.state=failed.
Результаты: attachment_variants PK(attachment_id,pipeline_version,name),
unique object_key; effect_publications PK(attachment_id,pipeline_version).
Worker в одной транзакции проверяет target version, fence, live lease и
processing, записывает4variants+effect_publication+ready. Object bytes
предшествуют COMMIT; дубли могут повторить PUT тех же bytes/keys.
Публикацию новой версии нельзя перезаписать старым fence/version.
Upload reservation120s предотвращает поздний COMMIT после GC: row lock плюс
проверка expiry нужны и при handoff, и при удалении просроченного reservation.
Unconfirmed bytes не становятся accepted jobs сами по себе.
S3: staging `objects/staging/<UUID>/original`, final
`objects/<attachment>/v<version>/{original,thumbnail,crop,optimized}`.
Filename — только отображаемое поле, не путь. IAM ограничен messenger/objects/*,
корневые credentials получает только S3/bootstrap. PG содержит metadata/SHA,
а не bytes. Broker envelope содержит ID/version/attempt/time, не storage paths.
pipeline_audit сохраняет explicit operator replay/version; pipeline_events —
наблюдаемые решения без secrets. pipeline_faults — test-only single-use hooks,
выключены без PIPELINE_FAULTS=1. В production API не имеет broker credentials;
test controller появляется только в compose.test.yaml и не публикует портов.