# imsaifali01/hospital-management-system architecture

> Architecture diagram of the GitHub repository imsaifali01/hospital-management-system, 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/imsaifali01/hospital-management-system
- Repository: https://github.com/imsaifali01/hospital-management-system

## Overview

This is a hospital-management web application: staff sign in, navigate a dashboard, and manage patients, doctors, appointments, and bills. The React frontend routes these workflows; its patient and billing screens make HTTP requests to Spring REST controllers, which delegate to JPA repositories. The backend also exposes authentication and domain APIs. Source excerpts directly establish patient and billing UI-to-API calls; links for other page/API pairs are omitted because their runtime requests were not shown.

Main entry points: [`hospital-frontend/src/App.jsx`](https://github.com/imsaifali01/hospital-management-system/blob/main/hospital-frontend/src/App.jsx) (App router), [`hospital-frontend/src/pages/Billing.jsx`](https://github.com/imsaifali01/hospital-management-system/blob/main/hospital-frontend/src/pages/Billing.jsx) (Billing and PDFs), [`backend/src/main/java/com/hms/backend/controller/PatientController.java`](https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/controller/PatientController.java) (Patient API), [`hospital-frontend/src/main.jsx`](https://github.com/imsaifali01/hospital-management-system/blob/main/hospital-frontend/src/main.jsx) (React entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Frontend shell"]
  node_web["React entry<br/>[main.jsx]"]
  node_app["App router<br/>[App.jsx]"]
  node_nav["Navbar<br/>[Navbar.jsx]"]
  node_sidebar["Sidebar navigation<br/>[Sidebar.jsx]"]
end

subgraph group_workflows["Hospital workflows"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_login["Login<br/>[Login.jsx]"]
  node_patients_ui["Patient management<br/>[Patients.jsx]"]
  node_doctors_ui["Doctor management<br/>[Doctors.jsx]"]
  node_appointments_ui["Appointments<br/>[Appointments.jsx]"]
  node_billing_ui["Billing and PDFs<br/>[Billing.jsx]"]
end

subgraph group_api["Backend API"]
  node_auth_api["Authentication API"]
  node_patient_api["Patient API"]
  node_doctor_api["Doctor API"]
  node_appointment_api["Appointment API"]
  node_billing_api["Billing API"]
end

subgraph group_persistence["Persistence"]
  node_users["User repository"]
  node_patients_repo["Patient repository"]
  node_doctors_repo["Doctor repository"]
  node_appointments_repo["Appointment repository"]
  node_billing_repo["Billing repository"]
  node_user_entity["User record<br/>[User.java]"]
  node_patient_entity["Patient record<br/>[Patient.java]"]
  node_doctor_entity["Doctor record<br/>[Doctor.java]"]
  node_appointment_entity["Appointment record<br/>[Appointment.java]"]
  node_billing_entity["Billing record<br/>[Billing.java]"]
end

node_staff(("Hospital staff"))

node_staff -->|"uses"| node_web
node_web -->|"renders"| node_app
node_app -->|"shows when signed out"| node_login
node_app -->|"renders"| node_nav
node_app -->|"renders"| node_sidebar
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_patients_ui
node_app -->|"routes to"| node_doctors_ui
node_app -->|"routes to"| node_appointments_ui
node_app -->|"routes to"| node_billing_ui
node_patients_ui -->|"HTTP CRUD"| node_patient_api
node_billing_ui -->|"loads patients"| node_patient_api
node_billing_ui -->|"HTTP billing"| node_billing_api
node_auth_api -->|"looks up user"| node_users
node_patient_api -->|"reads and writes"| node_patients_repo
node_doctor_api -->|"delegates to"| node_doctors_repo
node_appointment_api -->|"reads and writes"| node_appointments_repo
node_billing_api -->|"delegates to"| node_billing_repo
node_users -->|"maps entity"| node_user_entity
node_patients_repo -->|"maps entity"| node_patient_entity
node_doctors_repo -->|"maps entity"| node_doctor_entity
node_appointments_repo -->|"maps entity"| node_appointment_entity
node_billing_repo -->|"maps entity"| node_billing_entity

click node_web "https://github.com/imsaifali01/hospital-management-system/blob/main/hospital-frontend/src/main.jsx"
click node_app "https://github.com/imsaifali01/hospital-management-system/blob/main/hospital-frontend/src/App.jsx"
click node_nav "https://github.com/imsaifali01/hospital-management-system/blob/main/hospital-frontend/src/components/Navbar.jsx"
click node_sidebar "https://github.com/imsaifali01/hospital-management-system/blob/main/hospital-frontend/src/components/Sidebar.jsx"
click node_dashboard "https://github.com/imsaifali01/hospital-management-system/blob/main/hospital-frontend/src/pages/Dashboard.jsx"
click node_login "https://github.com/imsaifali01/hospital-management-system/blob/main/hospital-frontend/src/pages/Login.jsx"
click node_patients_ui "https://github.com/imsaifali01/hospital-management-system/blob/main/hospital-frontend/src/pages/Patients.jsx"
click node_doctors_ui "https://github.com/imsaifali01/hospital-management-system/blob/main/hospital-frontend/src/pages/Doctors.jsx"
click node_appointments_ui "https://github.com/imsaifali01/hospital-management-system/blob/main/hospital-frontend/src/pages/Appointments.jsx"
click node_billing_ui "https://github.com/imsaifali01/hospital-management-system/blob/main/hospital-frontend/src/pages/Billing.jsx"
click node_auth_api "https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/controller/AuthController.java"
click node_patient_api "https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/controller/PatientController.java"
click node_doctor_api "https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/controller/DoctorController.java"
click node_appointment_api "https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/controller/AppointmentController.java"
click node_billing_api "https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/controller/BillingController.java"
click node_users "https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/repository/UserRepository.java"
click node_patients_repo "https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/repository/PatientRepository.java"
click node_doctors_repo "https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/repository/DoctorRepository.java"
click node_appointments_repo "https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/repository/AppointmentRepository.java"
click node_billing_repo "https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/repository/BillingRepository.java"
click node_user_entity "https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/entity/User.java"
click node_patient_entity "https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/entity/Patient.java"
click node_doctor_entity "https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/entity/Doctor.java"
click node_appointment_entity "https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/entity/Appointment.java"
click node_billing_entity "https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/entity/Billing.java"

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,node_app,node_nav,node_sidebar toneBlue
class node_dashboard,node_login,node_patients_ui,node_doctors_ui,node_appointments_ui,node_billing_ui toneAmber
class node_auth_api,node_patient_api,node_doctor_api,node_appointment_api,node_billing_api toneMint
class node_users,node_patients_repo,node_doctors_repo,node_appointments_repo,node_billing_repo,node_user_entity,node_patient_entity,node_doctor_entity,node_appointment_entity,node_billing_entity toneRose
class node_staff toneIndigo
```

## Components

### Frontend shell

- [React entry](https://github.com/imsaifali01/hospital-management-system/blob/main/hospital-frontend/src/main.jsx): `hospital-frontend/src/main.jsx`
- [App router](https://github.com/imsaifali01/hospital-management-system/blob/main/hospital-frontend/src/App.jsx): `hospital-frontend/src/App.jsx`
- [Navbar](https://github.com/imsaifali01/hospital-management-system/blob/main/hospital-frontend/src/components/Navbar.jsx): `hospital-frontend/src/components/Navbar.jsx`
- [Sidebar navigation](https://github.com/imsaifali01/hospital-management-system/blob/main/hospital-frontend/src/components/Sidebar.jsx): `hospital-frontend/src/components/Sidebar.jsx`

### Hospital workflows

- [Dashboard](https://github.com/imsaifali01/hospital-management-system/blob/main/hospital-frontend/src/pages/Dashboard.jsx): `hospital-frontend/src/pages/Dashboard.jsx`
- [Login](https://github.com/imsaifali01/hospital-management-system/blob/main/hospital-frontend/src/pages/Login.jsx): `hospital-frontend/src/pages/Login.jsx`
- [Patient management](https://github.com/imsaifali01/hospital-management-system/blob/main/hospital-frontend/src/pages/Patients.jsx): `hospital-frontend/src/pages/Patients.jsx`
- [Doctor management](https://github.com/imsaifali01/hospital-management-system/blob/main/hospital-frontend/src/pages/Doctors.jsx): `hospital-frontend/src/pages/Doctors.jsx`
- [Appointments](https://github.com/imsaifali01/hospital-management-system/blob/main/hospital-frontend/src/pages/Appointments.jsx): `hospital-frontend/src/pages/Appointments.jsx`
- [Billing and PDFs](https://github.com/imsaifali01/hospital-management-system/blob/main/hospital-frontend/src/pages/Billing.jsx): `hospital-frontend/src/pages/Billing.jsx`

### Backend API

- [Authentication API](https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/controller/AuthController.java): `backend/src/main/java/com/hms/backend/controller/AuthController.java`
- [Patient API](https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/controller/PatientController.java): `backend/src/main/java/com/hms/backend/controller/PatientController.java`
- [Doctor API](https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/controller/DoctorController.java): `backend/src/main/java/com/hms/backend/controller/DoctorController.java`
- [Appointment API](https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/controller/AppointmentController.java): `backend/src/main/java/com/hms/backend/controller/AppointmentController.java`
- [Billing API](https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/controller/BillingController.java): `backend/src/main/java/com/hms/backend/controller/BillingController.java`

### Persistence

- [User repository](https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/repository/UserRepository.java): `backend/src/main/java/com/hms/backend/repository/UserRepository.java`
- [Patient repository](https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/repository/PatientRepository.java): `backend/src/main/java/com/hms/backend/repository/PatientRepository.java`
- [Doctor repository](https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/repository/DoctorRepository.java): `backend/src/main/java/com/hms/backend/repository/DoctorRepository.java`
- [Appointment repository](https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/repository/AppointmentRepository.java): `backend/src/main/java/com/hms/backend/repository/AppointmentRepository.java`
- [Billing repository](https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/repository/BillingRepository.java): `backend/src/main/java/com/hms/backend/repository/BillingRepository.java`
- [User record](https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/entity/User.java): `backend/src/main/java/com/hms/backend/entity/User.java`
- [Patient record](https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/entity/Patient.java): `backend/src/main/java/com/hms/backend/entity/Patient.java`
- [Doctor record](https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/entity/Doctor.java): `backend/src/main/java/com/hms/backend/entity/Doctor.java`
- [Appointment record](https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/entity/Appointment.java): `backend/src/main/java/com/hms/backend/entity/Appointment.java`
- [Billing record](https://github.com/imsaifali01/hospital-management-system/blob/main/backend/src/main/java/com/hms/backend/entity/Billing.java): `backend/src/main/java/com/hms/backend/entity/Billing.java`

### Other components

- **Hospital staff**

## Connections

- Hospital staff → React entry: uses
- React entry → App router: renders (evidence: `hospital-frontend/src/main.jsx`)
- App router → Login: shows when signed out (evidence: `hospital-frontend/src/App.jsx`)
- App router → Navbar: renders (evidence: `hospital-frontend/src/App.jsx`)
- App router → Sidebar navigation: renders (evidence: `hospital-frontend/src/App.jsx`)
- App router → Dashboard: routes to (evidence: `hospital-frontend/src/App.jsx`)
- App router → Patient management: routes to (evidence: `hospital-frontend/src/App.jsx`)
- App router → Doctor management: routes to (evidence: `hospital-frontend/src/App.jsx`)
- App router → Appointments: routes to (evidence: `hospital-frontend/src/App.jsx`)
- App router → Billing and PDFs: routes to (evidence: `hospital-frontend/src/App.jsx`)
- Patient management → Patient API: HTTP CRUD (evidence: `hospital-frontend/src/pages/Patients.jsx`)
- Billing and PDFs → Patient API: loads patients (evidence: `hospital-frontend/src/pages/Billing.jsx`)
- Billing and PDFs → Billing API: HTTP billing (evidence: `hospital-frontend/src/pages/Billing.jsx`)
- Authentication API → User repository: looks up user (evidence: `backend/src/main/java/com/hms/backend/controller/AuthController.java`)
- Patient API → Patient repository: reads and writes (evidence: `backend/src/main/java/com/hms/backend/controller/PatientController.java`)
- Doctor API → Doctor repository: delegates to (evidence: `backend/src/main/java/com/hms/backend/controller/DoctorController.java`)
- Appointment API → Appointment repository: reads and writes (evidence: `backend/src/main/java/com/hms/backend/controller/AppointmentController.java`)
- Billing API → Billing repository: delegates to (evidence: `backend/src/main/java/com/hms/backend/controller/BillingController.java`)
- User repository → User record: maps entity (evidence: `backend/src/main/java/com/hms/backend/repository/UserRepository.java`)
- Patient repository → Patient record: maps entity (evidence: `backend/src/main/java/com/hms/backend/repository/PatientRepository.java`)
- Doctor repository → Doctor record: maps entity (evidence: `backend/src/main/java/com/hms/backend/repository/DoctorRepository.java`)
- Appointment repository → Appointment record: maps entity (evidence: `backend/src/main/java/com/hms/backend/repository/AppointmentRepository.java`)
- Billing repository → Billing record: maps entity (evidence: `backend/src/main/java/com/hms/backend/repository/BillingRepository.java`)
