# yuven2212/book-a-doctor-using-mern architecture

> Architecture diagram of the GitHub repository yuven2212/book-a-doctor-using-mern, 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/yuven2212/book-a-doctor-using-mern
- Repository: https://github.com/yuven2212/book-a-doctor-using-mern

## Overview

This is a MERN doctor-appointment system. Patients register, browse approved doctors, check availability, book appointments, and review appointment history and notifications; doctors manage profiles and appointment statuses, while administrators manage users and doctor approvals. React routes and role-based layouts form the user interface, Express routes dispatch to controllers, and MongoDB models hold users, doctors, and appointments. The README documents these capabilities, but sampled excerpts do not show the client’s HTTP calls, so those connections are marked unverified.

Main entry points: [`client/src/App.js`](https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/client/src/App.js) (Route application), [`routes/userRoutes.js`](https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/routes/userRoutes.js) (User routes), [`client/src/components/Layout.js`](https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/client/src/components/Layout.js) (Role layout), [`controllers/userCtrl.js`](https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/controllers/userCtrl.js) (User workflows)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_app["Route application<br/>[App.js]"]
  node_layout["Role layout<br/>[Layout.js]"]
end

subgraph group_patient["Patient services"]
  node_authpages["Account access<br/>[Register.js]"]
  node_doctorsearch["Doctor search<br/>[HomePage.js]"]
  node_booking["Appointment booking<br/>[BookingPage.js]"]
  node_patientrecords["History and alerts"]
end

subgraph group_operations["Doctor and admin"]
  node_applydoctor["Doctor application<br/>[ApplyDoctor.js]"]
  node_doctorprofile["Doctor profile<br/>[Profile.js]"]
  node_doctorappointments["Doctor appointments"]
  node_admin["Admin management<br/>[Doctors.js]"]
end

subgraph group_api["Express API"]
  node_useroutes["User routes<br/>[userRoutes.js]"]
  node_doctorroutes["Doctor routes<br/>[doctorRoutes.js]"]
  node_adminroutes["Admin routes<br/>[adminRoutes.js]"]
  node_auth["JWT authorization<br/>[authMiddleware.js]"]
  node_userctrl["User workflows<br/>[userCtrl.js]"]
  node_doctorctrl["Doctor workflows<br/>[doctorCtrl.js]"]
  node_adminctrl["Admin workflows<br/>[adminCtrl.js]"]
end

subgraph group_data["Persistence"]
  node_users[("User records<br/>[userModels.js]")]
  node_doctors[("Doctor records<br/>[doctorModel.js]")]
  node_appointments[("Appointment records")]
end

node_browser(("User"))
node_mongodb[("MongoDB")]

node_browser -->|"opens"| node_app
node_app -->|"routes to"| node_authpages
node_app -->|"routes to"| node_doctorsearch
node_app -->|"routes to"| node_booking
node_app -->|"routes to"| node_patientrecords
node_app -->|"routes to"| node_applydoctor
node_app -->|"routes to"| node_doctorprofile
node_app -->|"routes to"| node_doctorappointments
node_app -->|"routes to"| node_admin
node_doctorsearch -->|"uses"| node_layout
node_booking -->|"uses"| node_layout
node_patientrecords -->|"uses"| node_layout
node_applydoctor -->|"uses"| node_layout
node_doctorprofile -->|"uses"| node_layout
node_doctorappointments -->|"uses"| node_layout
node_admin -->|"uses"| node_layout
node_authpages -.->|"calls API"| node_useroutes
node_doctorsearch -.->|"calls API"| node_useroutes
node_booking -.->|"calls API"| node_useroutes
node_patientrecords -.->|"calls API"| node_useroutes
node_applydoctor -.->|"calls API"| node_useroutes
node_doctorprofile -.->|"calls API"| node_doctorroutes
node_doctorappointments -.->|"calls API"| node_doctorroutes
node_admin -.->|"calls API"| node_adminroutes
node_useroutes -->|"guards routes"| node_auth
node_doctorroutes -->|"guards routes"| node_auth
node_adminroutes -->|"guards routes"| node_auth
node_useroutes -->|"dispatches"| node_userctrl
node_doctorroutes -->|"dispatches"| node_doctorctrl
node_adminroutes -->|"dispatches"| node_adminctrl
node_userctrl -->|"reads and writes"| node_users
node_userctrl -->|"reads and writes"| node_doctors
node_userctrl -->|"reads and writes"| node_appointments
node_doctorctrl -->|"reads and writes"| node_appointments
node_doctorctrl -->|"reads and writes"| node_doctors
node_doctorctrl -->|"reads and writes"| node_users
node_adminctrl -->|"reads and writes"| node_doctors
node_adminctrl -->|"reads and writes"| node_users
node_users -.->|"stored in"| node_mongodb
node_doctors -.->|"stored in"| node_mongodb
node_appointments -.->|"stored in"| node_mongodb

