DB Schema
Schema Overview
BSS uses a minimal MongoDB database for indexing only. All binary data and metadata lives in S3. The DB records are pointers for querying — not the source of truth for content.
Models
| Model | Description |
|---|---|
| Video | Video index record (fps, length, duration, timestamps) |
| Audio | Audio index record (sampleRate, channels, codec, duration) |
| TextTrack | Text track index (entryCount, time range, format) |
| LabelTrack | Label track index (entryCount, time range) |
| Embedding | Vector embeddings for semantic search |
Key Design Principles
- S3 is the source of truth — DB records are indexes, not data stores
- IDs are MongoDB ObjectId — auto-generated
- Soft deletes —
deletedAton Video, Audio, TextTrack, LabelTrack - Owner/project scoping — all records carry
owner+projectfor namespace isolation - embId — optional link to a VectorIndex for semantic search (Audio, TextTrack, LabelTrack)