# justraiah/clinic-repo architecture

> Architecture diagram of the GitHub repository justraiah/clinic-repo, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/justraiah/clinic-repo
- Repository: https://github.com/justraiah/clinic-repo

## Overview

Capstone Clinic is an ASP.NET Core clinic-management system. Its documented staff workflow is student lookup, medical-record consultation, vital-sign recording and history; recorded readings are classified and can be associated with alerts. The repository also includes mobile APIs, an integration API, ESP32 retrieval, and reporting capabilities. Edges below are limited to relationships shown in excerpts, the source index, or README; several page-handler implementations were not sampled, so their detailed calls are not inferred.

Main entry points: [`Capstone-Clinic/Data/AppDbContext.cs`](https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Data/AppDbContext.cs) (Clinic database), [`Capstone-Clinic/Pages/VitalSignLogPages`](https://github.com/justraiah/clinic-repo/tree/master/Capstone-Clinic/Pages/VitalSignLogPages) (Vital history), [`Capstone-Clinic/Pages/Student/Search.cshtml.cs`](https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Pages/Student/Search.cshtml.cs) (Student lookup), [`Capstone-Clinic/Pages/MedicalRecordPages`](https://github.com/justraiah/clinic-repo/tree/master/Capstone-Clinic/Pages/MedicalRecordPages) (Consultation records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clinic["Clinic workflow"]
  node_student_lookup["Student lookup<br/>[Search.cshtml.cs]"]
  node_student_admin["Student management"]
  node_consultations["Consultation records"]
end

subgraph group_health["Health monitoring"]
  node_vital_pages["Vital history"]
  node_evaluator["Status evaluator"]
  node_alert_pages["Alert management"]
end

subgraph group_data["Data model"]
  node_student_model["Student model<br/>[Student.cs]"]
  node_account_model["Student account<br/>[StudentAccount.cs]"]
  node_clinic_patient["Clinic patient<br/>[ClinicPatient.cs]"]
  node_medical_model["Medical record<br/>[MedicalRecord.cs]"]
  node_vital_model["Vital log<br/>[VitalSignLog.cs]"]
  node_alert_model["Alert record<br/>[Alert.cs]"]
  node_staff_model["Staff model<br/>[Staff.cs]"]
  node_database[("Clinic database<br/>[AppDbContext.cs]")]
end

subgraph group_interfaces["APIs and reporting"]
  node_mobile_api["Mobile APIs"]
  node_integration_api["Integration API"]
  node_iot_api["IoT vital API"]
  node_esp32_service["ESP32 client<br/>[Esp32Service.cs]"]
  node_reports["Reports and trends"]
  node_pdf_service["PDF generation"]
end

node_staff(("Clinic staff"))
node_sensor(("ESP32 sensor"))

node_staff -->|"looks up"| node_student_lookup
node_student_lookup -->|"opens record"| node_consultations
node_consultations -->|"records vitals"| node_vital_pages
node_vital_pages -->|"evaluates readings"| node_evaluator
node_vital_pages -->|"uses alerts"| node_alert_model
node_vital_pages -->|"requests readings"| node_esp32_service
node_esp32_service -.->|"fetches readings"| node_sensor
node_student_lookup -->|"queries"| node_database
node_student_admin -->|"reads and writes"| node_database
node_consultations -->|"reads and writes"| node_database
node_vital_pages -->|"reads and writes"| node_database
node_alert_pages -->|"reads and writes"| node_database
node_mobile_api -->|"queries"| node_database
node_integration_api -->|"queries"| node_database
node_reports -->|"queries"| node_database
node_reports -->|"generates PDF"| node_pdf_service
node_database -->|"maps entity"| node_student_model
node_database -->|"maps entity"| node_account_model
node_database -->|"maps entity"| node_clinic_patient
node_database -->|"maps entity"| node_medical_model
node_database -->|"maps entity"| node_vital_model
node_database -->|"maps entity"| node_alert_model
node_database -->|"maps entity"| node_staff_model

click node_student_lookup "https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Pages/Student/Search.cshtml.cs"
click node_student_admin "https://github.com/justraiah/clinic-repo/tree/master/Capstone-Clinic/Pages/StudentPages"
click node_consultations "https://github.com/justraiah/clinic-repo/tree/master/Capstone-Clinic/Pages/MedicalRecordPages"
click node_vital_pages "https://github.com/justraiah/clinic-repo/tree/master/Capstone-Clinic/Pages/VitalSignLogPages"
click node_evaluator "https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Helpers/VitalSignEvaluator.cs"
click node_alert_pages "https://github.com/justraiah/clinic-repo/tree/master/Capstone-Clinic/Pages/AlertPages"
click node_student_model "https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Models/Student.cs"
click node_account_model "https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Models/StudentAccount.cs"
click node_clinic_patient "https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Models/ClinicPatient.cs"
click node_medical_model "https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Models/MedicalRecord.cs"
click node_vital_model "https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Models/VitalSignLog.cs"
click node_alert_model "https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Models/Alert.cs"
click node_staff_model "https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Models/Staff.cs"
click node_database "https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Data/AppDbContext.cs"
click node_mobile_api "https://github.com/justraiah/clinic-repo/tree/master/Capstone-Clinic/Controllers"
click node_integration_api "https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Controllers/IntegrationMedicalRecordController.cs"
click node_iot_api "https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Controllers/IoTVitalSignController.cs"
click node_esp32_service "https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Models/Services/Esp32Service.cs"
click node_reports "https://github.com/justraiah/clinic-repo/tree/master/Capstone-Clinic/Pages/Reports"
click node_pdf_service "https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Services/PdfReportService.cs"

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_student_lookup,node_student_admin,node_consultations toneBlue
class node_vital_pages,node_evaluator,node_alert_pages toneAmber
class node_student_model,node_account_model,node_clinic_patient,node_medical_model,node_vital_model,node_alert_model,node_staff_model,node_database toneMint
class node_mobile_api,node_integration_api,node_iot_api,node_esp32_service,node_reports,node_pdf_service toneRose
class node_staff,node_sensor toneIndigo
```

## Components

### Clinic workflow

- [Student lookup](https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Pages/Student/Search.cshtml.cs): `Capstone-Clinic/Pages/Student/Search.cshtml.cs`
- [Student management](https://github.com/justraiah/clinic-repo/tree/master/Capstone-Clinic/Pages/StudentPages): `Capstone-Clinic/Pages/StudentPages`
- [Consultation records](https://github.com/justraiah/clinic-repo/tree/master/Capstone-Clinic/Pages/MedicalRecordPages): `Capstone-Clinic/Pages/MedicalRecordPages`

### Health monitoring

- [Vital history](https://github.com/justraiah/clinic-repo/tree/master/Capstone-Clinic/Pages/VitalSignLogPages): `Capstone-Clinic/Pages/VitalSignLogPages`
- [Status evaluator](https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Helpers/VitalSignEvaluator.cs): `Capstone-Clinic/Helpers/VitalSignEvaluator.cs`
- [Alert management](https://github.com/justraiah/clinic-repo/tree/master/Capstone-Clinic/Pages/AlertPages): `Capstone-Clinic/Pages/AlertPages`

### Data model

- [Student model](https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Models/Student.cs): `Capstone-Clinic/Models/Student.cs`
- [Student account](https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Models/StudentAccount.cs): `Capstone-Clinic/Models/StudentAccount.cs`
- [Clinic patient](https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Models/ClinicPatient.cs): `Capstone-Clinic/Models/ClinicPatient.cs`
- [Medical record](https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Models/MedicalRecord.cs): `Capstone-Clinic/Models/MedicalRecord.cs`
- [Vital log](https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Models/VitalSignLog.cs): `Capstone-Clinic/Models/VitalSignLog.cs`
- [Alert record](https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Models/Alert.cs): `Capstone-Clinic/Models/Alert.cs`
- [Staff model](https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Models/Staff.cs): `Capstone-Clinic/Models/Staff.cs`
- [Clinic database](https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Data/AppDbContext.cs): `Capstone-Clinic/Data/AppDbContext.cs`

### APIs and reporting

- [Mobile APIs](https://github.com/justraiah/clinic-repo/tree/master/Capstone-Clinic/Controllers): `Capstone-Clinic/Controllers`
- [Integration API](https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Controllers/IntegrationMedicalRecordController.cs): `Capstone-Clinic/Controllers/IntegrationMedicalRecordController.cs`
- [IoT vital API](https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Controllers/IoTVitalSignController.cs): `Capstone-Clinic/Controllers/IoTVitalSignController.cs`
- [ESP32 client](https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Models/Services/Esp32Service.cs): `Capstone-Clinic/Models/Services/Esp32Service.cs`
- [Reports and trends](https://github.com/justraiah/clinic-repo/tree/master/Capstone-Clinic/Pages/Reports): `Capstone-Clinic/Pages/Reports`
- [PDF generation](https://github.com/justraiah/clinic-repo/blob/master/Capstone-Clinic/Services/PdfReportService.cs): `Capstone-Clinic/Services/PdfReportService.cs`

### Other components

- **Clinic staff**
- **ESP32 sensor**

## Connections

- Clinic staff → Student lookup: looks up
- Student lookup → Consultation records: opens record
- Consultation records → Vital history: records vitals
- Vital history → Status evaluator: evaluates readings (evidence: `Capstone-Clinic/Pages/VitalSignLogPages/Create.cshtml.cs`)
- Vital history → Alert record: uses alerts (evidence: `Capstone-Clinic/Pages/VitalSignLogPages/Create.cshtml.cs`)
- Vital history → ESP32 client: requests readings (evidence: `Capstone-Clinic/Pages/VitalSignLogPages/Create.cshtml.cs`)
- ESP32 client → ESP32 sensor: fetches readings
- Student lookup → Clinic database: queries (evidence: `Capstone-Clinic/Pages/Student/Search.cshtml.cs`)
- Student management → Clinic database: reads and writes (evidence: `Capstone-Clinic/Pages/StudentPages/Create.cshtml.cs`)
- Consultation records → Clinic database: reads and writes (evidence: `Capstone-Clinic/Pages/MedicalRecordPages/Create.cshtml.cs`)
- Vital history → Clinic database: reads and writes (evidence: `Capstone-Clinic/Pages/VitalSignLogPages/Create.cshtml.cs`)
- Alert management → Clinic database: reads and writes (evidence: `Capstone-Clinic/Pages/AlertPages/Index.cshtml.cs`)
- Mobile APIs → Clinic database: queries (evidence: `Capstone-Clinic/Controllers/MobileStudentController.cs`)
- Integration API → Clinic database: queries (evidence: `Capstone-Clinic/Controllers/IntegrationMedicalRecordController.cs`)
- Reports and trends → Clinic database: queries (evidence: `Capstone-Clinic/Pages/Reports/TrendAnalysis/Index.cshtml.cs`)
- Reports and trends → PDF generation: generates PDF (evidence: `Capstone-Clinic/Pages/Reports/TrendAnalysis/Index.cshtml.cs`)
- Clinic database → Student model: maps entity (evidence: `Capstone-Clinic/Data/AppDbContext.cs`)
- Clinic database → Student account: maps entity (evidence: `Capstone-Clinic/Data/AppDbContext.cs`)
- Clinic database → Clinic patient: maps entity (evidence: `Capstone-Clinic/Data/AppDbContext.cs`)
- Clinic database → Medical record: maps entity (evidence: `Capstone-Clinic/Data/AppDbContext.cs`)
- Clinic database → Vital log: maps entity (evidence: `Capstone-Clinic/Data/AppDbContext.cs`)
- Clinic database → Alert record: maps entity (evidence: `Capstone-Clinic/Data/AppDbContext.cs`)
- Clinic database → Staff model: maps entity (evidence: `Capstone-Clinic/Data/AppDbContext.cs`)
