Workspace file components
| Component | Responsibility | Assessed source |
|---|---|---|
| Oqullus | Workspace tree, file operations, editors, transient state, feedback, and deep links | sparqd/oqullus at f76e57dbb88d |
| BFF API | User-token validation and exchange, workspace route proxy, upload buffering, and download streaming | sparqd/bff-api at 9b2fd45a4da1 |
| Workspace file backend | Canonical IDs, hierarchy, ACLs, metadata, trash, history, and object-storage access | deployed 5dcbb222241b; reviewed main f82d4cc7ad1f |
| Platform stacks | API and PostgreSQL deployment, credentials, storage bucket creation, resources, and lifecycle jobs | sparqd/platform-stacks at a71390d12463 |
| PostgreSQL | File/folder metadata, hierarchy, ACLs, trash state, and history records | Deployment-owned state store |
| S3 or OSS | Current file bytes and optional object versions | Workspace object-storage bucket |
See the canonical Workspace file assessment for behavior and architecture for cross-component boundaries.