# koti2579/hospital-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/koti2579/hospital-management-system
- Repository: https://github.com/koti2579/hospital-management-system

## Overview

HMS supports role-based hospital work: reception registers patients, doctors review and prescribe, labs record results, and pharmacy dispenses medicines; administrators manage staff and monitor hospital data. The React app routes staff and patient users to separate dashboards, while Express mounts role-specific API routes over MongoDB models and query modules. The README documents the major workflow and analytics capabilities; the sampled backend routes and dashboards support the main domain stages, but unsampled dashboard/API details limit claims about their exact interactions.

Main entry points: [`backend/index.js`](https://github.com/koti2579/hospital-management-system/blob/main/backend/index.js) (Express API), [`frontend/src/index.js`](https://github.com/koti2579/hospital-management-system/blob/main/frontend/src/index.js) (App routing), [`backend/config/queries/patientQueries.js`](https://github.com/koti2579/hospital-management-system/blob/main/backend/config/queries/patientQueries.js) (Patient records), [`backend/routes/patient.js`](https://github.com/koti2579/hospital-management-system/blob/main/backend/routes/patient.js) (Patient API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_web_routes["App routing<br/>[index.js]"]
  node_home["Home and login<br/>[Home.jsx]"]
  node_admin_ui["Admin dashboard<br/>[AdminDashboard.jsx]"]
  node_reception_ui["Reception dashboard"]
  node_doctor_ui["Doctor dashboard"]
  node_lab_ui["Lab dashboard<br/>[LabDashboard.jsx]"]
  node_pharmacy_ui["Pharmacy dashboard"]
  node_patient_ui["Patient dashboard"]
end

subgraph group_api["API and access"]
  node_server["Express API<br/>[index.js]"]
  node_auth["Authentication<br/>[auth.js]"]
  node_access["Token verification<br/>[authMiddleware.js]"]
  node_admin_api["Admin API<br/>[admin.js]"]
  node_reception_api["Reception API<br/>[reception.js]"]
end

subgraph group_clinical["Clinical workflows"]
  node_doctor_api["Doctor API<br/>[doctor.js]"]
  node_lab_api["Lab API<br/>[lab.js]"]
  node_pharmacy_api["Pharmacy API<br/>[pharmacy.js]"]
  node_patient_api["Patient API<br/>[patient.js]"]
end

subgraph group_records["Hospital records"]
  node_db_connect["Mongo connection<br/>[db.js]"]
  node_patient_queries["Patient records<br/>[patientQueries.js]"]
  node_user_queries["Staff records<br/>[userQueries.js]"]
  node_prescription_queries["Prescription records"]
  node_lab_queries["Lab test records<br/>[labTestQueries.js]"]
  node_medicine_queries["Medicine inventory<br/>[medicineQueries.js]"]
  node_patient_model[("Patient model<br/>[Patient.js]")]
  node_prescription_model[("Prescription model<br/>[Prescription.js]")]
  node_medicine_model[("Medicine model<br/>[Medicine.js]")]
  node_lab_model[("Lab test model<br/>[LabTest.js]")]
  node_user_model[("User model<br/>[User.js]")]
end

node_staff(("Hospital staff"))
node_patient_actor(("Patient"))

node_staff -->|"uses"| node_web_routes
node_patient_actor -->|"uses"| node_web_routes
node_web_routes -->|"routes to"| node_home
node_web_routes -->|"routes to"| node_admin_ui
node_web_routes -->|"routes to"| node_reception_ui
node_web_routes -->|"routes to"| node_doctor_ui
node_web_routes -->|"routes to"| node_lab_ui
node_web_routes -->|"routes to"| node_pharmacy_ui
node_web_routes -->|"routes to"| node_patient_ui
node_server -->|"connects"| node_db_connect
node_server -->|"mounts"| node_auth
node_server -->|"mounts"| node_admin_api
node_server -->|"mounts"| node_doctor_api
node_server -->|"mounts"| node_lab_api
node_server -->|"mounts"| node_pharmacy_api
node_server -->|"mounts"| node_reception_api
node_server -->|"mounts"| node_patient_api
node_auth -->|"looks up staff"| node_user_queries
node_auth -->|"looks up patient"| node_patient_queries
node_patient_api -->|"verifies patient"| node_access
node_admin_api -->|"uses"| node_user_queries
node_admin_api -->|"uses"| node_patient_queries
node_reception_api -->|"uses"| node_patient_queries
node_reception_api -->|"uses"| node_user_queries
node_doctor_api -->|"uses"| node_patient_queries
node_doctor_api -->|"uses"| node_prescription_queries
node_doctor_api -->|"uses"| node_lab_queries
node_lab_api -->|"uses"| node_lab_queries
node_lab_api -->|"uses"| node_patient_queries
node_pharmacy_api -->|"uses"| node_prescription_queries
node_pharmacy_api -->|"uses"| node_medicine_queries
node_pharmacy_api -->|"uses"| node_patient_queries
node_patient_api -->|"uses"| node_patient_queries
node_patient_api -->|"uses"| node_prescription_queries
node_patient_api -->|"uses"| node_lab_queries
node_patient_queries -->|"queries"| node_patient_model
node_user_queries -->|"queries"| node_user_model
node_prescription_queries -->|"queries"| node_prescription_model
node_lab_queries -->|"queries"| node_lab_model
node_medicine_queries -->|"queries"| node_medicine_model
node_home -.->|"calls API"| node_server
node_admin_ui -.->|"calls API"| node_server
node_reception_ui -.->|"calls API"| node_server
node_doctor_ui -.->|"calls API"| node_server
node_lab_ui -.->|"calls API"| node_server
node_pharmacy_ui -.->|"calls API"| node_server
node_patient_ui -.->|"calls API"| node_server

click node_web_routes "https://github.com/koti2579/hospital-management-system/blob/main/frontend/src/index.js"
click node_home "https://github.com/koti2579/hospital-management-system/blob/main/frontend/src/components/Home.jsx"
click node_admin_ui "https://github.com/koti2579/hospital-management-system/blob/main/frontend/src/components/AdminDashboard.jsx"
click node_reception_ui "https://github.com/koti2579/hospital-management-system/blob/main/frontend/src/components/ReceptionDashboard.jsx"
click node_doctor_ui "https://github.com/koti2579/hospital-management-system/blob/main/frontend/src/components/DoctorDashboard.jsx"
click node_lab_ui "https://github.com/koti2579/hospital-management-system/blob/main/frontend/src/components/LabDashboard.jsx"
click node_pharmacy_ui "https://github.com/koti2579/hospital-management-system/blob/main/frontend/src/components/PharmacyDashboard.jsx"
click node_patient_ui "https://github.com/koti2579/hospital-management-system/blob/main/frontend/src/components/PatientDashboard.jsx"
click node_server "https://github.com/koti2579/hospital-management-system/blob/main/backend/index.js"
click node_auth "https://github.com/koti2579/hospital-management-system/blob/main/backend/routes/auth.js"
click node_access "https://github.com/koti2579/hospital-management-system/blob/main/backend/middleware/authMiddleware.js"
click node_admin_api "https://github.com/koti2579/hospital-management-system/blob/main/backend/routes/admin.js"
click node_reception_api "https://github.com/koti2579/hospital-management-system/blob/main/backend/routes/reception.js"
click node_doctor_api "https://github.com/koti2579/hospital-management-system/blob/main/backend/routes/doctor.js"
click node_lab_api "https://github.com/koti2579/hospital-management-system/blob/main/backend/routes/lab.js"
click node_pharmacy_api "https://github.com/koti2579/hospital-management-system/blob/main/backend/routes/pharmacy.js"
click node_patient_api "https://github.com/koti2579/hospital-management-system/blob/main/backend/routes/patient.js"
click node_db_connect "https://github.com/koti2579/hospital-management-system/blob/main/backend/config/db.js"
click node_patient_queries "https://github.com/koti2579/hospital-management-system/blob/main/backend/config/queries/patientQueries.js"
click node_user_queries "https://github.com/koti2579/hospital-management-system/blob/main/backend/config/queries/userQueries.js"
click node_prescription_queries "https://github.com/koti2579/hospital-management-system/blob/main/backend/config/queries/prescriptionQueries.js"
click node_lab_queries "https://github.com/koti2579/hospital-management-system/blob/main/backend/config/queries/labTestQueries.js"
click node_medicine_queries "https://github.com/koti2579/hospital-management-system/blob/main/backend/config/queries/medicineQueries.js"
click node_patient_model "https://github.com/koti2579/hospital-management-system/blob/main/backend/models/Patient.js"
click node_prescription_model "https://github.com/koti2579/hospital-management-system/blob/main/backend/models/Prescription.js"
click node_medicine_model "https://github.com/koti2579/hospital-management-system/blob/main/backend/models/Medicine.js"
click node_lab_model "https://github.com/koti2579/hospital-management-system/blob/main/backend/models/LabTest.js"
click node_user_model "https://github.com/koti2579/hospital-management-system/blob/main/backend/models/User.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_web_routes,node_home,node_admin_ui,node_reception_ui,node_doctor_ui,node_lab_ui,node_pharmacy_ui,node_patient_ui toneBlue
class node_server,node_auth,node_access,node_admin_api,node_reception_api toneAmber
class node_doctor_api,node_lab_api,node_pharmacy_api,node_patient_api toneMint
class node_db_connect,node_patient_queries,node_user_queries,node_prescription_queries,node_lab_queries,node_medicine_queries,node_patient_model,node_prescription_model,node_medicine_model,node_lab_model,node_user_model toneRose
class node_staff,node_patient_actor toneIndigo
```

## Components

### Web application

- [App routing](https://github.com/koti2579/hospital-management-system/blob/main/frontend/src/index.js): `frontend/src/index.js`
- [Home and login](https://github.com/koti2579/hospital-management-system/blob/main/frontend/src/components/Home.jsx): `frontend/src/components/Home.jsx`
- [Admin dashboard](https://github.com/koti2579/hospital-management-system/blob/main/frontend/src/components/AdminDashboard.jsx): `frontend/src/components/AdminDashboard.jsx`
- [Reception dashboard](https://github.com/koti2579/hospital-management-system/blob/main/frontend/src/components/ReceptionDashboard.jsx): `frontend/src/components/ReceptionDashboard.jsx`
- [Doctor dashboard](https://github.com/koti2579/hospital-management-system/blob/main/frontend/src/components/DoctorDashboard.jsx): `frontend/src/components/DoctorDashboard.jsx`
- [Lab dashboard](https://github.com/koti2579/hospital-management-system/blob/main/frontend/src/components/LabDashboard.jsx): `frontend/src/components/LabDashboard.jsx`
- [Pharmacy dashboard](https://github.com/koti2579/hospital-management-system/blob/main/frontend/src/components/PharmacyDashboard.jsx): `frontend/src/components/PharmacyDashboard.jsx`
- [Patient dashboard](https://github.com/koti2579/hospital-management-system/blob/main/frontend/src/components/PatientDashboard.jsx): `frontend/src/components/PatientDashboard.jsx`

### API and access

- [Express API](https://github.com/koti2579/hospital-management-system/blob/main/backend/index.js): `backend/index.js`
- [Authentication](https://github.com/koti2579/hospital-management-system/blob/main/backend/routes/auth.js): `backend/routes/auth.js`
- [Token verification](https://github.com/koti2579/hospital-management-system/blob/main/backend/middleware/authMiddleware.js): `backend/middleware/authMiddleware.js`
- [Admin API](https://github.com/koti2579/hospital-management-system/blob/main/backend/routes/admin.js): `backend/routes/admin.js`
- [Reception API](https://github.com/koti2579/hospital-management-system/blob/main/backend/routes/reception.js): `backend/routes/reception.js`

### Clinical workflows

- [Doctor API](https://github.com/koti2579/hospital-management-system/blob/main/backend/routes/doctor.js): `backend/routes/doctor.js`
- [Lab API](https://github.com/koti2579/hospital-management-system/blob/main/backend/routes/lab.js): `backend/routes/lab.js`
- [Pharmacy API](https://github.com/koti2579/hospital-management-system/blob/main/backend/routes/pharmacy.js): `backend/routes/pharmacy.js`
- [Patient API](https://github.com/koti2579/hospital-management-system/blob/main/backend/routes/patient.js): `backend/routes/patient.js`

### Hospital records

- [Mongo connection](https://github.com/koti2579/hospital-management-system/blob/main/backend/config/db.js): `backend/config/db.js`
- [Patient records](https://github.com/koti2579/hospital-management-system/blob/main/backend/config/queries/patientQueries.js): `backend/config/queries/patientQueries.js`
- [Staff records](https://github.com/koti2579/hospital-management-system/blob/main/backend/config/queries/userQueries.js): `backend/config/queries/userQueries.js`
- [Prescription records](https://github.com/koti2579/hospital-management-system/blob/main/backend/config/queries/prescriptionQueries.js): `backend/config/queries/prescriptionQueries.js`
- [Lab test records](https://github.com/koti2579/hospital-management-system/blob/main/backend/config/queries/labTestQueries.js): `backend/config/queries/labTestQueries.js`
- [Medicine inventory](https://github.com/koti2579/hospital-management-system/blob/main/backend/config/queries/medicineQueries.js): `backend/config/queries/medicineQueries.js`
- [Patient model](https://github.com/koti2579/hospital-management-system/blob/main/backend/models/Patient.js): `backend/models/Patient.js`
- [Prescription model](https://github.com/koti2579/hospital-management-system/blob/main/backend/models/Prescription.js): `backend/models/Prescription.js`
- [Medicine model](https://github.com/koti2579/hospital-management-system/blob/main/backend/models/Medicine.js): `backend/models/Medicine.js`
- [Lab test model](https://github.com/koti2579/hospital-management-system/blob/main/backend/models/LabTest.js): `backend/models/LabTest.js`
- [User model](https://github.com/koti2579/hospital-management-system/blob/main/backend/models/User.js): `backend/models/User.js`

### Other components

- **Hospital staff**
- **Patient**

## Connections

- Hospital staff → App routing: uses (evidence: `frontend/src/index.js`)
- Patient → App routing: uses (evidence: `frontend/src/index.js`)
- App routing → Home and login: routes to (evidence: `frontend/src/index.js`)
- App routing → Admin dashboard: routes to (evidence: `frontend/src/index.js`)
- App routing → Reception dashboard: routes to (evidence: `frontend/src/index.js`)
- App routing → Doctor dashboard: routes to (evidence: `frontend/src/index.js`)
- App routing → Lab dashboard: routes to (evidence: `frontend/src/index.js`)
- App routing → Pharmacy dashboard: routes to (evidence: `frontend/src/index.js`)
- App routing → Patient dashboard: routes to (evidence: `frontend/src/index.js`)
- Express API → Mongo connection: connects (evidence: `backend/index.js`)
- Express API → Authentication: mounts (evidence: `backend/index.js`)
- Express API → Admin API: mounts (evidence: `backend/index.js`)
- Express API → Doctor API: mounts (evidence: `backend/index.js`)
- Express API → Lab API: mounts (evidence: `backend/index.js`)
- Express API → Pharmacy API: mounts (evidence: `backend/index.js`)
- Express API → Reception API: mounts (evidence: `backend/index.js`)
- Express API → Patient API: mounts (evidence: `backend/index.js`)
- Authentication → Staff records: looks up staff (evidence: `backend/routes/auth.js`)
- Authentication → Patient records: looks up patient (evidence: `backend/routes/auth.js`)
- Patient API → Token verification: verifies patient (evidence: `backend/routes/patient.js`)
- Admin API → Staff records: uses (evidence: `backend/routes/admin.js`)
- Admin API → Patient records: uses (evidence: `backend/routes/admin.js`)
- Reception API → Patient records: uses (evidence: `backend/routes/reception.js`)
- Reception API → Staff records: uses (evidence: `backend/routes/reception.js`)
- Doctor API → Patient records: uses (evidence: `backend/routes/doctor.js`)
- Doctor API → Prescription records: uses (evidence: `backend/routes/doctor.js`)
- Doctor API → Lab test records: uses (evidence: `backend/routes/doctor.js`)
- Lab API → Lab test records: uses (evidence: `backend/routes/lab.js`)
- Lab API → Patient records: uses (evidence: `backend/routes/lab.js`)
- Pharmacy API → Prescription records: uses (evidence: `backend/routes/pharmacy.js`)
- Pharmacy API → Medicine inventory: uses (evidence: `backend/routes/pharmacy.js`)
- Pharmacy API → Patient records: uses (evidence: `backend/routes/pharmacy.js`)
- Patient API → Patient records: uses (evidence: `backend/routes/patient.js`)
- Patient API → Prescription records: uses (evidence: `backend/routes/patient.js`)
- Patient API → Lab test records: uses (evidence: `backend/routes/patient.js`)
- Patient records → Patient model: queries (evidence: `backend/config/queries/patientQueries.js`)
- Staff records → User model: queries (evidence: `backend/config/queries/userQueries.js`)
- Prescription records → Prescription model: queries (evidence: `backend/config/queries/prescriptionQueries.js`)
- Lab test records → Lab test model: queries (evidence: `backend/config/queries/labTestQueries.js`)
- Medicine inventory → Medicine model: queries (evidence: `backend/config/queries/medicineQueries.js`)
- Home and login → Express API: calls API
- Admin dashboard → Express API: calls API
- Reception dashboard → Express API: calls API
- Doctor dashboard → Express API: calls API
- Lab dashboard → Express API: calls API
- Pharmacy dashboard → Express API: calls API
- Patient dashboard → Express API: calls API
