# naim-006/chronicai architecture

> Architecture diagram of the GitHub repository naim-006/chronicai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/naim-006/chronicai
- Repository: https://github.com/naim-006/chronicai

## Overview

ChronicAI is a patient-facing health-record and clinical-intelligence platform. Patients use its dashboard to manage records and care; the documented ingestion workflow scans a document, extracts clinical information, presents it for human verification, and stores it. The frontend also offers longitudinal health features and a grounded copilot, while a FastAPI backend provides OCR, retrieval, copilot, and medication-scheduling services. Several pages and routes were not sampled, so their internal calls are omitted; documented architecture relationships are cited to the README.

Main entry points: [`src/app/(dashboard)/dashboard/page.tsx`](https://github.com/naim-006/chronicai/blob/main/src/app/(dashboard)/dashboard/page.tsx) (Health dashboard), [`src/app/(dashboard)/vault/page.tsx`](https://github.com/naim-006/chronicai/blob/main/src/app/(dashboard)/vault/page.tsx) (Health vault), [`backend/app/main.py`](https://github.com/naim-006/chronicai/blob/main/backend/app/main.py) (FastAPI application), [`backend/app/routers/rag.py`](https://github.com/naim-006/chronicai/blob/main/backend/app/routers/rag.py) (RAG service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Patient experience"]
  node_dashboard["Health dashboard<br/>[page.tsx]"]
  node_authui["Authentication UI<br/>[page.tsx]"]
  node_authstate["Auth context<br/>[AuthContext.tsx]"]
  node_language["Language context"]
end

subgraph group_records["Records and care"]
  node_vault["Health vault<br/>[page.tsx]"]
  node_ocrroute["Record analysis API<br/>[route.ts]"]
  node_storage["Document storage<br/>[storage.ts]"]
  node_medications["Medication tracking<br/>[page.tsx]"]
  node_appointments["Appointments<br/>[page.tsx]"]
  node_metrics["Health analytics<br/>[page.tsx]"]
  node_screenings["Risk screening<br/>[page.tsx]"]
  node_timeline["Health timeline<br/>[page.tsx]"]
end

subgraph group_intelligence["Clinical intelligence"]
  node_copilotui["Clinical copilot UI<br/>[page.tsx]"]
  node_chatapi["Copilot chat API<br/>[route.ts]"]
  node_ragapi["Embedding API<br/>[route.ts]"]
end

subgraph group_backend["AI backend"]
  node_backendapp["FastAPI application<br/>[main.py]"]
  node_ocrbackend["OCR service<br/>[ocr.py]"]
  node_ragbackend["RAG service<br/>[rag.py]"]
  node_copilotbackend["Copilot service<br/>[copilot.py]"]
  node_scheduler["Medication scheduler<br/>[chrono_service.py]"]
  node_authbackend["Backend auth<br/>[auth.py]"]
end

subgraph group_persistence["Identity and persistence"]
  node_supabase[("Supabase")]
  node_profile["Profile service<br/>[profile.ts]"]
  node_realtime["Realtime updates<br/>[useRealtime.ts]"]
end

node_patient(("Patient"))

node_patient -->|"uses"| node_dashboard
node_patient -->|"signs in"| node_authui
node_dashboard -->|"manages records"| node_vault
node_vault -->|"submits scans"| node_ocrroute
node_ocrroute -.->|"requests extraction"| node_ocrbackend
node_ocrbackend -.->|"returns extraction"| node_vault
node_vault -->|"uploads documents"| node_storage
node_storage -->|"stores files"| node_supabase
node_vault -->|"persists verified records"| node_supabase
node_dashboard -->|"tracks doses"| node_medications
node_dashboard -->|"manages visits"| node_appointments
node_dashboard -->|"views trends"| node_metrics
node_dashboard -->|"views risk"| node_screenings
node_dashboard -->|"reviews history"| node_timeline
node_dashboard -->|"opens copilot"| node_copilotui
node_copilotui -.->|"sends questions"| node_chatapi
node_chatapi -.->|"retrieves context"| node_ragbackend
node_chatapi -.->|"requests guidance"| node_copilotbackend
node_ragapi -.->|"stores embeddings"| node_supabase
node_backendapp -->|"registers route"| node_ocrbackend
node_backendapp -->|"registers route"| node_ragbackend
node_backendapp -->|"registers route"| node_copilotbackend
node_copilotbackend -->|"retrieves context"| node_ragbackend
node_ragbackend -->|"queries vectors"| node_supabase
node_backendapp -->|"registers scheduler route"| node_scheduler
node_scheduler -.->|"requires identity"| node_authbackend
node_authui -.->|"maintains session"| node_authstate
node_authstate -->|"loads profile"| node_profile
node_profile -->|"reads profile"| node_supabase
node_dashboard -.->|"subscribes to updates"| node_realtime
node_realtime -->|"receives changes"| node_supabase
node_dashboard -.->|"localizes interface"| node_language

click node_dashboard "https://github.com/naim-006/chronicai/blob/main/src/app/(dashboard)/dashboard/page.tsx"
click node_authui "https://github.com/naim-006/chronicai/blob/main/src/app/(auth)/login/page.tsx"
click node_authstate "https://github.com/naim-006/chronicai/blob/main/src/context/AuthContext.tsx"
click node_language "https://github.com/naim-006/chronicai/blob/main/src/context/LanguageContext.tsx"
click node_vault "https://github.com/naim-006/chronicai/blob/main/src/app/(dashboard)/vault/page.tsx"
click node_ocrroute "https://github.com/naim-006/chronicai/blob/main/src/app/api/records/analyze/route.ts"
click node_storage "https://github.com/naim-006/chronicai/blob/main/src/lib/supabase/storage.ts"
click node_medications "https://github.com/naim-006/chronicai/blob/main/src/app/(dashboard)/medications/page.tsx"
click node_appointments "https://github.com/naim-006/chronicai/blob/main/src/app/(dashboard)/appointments/page.tsx"
click node_metrics "https://github.com/naim-006/chronicai/blob/main/src/app/(dashboard)/metrics/page.tsx"
click node_screenings "https://github.com/naim-006/chronicai/blob/main/src/app/(dashboard)/screenings/page.tsx"
click node_timeline "https://github.com/naim-006/chronicai/blob/main/src/app/(dashboard)/timeline/page.tsx"
click node_copilotui "https://github.com/naim-006/chronicai/blob/main/src/app/(dashboard)/assistant/page.tsx"
click node_chatapi "https://github.com/naim-006/chronicai/blob/main/src/app/api/assistant/chat/route.ts"
click node_ragapi "https://github.com/naim-006/chronicai/blob/main/src/app/api/rag/embed/route.ts"
click node_backendapp "https://github.com/naim-006/chronicai/blob/main/backend/app/main.py"
click node_ocrbackend "https://github.com/naim-006/chronicai/blob/main/backend/app/routers/ocr.py"
click node_ragbackend "https://github.com/naim-006/chronicai/blob/main/backend/app/routers/rag.py"
click node_copilotbackend "https://github.com/naim-006/chronicai/blob/main/backend/app/routers/copilot.py"
click node_scheduler "https://github.com/naim-006/chronicai/blob/main/backend/app/services/chrono_service.py"
click node_authbackend "https://github.com/naim-006/chronicai/blob/main/backend/app/core/auth.py"
click node_profile "https://github.com/naim-006/chronicai/blob/main/src/lib/supabase/services/profile.ts"
click node_realtime "https://github.com/naim-006/chronicai/blob/main/src/hooks/useRealtime.ts"

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_dashboard,node_authui,node_authstate,node_language toneBlue
class node_vault,node_ocrroute,node_storage,node_medications,node_appointments,node_metrics,node_screenings,node_timeline toneAmber
class node_copilotui,node_chatapi,node_ragapi toneMint
class node_backendapp,node_ocrbackend,node_ragbackend,node_copilotbackend,node_scheduler,node_authbackend toneRose
class node_supabase,node_profile,node_realtime,node_patient toneIndigo
```

## Components

### Patient experience

- [Health dashboard](https://github.com/naim-006/chronicai/blob/main/src/app/(dashboard)/dashboard/page.tsx): `src/app/(dashboard)/dashboard/page.tsx`
- [Authentication UI](https://github.com/naim-006/chronicai/blob/main/src/app/(auth)/login/page.tsx): `src/app/(auth)/login/page.tsx`
- [Auth context](https://github.com/naim-006/chronicai/blob/main/src/context/AuthContext.tsx): `src/context/AuthContext.tsx`
- [Language context](https://github.com/naim-006/chronicai/blob/main/src/context/LanguageContext.tsx): `src/context/LanguageContext.tsx`

### Records and care

- [Health vault](https://github.com/naim-006/chronicai/blob/main/src/app/(dashboard)/vault/page.tsx): `src/app/(dashboard)/vault/page.tsx`
- [Record analysis API](https://github.com/naim-006/chronicai/blob/main/src/app/api/records/analyze/route.ts): `src/app/api/records/analyze/route.ts`
- [Document storage](https://github.com/naim-006/chronicai/blob/main/src/lib/supabase/storage.ts): `src/lib/supabase/storage.ts`
- [Medication tracking](https://github.com/naim-006/chronicai/blob/main/src/app/(dashboard)/medications/page.tsx): `src/app/(dashboard)/medications/page.tsx`
- [Appointments](https://github.com/naim-006/chronicai/blob/main/src/app/(dashboard)/appointments/page.tsx): `src/app/(dashboard)/appointments/page.tsx`
- [Health analytics](https://github.com/naim-006/chronicai/blob/main/src/app/(dashboard)/metrics/page.tsx): `src/app/(dashboard)/metrics/page.tsx`
- [Risk screening](https://github.com/naim-006/chronicai/blob/main/src/app/(dashboard)/screenings/page.tsx): `src/app/(dashboard)/screenings/page.tsx`
- [Health timeline](https://github.com/naim-006/chronicai/blob/main/src/app/(dashboard)/timeline/page.tsx): `src/app/(dashboard)/timeline/page.tsx`

### Clinical intelligence

- [Clinical copilot UI](https://github.com/naim-006/chronicai/blob/main/src/app/(dashboard)/assistant/page.tsx): `src/app/(dashboard)/assistant/page.tsx`
- [Copilot chat API](https://github.com/naim-006/chronicai/blob/main/src/app/api/assistant/chat/route.ts): `src/app/api/assistant/chat/route.ts`
- [Embedding API](https://github.com/naim-006/chronicai/blob/main/src/app/api/rag/embed/route.ts): `src/app/api/rag/embed/route.ts`

### AI backend

- [FastAPI application](https://github.com/naim-006/chronicai/blob/main/backend/app/main.py): `backend/app/main.py`
- [OCR service](https://github.com/naim-006/chronicai/blob/main/backend/app/routers/ocr.py): `backend/app/routers/ocr.py`
- [RAG service](https://github.com/naim-006/chronicai/blob/main/backend/app/routers/rag.py): `backend/app/routers/rag.py`
- [Copilot service](https://github.com/naim-006/chronicai/blob/main/backend/app/routers/copilot.py): `backend/app/routers/copilot.py`
- [Medication scheduler](https://github.com/naim-006/chronicai/blob/main/backend/app/services/chrono_service.py): `backend/app/services/chrono_service.py`
- [Backend auth](https://github.com/naim-006/chronicai/blob/main/backend/app/core/auth.py): `backend/app/core/auth.py`

### Identity and persistence

- **Supabase**
- [Profile service](https://github.com/naim-006/chronicai/blob/main/src/lib/supabase/services/profile.ts): `src/lib/supabase/services/profile.ts`
- [Realtime updates](https://github.com/naim-006/chronicai/blob/main/src/hooks/useRealtime.ts): `src/hooks/useRealtime.ts`

### Other components

- **Patient**

## Connections

- Patient → Health dashboard: uses
- Patient → Authentication UI: signs in
- Health dashboard → Health vault: manages records
- Health vault → Record analysis API: submits scans
- Record analysis API → OCR service: requests extraction
- OCR service → Health vault: returns extraction
- Health vault → Document storage: uploads documents
- Document storage → Supabase: stores files (evidence: `src/lib/supabase/storage.ts`)
- Health vault → Supabase: persists verified records
- Health dashboard → Medication tracking: tracks doses
- Health dashboard → Appointments: manages visits
- Health dashboard → Health analytics: views trends
- Health dashboard → Risk screening: views risk
- Health dashboard → Health timeline: reviews history
- Health dashboard → Clinical copilot UI: opens copilot
- Clinical copilot UI → Copilot chat API: sends questions
- Copilot chat API → RAG service: retrieves context
- Copilot chat API → Copilot service: requests guidance
- Embedding API → Supabase: stores embeddings
- FastAPI application → OCR service: registers route (evidence: `backend/app/main.py`)
- FastAPI application → RAG service: registers route (evidence: `backend/app/main.py`)
- FastAPI application → Copilot service: registers route (evidence: `backend/app/main.py`)
- Copilot service → RAG service: retrieves context (evidence: `backend/app/routers/copilot.py`)
- RAG service → Supabase: queries vectors (evidence: `backend/app/routers/rag.py`)
- FastAPI application → Medication scheduler: registers scheduler route (evidence: `backend/app/main.py`)
- Medication scheduler → Backend auth: requires identity
- Authentication UI → Auth context: maintains session
- Auth context → Profile service: loads profile (evidence: `src/context/AuthContext.tsx`)
- Profile service → Supabase: reads profile (evidence: `src/lib/supabase/services/profile.ts`)
- Health dashboard → Realtime updates: subscribes to updates
- Realtime updates → Supabase: receives changes
- Health dashboard → Language context: localizes interface
