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[Client] -->|Upload| API[API /api/v1/upload]
API -->|Store| Storage[Storage Driver]
API -->|Write metadata| DB[(Postgres)]
API -->|Enqueue| Jobs[Background Jobs]
Jobs --> Preview[Preview PNG]
Jobs --> HLS[HLS segments]
Preview --> Storage
HLS --> Storage