# desai1611/xs-hair-beauty architecture

> Architecture diagram of the GitHub repository desai1611/xs-hair-beauty, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/desai1611/xs-hair-beauty
- Repository: https://github.com/desai1611/xs-hair-beauty

## Overview

XS Hair & Beauty is a salon website with a public service/product/review experience, enquiry booking, and a JWT-protected admin dashboard. Visitors browse database-backed content and submit an enquiry; the backend persists it and attempts email notifications. Admins manage bookings and salon content through the dashboard. The graph combines sampled routing, booking, and content-fetch code with capabilities explicitly documented in the README; unsampled implementation details are not inferred beyond those documented relationships.

Main entry points: [`backend/src/app.js`](https://github.com/desai1611/xs-hair-beauty/blob/main/backend/src/app.js) (HTTP application), [`frontend/src/api/client.js`](https://github.com/desai1611/xs-hair-beauty/blob/main/frontend/src/api/client.js) (API client), [`backend/src/routes`](https://github.com/desai1611/xs-hair-beauty/tree/main/backend/src/routes) (Content routes), [`backend/src/routes/bookingRoutes.js`](https://github.com/desai1611/xs-hair-beauty/blob/main/backend/src/routes/bookingRoutes.js) (Booking routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public website"]
  node_publicpages["Public pages"]
  node_bookingform["Booking form<br/>[Contact.jsx]"]
  node_fetch["Content fetching<br/>[useFetch.js]"]
  node_apiclient["API client<br/>[client.js]"]
end

subgraph group_admin["Admin dashboard"]
  node_adminroutes["Admin screens"]
  node_resourceui["Resource manager"]
  node_authcontext["Admin authentication<br/>[AuthContext.jsx]"]
end

subgraph group_api["REST API"]
  node_app["HTTP application<br/>[app.js]"]
  node_authroutes["Authentication routes<br/>[authRoutes.js]"]
  node_bookingroutes["Booking routes<br/>[bookingRoutes.js]"]
  node_contentroutes["Content routes"]
  node_uploadroutes["Upload routes<br/>[uploadRoutes.js]"]
  node_bookinglogic["Booking handling"]
  node_reviewlogic["Review handling"]
  node_servicecontent["Content controllers"]
  node_authmiddleware["JWT protection<br/>[auth.js]"]
  node_uploads["Image upload<br/>[upload.js]"]
end

subgraph group_data["Persistence and messaging"]
  node_mongodb[("MongoDB records")]
  node_mailer["Email notifications<br/>[mailer.js]"]
end

node_visitor(("Visitor"))
node_adminuser(("Admin user"))
node_emailservice["Email service"]

node_visitor -->|"browses"| node_publicpages
node_visitor -.->|"submits enquiry"| node_bookingform
node_publicpages -->|"loads content"| node_fetch
node_fetch -->|"requests data"| node_apiclient
node_bookingform -.->|"sends enquiry"| node_apiclient
node_adminuser -->|"manages salon"| node_adminroutes
node_adminroutes -->|"uses CRUD UI"| node_resourceui
node_resourceui -->|"sends CRUD requests"| node_apiclient
node_authcontext -->|"uses API"| node_apiclient
node_apiclient -.->|"calls REST API"| node_app
node_app -->|"mounts"| node_authroutes
node_app -->|"mounts"| node_bookingroutes
node_app -->|"mounts"| node_contentroutes
node_app -->|"mounts"| node_uploadroutes
node_bookingroutes -->|"routes requests"| node_bookinglogic
node_contentroutes -.->|"routes content requests"| node_servicecontent
node_contentroutes -->|"routes review requests"| node_reviewlogic
node_bookingroutes -->|"protects admin routes"| node_authmiddleware
node_contentroutes -.->|"protects admin routes"| node_authmiddleware
node_uploadroutes -->|"protects uploads"| node_authmiddleware
node_uploadroutes -->|"handles files"| node_uploads
node_bookinglogic -->|"stores bookings"| node_mongodb
node_bookinglogic -->|"requests notifications"| node_mailer
node_mailer -.->|"sends email"| node_emailservice
node_reviewlogic -->|"reads and writes reviews"| node_mongodb
node_servicecontent -.->|"reads and writes content"| node_mongodb

click node_publicpages "https://github.com/desai1611/xs-hair-beauty/tree/main/frontend/src/pages"
click node_bookingform "https://github.com/desai1611/xs-hair-beauty/blob/main/frontend/src/pages/Contact.jsx"
click node_fetch "https://github.com/desai1611/xs-hair-beauty/blob/main/frontend/src/hooks/useFetch.js"
click node_apiclient "https://github.com/desai1611/xs-hair-beauty/blob/main/frontend/src/api/client.js"
click node_adminroutes "https://github.com/desai1611/xs-hair-beauty/tree/main/frontend/src/pages/admin"
click node_resourceui "https://github.com/desai1611/xs-hair-beauty/blob/main/frontend/src/components/admin/ResourceManager.jsx"
click node_authcontext "https://github.com/desai1611/xs-hair-beauty/blob/main/frontend/src/context/AuthContext.jsx"
click node_app "https://github.com/desai1611/xs-hair-beauty/blob/main/backend/src/app.js"
click node_authroutes "https://github.com/desai1611/xs-hair-beauty/blob/main/backend/src/routes/authRoutes.js"
click node_bookingroutes "https://github.com/desai1611/xs-hair-beauty/blob/main/backend/src/routes/bookingRoutes.js"
click node_contentroutes "https://github.com/desai1611/xs-hair-beauty/tree/main/backend/src/routes"
click node_uploadroutes "https://github.com/desai1611/xs-hair-beauty/blob/main/backend/src/routes/uploadRoutes.js"
click node_bookinglogic "https://github.com/desai1611/xs-hair-beauty/blob/main/backend/src/controllers/bookingController.js"
click node_reviewlogic "https://github.com/desai1611/xs-hair-beauty/blob/main/backend/src/controllers/reviewController.js"
click node_servicecontent "https://github.com/desai1611/xs-hair-beauty/tree/main/backend/src/controllers"
click node_authmiddleware "https://github.com/desai1611/xs-hair-beauty/blob/main/backend/src/middleware/auth.js"
click node_uploads "https://github.com/desai1611/xs-hair-beauty/blob/main/backend/src/middleware/upload.js"
click node_mongodb "https://github.com/desai1611/xs-hair-beauty/tree/main/backend/src/models"
click node_mailer "https://github.com/desai1611/xs-hair-beauty/blob/main/backend/src/utils/mailer.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_publicpages,node_bookingform,node_fetch,node_apiclient,node_adminuser toneBlue
class node_adminroutes,node_resourceui,node_authcontext toneAmber
class node_app,node_authroutes,node_bookingroutes,node_contentroutes,node_uploadroutes,node_bookinglogic,node_reviewlogic,node_servicecontent,node_authmiddleware,node_uploads toneMint
class node_mongodb,node_mailer toneRose
class node_visitor,node_emailservice toneIndigo
```

## Components

### Public website

- [Public pages](https://github.com/desai1611/xs-hair-beauty/tree/main/frontend/src/pages): `frontend/src/pages`
- [Booking form](https://github.com/desai1611/xs-hair-beauty/blob/main/frontend/src/pages/Contact.jsx): `frontend/src/pages/Contact.jsx`
- [Content fetching](https://github.com/desai1611/xs-hair-beauty/blob/main/frontend/src/hooks/useFetch.js): `frontend/src/hooks/useFetch.js`
- [API client](https://github.com/desai1611/xs-hair-beauty/blob/main/frontend/src/api/client.js): `frontend/src/api/client.js`

### Admin dashboard

- [Admin screens](https://github.com/desai1611/xs-hair-beauty/tree/main/frontend/src/pages/admin): `frontend/src/pages/admin`
- [Resource manager](https://github.com/desai1611/xs-hair-beauty/blob/main/frontend/src/components/admin/ResourceManager.jsx): `frontend/src/components/admin/ResourceManager.jsx`
- [Admin authentication](https://github.com/desai1611/xs-hair-beauty/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`

### REST API

- [HTTP application](https://github.com/desai1611/xs-hair-beauty/blob/main/backend/src/app.js): `backend/src/app.js`
- [Authentication routes](https://github.com/desai1611/xs-hair-beauty/blob/main/backend/src/routes/authRoutes.js): `backend/src/routes/authRoutes.js`
- [Booking routes](https://github.com/desai1611/xs-hair-beauty/blob/main/backend/src/routes/bookingRoutes.js): `backend/src/routes/bookingRoutes.js`
- [Content routes](https://github.com/desai1611/xs-hair-beauty/tree/main/backend/src/routes): `backend/src/routes`
- [Upload routes](https://github.com/desai1611/xs-hair-beauty/blob/main/backend/src/routes/uploadRoutes.js): `backend/src/routes/uploadRoutes.js`
- [Booking handling](https://github.com/desai1611/xs-hair-beauty/blob/main/backend/src/controllers/bookingController.js): `backend/src/controllers/bookingController.js`
- [Review handling](https://github.com/desai1611/xs-hair-beauty/blob/main/backend/src/controllers/reviewController.js): `backend/src/controllers/reviewController.js`
- [Content controllers](https://github.com/desai1611/xs-hair-beauty/tree/main/backend/src/controllers): `backend/src/controllers`
- [JWT protection](https://github.com/desai1611/xs-hair-beauty/blob/main/backend/src/middleware/auth.js): `backend/src/middleware/auth.js`
- [Image upload](https://github.com/desai1611/xs-hair-beauty/blob/main/backend/src/middleware/upload.js): `backend/src/middleware/upload.js`

### Persistence and messaging

- [MongoDB records](https://github.com/desai1611/xs-hair-beauty/tree/main/backend/src/models): `backend/src/models`
- [Email notifications](https://github.com/desai1611/xs-hair-beauty/blob/main/backend/src/utils/mailer.js): `backend/src/utils/mailer.js`

### Other components

- **Visitor**
- **Admin user**
- **Email service**

## Connections

- Visitor → Public pages: browses
- Visitor → Booking form: submits enquiry (evidence: `README.md`)
- Public pages → Content fetching: loads content (evidence: `frontend/src/pages/BeautyServices.jsx`)
- Content fetching → API client: requests data (evidence: `frontend/src/hooks/useFetch.js`)
- Booking form → API client: sends enquiry (evidence: `README.md`)
- Admin user → Admin screens: manages salon
- Admin screens → Resource manager: uses CRUD UI (evidence: `frontend/src/pages/admin/ReviewsPanel.jsx`)
- Resource manager → API client: sends CRUD requests (evidence: `frontend/src/components/admin/ResourceManager.jsx`)
- Admin authentication → API client: uses API (evidence: `frontend/src/context/AuthContext.jsx`)
- API client → HTTP application: calls REST API (evidence: `README.md`)
- HTTP application → Authentication routes: mounts (evidence: `backend/src/app.js`)
- HTTP application → Booking routes: mounts (evidence: `backend/src/app.js`)
- HTTP application → Content routes: mounts (evidence: `backend/src/app.js`)
- HTTP application → Upload routes: mounts (evidence: `backend/src/app.js`)
- Booking routes → Booking handling: routes requests (evidence: `backend/src/routes/bookingRoutes.js`)
- Content routes → Content controllers: routes content requests (evidence: `backend/src/routes/reviewRoutes.js`)
- Content routes → Review handling: routes review requests (evidence: `backend/src/routes/reviewRoutes.js`)
- Booking routes → JWT protection: protects admin routes (evidence: `backend/src/routes/bookingRoutes.js`)
- Content routes → JWT protection: protects admin routes (evidence: `backend/src/routes/reviewRoutes.js`)
- Upload routes → JWT protection: protects uploads (evidence: `backend/src/routes/uploadRoutes.js`)
- Upload routes → Image upload: handles files (evidence: `backend/src/routes/uploadRoutes.js`)
- Booking handling → MongoDB records: stores bookings (evidence: `backend/src/controllers/bookingController.js`)
- Booking handling → Email notifications: requests notifications (evidence: `backend/src/controllers/bookingController.js`)
- Email notifications → Email service: sends email (evidence: `README.md`)
- Review handling → MongoDB records: reads and writes reviews (evidence: `backend/src/controllers/reviewController.js`)
- Content controllers → MongoDB records: reads and writes content (evidence: `backend/src/controllers/reviewController.js`)
