Architecture
Storage Pipeline
How files are stored and served.
- Upload received (direct or chunked)
- File stored via storage driver
- Metadata saved to DB
- Optional preview + HLS jobs enqueued
Storage drivers:
- Local filesystem
- S3-compatible object storage
Diagram
flowchart LR
Client -->. |Upload| --> API [/api/v1/upload]
API -->. |Store| --> Storage [Storage Driver]
API -->. |Write metadata| --> DB [(Postgres)]
API -->. |Enqueue| --> Jobs [Background Jobs]
Jobs -->. |Preview| --> Preview [Preview PNG]
Jobs -->. |HLS| --> HLS [HLS segments]
Preview -->. |Store| --> Storage
HLS -->. |Store| --> Storage