# kimheang-code-it/docetra architecture

> Architecture diagram of the GitHub repository kimheang-code-it/docetra, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kimheang-code-it/docetra
- Repository: https://github.com/kimheang-code-it/docetra

## Overview

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: [`backend/app/api/v2/router.py`](https://github.com/kimheang-code-it/docetra/blob/main/backend/app/api/v2/router.py) (V2 API router), [`frontend/app/app.vue`](https://github.com/kimheang-code-it/docetra/blob/main/frontend/app/app.vue) (Nuxt application), [`backend/app/main.py`](https://github.com/kimheang-code-it/docetra/blob/main/backend/app/main.py) (API / worker / scheduler), [`backend/app/modules/storage_integration/services/storage.py`](https://github.com/kimheang-code-it/docetra/blob/main/backend/app/modules/storage_integration/services/storage.py) (Object storage access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_frontend["Nuxt application<br/>[app.vue]"]
  node_auth_ui["Login and session UI<br/>[useAuthApi.ts]"]
  node_workspace_ui["Workspace and records UI<br/>[useDocumentPage.ts]"]
  node_meeting_ui["Meeting boards"]
  node_search_ui["Global search<br/>[useGlobalSearch.ts]"]
  node_storage_ui["Storage settings UI"]
end

subgraph group_api["API and identity"]
  node_api_router["V2 API router<br/>[router.py]"]
  node_auth["Authentication and authorization<br/>[security.py]"]
end

subgraph group_domain["Workflow domains"]
  node_people["People and access<br/>[service.py]"]
  node_records["Record collections<br/>[service.py]"]
  node_orgs["Organization workflows"]
  node_meetings["Meeting workflows<br/>[meeting.py]"]
  node_configuration["Record configuration<br/>[service.py]"]
  node_reporting["Search and dashboards<br/>[search.py]"]
  node_exports["Export workflows<br/>[export_router.py]"]
  node_attachments["Attachment workflows"]
end

subgraph group_platform["Persistence and integrations"]
  node_database[("Relational database<br/>[session.py]")]
  node_storage_config["Storage provider management"]
  node_storage["Object storage access<br/>[storage.py]"]
end

subgraph group_async["Background operations"]
  node_process["API / worker / scheduler<br/>[main.py]"]
  node_job_topology["Job topology<br/>[topology.py]"]
  node_export_worker["Export consumer<br/>[exports.py]"]
  node_outbox_worker["Outbox consumer<br/>[outbox.py]"]
  node_publishers["Job publishers<br/>[publishers.py]"]
  node_scheduler["Scheduled tasks"]
end

node_user(("User"))
node_object_store[("S3-compatible storage")]
node_google_drive["Google Drive"]
node_email["Email service<br/>[service.py]"]
node_telegram["Telegram integration<br/>[service.py]"]

node_user -->|"uses"| node_frontend
node_frontend -.->|"presents login"| node_auth_ui
node_frontend -.->|"presents records"| node_workspace_ui
node_frontend -.->|"presents meetings"| node_meeting_ui
node_frontend -.->|"offers search"| node_search_ui
node_frontend -.->|"offers settings"| node_storage_ui
node_auth_ui -.->|"HTTP requests"| node_api_router
node_workspace_ui -.->|"HTTP requests"| node_api_router
node_meeting_ui -.->|"HTTP requests"| node_api_router
node_search_ui -.->|"HTTP requests"| node_api_router
node_storage_ui -.->|"HTTP requests"| node_api_router
node_api_router -->|"protects routes"| node_auth
node_api_router -->|"registers"| node_people
node_api_router -->|"registers"| node_records
node_api_router -->|"registers"| node_orgs
node_api_router -->|"registers"| node_configuration
node_api_router -->|"registers"| node_reporting
node_api_router -->|"registers"| node_exports
node_api_router -->|"registers"| node_attachments
node_api_router -->|"registers"| node_storage_config
node_api_router -.->|"registers"| node_meetings
node_auth -.->|"resolves identity"| node_people
node_orgs -->|"resolves officer"| node_people
node_records -.->|"reads and writes"| node_database
node_people -.->|"reads and writes"| node_database
node_configuration -.->|"stores settings"| node_database
node_storage_config -.->|"stores providers"| node_database
node_storage -.->|"stores objects"| node_object_store
node_storage -->|"resolves provider"| node_storage_config
node_storage -.->|"supports provider"| node_google_drive
node_api_router -->|"configures resolver"| node_storage
node_process -->|"serves API"| node_api_router
node_process -.->|"starts roles"| node_job_topology
node_process -->|"runs consumer"| node_export_worker
node_process -->|"runs consumer"| node_outbox_worker
node_process -.->|"runs schedules"| node_scheduler
node_export_worker -.->|"processes exports"| node_exports
node_publishers -.->|"publishes jobs"| node_export_worker
node_publishers -.->|"publishes work"| node_outbox_worker
node_scheduler -.->|"queues reminders"| node_publishers
node_outbox_worker -.->|"delivers email"| node_email
node_outbox_worker -.->|"delivers messages"| node_telegram

click node_frontend "https://github.com/kimheang-code-it/docetra/blob/main/frontend/app/app.vue"
click node_auth_ui "https://github.com/kimheang-code-it/docetra/blob/main/frontend/app/composables/auth/useAuthApi.ts"
click node_workspace_ui "https://github.com/kimheang-code-it/docetra/blob/main/frontend/app/composables/workspace/useDocumentPage.ts"
click node_meeting_ui "https://github.com/kimheang-code-it/docetra/blob/main/frontend/app/composables/meeting/useMeetingTopicBoard.ts"
click node_search_ui "https://github.com/kimheang-code-it/docetra/blob/main/frontend/app/composables/search/useGlobalSearch.ts"
click node_storage_ui "https://github.com/kimheang-code-it/docetra/blob/main/frontend/app/repositories/http/settings-storage.ts"
click node_api_router "https://github.com/kimheang-code-it/docetra/blob/main/backend/app/api/v2/router.py"
click node_auth "https://github.com/kimheang-code-it/docetra/blob/main/backend/app/core/security.py"
click node_people "https://github.com/kimheang-code-it/docetra/blob/main/backend/app/modules/people_access/service.py"
click node_records "https://github.com/kimheang-code-it/docetra/blob/main/backend/app/modules/record/services/service.py"
click node_orgs "https://github.com/kimheang-code-it/docetra/blob/main/backend/app/application/organization_router.py"
click node_meetings "https://github.com/kimheang-code-it/docetra/blob/main/backend/app/modules/record/services/meeting.py"
click node_configuration "https://github.com/kimheang-code-it/docetra/blob/main/backend/app/modules/admin_config/service.py"
click node_reporting "https://github.com/kimheang-code-it/docetra/blob/main/backend/app/modules/reporting_support/services/search.py"
click node_exports "https://github.com/kimheang-code-it/docetra/blob/main/backend/app/application/export_router.py"
click node_attachments "https://github.com/kimheang-code-it/docetra/blob/main/backend/app/application/attachment_router.py"
click node_database "https://github.com/kimheang-code-it/docetra/blob/main/backend/app/db/session.py"
click node_storage_config "https://github.com/kimheang-code-it/docetra/blob/main/backend/app/modules/storage_integration/services/provider_service.py"
click node_storage "https://github.com/kimheang-code-it/docetra/blob/main/backend/app/modules/storage_integration/services/storage.py"
click node_email "https://github.com/kimheang-code-it/docetra/blob/main/backend/app/integrations/email/service.py"
click node_telegram "https://github.com/kimheang-code-it/docetra/blob/main/backend/app/integrations/telegram/service.py"
click node_process "https://github.com/kimheang-code-it/docetra/blob/main/backend/app/main.py"
click node_job_topology "https://github.com/kimheang-code-it/docetra/blob/main/backend/app/jobs/topology.py"
click node_export_worker "https://github.com/kimheang-code-it/docetra/blob/main/backend/app/jobs/consumers/exports.py"
click node_outbox_worker "https://github.com/kimheang-code-it/docetra/blob/main/backend/app/jobs/consumers/outbox.py"
click node_publishers "https://github.com/kimheang-code-it/docetra/blob/main/backend/app/jobs/publishers.py"
click node_scheduler "https://github.com/kimheang-code-it/docetra/blob/main/backend/app/jobs/scheduler/meeting_reminders.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_frontend,node_auth_ui,node_workspace_ui,node_meeting_ui,node_search_ui,node_storage_ui,node_user toneBlue
class node_api_router,node_auth,node_object_store toneAmber
class node_people,node_records,node_orgs,node_meetings,node_configuration,node_reporting,node_exports,node_attachments toneMint
class node_database,node_storage_config,node_storage toneRose
class node_process,node_job_topology,node_export_worker,node_outbox_worker,node_publishers,node_scheduler,node_google_drive,node_telegram toneIndigo
class node_email toneTeal
```

## Components

### Web client

- [Nuxt application](https://github.com/kimheang-code-it/docetra/blob/main/frontend/app/app.vue): `frontend/app/app.vue`
- [Login and session UI](https://github.com/kimheang-code-it/docetra/blob/main/frontend/app/composables/auth/useAuthApi.ts): `frontend/app/composables/auth/useAuthApi.ts`
- [Workspace and records UI](https://github.com/kimheang-code-it/docetra/blob/main/frontend/app/composables/workspace/useDocumentPage.ts): `frontend/app/composables/workspace/useDocumentPage.ts`
- [Meeting boards](https://github.com/kimheang-code-it/docetra/blob/main/frontend/app/composables/meeting/useMeetingTopicBoard.ts): `frontend/app/composables/meeting/useMeetingTopicBoard.ts`
- [Global search](https://github.com/kimheang-code-it/docetra/blob/main/frontend/app/composables/search/useGlobalSearch.ts): `frontend/app/composables/search/useGlobalSearch.ts`
- [Storage settings UI](https://github.com/kimheang-code-it/docetra/blob/main/frontend/app/repositories/http/settings-storage.ts): `frontend/app/repositories/http/settings-storage.ts`

### API and identity

- [V2 API router](https://github.com/kimheang-code-it/docetra/blob/main/backend/app/api/v2/router.py): `backend/app/api/v2/router.py`
- [Authentication and authorization](https://github.com/kimheang-code-it/docetra/blob/main/backend/app/core/security.py): `backend/app/core/security.py`

### Workflow domains

- [People and access](https://github.com/kimheang-code-it/docetra/blob/main/backend/app/modules/people_access/service.py): `backend/app/modules/people_access/service.py`
- [Record collections](https://github.com/kimheang-code-it/docetra/blob/main/backend/app/modules/record/services/service.py): `backend/app/modules/record/services/service.py`
- [Organization workflows](https://github.com/kimheang-code-it/docetra/blob/main/backend/app/application/organization_router.py): `backend/app/application/organization_router.py`
- [Meeting workflows](https://github.com/kimheang-code-it/docetra/blob/main/backend/app/modules/record/services/meeting.py): `backend/app/modules/record/services/meeting.py`
- [Record configuration](https://github.com/kimheang-code-it/docetra/blob/main/backend/app/modules/admin_config/service.py): `backend/app/modules/admin_config/service.py`
- [Search and dashboards](https://github.com/kimheang-code-it/docetra/blob/main/backend/app/modules/reporting_support/services/search.py): `backend/app/modules/reporting_support/services/search.py`
- [Export workflows](https://github.com/kimheang-code-it/docetra/blob/main/backend/app/application/export_router.py): `backend/app/application/export_router.py`
- [Attachment workflows](https://github.com/kimheang-code-it/docetra/blob/main/backend/app/application/attachment_router.py): `backend/app/application/attachment_router.py`

### Persistence and integrations

- [Relational database](https://github.com/kimheang-code-it/docetra/blob/main/backend/app/db/session.py): `backend/app/db/session.py`
- [Storage provider management](https://github.com/kimheang-code-it/docetra/blob/main/backend/app/modules/storage_integration/services/provider_service.py): `backend/app/modules/storage_integration/services/provider_service.py`
- [Object storage access](https://github.com/kimheang-code-it/docetra/blob/main/backend/app/modules/storage_integration/services/storage.py): `backend/app/modules/storage_integration/services/storage.py`

### Background operations

- [API / worker / scheduler](https://github.com/kimheang-code-it/docetra/blob/main/backend/app/main.py): `backend/app/main.py`
- [Job topology](https://github.com/kimheang-code-it/docetra/blob/main/backend/app/jobs/topology.py): `backend/app/jobs/topology.py`
- [Export consumer](https://github.com/kimheang-code-it/docetra/blob/main/backend/app/jobs/consumers/exports.py): `backend/app/jobs/consumers/exports.py`
- [Outbox consumer](https://github.com/kimheang-code-it/docetra/blob/main/backend/app/jobs/consumers/outbox.py): `backend/app/jobs/consumers/outbox.py`
- [Job publishers](https://github.com/kimheang-code-it/docetra/blob/main/backend/app/jobs/publishers.py): `backend/app/jobs/publishers.py`
- [Scheduled tasks](https://github.com/kimheang-code-it/docetra/blob/main/backend/app/jobs/scheduler/meeting_reminders.py): `backend/app/jobs/scheduler/meeting_reminders.py`

### Other components

- **User**
- **S3-compatible storage**
- **Google Drive**
- [Email service](https://github.com/kimheang-code-it/docetra/blob/main/backend/app/integrations/email/service.py): `backend/app/integrations/email/service.py`
- [Telegram integration](https://github.com/kimheang-code-it/docetra/blob/main/backend/app/integrations/telegram/service.py): `backend/app/integrations/telegram/service.py`

## Connections

- User → Nuxt application: uses (evidence: `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 (evidence: `backend/app/api/v2/router.py`)
- V2 API router → People and access: registers (evidence: `backend/app/api/v2/router.py`)
- V2 API router → Record collections: registers (evidence: `backend/app/api/v2/router.py`)
- V2 API router → Organization workflows: registers (evidence: `backend/app/api/v2/router.py`)
- V2 API router → Record configuration: registers (evidence: `backend/app/api/v2/router.py`)
- V2 API router → Search and dashboards: registers (evidence: `backend/app/api/v2/router.py`)
- V2 API router → Export workflows: registers (evidence: `backend/app/api/v2/router.py`)
- V2 API router → Attachment workflows: registers (evidence: `backend/app/api/v2/router.py`)
- V2 API router → Storage provider management: registers (evidence: `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 (evidence: `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 (evidence: `backend/app/modules/storage_integration/services/storage.py`)
- Object storage access → Google Drive: supports provider
- V2 API router → Object storage access: configures resolver (evidence: `backend/app/api/v2/router.py`)
- API / worker / scheduler → V2 API router: serves API (evidence: `backend/app/main.py`)
- API / worker / scheduler → Job topology: starts roles (evidence: `backend/app/main.py`)
- API / worker / scheduler → Export consumer: runs consumer (evidence: `backend/app/main.py`)
- API / worker / scheduler → Outbox consumer: runs consumer (evidence: `backend/app/main.py`)
- API / worker / scheduler → Scheduled tasks: runs schedules (evidence: `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
