Core architecture
- Routers stay thin and delegate orchestration to manager classes.
- Managers bind user context, services, and storage providers through ManagerFactory.
- Audio analysis stays local-first while persisted metadata is optimized for SQLite or Cosmos DB.
- Docstrings follow Sphinx-friendly conventions and can also be consumed by modern doc builders.
Storage providers
local-jsonsqliteazure-cosmos
Each provider stores optimized, user-scoped library documents.
Developer Workspace
Browse the rendered docs in the frame below, then jump back into the manager architecture notes without leaving the page.
Contributor notes
Flow: Router -> Manager -> Service -> Repository -> StorageProvider
Use `ManagerFactory` for new component managers and keep ownership checks in the manager layer.