# chaitali-rao/clinic-booking-portal architecture

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

- Interactive diagram: https://gitdiagram.com/chaitali-rao/clinic-booking-portal
- Repository: https://github.com/chaitali-rao/clinic-booking-portal

## Overview

This is a doctor-appointment platform with a React client and an Express API backed by MongoDB. Patients register or sign in, browse doctors, check availability and booked slots, then book and manage appointments; doctors manage availability and appointment status, while admins manage platform records. The client also offers AI symptom-based specialty suggestions. The graph covers the documented routes and features, but several page and route implementations were not excerpted, so uncertain links are omitted.

Main entry points: [`doctor-appointment-frontend/src/App.js`](https://github.com/chaitali-rao/clinic-booking-portal/blob/master/doctor-appointment-frontend/src/App.js) (Route app), [`doctor-appointment-frontend/src/services/api.js`](https://github.com/chaitali-rao/clinic-booking-portal/blob/master/doctor-appointment-frontend/src/services/api.js) (HTTP client), [`server.js`](https://github.com/chaitali-rao/clinic-booking-portal/blob/master/server.js) (Express server), [`routes/appointmentRoutes.js`](https://github.com/chaitali-rao/clinic-booking-portal/blob/master/routes/appointmentRoutes.js) (Appointment routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["Route app<br/>[App.js]"]
  node_navbar["Navigation<br/>[Navbar.js]"]
  node_protected["Role guard<br/>[ProtectedRoute.jsx]"]
  node_login["Login<br/>[Login.js]"]
  node_register["Registration<br/>[Register.js]"]
  node_admin["Admin dashboard<br/>[Dashboard.js]"]
  node_find["Doctor search and booking<br/>[Doctors.js]"]
  node_myappointments["Patient appointments<br/>[MyAppointments.js]"]
  node_doctorview["Doctor dashboard<br/>[DoctorDashboard.js]"]
end

subgraph group_api["API and access"]
  node_api["HTTP client<br/>[api.js]"]
  node_server["Express server<br/>[server.js]"]
  node_authroutes["Authentication routes<br/>[authRoutes.js]"]
  node_doctorroutes["Doctor routes<br/>[doctorRoutes.js]"]
  node_appointmentroutes["Appointment routes"]
  node_airoutes["AI symptom route<br/>[aiRoutes.js]"]
  node_auth["JWT and role checks<br/>[authMiddleware.js]"]
end

subgraph group_domain["Care workflows"]
end

subgraph group_data["Persistence and integrations"]
  node_users[("User accounts<br/>[User.js]")]
  node_doctors[("Doctor profiles<br/>[Doctor.js]")]
  node_appointments[("Appointments<br/>[Appointment.js]")]
  node_dbconfig["Database connection<br/>[db.js]"]
end

node_user(("Patient, doctor, admin"))
node_mongodb[("MongoDB")]
node_gemini{{"Gemini API"}}

node_user -->|"uses"| node_app
node_app -->|"renders"| node_navbar
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_register
node_app -->|"routes to"| node_admin
node_app -->|"routes to"| node_find
node_app -->|"routes to"| node_myappointments
node_app -->|"routes to"| node_doctorview
node_app -->|"guards routes"| node_protected
node_login -->|"sends credentials"| node_api
node_register -->|"submits registration"| node_api
node_find -->|"requests doctors and slots"| node_api
node_myappointments -->|"manages appointments"| node_api
node_doctorview -->|"manages appointments"| node_api
node_admin -->|"requests data"| node_api
node_api -.->|"sends API requests"| node_server
node_server -->|"connects database"| node_dbconfig
node_server -->|"mounts routes"| node_authroutes
node_server -->|"mounts routes"| node_doctorroutes
node_server -->|"mounts routes"| node_appointmentroutes
node_server -->|"mounts routes"| node_airoutes
node_authroutes -->|"reads and writes"| node_users
node_authroutes -->|"creates profiles"| node_doctors
node_doctorroutes -->|"checks access"| node_auth
node_appointmentroutes -->|"checks access"| node_auth
node_airoutes -->|"checks access"| node_auth
node_doctorroutes -->|"reads and updates"| node_doctors
node_appointmentroutes -->|"reads and updates"| node_appointments
node_appointmentroutes -->|"looks up doctor"| node_doctors
node_dbconfig -->|"connects"| node_mongodb
node_airoutes -->|"requests suggestions"| node_gemini
node_find -->|"checks symptoms"| node_airoutes

click node_app "https://github.com/chaitali-rao/clinic-booking-portal/blob/master/doctor-appointment-frontend/src/App.js"
click node_navbar "https://github.com/chaitali-rao/clinic-booking-portal/blob/master/doctor-appointment-frontend/src/components/Navbar.js"
click node_protected "https://github.com/chaitali-rao/clinic-booking-portal/blob/master/doctor-appointment-frontend/src/components/ProtectedRoute.jsx"
click node_login "https://github.com/chaitali-rao/clinic-booking-portal/blob/master/doctor-appointment-frontend/src/pages/Login.js"
click node_register "https://github.com/chaitali-rao/clinic-booking-portal/blob/master/doctor-appointment-frontend/src/pages/Register.js"
click node_admin "https://github.com/chaitali-rao/clinic-booking-portal/blob/master/doctor-appointment-frontend/src/pages/Dashboard.js"
click node_find "https://github.com/chaitali-rao/clinic-booking-portal/blob/master/doctor-appointment-frontend/src/pages/Doctors.js"
click node_myappointments "https://github.com/chaitali-rao/clinic-booking-portal/blob/master/doctor-appointment-frontend/src/pages/MyAppointments.js"
click node_doctorview "https://github.com/chaitali-rao/clinic-booking-portal/blob/master/doctor-appointment-frontend/src/pages/DoctorDashboard.js"
click node_api "https://github.com/chaitali-rao/clinic-booking-portal/blob/master/doctor-appointment-frontend/src/services/api.js"
click node_server "https://github.com/chaitali-rao/clinic-booking-portal/blob/master/server.js"
click node_authroutes "https://github.com/chaitali-rao/clinic-booking-portal/blob/master/routes/authRoutes.js"
click node_doctorroutes "https://github.com/chaitali-rao/clinic-booking-portal/blob/master/routes/doctorRoutes.js"
click node_appointmentroutes "https://github.com/chaitali-rao/clinic-booking-portal/blob/master/routes/appointmentRoutes.js"
click node_airoutes "https://github.com/chaitali-rao/clinic-booking-portal/blob/master/routes/aiRoutes.js"
click node_auth "https://github.com/chaitali-rao/clinic-booking-portal/blob/master/middleware/authMiddleware.js"
click node_users "https://github.com/chaitali-rao/clinic-booking-portal/blob/master/models/User.js"
click node_doctors "https://github.com/chaitali-rao/clinic-booking-portal/blob/master/models/Doctor.js"
click node_appointments "https://github.com/chaitali-rao/clinic-booking-portal/blob/master/models/Appointment.js"
click node_dbconfig "https://github.com/chaitali-rao/clinic-booking-portal/blob/master/config/db.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_navbar,node_protected,node_login,node_register,node_admin,node_find,node_myappointments,node_doctorview toneBlue
class node_api,node_server,node_authroutes,node_doctorroutes,node_appointmentroutes,node_airoutes,node_auth,node_mongodb toneAmber
class node_users,node_doctors,node_appointments,node_dbconfig toneRose
class node_user toneIndigo
class node_gemini toneMint
```

## Components

### Web client

- [Route app](https://github.com/chaitali-rao/clinic-booking-portal/blob/master/doctor-appointment-frontend/src/App.js): `doctor-appointment-frontend/src/App.js`
- [Navigation](https://github.com/chaitali-rao/clinic-booking-portal/blob/master/doctor-appointment-frontend/src/components/Navbar.js): `doctor-appointment-frontend/src/components/Navbar.js`
- [Role guard](https://github.com/chaitali-rao/clinic-booking-portal/blob/master/doctor-appointment-frontend/src/components/ProtectedRoute.jsx): `doctor-appointment-frontend/src/components/ProtectedRoute.jsx`
- [Login](https://github.com/chaitali-rao/clinic-booking-portal/blob/master/doctor-appointment-frontend/src/pages/Login.js): `doctor-appointment-frontend/src/pages/Login.js`
- [Registration](https://github.com/chaitali-rao/clinic-booking-portal/blob/master/doctor-appointment-frontend/src/pages/Register.js): `doctor-appointment-frontend/src/pages/Register.js`
- [Admin dashboard](https://github.com/chaitali-rao/clinic-booking-portal/blob/master/doctor-appointment-frontend/src/pages/Dashboard.js): `doctor-appointment-frontend/src/pages/Dashboard.js`
- [Doctor search and booking](https://github.com/chaitali-rao/clinic-booking-portal/blob/master/doctor-appointment-frontend/src/pages/Doctors.js): `doctor-appointment-frontend/src/pages/Doctors.js`
- [Patient appointments](https://github.com/chaitali-rao/clinic-booking-portal/blob/master/doctor-appointment-frontend/src/pages/MyAppointments.js): `doctor-appointment-frontend/src/pages/MyAppointments.js`
- [Doctor dashboard](https://github.com/chaitali-rao/clinic-booking-portal/blob/master/doctor-appointment-frontend/src/pages/DoctorDashboard.js): `doctor-appointment-frontend/src/pages/DoctorDashboard.js`

### API and access

- [HTTP client](https://github.com/chaitali-rao/clinic-booking-portal/blob/master/doctor-appointment-frontend/src/services/api.js): `doctor-appointment-frontend/src/services/api.js`
- [Express server](https://github.com/chaitali-rao/clinic-booking-portal/blob/master/server.js): `server.js`
- [Authentication routes](https://github.com/chaitali-rao/clinic-booking-portal/blob/master/routes/authRoutes.js): `routes/authRoutes.js`
- [Doctor routes](https://github.com/chaitali-rao/clinic-booking-portal/blob/master/routes/doctorRoutes.js): `routes/doctorRoutes.js`
- [Appointment routes](https://github.com/chaitali-rao/clinic-booking-portal/blob/master/routes/appointmentRoutes.js): `routes/appointmentRoutes.js`
- [AI symptom route](https://github.com/chaitali-rao/clinic-booking-portal/blob/master/routes/aiRoutes.js): `routes/aiRoutes.js`
- [JWT and role checks](https://github.com/chaitali-rao/clinic-booking-portal/blob/master/middleware/authMiddleware.js): `middleware/authMiddleware.js`

### Persistence and integrations

- [User accounts](https://github.com/chaitali-rao/clinic-booking-portal/blob/master/models/User.js): `models/User.js`
- [Doctor profiles](https://github.com/chaitali-rao/clinic-booking-portal/blob/master/models/Doctor.js): `models/Doctor.js`
- [Appointments](https://github.com/chaitali-rao/clinic-booking-portal/blob/master/models/Appointment.js): `models/Appointment.js`
- [Database connection](https://github.com/chaitali-rao/clinic-booking-portal/blob/master/config/db.js): `config/db.js`

### Other components

- **Patient, doctor, admin**
- **MongoDB**
- **Gemini API**

## Connections

- Patient, doctor, admin → Route app: uses
- Route app → Navigation: renders (evidence: `doctor-appointment-frontend/src/App.js`)
- Route app → Login: routes to (evidence: `doctor-appointment-frontend/src/App.js`)
- Route app → Registration: routes to (evidence: `doctor-appointment-frontend/src/App.js`)
- Route app → Admin dashboard: routes to (evidence: `doctor-appointment-frontend/src/App.js`)
- Route app → Doctor search and booking: routes to (evidence: `doctor-appointment-frontend/src/App.js`)
- Route app → Patient appointments: routes to (evidence: `doctor-appointment-frontend/src/App.js`)
- Route app → Doctor dashboard: routes to (evidence: `doctor-appointment-frontend/src/App.js`)
- Route app → Role guard: guards routes (evidence: `doctor-appointment-frontend/src/App.js`)
- Login → HTTP client: sends credentials (evidence: `doctor-appointment-frontend/src/pages/Login.js`)
- Registration → HTTP client: submits registration (evidence: `doctor-appointment-frontend/src/pages/Register.js`)
- Doctor search and booking → HTTP client: requests doctors and slots (evidence: `doctor-appointment-frontend/src/pages/Doctors.js`)
- Patient appointments → HTTP client: manages appointments (evidence: `doctor-appointment-frontend/src/pages/MyAppointments.js`)
- Doctor dashboard → HTTP client: manages appointments (evidence: `doctor-appointment-frontend/src/pages/DoctorDashboard.js`)
- Admin dashboard → HTTP client: requests data (evidence: `doctor-appointment-frontend/src/pages/Dashboard.js`)
- HTTP client → Express server: sends API requests
- Express server → Database connection: connects database (evidence: `server.js`)
- Express server → Authentication routes: mounts routes (evidence: `server.js`)
- Express server → Doctor routes: mounts routes (evidence: `server.js`)
- Express server → Appointment routes: mounts routes (evidence: `server.js`)
- Express server → AI symptom route: mounts routes (evidence: `server.js`)
- Authentication routes → User accounts: reads and writes (evidence: `routes/authRoutes.js`)
- Authentication routes → Doctor profiles: creates profiles (evidence: `routes/authRoutes.js`)
- Doctor routes → JWT and role checks: checks access (evidence: `routes/doctorRoutes.js`)
- Appointment routes → JWT and role checks: checks access (evidence: `routes/appointmentRoutes.js`)
- AI symptom route → JWT and role checks: checks access (evidence: `routes/aiRoutes.js`)
- Doctor routes → Doctor profiles: reads and updates (evidence: `routes/doctorRoutes.js`)
- Appointment routes → Appointments: reads and updates (evidence: `routes/appointmentRoutes.js`)
- Appointment routes → Doctor profiles: looks up doctor (evidence: `routes/appointmentRoutes.js`)
- Database connection → MongoDB: connects (evidence: `config/db.js`)
- AI symptom route → Gemini API: requests suggestions (evidence: `routes/aiRoutes.js`)
- Doctor search and booking → AI symptom route: checks symptoms (evidence: `doctor-appointment-frontend/src/pages/Doctors.js`)
