# bnod-gh/danta architecture

> Architecture diagram of the GitHub repository bnod-gh/danta, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bnod-gh/danta
- Repository: https://github.com/bnod-gh/danta

## Overview

Danta is a multi-tenant dental-practice management SaaS. The primary user workflow is staff using the web dashboard or mobile app to access practice operations and clinical records; the API provides business logic and persistence, with identity, gateway, practice, and worker services supporting the product. The tree shows distinct booking, patient-care, billing, imaging, claims, communications, and reporting capabilities. Arrows between frontends and services are architectural links documented only at a high level; the sampled excerpts do not establish their runtime wiring.

Main entry points: [`apps/gateway/src`](https://github.com/bnod-gh/danta/tree/main/apps/gateway/src) (API gateway), [`apps/web/src`](https://github.com/bnod-gh/danta/tree/main/apps/web/src) (Web dashboard), [`apps/mobile/app`](https://github.com/bnod-gh/danta/tree/main/apps/mobile/app) (Mobile app), [`apps/api/src`](https://github.com/bnod-gh/danta/tree/main/apps/api/src) (Core API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["User applications"]
  node_web["Web dashboard"]
  node_mobile["Mobile app"]
end

subgraph group_platform["Platform services"]
  node_gateway["API gateway"]
  node_identity["Identity service"]
  node_api["Core API"]
  node_practice_svc["Practice service"]
end

subgraph group_practice["Practice operations"]
  node_appointments["Appointments"]
  node_scheduling["Scheduling"]
  node_billing["Billing and payments"]
  node_claims["Claims integrations"]
  node_communications["Communications"]
  node_reports["Reporting"]
end

subgraph group_care["Clinical care"]
  node_patients["Patient records"]
  node_clinical["Clinical records"]
  node_dental["Dental charting"]
  node_imaging["Dental imaging"]
end

subgraph group_foundation["Data and jobs"]
  node_worker["Background jobs"]
  node_database[("Database")]
  node_storage["File storage"]
end

node_staff(("Practice staff"))

node_staff -->|"uses dashboard"| node_web
node_staff -->|"uses mobile app"| node_mobile
node_web -.->|"sends requests"| node_gateway
node_mobile -.->|"sends requests"| node_gateway
node_gateway -.->|"routes requests"| node_api
node_gateway -.->|"routes requests"| node_identity
node_api -->|"persists data"| node_database

click node_web "https://github.com/bnod-gh/danta/tree/main/apps/web/src"
click node_mobile "https://github.com/bnod-gh/danta/tree/main/apps/mobile/app"
click node_gateway "https://github.com/bnod-gh/danta/tree/main/apps/gateway/src"
click node_identity "https://github.com/bnod-gh/danta/tree/main/apps/identity/src"
click node_api "https://github.com/bnod-gh/danta/tree/main/apps/api/src"
click node_practice_svc "https://github.com/bnod-gh/danta/tree/main/apps/practice/src"
click node_patients "https://github.com/bnod-gh/danta/tree/main/apps/api/src/modules/patients"
click node_clinical "https://github.com/bnod-gh/danta/tree/main/apps/api/src/modules/clinical-notes"
click node_dental "https://github.com/bnod-gh/danta/tree/main/apps/api/src/modules/dental-charts"
click node_imaging "https://github.com/bnod-gh/danta/tree/main/apps/api/src/modules/imaging-images"
click node_appointments "https://github.com/bnod-gh/danta/tree/main/apps/api/src/modules/appointments"
click node_scheduling "https://github.com/bnod-gh/danta/tree/main/apps/api/src/modules/schedules"
click node_billing "https://github.com/bnod-gh/danta/tree/main/apps/api/src/modules/invoices"
click node_claims "https://github.com/bnod-gh/danta/tree/main/apps/api/src/modules/claim-integrations"
click node_communications "https://github.com/bnod-gh/danta/tree/main/apps/api/src/modules/communication"
click node_reports "https://github.com/bnod-gh/danta/tree/main/apps/api/src/modules/reports"
click node_worker "https://github.com/bnod-gh/danta/tree/main/apps/worker/src"
click node_database "https://github.com/bnod-gh/danta/tree/main/packages/database"
click node_storage "https://github.com/bnod-gh/danta/tree/main/apps/api/src/storage"

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_web,node_mobile toneBlue
class node_gateway,node_identity,node_api,node_practice_svc toneAmber
class node_appointments,node_scheduling,node_billing,node_claims,node_communications,node_reports toneMint
class node_patients,node_clinical,node_dental,node_imaging toneRose
class node_worker,node_database,node_storage,node_staff toneIndigo
```

## Components

### User applications

- [Web dashboard](https://github.com/bnod-gh/danta/tree/main/apps/web/src): `apps/web/src`
- [Mobile app](https://github.com/bnod-gh/danta/tree/main/apps/mobile/app): `apps/mobile/app`

### Platform services

- [API gateway](https://github.com/bnod-gh/danta/tree/main/apps/gateway/src): `apps/gateway/src`
- [Identity service](https://github.com/bnod-gh/danta/tree/main/apps/identity/src): `apps/identity/src`
- [Core API](https://github.com/bnod-gh/danta/tree/main/apps/api/src): `apps/api/src`
- [Practice service](https://github.com/bnod-gh/danta/tree/main/apps/practice/src): `apps/practice/src`

### Practice operations

- [Appointments](https://github.com/bnod-gh/danta/tree/main/apps/api/src/modules/appointments): `apps/api/src/modules/appointments`
- [Scheduling](https://github.com/bnod-gh/danta/tree/main/apps/api/src/modules/schedules): `apps/api/src/modules/schedules`
- [Billing and payments](https://github.com/bnod-gh/danta/tree/main/apps/api/src/modules/invoices): `apps/api/src/modules/invoices`
- [Claims integrations](https://github.com/bnod-gh/danta/tree/main/apps/api/src/modules/claim-integrations): `apps/api/src/modules/claim-integrations`
- [Communications](https://github.com/bnod-gh/danta/tree/main/apps/api/src/modules/communication): `apps/api/src/modules/communication`
- [Reporting](https://github.com/bnod-gh/danta/tree/main/apps/api/src/modules/reports): `apps/api/src/modules/reports`

### Clinical care

- [Patient records](https://github.com/bnod-gh/danta/tree/main/apps/api/src/modules/patients): `apps/api/src/modules/patients`
- [Clinical records](https://github.com/bnod-gh/danta/tree/main/apps/api/src/modules/clinical-notes): `apps/api/src/modules/clinical-notes`
- [Dental charting](https://github.com/bnod-gh/danta/tree/main/apps/api/src/modules/dental-charts): `apps/api/src/modules/dental-charts`
- [Dental imaging](https://github.com/bnod-gh/danta/tree/main/apps/api/src/modules/imaging-images): `apps/api/src/modules/imaging-images`

### Data and jobs

- [Background jobs](https://github.com/bnod-gh/danta/tree/main/apps/worker/src): `apps/worker/src`
- [Database](https://github.com/bnod-gh/danta/tree/main/packages/database): `packages/database`
- [File storage](https://github.com/bnod-gh/danta/tree/main/apps/api/src/storage): `apps/api/src/storage`

### Other components

- **Practice staff**

## Connections

- Practice staff → Web dashboard: uses dashboard
- Practice staff → Mobile app: uses mobile app
- Web dashboard → API gateway: sends requests
- Mobile app → API gateway: sends requests
- API gateway → Core API: routes requests
- API gateway → Identity service: routes requests
- Core API → Database: persists data
