# sinaremanav/kalpana-multispeciality-dental-hospital architecture

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

- Interactive diagram: https://gitdiagram.com/sinaremanav/kalpana-multispeciality-dental-hospital
- Repository: https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital

## Overview

Kalpana Dental Clinic is a patient-facing dental clinic website paired with an admin and doctor management portal. Patients browse clinic information, submit appointments or inquiries, and contact the clinic; staff authenticate, review bookings and messages, and manage clinic content. The frontend uses modular data services and Supabase, while the Express backend exposes API and authentication routes. The README documents capabilities whose source was not sampled; those are represented at subsystem level where exact implementation paths are unavailable.

Main entry points: [`frontend/src/App.jsx`](https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/frontend/src/App.jsx) (Route Application), [`frontend/src/lib/supabaseClient.js`](https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/frontend/src/lib/supabaseClient.js) (Supabase Client), [`frontend/src/pages`](https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/tree/main/frontend/src/pages) (Clinic Pages), [`frontend/src/admin/pages`](https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/tree/main/frontend/src/admin/pages) (Content Managers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Patient Portal"]
  node_app["Route Application<br/>[App.jsx]"]
  node_public_pages["Clinic Pages"]
  node_appointment_page["Appointment Booking<br/>[Appointment.jsx]"]
  node_contact_page["Contact Inquiry<br/>[Contact.jsx]"]
  node_public_components["Public Components"]
end

subgraph group_admin["Admin Portal"]
  node_auth_context["Session and Roles<br/>[AuthContext.jsx]"]
  node_admin_routes["Admin Routes<br/>[App.jsx]"]
  node_admin_managers["Content Managers"]
  node_admin_dashboard["Admin Dashboard<br/>[Dashboard.jsx]"]
  node_admin_widgets["Admin UI Components"]
end

subgraph group_data["Data Services"]
  node_appointment_service["Appointment Service"]
  node_contact_service["Contact Service<br/>[contactService.js]"]
  node_content_services["Content Services"]
  node_auth_service["Authentication Service<br/>[authService.js]"]
  node_storage_service["Image Storage Service<br/>[storageService.js]"]
  node_supabase_client["Supabase Client<br/>[supabaseClient.js]"]
end

subgraph group_backend["Backend API"]
  node_express["Express Server<br/>[server.js]"]
  node_api_routes["API Routes<br/>[api.js]"]
  node_auth_routes["Backend Auth Routes<br/>[auth.js]"]
  node_backend_supabase["Backend Supabase Client<br/>[supabase.js]"]
  node_fallback_data["Fallback Data<br/>[index.js]"]
end

node_patient(("Patients"))
node_staff(("Clinic Staff"))
node_supabase[("Supabase")]

node_patient -->|"opens site"| node_app
node_staff -->|"opens portal"| node_app
node_app -->|"routes to"| node_public_pages
node_app -->|"routes to"| node_admin_routes
node_public_pages -.->|"books through"| node_appointment_page
node_public_pages -.->|"sends inquiries"| node_contact_page
node_app -->|"renders shared UI"| node_public_components
node_appointment_page -.->|"submits booking"| node_appointment_service
node_contact_page -.->|"submits inquiry"| node_contact_service
node_appointment_service -->|"uses client"| node_supabase_client
node_contact_service -.->|"uses client"| node_supabase_client
node_supabase_client -->|"connects to"| node_supabase
node_admin_routes -->|"routes to"| node_admin_managers
node_admin_routes -->|"routes to"| node_admin_dashboard
node_admin_routes -->|"provides auth"| node_auth_context
node_auth_context -->|"uses service"| node_auth_service
node_auth_service -->|"uses client"| node_supabase_client
node_admin_managers -.->|"manages clinic data"| node_content_services
node_admin_managers -->|"uses management UI"| node_admin_widgets
node_admin_widgets -->|"uploads images"| node_storage_service
node_storage_service -->|"uses client"| node_supabase_client
node_express -->|"registers routes"| node_api_routes
node_express -->|"registers routes"| node_auth_routes
node_api_routes -->|"uses client"| node_backend_supabase
node_api_routes -->|"loads fallback data"| node_fallback_data
node_auth_routes -->|"uses client"| node_backend_supabase
node_backend_supabase -.->|"connects to"| node_supabase

click node_app "https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/frontend/src/App.jsx"
click node_public_pages "https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/tree/main/frontend/src/pages"
click node_appointment_page "https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/frontend/src/pages/Appointment.jsx"
click node_contact_page "https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/frontend/src/pages/Contact.jsx"
click node_public_components "https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/tree/main/frontend/src/components"
click node_auth_context "https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/frontend/src/admin/context/AuthContext.jsx"
click node_admin_routes "https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/frontend/src/App.jsx"
click node_admin_managers "https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/tree/main/frontend/src/admin/pages"
click node_admin_dashboard "https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/frontend/src/admin/pages/Dashboard.jsx"
click node_admin_widgets "https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/tree/main/frontend/src/admin/components"
click node_appointment_service "https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/frontend/src/services/appointmentService.js"
click node_contact_service "https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/frontend/src/services/contactService.js"
click node_content_services "https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/tree/main/frontend/src/services"
click node_auth_service "https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/frontend/src/services/authService.js"
click node_storage_service "https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/frontend/src/services/storageService.js"
click node_supabase_client "https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/frontend/src/lib/supabaseClient.js"
click node_express "https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/backend/server.js"
click node_api_routes "https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/backend/routes/api.js"
click node_auth_routes "https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/backend/routes/auth.js"
click node_backend_supabase "https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/backend/lib/supabase.js"
click node_fallback_data "https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/backend/data/index.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_public_pages,node_appointment_page,node_contact_page,node_public_components toneBlue
class node_auth_context,node_admin_routes,node_admin_managers,node_admin_dashboard,node_admin_widgets,node_supabase toneAmber
class node_appointment_service,node_contact_service,node_content_services,node_auth_service,node_storage_service,node_supabase_client toneMint
class node_express,node_api_routes,node_auth_routes,node_backend_supabase,node_fallback_data toneRose
class node_patient,node_staff toneIndigo
```

## Components

### Patient Portal

- [Route Application](https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Clinic Pages](https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/tree/main/frontend/src/pages): `frontend/src/pages`
- [Appointment Booking](https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/frontend/src/pages/Appointment.jsx): `frontend/src/pages/Appointment.jsx`
- [Contact Inquiry](https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/frontend/src/pages/Contact.jsx): `frontend/src/pages/Contact.jsx`
- [Public Components](https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/tree/main/frontend/src/components): `frontend/src/components`

### Admin Portal

- [Session and Roles](https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/frontend/src/admin/context/AuthContext.jsx): `frontend/src/admin/context/AuthContext.jsx`
- [Admin Routes](https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Content Managers](https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/tree/main/frontend/src/admin/pages): `frontend/src/admin/pages`
- [Admin Dashboard](https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/frontend/src/admin/pages/Dashboard.jsx): `frontend/src/admin/pages/Dashboard.jsx`
- [Admin UI Components](https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/tree/main/frontend/src/admin/components): `frontend/src/admin/components`

### Data Services

- [Appointment Service](https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/frontend/src/services/appointmentService.js): `frontend/src/services/appointmentService.js`
- [Contact Service](https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/frontend/src/services/contactService.js): `frontend/src/services/contactService.js`
- [Content Services](https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/tree/main/frontend/src/services): `frontend/src/services`
- [Authentication Service](https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/frontend/src/services/authService.js): `frontend/src/services/authService.js`
- [Image Storage Service](https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/frontend/src/services/storageService.js): `frontend/src/services/storageService.js`
- [Supabase Client](https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/frontend/src/lib/supabaseClient.js): `frontend/src/lib/supabaseClient.js`

### Backend API

- [Express Server](https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/backend/server.js): `backend/server.js`
- [API Routes](https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/backend/routes/api.js): `backend/routes/api.js`
- [Backend Auth Routes](https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/backend/routes/auth.js): `backend/routes/auth.js`
- [Backend Supabase Client](https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/backend/lib/supabase.js): `backend/lib/supabase.js`
- [Fallback Data](https://github.com/sinaremanav/kalpana-multispeciality-dental-hospital/blob/main/backend/data/index.js): `backend/data/index.js`

### Other components

- **Patients**
- **Clinic Staff**
- **Supabase**

## Connections

- Patients → Route Application: opens site (evidence: `README.md`)
- Clinic Staff → Route Application: opens portal (evidence: `README.md`)
- Route Application → Clinic Pages: routes to (evidence: `frontend/src/App.jsx`)
- Route Application → Admin Routes: routes to (evidence: `frontend/src/App.jsx`)
- Clinic Pages → Appointment Booking: books through (evidence: `README.md`)
- Clinic Pages → Contact Inquiry: sends inquiries (evidence: `README.md`)
- Route Application → Public Components: renders shared UI (evidence: `frontend/src/App.jsx`)
- Appointment Booking → Appointment Service: submits booking (evidence: `README.md`)
- Contact Inquiry → Contact Service: submits inquiry (evidence: `README.md`)
- Appointment Service → Supabase Client: uses client (evidence: `frontend/src/services/appointmentService.js`)
- Contact Service → Supabase Client: uses client (evidence: `README.md`)
- Supabase Client → Supabase: connects to (evidence: `README.md`)
- Admin Routes → Content Managers: routes to (evidence: `frontend/src/App.jsx`)
- Admin Routes → Admin Dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Admin Routes → Session and Roles: provides auth (evidence: `frontend/src/App.jsx`)
- Session and Roles → Authentication Service: uses service (evidence: `frontend/src/admin/context/AuthContext.jsx`)
- Authentication Service → Supabase Client: uses client (evidence: `frontend/src/services/authService.js`)
- Content Managers → Content Services: manages clinic data (evidence: `README.md`)
- Content Managers → Admin UI Components: uses management UI (evidence: `frontend/src/admin/pages/DoctorsManager.jsx`)
- Admin UI Components → Image Storage Service: uploads images (evidence: `frontend/src/admin/components/ImageUploader.jsx`)
- Image Storage Service → Supabase Client: uses client (evidence: `frontend/src/services/storageService.js`)
- Express Server → API Routes: registers routes (evidence: `backend/server.js`)
- Express Server → Backend Auth Routes: registers routes (evidence: `backend/server.js`)
- API Routes → Backend Supabase Client: uses client (evidence: `backend/routes/api.js`)
- API Routes → Fallback Data: loads fallback data (evidence: `backend/routes/api.js`)
- Backend Auth Routes → Backend Supabase Client: uses client (evidence: `backend/routes/auth.js`)
- Backend Supabase Client → Supabase: connects to (evidence: `README.md`)
