# wcthls/smart-hospital-platform architecture

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

- Interactive diagram: https://gitdiagram.com/wcthls/smart-hospital-platform
- Repository: https://github.com/wcthls/smart-hospital-platform

## Overview

ClinIQ is a hospital patient-journey platform: patients check in and receive care while staff coordinate triage, clinical work, diagnostics, prescriptions, billing, and operations. The React application calls a FastAPI modular monolith, whose domain routes use shared clinical data and supporting AI and event infrastructure. The map preserves documented capabilities such as oncology, local diagnostic AI, and live operations; several backend branches are represented at directory level because their implementation was not sampled.

Main entry points: [`frontend/src/lib/api.ts`](https://github.com/wcthls/smart-hospital-platform/blob/main/frontend/src/lib/api.ts) (API Client), [`backend/app/main.py`](https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/main.py) (FastAPI Application), [`backend/app/models.py`](https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/models.py) (Clinical Domain Model), [`backend/app/api/routes_journey.py`](https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/api/routes_journey.py) (Identity and Triage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_front["Patient and Staff UI"]
  node_patient["Patient Portal"]
  node_triage["Triage Workspace"]
  node_doctor["Doctor Workspace"]
  node_lab["Lab Workspace<br/>[LabWorkspace.tsx]"]
  node_radiology["Radiology Workspace"]
  node_pharmacy["Pharmacy Workspace"]
  node_oncology["Oncology Workspace"]
  node_ops["Operations Console<br/>[CommandCenter.tsx]"]
  node_api["API Client<br/>[api.ts]"]
end

subgraph group_journey["Care Journey"]
  node_journey_api["Identity and Triage<br/>[routes_journey.py]"]
  node_os_api["Hospital OS and Portal<br/>[routes_os.py]"]
end

subgraph group_clinical["Clinical Services"]
  node_clinical_api["Clinical and Labs<br/>[routes_clinical.py]"]
  node_billing["Billing and Discharge<br/>[routes_billing.py]"]
  node_oncology_api["Oncology Services<br/>[routes_oncology.py]"]
  node_ai_routes["AI Endpoints<br/>[routes_ai.py]"]
  node_ai_agents["AI Agents<br/>[agents.py]"]
  node_diagnostics["Local Diagnostics<br/>[local_analyzer.py]"]
end

subgraph group_platform["Shared Platform"]
  node_models["Clinical Domain Model<br/>[models.py]"]
  node_database[("Database<br/>[database.py]")]
  node_events["Event Bus<br/>[events.py]"]
  node_security["Consent and Audit<br/>[security.py]"]
  node_entry["FastAPI Application<br/>[main.py]"]
end

node_patient_actor(("Patient"))
node_staff_actor(("Hospital Staff"))

node_patient_actor -->|"uses"| node_patient
node_staff_actor -->|"uses"| node_triage
node_staff_actor -->|"uses"| node_doctor
node_patient -->|"requests data"| node_api
node_triage -->|"requests data"| node_api
node_doctor -->|"requests data"| node_api
node_lab -->|"requests data"| node_api
node_radiology -->|"requests data"| node_api
node_pharmacy -->|"requests data"| node_api
node_oncology -.->|"requests data"| node_api
node_ops -.->|"requests data"| node_api
node_api -->|"calls endpoints"| node_journey_api
node_api -->|"calls endpoints"| node_clinical_api
node_api -->|"calls endpoints"| node_billing
node_api -->|"calls endpoints"| node_os_api
node_entry -->|"registers router"| node_journey_api
node_entry -->|"registers router"| node_clinical_api
node_entry -->|"registers router"| node_billing
node_entry -->|"registers router"| node_oncology_api
node_entry -->|"registers router"| node_ai_routes
node_entry -->|"registers router"| node_os_api
node_journey_api -->|"references"| node_clinical_api
node_journey_api -->|"reads and writes"| node_models
node_clinical_api -->|"reads and writes"| node_models
node_billing -->|"reads and writes"| node_models
node_oncology_api -->|"reads and writes"| node_models
node_os_api -->|"reads and writes"| node_models
node_database -->|"registers mappings"| node_models
node_entry -->|"initializes"| node_database
node_entry -->|"streams events"| node_events
node_clinical_api -->|"uses drafts"| node_ai_agents
node_ai_agents -.->|"analyzes locally"| node_diagnostics
node_ai_routes -.->|"dispatches"| node_ai_agents
node_security -->|"audits actions"| node_models
node_journey_api -.->|"checks consent"| node_security

click node_patient "https://github.com/wcthls/smart-hospital-platform/blob/main/frontend/src/features/patient/PatientDashboard.tsx"
click node_triage "https://github.com/wcthls/smart-hospital-platform/blob/main/frontend/src/features/triage/TriageWorkspace.tsx"
click node_doctor "https://github.com/wcthls/smart-hospital-platform/blob/main/frontend/src/features/doctor/DoctorWorkspace.tsx"
click node_lab "https://github.com/wcthls/smart-hospital-platform/blob/main/frontend/src/features/lab/LabWorkspace.tsx"
click node_radiology "https://github.com/wcthls/smart-hospital-platform/blob/main/frontend/src/features/radiology/RadiologyWorkspace.tsx"
click node_pharmacy "https://github.com/wcthls/smart-hospital-platform/blob/main/frontend/src/features/pharmacy/PharmacyWorkspace.tsx"
click node_oncology "https://github.com/wcthls/smart-hospital-platform/blob/main/frontend/src/features/oncology/OncologyWorkspace.tsx"
click node_ops "https://github.com/wcthls/smart-hospital-platform/blob/main/frontend/src/features/admin/CommandCenter.tsx"
click node_api "https://github.com/wcthls/smart-hospital-platform/blob/main/frontend/src/lib/api.ts"
click node_journey_api "https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/api/routes_journey.py"
click node_clinical_api "https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/api/routes_clinical.py"
click node_billing "https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/api/routes_billing.py"
click node_oncology_api "https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/api/routes_oncology.py"
click node_ai_routes "https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/api/routes_ai.py"
click node_ai_agents "https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/ai/agents.py"
click node_diagnostics "https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/ai/local_analyzer.py"
click node_os_api "https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/api/routes_os.py"
click node_models "https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/models.py"
click node_database "https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/core/database.py"
click node_events "https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/core/events.py"
click node_security "https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/core/security.py"
click node_entry "https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/main.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_patient,node_triage,node_doctor,node_lab,node_radiology,node_pharmacy,node_oncology,node_ops,node_api toneBlue
class node_journey_api,node_os_api toneAmber
class node_clinical_api,node_billing,node_oncology_api,node_ai_routes,node_ai_agents,node_diagnostics toneMint
class node_models,node_database,node_events,node_security,node_entry toneRose
class node_patient_actor,node_staff_actor toneIndigo
```

## Components

### Patient and Staff UI

- [Patient Portal](https://github.com/wcthls/smart-hospital-platform/blob/main/frontend/src/features/patient/PatientDashboard.tsx): `frontend/src/features/patient/PatientDashboard.tsx`
- [Triage Workspace](https://github.com/wcthls/smart-hospital-platform/blob/main/frontend/src/features/triage/TriageWorkspace.tsx): `frontend/src/features/triage/TriageWorkspace.tsx`
- [Doctor Workspace](https://github.com/wcthls/smart-hospital-platform/blob/main/frontend/src/features/doctor/DoctorWorkspace.tsx): `frontend/src/features/doctor/DoctorWorkspace.tsx`
- [Lab Workspace](https://github.com/wcthls/smart-hospital-platform/blob/main/frontend/src/features/lab/LabWorkspace.tsx): `frontend/src/features/lab/LabWorkspace.tsx`
- [Radiology Workspace](https://github.com/wcthls/smart-hospital-platform/blob/main/frontend/src/features/radiology/RadiologyWorkspace.tsx): `frontend/src/features/radiology/RadiologyWorkspace.tsx`
- [Pharmacy Workspace](https://github.com/wcthls/smart-hospital-platform/blob/main/frontend/src/features/pharmacy/PharmacyWorkspace.tsx): `frontend/src/features/pharmacy/PharmacyWorkspace.tsx`
- [Oncology Workspace](https://github.com/wcthls/smart-hospital-platform/blob/main/frontend/src/features/oncology/OncologyWorkspace.tsx): `frontend/src/features/oncology/OncologyWorkspace.tsx`
- [Operations Console](https://github.com/wcthls/smart-hospital-platform/blob/main/frontend/src/features/admin/CommandCenter.tsx): `frontend/src/features/admin/CommandCenter.tsx`
- [API Client](https://github.com/wcthls/smart-hospital-platform/blob/main/frontend/src/lib/api.ts): `frontend/src/lib/api.ts`

### Care Journey

- [Identity and Triage](https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/api/routes_journey.py): `backend/app/api/routes_journey.py`
- [Hospital OS and Portal](https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/api/routes_os.py): `backend/app/api/routes_os.py`

### Clinical Services

- [Clinical and Labs](https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/api/routes_clinical.py): `backend/app/api/routes_clinical.py`
- [Billing and Discharge](https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/api/routes_billing.py): `backend/app/api/routes_billing.py`
- [Oncology Services](https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/api/routes_oncology.py): `backend/app/api/routes_oncology.py`
- [AI Endpoints](https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/api/routes_ai.py): `backend/app/api/routes_ai.py`
- [AI Agents](https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/ai/agents.py): `backend/app/ai/agents.py`
- [Local Diagnostics](https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/ai/local_analyzer.py): `backend/app/ai/local_analyzer.py`

### Shared Platform

- [Clinical Domain Model](https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/models.py): `backend/app/models.py`
- [Database](https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/core/database.py): `backend/app/core/database.py`
- [Event Bus](https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/core/events.py): `backend/app/core/events.py`
- [Consent and Audit](https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/core/security.py): `backend/app/core/security.py`
- [FastAPI Application](https://github.com/wcthls/smart-hospital-platform/blob/main/backend/app/main.py): `backend/app/main.py`

### Other components

- **Patient**
- **Hospital Staff**

## Connections

- Patient → Patient Portal: uses
- Hospital Staff → Triage Workspace: uses
- Hospital Staff → Doctor Workspace: uses
- Patient Portal → API Client: requests data (evidence: `frontend/src/features/patient/PatientDashboard.tsx`)
- Triage Workspace → API Client: requests data (evidence: `frontend/src/features/triage/TriageWorkspace.tsx`)
- Doctor Workspace → API Client: requests data (evidence: `frontend/src/features/doctor/DoctorWorkspace.tsx`)
- Lab Workspace → API Client: requests data (evidence: `frontend/src/features/lab/LabWorkspace.tsx`)
- Radiology Workspace → API Client: requests data (evidence: `frontend/src/features/radiology/RadiologyWorkspace.tsx`)
- Pharmacy Workspace → API Client: requests data (evidence: `frontend/src/features/pharmacy/PharmacyWorkspace.tsx`)
- Oncology Workspace → API Client: requests data
- Operations Console → API Client: requests data
- API Client → Identity and Triage: calls endpoints (evidence: `frontend/src/lib/api.ts`)
- API Client → Clinical and Labs: calls endpoints (evidence: `frontend/src/lib/api.ts`)
- API Client → Billing and Discharge: calls endpoints (evidence: `frontend/src/lib/api.ts`)
- API Client → Hospital OS and Portal: calls endpoints (evidence: `frontend/src/lib/api.ts`)
- FastAPI Application → Identity and Triage: registers router (evidence: `backend/app/main.py`)
- FastAPI Application → Clinical and Labs: registers router (evidence: `backend/app/main.py`)
- FastAPI Application → Billing and Discharge: registers router (evidence: `backend/app/main.py`)
- FastAPI Application → Oncology Services: registers router (evidence: `backend/app/main.py`)
- FastAPI Application → AI Endpoints: registers router (evidence: `backend/app/main.py`)
- FastAPI Application → Hospital OS and Portal: registers router (evidence: `backend/app/main.py`)
- Identity and Triage → Clinical and Labs: references (evidence: `backend/app/api/routes_journey.py`)
- Identity and Triage → Clinical Domain Model: reads and writes (evidence: `backend/app/api/routes_journey.py`)
- Clinical and Labs → Clinical Domain Model: reads and writes (evidence: `backend/app/api/routes_clinical.py`)
- Billing and Discharge → Clinical Domain Model: reads and writes (evidence: `backend/app/api/routes_billing.py`)
- Oncology Services → Clinical Domain Model: reads and writes (evidence: `backend/app/api/routes_oncology.py`)
- Hospital OS and Portal → Clinical Domain Model: reads and writes (evidence: `backend/app/api/routes_os.py`)
- Database → Clinical Domain Model: registers mappings (evidence: `backend/app/core/database.py`)
- FastAPI Application → Database: initializes (evidence: `backend/app/main.py`)
- FastAPI Application → Event Bus: streams events (evidence: `backend/app/main.py`)
- Clinical and Labs → AI Agents: uses drafts (evidence: `backend/app/api/routes_clinical.py`)
- AI Agents → Local Diagnostics: analyzes locally
- AI Endpoints → AI Agents: dispatches
- Consent and Audit → Clinical Domain Model: audits actions (evidence: `backend/app/core/security.py`)
- Identity and Triage → Consent and Audit: checks consent (evidence: `backend/app/api/routes_journey.py`)
