Dynavera/docs/application-structure.md

65 lines
1.3 KiB
Markdown
Raw Normal View History

2026-02-27 02:09:54 +00:00
# Application Structure (Detailed)
This page expands on where responsibilities live in the codebase.
## Core Apps
### `apps.accounts`
Handles identity and tenancy concerns:
- User model and role flags
- Organization ownership and membership
- Role assignment and invite flows
### `apps.knowledge`
Handles ingestion and retrieval data prep:
- Upload and tracking of training files
- Content extraction and chunking pipeline
- Embedding persistence in role-scoped vector documents
### `apps.onboarding`
Handles the agentic onboarding runtime:
- Session and flow models
- WebSocket consumer orchestrator
- Tool routing (MCP-style handler)
- Flow/session APIs for frontend integration
## Infrastructure Modules
### `config/*`
Framework-level config and wiring:
- Django settings
- URL/API routing
- ASGI/Channels entry points
- Celery config
### `compose/*`
Environment-specific deployment configuration:
- Development compose stack
- Production compose stack
- Inference compose profile
### `gpu_server.py`
Inference service entry point:
- Chat completions endpoint
- Embeddings endpoint
- Semantic chunking endpoint
- Health checks and model lifecycle
## Navigation
- [Distributed Runtime Flow](distributed-runtime-flow.md)
- [Deployment Topologies](deployment-topologies.md)
- [Project README](../README.md)