# developerwlm/whitehouse_finalcomplete_mathesh1 architecture

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

- Interactive diagram: https://gitdiagram.com/developerwlm/whitehouse_finalcomplete_mathesh1
- Repository: https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1

## Overview

Whitehouse is a course-provider website with a CMS-backed public site and a separate admin panel. Visitors browse courses, FAQs, and blogs, and can submit enquiries; administrators sign in to manage content, profile details, uploads, and enquiries. The backend serves both interfaces, stores CMS records in MongoDB, and integrates with email, Google Sheets, and Cloudinary. The README provides no architecture details, so unsampled relationships are omitted; the graph uses source-index references and the shown API calls/routes.

Main entry points: [`backend/src/routes/admin.js`](https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/backend/src/routes/admin.js) (Admin endpoints), [`backend/src/routes/public.js`](https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/backend/src/routes/public.js) (Public endpoints), [`admin/src/api/client.js`](https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/admin/src/api/client.js) (Admin API client), [`client/src/App.jsx`](https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/client/src/App.jsx) (Site routes and pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public website"]
  node_site["Site routes and pages<br/>[App.jsx]"]
  node_course_catalog["Course catalog<br/>[courses.js]"]
  node_site_effects["Site interactions<br/>[useSiteEffects.js]"]
  node_public_api_client["Public API client<br/>[api.js]"]
  node_enquiry_form["Enquiry capture<br/>[EnquiryForm.jsx]"]
  node_home_popup["Home enquiry popup"]
  node_public_pages["Content pages"]
end

subgraph group_admin["Admin CMS"]
  node_admin_app["Admin routes<br/>[App.jsx]"]
  node_admin_auth["Admin sessions<br/>[AuthContext.jsx]"]
  node_admin_api["Admin API client<br/>[client.js]"]
  node_admin_content["Content management"]
  node_admin_uploads["Image uploads"]
  node_admin_enquiries["Enquiry management<br/>[Enquiries.jsx]"]
end

subgraph group_backend["API and domain"]
  node_api_server["HTTP server and routing<br/>[server.js]"]
  node_public_routes["Public endpoints<br/>[public.js]"]
  node_admin_routes["Admin endpoints<br/>[admin.js]"]
  node_auth_middleware["JWT authorization<br/>[auth.js]"]
  node_crud["Resource operations<br/>[crud.js]"]
  node_content_models[("CMS records")]
  node_database[("MongoDB<br/>[db.js]")]
  node_sheet_adapter["Sheet adapter<br/>[sheets.js]"]
  node_mailer["Email delivery<br/>[mailer.js]"]
  node_cloudinary_adapter["Image storage adapter<br/>[cloudinary.js]"]
end

subgraph group_integrations["External services"]
  node_google_sheets[("Google Sheets")]
  node_email_service["Email service"]
  node_cloudinary["Cloudinary"]
end

node_visitor(("Visitor"))
node_admin_user(("Administrator"))

node_visitor -->|"browses"| node_site
node_site -->|"routes to"| node_public_pages
node_site -->|"renders"| node_home_popup
node_site -->|"invokes"| node_site_effects
node_public_pages -->|"uses catalog"| node_course_catalog
node_public_pages -->|"requests content"| node_public_api_client
node_home_popup -->|"submits enquiry"| node_public_api_client
node_enquiry_form -.->|"submits enquiry"| node_public_api_client
node_admin_user -->|"uses"| node_admin_app
node_admin_app -->|"provides session"| node_admin_auth
node_admin_app -->|"routes to"| node_admin_content
node_admin_auth -->|"calls"| node_admin_api
node_admin_content -.->|"requests resources"| node_admin_api
node_admin_uploads -->|"uploads image"| node_admin_api
node_admin_enquiries -.->|"loads enquiries"| node_admin_api
node_api_server -->|"mounts"| node_public_routes
node_api_server -->|"mounts"| node_admin_routes
node_public_api_client -->|"calls endpoints"| node_public_routes
node_admin_api -->|"calls endpoints"| node_admin_routes
node_public_routes -->|"queries"| node_content_models
node_public_routes -->|"uses resource operations"| node_crud
node_admin_routes -->|"manages records"| node_content_models
node_admin_routes -->|"uses resource operations"| node_crud
node_admin_routes -->|"requires authorization"| node_auth_middleware
node_admin_routes -->|"reads enquiries"| node_sheet_adapter
node_admin_routes -->|"uploads images"| node_cloudinary_adapter
node_public_routes -->|"records enquiries"| node_sheet_adapter
node_public_routes -->|"sends enquiry email"| node_mailer
node_api_server -->|"connects"| node_database
node_sheet_adapter -->|"reads and writes"| node_google_sheets
node_mailer -.->|"delivers mail"| node_email_service
node_cloudinary_adapter -.->|"stores images"| node_cloudinary

click node_site "https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/client/src/App.jsx"
click node_course_catalog "https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/client/src/data/courses.js"
click node_site_effects "https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/client/src/hooks/useSiteEffects.js"
click node_public_api_client "https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/client/src/services/api.js"
click node_enquiry_form "https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/client/src/components/EnquiryForm.jsx"
click node_home_popup "https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/client/src/components/HomeEnquiryPopup.jsx"
click node_public_pages "https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/tree/main/client/src/pages"
click node_admin_app "https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/admin/src/App.jsx"
click node_admin_auth "https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/admin/src/context/AuthContext.jsx"
click node_admin_api "https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/admin/src/api/client.js"
click node_admin_content "https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/tree/main/admin/src/pages"
click node_admin_uploads "https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/admin/src/components/ImageUploadField.jsx"
click node_admin_enquiries "https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/admin/src/pages/Enquiries.jsx"
click node_api_server "https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/backend/server.js"
click node_public_routes "https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/backend/src/routes/public.js"
click node_admin_routes "https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/backend/src/routes/admin.js"
click node_auth_middleware "https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/backend/src/middleware/auth.js"
click node_crud "https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/backend/src/utils/crud.js"
click node_content_models "https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/tree/main/backend/src/models"
click node_database "https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/backend/src/db.js"
click node_sheet_adapter "https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/backend/src/utils/sheets.js"
click node_mailer "https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/backend/src/utils/mailer.js"
click node_cloudinary_adapter "https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/backend/src/utils/cloudinary.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_site,node_course_catalog,node_site_effects,node_public_api_client,node_enquiry_form,node_home_popup,node_public_pages toneBlue
class node_admin_app,node_admin_auth,node_admin_api,node_admin_content,node_admin_uploads,node_admin_enquiries toneAmber
class node_api_server,node_public_routes,node_admin_routes,node_auth_middleware,node_crud,node_content_models,node_database,node_sheet_adapter,node_mailer,node_cloudinary_adapter toneMint
class node_google_sheets,node_email_service,node_cloudinary toneRose
class node_visitor,node_admin_user toneIndigo
```

## Components

### Public website

- [Site routes and pages](https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Course catalog](https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/client/src/data/courses.js): `client/src/data/courses.js`
- [Site interactions](https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/client/src/hooks/useSiteEffects.js): `client/src/hooks/useSiteEffects.js`
- [Public API client](https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/client/src/services/api.js): `client/src/services/api.js`
- [Enquiry capture](https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/client/src/components/EnquiryForm.jsx): `client/src/components/EnquiryForm.jsx`
- [Home enquiry popup](https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/client/src/components/HomeEnquiryPopup.jsx): `client/src/components/HomeEnquiryPopup.jsx`
- [Content pages](https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/tree/main/client/src/pages): `client/src/pages`

### Admin CMS

- [Admin routes](https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/admin/src/App.jsx): `admin/src/App.jsx`
- [Admin sessions](https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/admin/src/context/AuthContext.jsx): `admin/src/context/AuthContext.jsx`
- [Admin API client](https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/admin/src/api/client.js): `admin/src/api/client.js`
- [Content management](https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/tree/main/admin/src/pages): `admin/src/pages`
- [Image uploads](https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/admin/src/components/ImageUploadField.jsx): `admin/src/components/ImageUploadField.jsx`
- [Enquiry management](https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/admin/src/pages/Enquiries.jsx): `admin/src/pages/Enquiries.jsx`

### API and domain

- [HTTP server and routing](https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/backend/server.js): `backend/server.js`
- [Public endpoints](https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/backend/src/routes/public.js): `backend/src/routes/public.js`
- [Admin endpoints](https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/backend/src/routes/admin.js): `backend/src/routes/admin.js`
- [JWT authorization](https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/backend/src/middleware/auth.js): `backend/src/middleware/auth.js`
- [Resource operations](https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/backend/src/utils/crud.js): `backend/src/utils/crud.js`
- [CMS records](https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/tree/main/backend/src/models): `backend/src/models`
- [MongoDB](https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/backend/src/db.js): `backend/src/db.js`
- [Sheet adapter](https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/backend/src/utils/sheets.js): `backend/src/utils/sheets.js`
- [Email delivery](https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/backend/src/utils/mailer.js): `backend/src/utils/mailer.js`
- [Image storage adapter](https://github.com/developerwlm/whitehouse_finalcomplete_mathesh1/blob/main/backend/src/utils/cloudinary.js): `backend/src/utils/cloudinary.js`

### External services

- **Google Sheets**
- **Email service**
- **Cloudinary**

### Other components

- **Visitor**
- **Administrator**

## Connections

- Visitor → Site routes and pages: browses (evidence: `client/src/App.jsx`)
- Site routes and pages → Content pages: routes to (evidence: `client/src/App.jsx`)
- Site routes and pages → Home enquiry popup: renders (evidence: `client/src/App.jsx`)
- Site routes and pages → Site interactions: invokes (evidence: `client/src/App.jsx`)
- Content pages → Course catalog: uses catalog (evidence: `client/src/pages/CourseDetails.jsx`)
- Content pages → Public API client: requests content (evidence: `client/src/pages/Home.jsx`)
- Home enquiry popup → Public API client: submits enquiry (evidence: `client/src/components/HomeEnquiryPopup.jsx`)
- Enquiry capture → Public API client: submits enquiry
- Administrator → Admin routes: uses (evidence: `admin/src/App.jsx`)
- Admin routes → Admin sessions: provides session (evidence: `admin/src/App.jsx`)
- Admin routes → Content management: routes to (evidence: `admin/src/App.jsx`)
- Admin sessions → Admin API client: calls (evidence: `admin/src/context/AuthContext.jsx`)
- Content management → Admin API client: requests resources (evidence: `admin/src/pages/CourseForm.jsx`)
- Image uploads → Admin API client: uploads image (evidence: `admin/src/components/ImageUploadField.jsx`)
- Enquiry management → Admin API client: loads enquiries
- HTTP server and routing → Public endpoints: mounts (evidence: `backend/server.js`)
- HTTP server and routing → Admin endpoints: mounts (evidence: `backend/server.js`)
- Public API client → Public endpoints: calls endpoints
- Admin API client → Admin endpoints: calls endpoints (evidence: `backend/src/routes/admin.js`)
- Public endpoints → CMS records: queries (evidence: `backend/src/routes/public.js`)
- Public endpoints → Resource operations: uses resource operations (evidence: `backend/src/routes/public.js`)
- Admin endpoints → CMS records: manages records (evidence: `backend/src/routes/admin.js`)
- Admin endpoints → Resource operations: uses resource operations (evidence: `backend/src/routes/admin.js`)
- Admin endpoints → JWT authorization: requires authorization (evidence: `backend/src/routes/admin.js`)
- Admin endpoints → Sheet adapter: reads enquiries (evidence: `backend/src/routes/admin.js`)
- Admin endpoints → Image storage adapter: uploads images (evidence: `backend/src/routes/admin.js`)
- Public endpoints → Sheet adapter: records enquiries (evidence: `backend/src/routes/public.js`)
- Public endpoints → Email delivery: sends enquiry email (evidence: `backend/src/routes/public.js`)
- HTTP server and routing → MongoDB: connects (evidence: `backend/server.js`)
- Sheet adapter → Google Sheets: reads and writes (evidence: `backend/src/utils/sheets.js`)
- Email delivery → Email service: delivers mail
- Image storage adapter → Cloudinary: stores images