click node_app "https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/client/src/App.js"
click node_layout "https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/client/src/components/Layout.js"
click node_authpages "https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/client/src/pages/Register.js"
click node_doctorsearch "https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/client/src/pages/HomePage.js"
click node_booking "https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/client/src/pages/BookingPage.js"
click node_patientrecords "https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/client/src/pages/NotificationPage.js"
click node_applydoctor "https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/client/src/pages/ApplyDoctor.js"
click node_doctorprofile "https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/client/src/pages/doctor/Profile.js"
click node_doctorappointments "https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/client/src/pages/doctor/DoctorAppointments.js"
click node_admin "https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/client/src/pages/admin/Doctors.js"
click node_useroutes "https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/routes/userRoutes.js"
click node_doctorroutes "https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/routes/doctorRoutes.js"
click node_adminroutes "https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/routes/adminRoutes.js"
click node_auth "https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/middlewares/authMiddleware.js"
click node_userctrl "https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/controllers/userCtrl.js"
click node_doctorctrl "https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/controllers/doctorCtrl.js"
click node_adminctrl "https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/controllers/adminCtrl.js"
click node_users "https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/models/userModels.js"
click node_doctors "https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/models/doctorModel.js"
click node_appointments "https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/models/appointmentModel.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_layout,node_browser toneBlue
class node_authpages,node_doctorsearch,node_booking,node_patientrecords,node_mongodb toneAmber
class node_applydoctor,node_doctorprofile,node_doctorappointments,node_admin toneMint
class node_useroutes,node_doctorroutes,node_adminroutes,node_auth,node_userctrl,node_doctorctrl,node_adminctrl toneRose
class node_users,node_doctors,node_appointments toneIndigo
```

## Components

### React client

- [Route application](https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/client/src/App.js): `client/src/App.js`
- [Role layout](https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/client/src/components/Layout.js): `client/src/components/Layout.js`

### Patient services

- [Account access](https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/client/src/pages/Register.js): `client/src/pages/Register.js`
- [Doctor search](https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/client/src/pages/HomePage.js): `client/src/pages/HomePage.js`
- [Appointment booking](https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/client/src/pages/BookingPage.js): `client/src/pages/BookingPage.js`
- [History and alerts](https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/client/src/pages/NotificationPage.js): `client/src/pages/NotificationPage.js`

### Doctor and admin

- [Doctor application](https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/client/src/pages/ApplyDoctor.js): `client/src/pages/ApplyDoctor.js`
- [Doctor profile](https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/client/src/pages/doctor/Profile.js): `client/src/pages/doctor/Profile.js`
- [Doctor appointments](https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/client/src/pages/doctor/DoctorAppointments.js): `client/src/pages/doctor/DoctorAppointments.js`
- [Admin management](https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/client/src/pages/admin/Doctors.js): `client/src/pages/admin/Doctors.js`

### Express API

- [User routes](https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/routes/userRoutes.js): `routes/userRoutes.js`
- [Doctor routes](https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/routes/doctorRoutes.js): `routes/doctorRoutes.js`
- [Admin routes](https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/routes/adminRoutes.js): `routes/adminRoutes.js`
- [JWT authorization](https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/middlewares/authMiddleware.js): `middlewares/authMiddleware.js`
- [User workflows](https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/controllers/userCtrl.js): `controllers/userCtrl.js`
- [Doctor workflows](https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/controllers/doctorCtrl.js): `controllers/doctorCtrl.js`
- [Admin workflows](https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/controllers/adminCtrl.js): `controllers/adminCtrl.js`

### Persistence

- [User records](https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/models/userModels.js): `models/userModels.js`
- [Doctor records](https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/models/doctorModel.js): `models/doctorModel.js`
- [Appointment records](https://github.com/yuven2212/book-a-doctor-using-mern/blob/main/models/appointmentModel.js): `models/appointmentModel.js`

### Other components

- **User**
- **MongoDB**

## Connections

- User → Route application: opens (evidence: `README.md`)
- Route application → Account access: routes to (evidence: `client/src/App.js`)
- Route application → Doctor search: routes to (evidence: `client/src/App.js`)
- Route application → Appointment booking: routes to (evidence: `client/src/App.js`)
- Route application → History and alerts: routes to (evidence: `client/src/App.js`)
- Route application → Doctor application: routes to (evidence: `client/src/App.js`)
- Route application → Doctor profile: routes to (evidence: `client/src/App.js`)
- Route application → Doctor appointments: routes to (evidence: `client/src/App.js`)
- Route application → Admin management: routes to (evidence: `client/src/App.js`)
- Doctor search → Role layout: uses (evidence: `client/src/pages/HomePage.js`)
- Appointment booking → Role layout: uses (evidence: `client/src/pages/BookingPage.js`)
- History and alerts → Role layout: uses (evidence: `client/src/pages/NotificationPage.js`)
- Doctor application → Role layout: uses (evidence: `client/src/pages/ApplyDoctor.js`)
- Doctor profile → Role layout: uses (evidence: `client/src/pages/doctor/Profile.js`)
- Doctor appointments → Role layout: uses (evidence: `client/src/pages/doctor/DoctorAppointments.js`)
- Admin management → Role layout: uses (evidence: `client/src/pages/admin/Doctors.js`)
- Account access → User routes: calls API
- Doctor search → User routes: calls API
- Appointment booking → User routes: calls API
- History and alerts → User routes: calls API
- Doctor application → User routes: calls API
- Doctor profile → Doctor routes: calls API
- Doctor appointments → Doctor routes: calls API
- Admin management → Admin routes: calls API
- User routes → JWT authorization: guards routes (evidence: `routes/userRoutes.js`)
- Doctor routes → JWT authorization: guards routes (evidence: `routes/doctorRoutes.js`)
- Admin routes → JWT authorization: guards routes (evidence: `routes/adminRoutes.js`)
- User routes → User workflows: dispatches (evidence: `routes/userRoutes.js`)
- Doctor routes → Doctor workflows: dispatches (evidence: `routes/doctorRoutes.js`)
- Admin routes → Admin workflows: dispatches (evidence: `routes/adminRoutes.js`)
- User workflows → User records: reads and writes (evidence: `controllers/userCtrl.js`)
- User workflows → Doctor records: reads and writes (evidence: `controllers/userCtrl.js`)
- User workflows → Appointment records: reads and writes (evidence: `controllers/userCtrl.js`)
- Doctor workflows → Appointment records: reads and writes (evidence: `controllers/doctorCtrl.js`)
- Doctor workflows → Doctor records: reads and writes (evidence: `controllers/doctorCtrl.js`)
- Doctor workflows → User records: reads and writes (evidence: `controllers/doctorCtrl.js`)
- Admin workflows → Doctor records: reads and writes (evidence: `controllers/adminCtrl.js`)
- Admin workflows → User records: reads and writes (evidence: `controllers/adminCtrl.js`)
- User records → MongoDB: stored in
- Doctor records → MongoDB: stored in
- Appointment records → MongoDB: stored in
