# klubnikabytes/dr.awrini_rana architecture

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

- Interactive diagram: https://gitdiagram.com/klubnikabytes/dr.awrini_rana
- Repository: https://github.com/klubnikabytes/dr.awrini_rana

## Overview

This is a multi-clinic healthcare operations application: staff register patients and appointments, doctors document visits, and teams manage lab, day-care, home-care, billing, and reporting workflows. The graph includes the major documented UI areas and the backend modules most clearly supported by the source index and excerpts. Several frontend-to-API calls and unsampled route/controller details are not shown, so those links are omitted rather than inferred.

Main entry points: [`backend/server.js`](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/server.js) (HTTP application), [`backend/controllers/frontdeskController.js`](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/controllers/frontdeskController.js) (Front-desk operations), [`frontend/src/App.jsx`](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/frontend/src/App.jsx) (Application routes), [`backend/controllers/reportController.js`](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/controllers/reportController.js) (Operational reports)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_app["Application routes<br/>[App.jsx]"]
  node_dashboard["Clinic dashboard<br/>[Dashboard.jsx]"]
  node_visitpad["Doctor visit pad<br/>[VisitPad.jsx]"]
  node_labui["Lab workspace<br/>[LabPage.jsx]"]
  node_daycareui["Day-care workspace<br/>[DayCarePage.jsx]"]
  node_homecareui["Home-care workspace<br/>[HomeCarePage.jsx]"]
end

subgraph group_api["API and access"]
  node_auth["Request protection<br/>[authMiddleware.js]"]
  node_server["HTTP application<br/>[server.js]"]
end

subgraph group_care["Clinical operations"]
  node_frontdesk["Front-desk operations"]
  node_doctor["Doctor operations"]
  node_lab["Lab orders"]
  node_daycare["Day-care records"]
  node_homecare["Home-care records"]
  node_patientutil["Patient matching<br/>[patientUtils.js]"]
end

subgraph group_data["Data and events"]
  node_patients[("Patient records<br/>[Patient.js]")]
  node_appointments[("Appointments<br/>[Appointment.js]")]
  node_bills[("Bills and payments<br/>[Bill.js]")]
  node_laborders[("Lab orders store<br/>[LabOrder.js]")]
  node_daycarerecords[("Day-care store<br/>[DayCare.js]")]
  node_homecarerecords[("Home-care store<br/>[HomeCare.js]")]
  node_staffrecords[("Staff records<br/>[Staff.js]")]
  node_events["Live event broadcast<br/>[websocket.js]"]
end

subgraph group_admin["Administration and reporting"]
  node_reports["Operational reports"]
  node_admin["Admin operations<br/>[adminController.js]"]
end

node_staff(("Clinic staff"))

node_staff -->|"uses"| node_app
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_visitpad
node_app -->|"routes to"| node_labui
node_app -->|"routes to"| node_daycareui
node_app -->|"routes to"| node_homecareui
node_server -->|"uses"| node_auth
node_server -->|"initializes"| node_events
node_server -->|"mounts routes"| node_frontdesk
node_server -->|"mounts routes"| node_doctor
node_server -->|"mounts routes"| node_daycare
node_server -->|"mounts routes"| node_homecare
node_server -->|"mounts routes"| node_lab
node_server -->|"mounts routes"| node_reports
node_frontdesk -->|"reads and writes"| node_patients
node_frontdesk -->|"reads and writes"| node_appointments
node_frontdesk -->|"reads and writes"| node_bills
node_frontdesk -->|"updates"| node_laborders
node_frontdesk -->|"uses"| node_patientutil
node_frontdesk -->|"broadcasts"| node_events
node_doctor -->|"reads and writes"| node_patients
node_doctor -->|"reads and writes"| node_appointments
node_doctor -->|"reads"| node_laborders
node_lab -->|"reads and writes"| node_laborders
node_lab -->|"uses"| node_patientutil
node_lab -->|"broadcasts"| node_events
node_daycare -->|"reads and writes"| node_daycarerecords
node_homecare -->|"reads and writes"| node_homecarerecords
node_homecare -->|"uses"| node_bills
node_homecare -->|"uses"| node_patientutil
node_reports -->|"reads"| node_bills
node_reports -->|"reads"| node_patients
node_reports -->|"reads"| node_laborders
node_reports -->|"reads"| node_daycarerecords
node_reports -->|"reads"| node_homecarerecords
node_admin -->|"manages"| node_staffrecords
node_patientutil -->|"matches or creates"| node_patients

