# kieth-sy/dentaflow---aimsmile-dental-clinic architecture

> Architecture diagram of the GitHub repository kieth-sy/dentaflow---aimsmile-dental-clinic, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kieth-sy/dentaflow---aimsmile-dental-clinic
- Repository: https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic

## Overview

AimSmile is a role-based dental-clinic management system. A user enters through authentication or a role dashboard, then uses clinic workflows for appointments, patient records, clinical care, billing, inventory, reviews, and reporting; separate routes provide offline AI tools and public information. The graph retains the README’s major capabilities, including subsystems whose implementation was not sampled. Edges are limited to README statements and source references shown in the supplied excerpts and index; some internal route wiring is not shown.

Main entry points: [`clinic/models.py`](https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/clinic/models.py) (Clinic Domain Models), [`clinic/views.py`](https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/clinic/views.py) (Role Dashboards), [`manage_panel/views.py`](https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/manage_panel/views.py) (Custom Admin Console), [`accounts/views.py`](https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/accounts/views.py) (Accounts & Roles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity &amp; Access"]
  node_accounts["Accounts &amp; Roles<br/>[views.py]"]
  node_account_forms["Auth &amp; Profile Forms<br/>[forms.py]"]
  node_user_model["Role User Model<br/>[models.py]"]
end

subgraph group_clinic["Clinic Operations"]
  node_dashboard["Role Dashboards<br/>[views.py]"]
  node_appointments["Appointments<br/>[views.py]"]
  node_patient_records["Patient &amp; Tooth Chart<br/>[views.py]"]
  node_treatments["Treatments &amp; Prescriptions<br/>[views.py]"]
  node_billing["Invoices &amp; Payments<br/>[models.py]"]
  node_inventory_reviews["Inventory &amp; Reviews<br/>[views.py]"]
  node_clinic_forms["Clinic Forms<br/>[forms.py]"]
  node_clinic_models["Clinic Domain Models<br/>[models.py]"]
  node_clinic_db[("Clinic Data Store<br/>[db.sqlite3]")]
end

subgraph group_insights["AI &amp; Insights"]
  node_ai_tools["Offline AI Tools<br/>[views.py]"]
  node_ai_engine["Rule-Based Engine<br/>[engine.py]"]
  node_analytics["Clinic Analytics<br/>[analytics.py]"]
end

subgraph group_admin["Administration"]
  node_admin_console["Custom Admin Console<br/>[views.py]"]
  node_admin_registry["CRUD Registry<br/>[registry.py]"]
end

subgraph group_public["Public Experience"]
  node_public_site["Marketing &amp; Services"]
end

node_visitor(("Visitor / User"))

node_visitor -->|"signs in / signs up"| node_accounts
node_accounts -->|"uses forms"| node_account_forms
node_account_forms -->|"creates / edits"| node_user_model
node_accounts -->|"authenticates users"| node_user_model
node_visitor -->|"opens role workspace"| node_dashboard
node_dashboard -->|"manages"| node_appointments
node_dashboard -->|"opens records"| node_patient_records
node_appointments -->|"uses forms"| node_clinic_forms
node_patient_records -->|"uses forms"| node_clinic_forms
node_treatments -->|"uses forms"| node_clinic_forms
node_appointments -->|"reads / updates"| node_clinic_models
node_patient_records -->|"reads / updates"| node_clinic_models
node_treatments -->|"records care"| node_clinic_models
node_billing -->|"models line items"| node_clinic_models
node_inventory_reviews -->|"manages records"| node_clinic_models
node_clinic_models -->|"persists data"| node_clinic_db
node_visitor -->|"uses AI tools"| node_ai_tools
node_ai_tools -->|"calls rules"| node_ai_engine
node_ai_tools -->|"loads services"| node_clinic_models
node_dashboard -->|"requests metrics"| node_analytics
node_visitor -->|"opens admin panel"| node_admin_console
node_admin_console -->|"resolves resources"| node_admin_registry
node_admin_console -->|"manages clinic data"| node_clinic_models
node_admin_console -->|"shows reports"| node_analytics
node_visitor -->|"browses information"| node_public_site

click node_accounts "https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/accounts/views.py"
click node_account_forms "https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/accounts/forms.py"
click node_user_model "https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/accounts/models.py"
click node_dashboard "https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/clinic/views.py"
click node_appointments "https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/clinic/views.py"
click node_patient_records "https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/clinic/views.py"
click node_treatments "https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/clinic/views.py"
click node_billing "https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/clinic/models.py"
click node_inventory_reviews "https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/clinic/views.py"
click node_clinic_forms "https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/clinic/forms.py"
click node_clinic_models "https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/clinic/models.py"
click node_clinic_db "https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/db.sqlite3"
click node_ai_tools "https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/aiassistant/views.py"
click node_ai_engine "https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/aiassistant/engine.py"
click node_analytics "https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/clinic/analytics.py"
click node_admin_console "https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/manage_panel/views.py"
click node_admin_registry "https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/manage_panel/registry.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_accounts,node_account_forms,node_user_model,node_visitor toneBlue
class node_dashboard,node_appointments,node_patient_records,node_treatments,node_billing,node_inventory_reviews,node_clinic_forms,node_clinic_models,node_clinic_db toneAmber
class node_ai_tools,node_ai_engine,node_analytics toneMint
class node_admin_console,node_admin_registry toneRose
class node_public_site toneIndigo
```

## Components

### Identity & Access

- [Accounts & Roles](https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/accounts/views.py): `accounts/views.py`
- [Auth & Profile Forms](https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/accounts/forms.py): `accounts/forms.py`
- [Role User Model](https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/accounts/models.py): `accounts/models.py`

### Clinic Operations

- [Role Dashboards](https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/clinic/views.py): `clinic/views.py`
- [Appointments](https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/clinic/views.py): `clinic/views.py`
- [Patient & Tooth Chart](https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/clinic/views.py): `clinic/views.py`
- [Treatments & Prescriptions](https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/clinic/views.py): `clinic/views.py`
- [Invoices & Payments](https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/clinic/models.py): `clinic/models.py`
- [Inventory & Reviews](https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/clinic/views.py): `clinic/views.py`
- [Clinic Forms](https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/clinic/forms.py): `clinic/forms.py`
- [Clinic Domain Models](https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/clinic/models.py): `clinic/models.py`
- [Clinic Data Store](https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/db.sqlite3): `db.sqlite3`

### AI & Insights

- [Offline AI Tools](https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/aiassistant/views.py): `aiassistant/views.py`
- [Rule-Based Engine](https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/aiassistant/engine.py): `aiassistant/engine.py`
- [Clinic Analytics](https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/clinic/analytics.py): `clinic/analytics.py`

### Administration

- [Custom Admin Console](https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/manage_panel/views.py): `manage_panel/views.py`
- [CRUD Registry](https://github.com/kieth-sy/dentaflow---aimsmile-dental-clinic/blob/main/manage_panel/registry.py): `manage_panel/registry.py`

### Public Experience

- **Marketing & Services**

### Other components

- **Visitor / User**

## Connections

- Visitor / User → Accounts & Roles: signs in / signs up (evidence: `README.md`)
- Accounts & Roles → Auth & Profile Forms: uses forms (evidence: `accounts/views.py`)
- Auth & Profile Forms → Role User Model: creates / edits (evidence: `accounts/forms.py`)
- Accounts & Roles → Role User Model: authenticates users (evidence: `accounts/views.py`)
- Visitor / User → Role Dashboards: opens role workspace (evidence: `README.md`)
- Role Dashboards → Appointments: manages (evidence: `README.md`)
- Role Dashboards → Patient & Tooth Chart: opens records (evidence: `README.md`)
- Appointments → Clinic Forms: uses forms (evidence: `clinic/views.py`)
- Patient & Tooth Chart → Clinic Forms: uses forms (evidence: `clinic/views.py`)
- Treatments & Prescriptions → Clinic Forms: uses forms (evidence: `clinic/forms.py`)
- Appointments → Clinic Domain Models: reads / updates (evidence: `clinic/views.py`)
- Patient & Tooth Chart → Clinic Domain Models: reads / updates (evidence: `clinic/views.py`)
- Treatments & Prescriptions → Clinic Domain Models: records care (evidence: `clinic/models.py`)
- Invoices & Payments → Clinic Domain Models: models line items (evidence: `clinic/models.py`)
- Inventory & Reviews → Clinic Domain Models: manages records (evidence: `README.md`)
- Clinic Domain Models → Clinic Data Store: persists data (evidence: `clinic/models.py`)
- Visitor / User → Offline AI Tools: uses AI tools (evidence: `README.md`)
- Offline AI Tools → Rule-Based Engine: calls rules (evidence: `aiassistant/views.py`)
- Offline AI Tools → Clinic Domain Models: loads services (evidence: `aiassistant/views.py`)
- Role Dashboards → Clinic Analytics: requests metrics (evidence: `clinic/views.py`)
- Visitor / User → Custom Admin Console: opens admin panel (evidence: `README.md`)
- Custom Admin Console → CRUD Registry: resolves resources (evidence: `manage_panel/views.py`)
- Custom Admin Console → Clinic Domain Models: manages clinic data (evidence: `manage_panel/views.py`)
- Custom Admin Console → Clinic Analytics: shows reports (evidence: `manage_panel/views.py`)
- Visitor / User → Marketing & Services: browses information (evidence: `README.md`)
