# rickyharish/healthcare architecture

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

- Interactive diagram: https://gitdiagram.com/rickyharish/healthcare
- Repository: https://github.com/rickyharish/healthcare

## Overview

Healthcare Application is a React/Express healthcare portal. Its user journey covers account registration and OTP verification, doctor search and selection, appointment booking, then appointment review or cancellation; password recovery and administrative doctor management are additional capabilities. The backend uses MongoDB models for users and appointments, while search currently filters demonstration data in its route. Some frontend-to-API details and several advertised capabilities are not shown in source excerpts, so those connections are documented or marked unverified rather than inferred as direct calls.

Main entry points: [`frontend/src/App.js`](https://github.com/rickyharish/healthcare/blob/main/frontend/src/App.js) (App routing), [`backend/server.js`](https://github.com/rickyharish/healthcare/blob/main/backend/server.js) (Express server), [`backend/routes/authRoutes.js`](https://github.com/rickyharish/healthcare/blob/main/backend/routes/authRoutes.js) (Auth routes), [`backend/routes/appointmentRoutes.js`](https://github.com/rickyharish/healthcare/blob/main/backend/routes/appointmentRoutes.js) (Appointment API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Patient web app"]
  node_app["App routing<br/>[App.js]"]
  node_auth_ui["Auth state<br/>[AuthContext.js]"]
  node_login["Login and registration<br/>[Login.js]"]
  node_otp_ui["OTP verification<br/>[verifyOtp.js]"]
  node_recovery["Password recovery<br/>[ForgotPassword.js]"]
  node_home["Doctor search<br/>[Home.js]"]
  node_searchbar["Search filters<br/>[Searchbar.js]"]
  node_doctor_select["Doctor selection<br/>[DoctorSelection.js]"]
  node_booking["Appointment booking"]
  node_preview["Appointment review"]
  node_admin_ui["Admin panel<br/>[AdminPanel.js]"]
end

subgraph group_backend["API services"]
  node_api["Express server<br/>[server.js]"]
  node_auth_routes["Auth routes<br/>[authRoutes.js]"]
  node_auth_controller["Authentication<br/>[authController.js]"]
  node_search_routes["Doctor search API<br/>[searchRoutes.js]"]
  node_appointment_routes["Appointment API"]
  node_appointment_controller["Booking handler"]
  node_admin_routes["Admin routes<br/>[adminRoutes.js]"]
  node_admin_controller["Admin handlers<br/>[adminController.js]"]
end

subgraph group_data["Healthcare data"]
  node_db_config["Database connection<br/>[db.js]"]
  node_users[("User records<br/>[User.js]")]
  node_appointments[("Appointment records<br/>[Appointment.js]")]
  node_doctors[("Doctor records<br/>[Doctor.js]")]
  node_hospitals[("Hospital records<br/>[Hospital.js]")]
end

subgraph group_external["External services"]
  node_mongodb[("MongoDB")]
  node_email["Email service"]
end

node_patient(("Patient"))

node_patient -->|"uses"| node_app
node_app -->|"provides auth"| node_auth_ui
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_otp_ui
node_app -->|"routes to"| node_recovery
node_app -->|"routes to"| node_doctor_select
node_app -->|"routes to"| node_booking
node_app -->|"routes to"| node_preview
node_app -->|"routes to"| node_admin_ui
node_home -->|"renders"| node_searchbar
node_patient -->|"authenticates"| node_login
node_login -.->|"submits credentials"| node_auth_routes
node_otp_ui -.->|"verifies OTP"| node_auth_routes
node_recovery -.->|"requests reset"| node_auth_routes
node_api -->|"mounts"| node_auth_routes
node_api -->|"mounts"| node_search_routes
node_api -->|"mounts"| node_appointment_routes
node_api -->|"mounts"| node_admin_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_auth_controller -->|"reads and writes"| node_users
node_auth_controller -->|"sends messages"| node_email
node_searchbar -.->|"searches doctors"| node_search_routes
node_search_routes -->|"returns matches"| node_patient
node_patient -->|"selects doctor"| node_doctor_select
node_booking -.->|"books appointment"| node_appointment_routes
node_appointment_routes -->|"reads and writes"| node_appointments
node_appointment_controller -->|"saves appointment"| node_appointments
node_preview -->|"lists or cancels"| node_appointment_routes
node_admin_routes -->|"dispatches"| node_admin_controller
node_admin_ui -.->|"manages doctors"| node_admin_routes
node_api -->|"connects database"| node_db_config
node_db_config -.->|"connects"| node_mongodb
node_users -->|"stored in"| node_mongodb
node_appointments -->|"stored in"| node_mongodb
node_doctors -->|"stored in"| node_mongodb
node_hospitals -->|"stored in"| node_mongodb

click node_app "https://github.com/rickyharish/healthcare/blob/main/frontend/src/App.js"
click node_auth_ui "https://github.com/rickyharish/healthcare/blob/main/frontend/src/components/AuthContext.js"
click node_login "https://github.com/rickyharish/healthcare/blob/main/frontend/src/pages/Login.js"
click node_otp_ui "https://github.com/rickyharish/healthcare/blob/main/frontend/src/services/verifyOtp.js"
click node_recovery "https://github.com/rickyharish/healthcare/blob/main/frontend/src/pages/ForgotPassword.js"
click node_home "https://github.com/rickyharish/healthcare/blob/main/frontend/src/pages/Home.js"
click node_searchbar "https://github.com/rickyharish/healthcare/blob/main/frontend/src/components/Searchbar.js"
click node_doctor_select "https://github.com/rickyharish/healthcare/blob/main/frontend/src/components/DoctorSelection.js"
click node_booking "https://github.com/rickyharish/healthcare/blob/main/frontend/src/components/AppointmentBooking.js"
click node_preview "https://github.com/rickyharish/healthcare/blob/main/frontend/src/components/AppointmentPreview.js"
click node_admin_ui "https://github.com/rickyharish/healthcare/blob/main/frontend/src/pages/AdminPanel.js"
click node_api "https://github.com/rickyharish/healthcare/blob/main/backend/server.js"
click node_auth_routes "https://github.com/rickyharish/healthcare/blob/main/backend/routes/authRoutes.js"
click node_auth_controller "https://github.com/rickyharish/healthcare/blob/main/backend/controllers/authController.js"
click node_search_routes "https://github.com/rickyharish/healthcare/blob/main/backend/routes/searchRoutes.js"
click node_appointment_routes "https://github.com/rickyharish/healthcare/blob/main/backend/routes/appointmentRoutes.js"
click node_appointment_controller "https://github.com/rickyharish/healthcare/blob/main/backend/controllers/appointmentController.js"
click node_admin_routes "https://github.com/rickyharish/healthcare/blob/main/backend/routes/adminRoutes.js"
click node_admin_controller "https://github.com/rickyharish/healthcare/blob/main/backend/controllers/adminController.js"
click node_db_config "https://github.com/rickyharish/healthcare/blob/main/backend/config/db.js"
click node_users "https://github.com/rickyharish/healthcare/blob/main/backend/models/User.js"
click node_appointments "https://github.com/rickyharish/healthcare/blob/main/backend/models/Appointment.js"
click node_doctors "https://github.com/rickyharish/healthcare/blob/main/backend/models/Doctor.js"
click node_hospitals "https://github.com/rickyharish/healthcare/blob/main/backend/models/Hospital.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_auth_ui,node_login,node_otp_ui,node_recovery,node_home,node_searchbar,node_doctor_select,node_booking,node_preview,node_admin_ui toneBlue
class node_api,node_auth_routes,node_auth_controller,node_search_routes,node_appointment_routes,node_appointment_controller,node_admin_routes,node_admin_controller toneAmber
class node_db_config,node_users,node_appointments,node_doctors,node_hospitals toneMint
class node_mongodb,node_email toneRose
class node_patient toneIndigo
```

## Components

### Patient web app

- [App routing](https://github.com/rickyharish/healthcare/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Auth state](https://github.com/rickyharish/healthcare/blob/main/frontend/src/components/AuthContext.js): `frontend/src/components/AuthContext.js`
- [Login and registration](https://github.com/rickyharish/healthcare/blob/main/frontend/src/pages/Login.js): `frontend/src/pages/Login.js`
- [OTP verification](https://github.com/rickyharish/healthcare/blob/main/frontend/src/services/verifyOtp.js): `frontend/src/services/verifyOtp.js`
- [Password recovery](https://github.com/rickyharish/healthcare/blob/main/frontend/src/pages/ForgotPassword.js): `frontend/src/pages/ForgotPassword.js`
- [Doctor search](https://github.com/rickyharish/healthcare/blob/main/frontend/src/pages/Home.js): `frontend/src/pages/Home.js`
- [Search filters](https://github.com/rickyharish/healthcare/blob/main/frontend/src/components/Searchbar.js): `frontend/src/components/Searchbar.js`
- [Doctor selection](https://github.com/rickyharish/healthcare/blob/main/frontend/src/components/DoctorSelection.js): `frontend/src/components/DoctorSelection.js`
- [Appointment booking](https://github.com/rickyharish/healthcare/blob/main/frontend/src/components/AppointmentBooking.js): `frontend/src/components/AppointmentBooking.js`
- [Appointment review](https://github.com/rickyharish/healthcare/blob/main/frontend/src/components/AppointmentPreview.js): `frontend/src/components/AppointmentPreview.js`
- [Admin panel](https://github.com/rickyharish/healthcare/blob/main/frontend/src/pages/AdminPanel.js): `frontend/src/pages/AdminPanel.js`

### API services

- [Express server](https://github.com/rickyharish/healthcare/blob/main/backend/server.js): `backend/server.js`
- [Auth routes](https://github.com/rickyharish/healthcare/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Authentication](https://github.com/rickyharish/healthcare/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [Doctor search API](https://github.com/rickyharish/healthcare/blob/main/backend/routes/searchRoutes.js): `backend/routes/searchRoutes.js`
- [Appointment API](https://github.com/rickyharish/healthcare/blob/main/backend/routes/appointmentRoutes.js): `backend/routes/appointmentRoutes.js`
- [Booking handler](https://github.com/rickyharish/healthcare/blob/main/backend/controllers/appointmentController.js): `backend/controllers/appointmentController.js`
- [Admin routes](https://github.com/rickyharish/healthcare/blob/main/backend/routes/adminRoutes.js): `backend/routes/adminRoutes.js`
- [Admin handlers](https://github.com/rickyharish/healthcare/blob/main/backend/controllers/adminController.js): `backend/controllers/adminController.js`

### Healthcare data

- [Database connection](https://github.com/rickyharish/healthcare/blob/main/backend/config/db.js): `backend/config/db.js`
- [User records](https://github.com/rickyharish/healthcare/blob/main/backend/models/User.js): `backend/models/User.js`
- [Appointment records](https://github.com/rickyharish/healthcare/blob/main/backend/models/Appointment.js): `backend/models/Appointment.js`
- [Doctor records](https://github.com/rickyharish/healthcare/blob/main/backend/models/Doctor.js): `backend/models/Doctor.js`
- [Hospital records](https://github.com/rickyharish/healthcare/blob/main/backend/models/Hospital.js): `backend/models/Hospital.js`

### External services

- **MongoDB**
- **Email service**

### Other components

- **Patient**

## Connections

- Patient → App routing: uses (evidence: `README.md`)
- App routing → Auth state: provides auth (evidence: `frontend/src/App.js`)
- App routing → Doctor search: routes to (evidence: `frontend/src/App.js`)
- App routing → Login and registration: routes to (evidence: `frontend/src/App.js`)
- App routing → OTP verification: routes to (evidence: `frontend/src/App.js`)
- App routing → Password recovery: routes to (evidence: `frontend/src/App.js`)
- App routing → Doctor selection: routes to (evidence: `frontend/src/App.js`)
- App routing → Appointment booking: routes to (evidence: `frontend/src/App.js`)
- App routing → Appointment review: routes to (evidence: `frontend/src/App.js`)
- App routing → Admin panel: routes to (evidence: `frontend/src/App.js`)
- Doctor search → Search filters: renders (evidence: `frontend/src/pages/Home.js`)
- Patient → Login and registration: authenticates (evidence: `README.md`)
- Login and registration → Auth routes: submits credentials (evidence: `README.md`)
- OTP verification → Auth routes: verifies OTP (evidence: `README.md`)
- Password recovery → Auth routes: requests reset (evidence: `README.md`)
- Express server → Auth routes: mounts (evidence: `backend/server.js`)
- Express server → Doctor search API: mounts (evidence: `backend/server.js`)
- Express server → Appointment API: mounts (evidence: `backend/server.js`)
- Express server → Admin routes: mounts (evidence: `backend/server.js`)
- Auth routes → Authentication: dispatches (evidence: `backend/routes/authRoutes.js`)
- Authentication → User records: reads and writes (evidence: `backend/controllers/authController.js`)
- Authentication → Email service: sends messages (evidence: `backend/controllers/authController.js`)
- Search filters → Doctor search API: searches doctors (evidence: `README.md`)
- Doctor search API → Patient: returns matches (evidence: `backend/routes/searchRoutes.js`)
- Patient → Doctor selection: selects doctor (evidence: `README.md`)
- Appointment booking → Appointment API: books appointment (evidence: `README.md`)
- Appointment API → Appointment records: reads and writes (evidence: `backend/routes/appointmentRoutes.js`)
- Booking handler → Appointment records: saves appointment (evidence: `backend/controllers/appointmentController.js`)
- Appointment review → Appointment API: lists or cancels (evidence: `frontend/src/components/AppointmentPreview.js`)
- Admin routes → Admin handlers: dispatches (evidence: `backend/routes/adminRoutes.js`)
- Admin panel → Admin routes: manages doctors (evidence: `README.md`)
- Express server → Database connection: connects database (evidence: `backend/server.js`)
- Database connection → MongoDB: connects (evidence: `README.md`)
- User records → MongoDB: stored in (evidence: `README.md`)
- Appointment records → MongoDB: stored in (evidence: `README.md`)
- Doctor records → MongoDB: stored in (evidence: `README.md`)
- Hospital records → MongoDB: stored in (evidence: `README.md`)