click node_app "https://github.com/klubnikabytes/dr.awrini_rana/blob/main/frontend/src/App.jsx"
click node_dashboard "https://github.com/klubnikabytes/dr.awrini_rana/blob/main/frontend/src/pages/Dashboard.jsx"
click node_visitpad "https://github.com/klubnikabytes/dr.awrini_rana/blob/main/frontend/src/pages/Doctor/VisitPad.jsx"
click node_labui "https://github.com/klubnikabytes/dr.awrini_rana/blob/main/frontend/src/pages/Lab/LabPage.jsx"
click node_daycareui "https://github.com/klubnikabytes/dr.awrini_rana/blob/main/frontend/src/pages/DayCare/DayCarePage.jsx"
click node_homecareui "https://github.com/klubnikabytes/dr.awrini_rana/blob/main/frontend/src/pages/HomeCare/HomeCarePage.jsx"
click node_auth "https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/middleware/authMiddleware.js"
click node_server "https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/server.js"
click node_frontdesk "https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/controllers/frontdeskController.js"
click node_doctor "https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/controllers/doctorController.js"
click node_lab "https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/controllers/labOrderController.js"
click node_daycare "https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/controllers/dayCareController.js"
click node_homecare "https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/controllers/homeCareController.js"
click node_patientutil "https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/utils/patientUtils.js"
click node_reports "https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/controllers/reportController.js"
click node_admin "https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/controllers/adminController.js"
click node_patients "https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/models/Patient.js"
click node_appointments "https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/models/Appointment.js"
click node_bills "https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/models/Bill.js"
click node_laborders "https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/models/LabOrder.js"
click node_daycarerecords "https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/models/DayCare.js"
click node_homecarerecords "https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/models/HomeCare.js"
click node_staffrecords "https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/models/Staff.js"
click node_events "https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/websocket.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_dashboard,node_visitpad,node_labui,node_daycareui,node_homecareui toneBlue
class node_auth,node_server toneAmber
class node_frontdesk,node_doctor,node_lab,node_daycare,node_homecare,node_patientutil toneMint
class node_patients,node_appointments,node_bills,node_laborders,node_daycarerecords,node_homecarerecords,node_staffrecords,node_events toneRose
class node_reports,node_admin,node_staff toneIndigo
```

## Components

### Web application

- [Application routes](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Clinic dashboard](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [Doctor visit pad](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/frontend/src/pages/Doctor/VisitPad.jsx): `frontend/src/pages/Doctor/VisitPad.jsx`
- [Lab workspace](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/frontend/src/pages/Lab/LabPage.jsx): `frontend/src/pages/Lab/LabPage.jsx`
- [Day-care workspace](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/frontend/src/pages/DayCare/DayCarePage.jsx): `frontend/src/pages/DayCare/DayCarePage.jsx`
- [Home-care workspace](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/frontend/src/pages/HomeCare/HomeCarePage.jsx): `frontend/src/pages/HomeCare/HomeCarePage.jsx`

### API and access

- [Request protection](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/middleware/authMiddleware.js): `backend/middleware/authMiddleware.js`
- [HTTP application](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/server.js): `backend/server.js`

### Clinical operations

- [Front-desk operations](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/controllers/frontdeskController.js): `backend/controllers/frontdeskController.js`
- [Doctor operations](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/controllers/doctorController.js): `backend/controllers/doctorController.js`
- [Lab orders](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/controllers/labOrderController.js): `backend/controllers/labOrderController.js`
- [Day-care records](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/controllers/dayCareController.js): `backend/controllers/dayCareController.js`
- [Home-care records](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/controllers/homeCareController.js): `backend/controllers/homeCareController.js`
- [Patient matching](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/utils/patientUtils.js): `backend/utils/patientUtils.js`

### Data and events

- [Patient records](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/models/Patient.js): `backend/models/Patient.js`
- [Appointments](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/models/Appointment.js): `backend/models/Appointment.js`
- [Bills and payments](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/models/Bill.js): `backend/models/Bill.js`
- [Lab orders store](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/models/LabOrder.js): `backend/models/LabOrder.js`
- [Day-care store](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/models/DayCare.js): `backend/models/DayCare.js`
- [Home-care store](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/models/HomeCare.js): `backend/models/HomeCare.js`
- [Staff records](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/models/Staff.js): `backend/models/Staff.js`
- [Live event broadcast](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/websocket.js): `backend/websocket.js`

### Administration and reporting

- [Operational reports](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/controllers/reportController.js): `backend/controllers/reportController.js`
- [Admin operations](https://github.com/klubnikabytes/dr.awrini_rana/blob/main/backend/controllers/adminController.js): `backend/controllers/adminController.js`

### Other components

- **Clinic staff**

## Connections

- Clinic staff → Application routes: uses (evidence: `frontend/src/App.jsx`)
- Application routes → Clinic dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → Doctor visit pad: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → Lab workspace: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → Day-care workspace: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → Home-care workspace: routes to (evidence: `frontend/src/App.jsx`)
- HTTP application → Request protection: uses (evidence: `backend/server.js`)
- HTTP application → Live event broadcast: initializes (evidence: `backend/server.js`)
- HTTP application → Front-desk operations: mounts routes (evidence: `backend/server.js`)
- HTTP application → Doctor operations: mounts routes (evidence: `backend/server.js`)
- HTTP application → Day-care records: mounts routes (evidence: `backend/server.js`)
- HTTP application → Home-care records: mounts routes (evidence: `backend/server.js`)
- HTTP application → Lab orders: mounts routes (evidence: `backend/server.js`)
- HTTP application → Operational reports: mounts routes (evidence: `backend/server.js`)
- Front-desk operations → Patient records: reads and writes (evidence: `backend/controllers/frontdeskController.js`)
- Front-desk operations → Appointments: reads and writes (evidence: `backend/controllers/frontdeskController.js`)
- Front-desk operations → Bills and payments: reads and writes (evidence: `backend/controllers/frontdeskController.js`)
- Front-desk operations → Lab orders store: updates (evidence: `backend/controllers/frontdeskController.js`)
- Front-desk operations → Patient matching: uses (evidence: `backend/controllers/frontdeskController.js`)
- Front-desk operations → Live event broadcast: broadcasts (evidence: `backend/controllers/frontdeskController.js`)
- Doctor operations → Patient records: reads and writes (evidence: `backend/controllers/doctorController.js`)
- Doctor operations → Appointments: reads and writes (evidence: `backend/controllers/doctorController.js`)
- Doctor operations → Lab orders store: reads (evidence: `backend/controllers/doctorController.js`)
- Lab orders → Lab orders store: reads and writes (evidence: `backend/controllers/labOrderController.js`)
- Lab orders → Patient matching: uses (evidence: `backend/controllers/labOrderController.js`)
- Lab orders → Live event broadcast: broadcasts (evidence: `backend/controllers/labOrderController.js`)
- Day-care records → Day-care store: reads and writes
- Home-care records → Home-care store: reads and writes (evidence: `backend/controllers/homeCareController.js`)
- Home-care records → Bills and payments: uses (evidence: `backend/controllers/homeCareController.js`)
- Home-care records → Patient matching: uses (evidence: `backend/controllers/homeCareController.js`)
- Operational reports → Bills and payments: reads (evidence: `backend/controllers/reportController.js`)
- Operational reports → Patient records: reads (evidence: `backend/controllers/reportController.js`)
- Operational reports → Lab orders store: reads (evidence: `backend/controllers/reportController.js`)
- Operational reports → Day-care store: reads (evidence: `backend/controllers/reportController.js`)
- Operational reports → Home-care store: reads (evidence: `backend/controllers/reportController.js`)
- Admin operations → Staff records: manages (evidence: `backend/controllers/adminController.js`)
- Patient matching → Patient records: matches or creates (evidence: `backend/utils/patientUtils.js`)
