# vidit2004/patienttriage.ai architecture

> Architecture diagram of the GitHub repository vidit2004/patienttriage.ai, 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/vidit2004/patienttriage.ai
- Repository: https://github.com/vidit2004/patienttriage.ai

## Overview

PatientTriage.ai is an emergency-department clinical decision-support workstation. The nurse enters patient details or transcript-derived data; the backend analyzes acuity and returns an ESI recommendation and handover, then manages a prioritized waiting queue for monitoring, reassessment, and clinician action. The README also describes age-calibrated vitals, safety rules, uncertainty escalation, surge controls, statistics, and audit logging. Edges reflect excerpted calls, imports, endpoint paths, or README statements; unsampled implementation details are not inferred.

Main entry points: [`frontend/src/App.jsx`](https://github.com/vidit2004/patienttriage.ai/blob/main/frontend/src/App.jsx) (Clinical Workstation), [`frontend/src/services/api.js`](https://github.com/vidit2004/patienttriage.ai/blob/main/frontend/src/services/api.js) (API Client), [`backend/server.js`](https://github.com/vidit2004/patienttriage.ai/blob/main/backend/server.js) (API Server), [`backend/services/geminiService.js`](https://github.com/vidit2004/patienttriage.ai/blob/main/backend/services/geminiService.js) (Clinical AI Reasoning)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_intake["Intake and Workstation"]
  node_app["Clinical Workstation<br/>[App.jsx]"]
  node_intake_ui["Patient Intake"]
  node_patient_detail["Patient Detail"]
  node_handover["SBAR Handover"]
  node_api_client["API Client<br/>[api.js]"]
  node_server["API Server<br/>[server.js]"]
end

subgraph group_clinical["Clinical Reasoning"]
  node_triage_routes["Triage Routes<br/>[triageRoutes.js]"]
  node_triage_ai["Clinical AI Reasoning<br/>[geminiService.js]"]
  node_safety_rules["Safety Rules"]
  node_vital_calibrator["Vital Calibration<br/>[vitalCalibrator.js]"]
  node_uncertainty["Uncertainty Escalation"]
end

subgraph group_queue["Queue and Monitoring"]
  node_patient_routes["Patient Routes<br/>[patientRoutes.js]"]
  node_queue_store["Queue State and Scoring<br/>[patientStore.js]"]
  node_benchmark["Benchmark Patients"]
  node_queue_ui["Live Queue<br/>[QueueDashboard.jsx]"]
  node_vitals_ui["Vitals Recheck"]
  node_surge_ui["Surge Controls"]
  node_patient_model[("Patient Model<br/>[PatientModel.js]")]
end

subgraph group_oversight["Oversight and Reporting"]
  node_stats_routes["Statistics Routes<br/>[statsRoutes.js]"]
  node_stats_ui["Statistics Overview<br/>[StatsOverview.jsx]"]
  node_audit_routes["Audit Routes<br/>[auditRoutes.js]"]
  node_audit_service["Audit Logging<br/>[auditService.js]"]
  node_audit_model[("Audit Log Model<br/>[AuditLogModel.js]")]
  node_override_ui["Clinician Override"]
  node_audit_ui["Audit Viewer<br/>[AuditLogViewer.jsx]"]
end

node_nurse(("Triage Nurse"))

node_nurse -->|"uses"| node_app
node_app -->|"renders"| node_intake_ui
node_app -->|"renders"| node_patient_detail
node_app -->|"renders"| node_handover
node_app -->|"renders"| node_queue_ui
node_app -->|"renders"| node_vitals_ui
node_app -->|"renders"| node_surge_ui
node_app -->|"renders"| node_stats_ui
node_app -->|"renders"| node_override_ui
node_app -->|"renders"| node_audit_ui
node_app -->|"requests data"| node_api_client
node_intake_ui -->|"submits intake"| node_api_client
node_api_client -->|"calls API"| node_server
node_server -->|"mounts"| node_triage_routes
node_server -->|"mounts"| node_patient_routes
node_server -->|"mounts"| node_stats_routes
node_server -->|"mounts"| node_audit_routes
node_triage_routes -->|"analyzes patients"| node_triage_ai
node_triage_routes -->|"calibrates vitals"| node_vital_calibrator
node_patient_routes -->|"triages arrivals"| node_triage_ai
node_patient_routes -->|"manages queue"| node_queue_store
node_triage_ai -->|"checks triggers"| node_safety_rules
node_triage_ai -->|"scores uncertainty"| node_uncertainty
node_triage_ai -->|"calibrates vitals"| node_vital_calibrator
node_safety_rules -->|"evaluates vitals"| node_vital_calibrator
node_queue_store -->|"loads cohort"| node_benchmark
node_queue_store -->|"uses model"| node_patient_model
node_queue_store -->|"records events"| node_audit_service
node_override_ui -->|"submits override"| node_api_client
node_vitals_ui -->|"updates vitals"| node_api_client
node_surge_ui -->|"controls surge"| node_api_client
node_audit_ui -->|"fetches logs"| node_api_client
node_api_client -->|"requests patients"| node_patient_routes
node_api_client -->|"requests analysis"| node_triage_routes
node_api_client -->|"requests stats"| node_stats_routes
node_api_client -->|"requests audits"| node_audit_routes
node_stats_routes -->|"reads queue stats"| node_queue_store
node_audit_routes -->|"reads logs"| node_audit_service
node_audit_service -->|"syncs logs"| node_audit_model

click node_app "https://github.com/vidit2004/patienttriage.ai/blob/main/frontend/src/App.jsx"
click node_intake_ui "https://github.com/vidit2004/patienttriage.ai/blob/main/frontend/src/components/PatientIntakeModal.jsx"
click node_patient_detail "https://github.com/vidit2004/patienttriage.ai/blob/main/frontend/src/components/PatientDetailModal.jsx"
click node_handover "https://github.com/vidit2004/patienttriage.ai/blob/main/frontend/src/components/DoctorHandoverModal.jsx"
click node_api_client "https://github.com/vidit2004/patienttriage.ai/blob/main/frontend/src/services/api.js"
click node_server "https://github.com/vidit2004/patienttriage.ai/blob/main/backend/server.js"
click node_triage_routes "https://github.com/vidit2004/patienttriage.ai/blob/main/backend/routes/triageRoutes.js"
click node_patient_routes "https://github.com/vidit2004/patienttriage.ai/blob/main/backend/routes/patientRoutes.js"
click node_triage_ai "https://github.com/vidit2004/patienttriage.ai/blob/main/backend/services/geminiService.js"
click node_safety_rules "https://github.com/vidit2004/patienttriage.ai/blob/main/backend/services/safetyRuleEngine.js"
click node_vital_calibrator "https://github.com/vidit2004/patienttriage.ai/blob/main/backend/services/vitalCalibrator.js"
click node_uncertainty "https://github.com/vidit2004/patienttriage.ai/blob/main/backend/services/uncertaintyEngine.js"
click node_queue_store "https://github.com/vidit2004/patienttriage.ai/blob/main/backend/models/patientStore.js"
click node_benchmark "https://github.com/vidit2004/patienttriage.ai/blob/main/backend/data/simulatedPatients.js"
click node_queue_ui "https://github.com/vidit2004/patienttriage.ai/blob/main/frontend/src/components/QueueDashboard.jsx"
click node_vitals_ui "https://github.com/vidit2004/patienttriage.ai/blob/main/frontend/src/components/VitalsRecheckModal.jsx"
click node_surge_ui "https://github.com/vidit2004/patienttriage.ai/blob/main/frontend/src/components/SurgeSimulationPanel.jsx"
click node_stats_routes "https://github.com/vidit2004/patienttriage.ai/blob/main/backend/routes/statsRoutes.js"
click node_stats_ui "https://github.com/vidit2004/patienttriage.ai/blob/main/frontend/src/components/StatsOverview.jsx"
click node_audit_routes "https://github.com/vidit2004/patienttriage.ai/blob/main/backend/routes/auditRoutes.js"
click node_audit_service "https://github.com/vidit2004/patienttriage.ai/blob/main/backend/services/auditService.js"
click node_audit_model "https://github.com/vidit2004/patienttriage.ai/blob/main/backend/models/AuditLogModel.js"
click node_override_ui "https://github.com/vidit2004/patienttriage.ai/blob/main/frontend/src/components/ClinicianOverrideModal.jsx"
click node_audit_ui "https://github.com/vidit2004/patienttriage.ai/blob/main/frontend/src/components/AuditLogViewer.jsx"
click node_patient_model "https://github.com/vidit2004/patienttriage.ai/blob/main/backend/models/PatientModel.js"

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_app,node_intake_ui,node_patient_detail,node_handover,node_api_client,node_server toneBlue
class node_triage_routes,node_triage_ai,node_safety_rules,node_vital_calibrator,node_uncertainty toneAmber
class node_patient_routes,node_queue_store,node_benchmark,node_queue_ui,node_vitals_ui,node_surge_ui,node_patient_model toneMint
class node_stats_routes,node_stats_ui,node_audit_routes,node_audit_service,node_audit_model,node_override_ui,node_audit_ui toneRose
class node_nurse toneIndigo
```

## Components

### Intake and Workstation

- [Clinical Workstation](https://github.com/vidit2004/patienttriage.ai/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Patient Intake](https://github.com/vidit2004/patienttriage.ai/blob/main/frontend/src/components/PatientIntakeModal.jsx): `frontend/src/components/PatientIntakeModal.jsx`
- [Patient Detail](https://github.com/vidit2004/patienttriage.ai/blob/main/frontend/src/components/PatientDetailModal.jsx): `frontend/src/components/PatientDetailModal.jsx`
- [SBAR Handover](https://github.com/vidit2004/patienttriage.ai/blob/main/frontend/src/components/DoctorHandoverModal.jsx): `frontend/src/components/DoctorHandoverModal.jsx`
- [API Client](https://github.com/vidit2004/patienttriage.ai/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [API Server](https://github.com/vidit2004/patienttriage.ai/blob/main/backend/server.js): `backend/server.js`

### Clinical Reasoning

- [Triage Routes](https://github.com/vidit2004/patienttriage.ai/blob/main/backend/routes/triageRoutes.js): `backend/routes/triageRoutes.js`
- [Clinical AI Reasoning](https://github.com/vidit2004/patienttriage.ai/blob/main/backend/services/geminiService.js): `backend/services/geminiService.js`
- [Safety Rules](https://github.com/vidit2004/patienttriage.ai/blob/main/backend/services/safetyRuleEngine.js): `backend/services/safetyRuleEngine.js`
- [Vital Calibration](https://github.com/vidit2004/patienttriage.ai/blob/main/backend/services/vitalCalibrator.js): `backend/services/vitalCalibrator.js`
- [Uncertainty Escalation](https://github.com/vidit2004/patienttriage.ai/blob/main/backend/services/uncertaintyEngine.js): `backend/services/uncertaintyEngine.js`

### Queue and Monitoring

- [Patient Routes](https://github.com/vidit2004/patienttriage.ai/blob/main/backend/routes/patientRoutes.js): `backend/routes/patientRoutes.js`
- [Queue State and Scoring](https://github.com/vidit2004/patienttriage.ai/blob/main/backend/models/patientStore.js): `backend/models/patientStore.js`
- [Benchmark Patients](https://github.com/vidit2004/patienttriage.ai/blob/main/backend/data/simulatedPatients.js): `backend/data/simulatedPatients.js`
- [Live Queue](https://github.com/vidit2004/patienttriage.ai/blob/main/frontend/src/components/QueueDashboard.jsx): `frontend/src/components/QueueDashboard.jsx`
- [Vitals Recheck](https://github.com/vidit2004/patienttriage.ai/blob/main/frontend/src/components/VitalsRecheckModal.jsx): `frontend/src/components/VitalsRecheckModal.jsx`
- [Surge Controls](https://github.com/vidit2004/patienttriage.ai/blob/main/frontend/src/components/SurgeSimulationPanel.jsx): `frontend/src/components/SurgeSimulationPanel.jsx`
- [Patient Model](https://github.com/vidit2004/patienttriage.ai/blob/main/backend/models/PatientModel.js): `backend/models/PatientModel.js`

### Oversight and Reporting

- [Statistics Routes](https://github.com/vidit2004/patienttriage.ai/blob/main/backend/routes/statsRoutes.js): `backend/routes/statsRoutes.js`
- [Statistics Overview](https://github.com/vidit2004/patienttriage.ai/blob/main/frontend/src/components/StatsOverview.jsx): `frontend/src/components/StatsOverview.jsx`
- [Audit Routes](https://github.com/vidit2004/patienttriage.ai/blob/main/backend/routes/auditRoutes.js): `backend/routes/auditRoutes.js`
- [Audit Logging](https://github.com/vidit2004/patienttriage.ai/blob/main/backend/services/auditService.js): `backend/services/auditService.js`
- [Audit Log Model](https://github.com/vidit2004/patienttriage.ai/blob/main/backend/models/AuditLogModel.js): `backend/models/AuditLogModel.js`
- [Clinician Override](https://github.com/vidit2004/patienttriage.ai/blob/main/frontend/src/components/ClinicianOverrideModal.jsx): `frontend/src/components/ClinicianOverrideModal.jsx`
- [Audit Viewer](https://github.com/vidit2004/patienttriage.ai/blob/main/frontend/src/components/AuditLogViewer.jsx): `frontend/src/components/AuditLogViewer.jsx`

### Other components

- **Triage Nurse**

## Connections

- Triage Nurse → Clinical Workstation: uses (evidence: `README.md`)
- Clinical Workstation → Patient Intake: renders (evidence: `frontend/src/App.jsx`)
- Clinical Workstation → Patient Detail: renders (evidence: `frontend/src/App.jsx`)
- Clinical Workstation → SBAR Handover: renders (evidence: `frontend/src/App.jsx`)
- Clinical Workstation → Live Queue: renders (evidence: `frontend/src/App.jsx`)
- Clinical Workstation → Vitals Recheck: renders (evidence: `frontend/src/App.jsx`)
- Clinical Workstation → Surge Controls: renders (evidence: `frontend/src/App.jsx`)
- Clinical Workstation → Statistics Overview: renders (evidence: `frontend/src/App.jsx`)
- Clinical Workstation → Clinician Override: renders (evidence: `frontend/src/App.jsx`)
- Clinical Workstation → Audit Viewer: renders (evidence: `frontend/src/App.jsx`)
- Clinical Workstation → API Client: requests data (evidence: `frontend/src/App.jsx`)
- Patient Intake → API Client: submits intake (evidence: `frontend/src/services/api.js`)
- API Client → API Server: calls API (evidence: `frontend/src/services/api.js`)
- API Server → Triage Routes: mounts (evidence: `backend/server.js`)
- API Server → Patient Routes: mounts (evidence: `backend/server.js`)
- API Server → Statistics Routes: mounts (evidence: `backend/server.js`)
- API Server → Audit Routes: mounts (evidence: `backend/server.js`)
- Triage Routes → Clinical AI Reasoning: analyzes patients (evidence: `backend/routes/triageRoutes.js`)
- Triage Routes → Vital Calibration: calibrates vitals (evidence: `backend/routes/triageRoutes.js`)
- Patient Routes → Clinical AI Reasoning: triages arrivals (evidence: `backend/routes/patientRoutes.js`)
- Patient Routes → Queue State and Scoring: manages queue (evidence: `backend/routes/patientRoutes.js`)
- Clinical AI Reasoning → Safety Rules: checks triggers (evidence: `backend/services/geminiService.js`)
- Clinical AI Reasoning → Uncertainty Escalation: scores uncertainty (evidence: `backend/services/geminiService.js`)
- Clinical AI Reasoning → Vital Calibration: calibrates vitals (evidence: `backend/services/geminiService.js`)
- Safety Rules → Vital Calibration: evaluates vitals (evidence: `backend/services/safetyRuleEngine.js`)
- Queue State and Scoring → Benchmark Patients: loads cohort (evidence: `backend/models/patientStore.js`)
- Queue State and Scoring → Patient Model: uses model (evidence: `backend/models/patientStore.js`)
- Queue State and Scoring → Audit Logging: records events (evidence: `backend/models/patientStore.js`)
- Clinician Override → API Client: submits override (evidence: `frontend/src/components/ClinicianOverrideModal.jsx`)
- Vitals Recheck → API Client: updates vitals (evidence: `frontend/src/components/VitalsRecheckModal.jsx`)
- Surge Controls → API Client: controls surge (evidence: `frontend/src/components/SurgeSimulationPanel.jsx`)
- Audit Viewer → API Client: fetches logs (evidence: `frontend/src/components/AuditLogViewer.jsx`)
- API Client → Patient Routes: requests patients (evidence: `frontend/src/services/api.js`)
- API Client → Triage Routes: requests analysis (evidence: `frontend/src/services/api.js`)
- API Client → Statistics Routes: requests stats (evidence: `frontend/src/services/api.js`)
- API Client → Audit Routes: requests audits (evidence: `frontend/src/services/api.js`)
- Statistics Routes → Queue State and Scoring: reads queue stats (evidence: `backend/routes/statsRoutes.js`)
- Audit Routes → Audit Logging: reads logs (evidence: `backend/routes/auditRoutes.js`)
- Audit Logging → Audit Log Model: syncs logs (evidence: `backend/services/auditService.js`)
