How kimheang-code-it/docetra works
Docetra is a records and organizational-workflow platform, with a Nuxt client and FastAPI backend. A user authenticates, works with configured record types and organization collections, and can manage meetings, collaboration, files, search, dashboards, and exports. The backend exposes these capabilities through the v2 API; domain services operate on relational records and integrate with configured storage. Separate worker, scheduler, and Telegram process modes support asynchronous exports, outbox work, reminders, and bot interactions. The graph emphasizes documented runtime wiring and sampled calls; several frontend and backend feature branches are represented from the tree, with uncertain internal links omitted.
Main entry points: router.py V2 API router · app.vue Nuxt application · main.py API / worker / scheduler · storage.py Object storage access
Components 30
Web client
- Nuxt application
frontend/app/app.vue - Login and session UI
frontend/app/composables/auth/useAuthApi.ts - Workspace and records UI
frontend/app/composables/workspace/useDocumentPage.ts - Meeting boards
frontend/app/composables/meeting/useMeetingTopicBoard.ts - Global search
frontend/app/composables/search/useGlobalSearch.ts - Storage settings UI
frontend/app/repositories/http/settings-storage.ts
API and identity
- V2 API router
backend/app/api/v2/router.py - Authentication and authorization
backend/app/core/security.py
Workflow domains
- People and access
backend/app/modules/people_access/service.py - Record collections
backend/app/modules/record/services/service.py - Organization workflows
backend/app/application/organization_router.py - Meeting workflows
backend/app/modules/record/services/meeting.py - Record configuration
backend/app/modules/admin_config/service.py - Search and dashboards
backend/app/modules/reporting_support/services/search.py - Export workflows
backend/app/application/export_router.py - Attachment workflows
backend/app/application/attachment_router.py
Persistence and integrations
- Relational database
backend/app/db/session.py - Storage provider management
backend/app/modules/storage_integration/services/provider_service.py - Object storage access
backend/app/modules/storage_integration/services/storage.py
Background operations
- API / worker / scheduler
backend/app/main.py - Job topology
backend/app/jobs/topology.py - Export consumer
backend/app/jobs/consumers/exports.py - Outbox consumer
backend/app/jobs/consumers/outbox.py - Job publishers
backend/app/jobs/publishers.py - Scheduled tasks
backend/app/jobs/scheduler/meeting_reminders.py
Other components
- User
- S3-compatible storage
- Google Drive
- Email service
backend/app/integrations/email/service.py - Telegram integration
backend/app/integrations/telegram/service.py
Connections 42
- User → Nuxt application: uses
frontend/app/app.vue - Nuxt application → Login and session UI: presents login
- Nuxt application → Workspace and records UI: presents records
- Nuxt application → Meeting boards: presents meetings
- Nuxt application → Global search: offers search
- Nuxt application → Storage settings UI: offers settings
- Login and session UI → V2 API router: HTTP requests
- Workspace and records UI → V2 API router: HTTP requests
- Meeting boards → V2 API router: HTTP requests
- Global search → V2 API router: HTTP requests
- Storage settings UI → V2 API router: HTTP requests
- V2 API router → Authentication and authorization: protects routes
backend/app/api/v2/router.py - V2 API router → People and access: registers
backend/app/api/v2/router.py - V2 API router → Record collections: registers
backend/app/api/v2/router.py - V2 API router → Organization workflows: registers
backend/app/api/v2/router.py - V2 API router → Record configuration: registers
backend/app/api/v2/router.py - V2 API router → Search and dashboards: registers
backend/app/api/v2/router.py - V2 API router → Export workflows: registers
backend/app/api/v2/router.py - V2 API router → Attachment workflows: registers
backend/app/api/v2/router.py - V2 API router → Storage provider management: registers
backend/app/api/v2/router.py - V2 API router → Meeting workflows: registers
- Authentication and authorization → People and access: resolves identity
- Organization workflows → People and access: resolves officer
backend/app/application/organization_router.py - Record collections → Relational database: reads and writes
- People and access → Relational database: reads and writes
- Record configuration → Relational database: stores settings
- Storage provider management → Relational database: stores providers
- Object storage access → S3-compatible storage: stores objects
- Object storage access → Storage provider management: resolves provider
backend/app/modules/storage_integration/services/storage.py - Object storage access → Google Drive: supports provider
- V2 API router → Object storage access: configures resolver
backend/app/api/v2/router.py - API / worker / scheduler → V2 API router: serves API
backend/app/main.py - API / worker / scheduler → Job topology: starts roles
backend/app/main.py - API / worker / scheduler → Export consumer: runs consumer
backend/app/main.py - API / worker / scheduler → Outbox consumer: runs consumer
backend/app/main.py - API / worker / scheduler → Scheduled tasks: runs schedules
backend/app/main.py - Export consumer → Export workflows: processes exports
- Job publishers → Export consumer: publishes jobs
- Job publishers → Outbox consumer: publishes work
- Scheduled tasks → Job publishers: queues reminders
- Outbox consumer → Email service: delivers email
- Outbox consumer → Telegram integration: delivers messages