# boopathy008/azhagu-decor-wedding-planner architecture

> Architecture diagram of the GitHub repository boopathy008/azhagu-decor-wedding-planner, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/boopathy008/azhagu-decor-wedding-planner
- Repository: https://github.com/boopathy008/azhagu-decor-wedding-planner

## Overview

Alagu Decor is a wedding-planning company website with public service and gallery pages, an enquiry channel, and a JWT-protected admin area for managing gallery images and reviewing enquiries. The principal workflow is an admin publishing an image through the API, which stores the image in Cloudinary and its metadata in PostgreSQL; the public category gallery then retrieves and displays published items. The graph also includes authentication and dashboard capabilities. Some frontend API wiring and backend modules were not excerpted, so those relationships rely on README statements.

Main entry points: [`frontend/src/services/api.ts`](https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/frontend/src/services/api.ts) (API client), [`frontend/src/App.tsx`](https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/frontend/src/App.tsx) (Route application), [`frontend/src/pages/ServiceCategoryPage.tsx`](https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/frontend/src/pages/ServiceCategoryPage.tsx) (Service pages), [`backend/src/main/java/com/alagu/decor/service/DashboardService.java`](https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/service/DashboardService.java) (Dashboard statistics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public website"]
  node_app["Route application<br/>[App.tsx]"]
  node_service_pages["Service pages"]
  node_service_config["Service structure<br/>[services.ts]"]
  node_gallery_view["Masonry gallery<br/>[MasonryGallery.tsx]"]
  node_enquiry_page["Contact enquiry<br/>[Contact.tsx]"]
  node_api_client["API client<br/>[api.ts]"]
end

subgraph group_admin["Admin experience"]
  node_admin_pages["Admin screens"]
  node_auth_context["Admin session<br/>[AuthContext.tsx]"]
end

subgraph group_backend["Backend API"]
  node_auth_controller["Authentication API"]
  node_auth_service["Authentication<br/>[AuthService.java]"]
  node_admin_identity["Admin identity lookup"]
  node_admin_gallery_api["Gallery admin API"]
  node_public_gallery_api["Public gallery API"]
  node_enquiry_api["Enquiry API"]
  node_enquiry_admin["Enquiry administration"]
  node_dashboard_api["Dashboard API"]
  node_gallery_service["Gallery workflows"]
  node_enquiry_service["Enquiry workflows"]
  node_dashboard_service["Dashboard statistics"]
  node_cloudinary_service["Image asset service"]
end

subgraph group_data["Persistence and media"]
  node_gallery_store[("Gallery records")]
  node_enquiry_store[("Enquiry records")]
  node_admin_store[("Admin records")]
  node_cloudinary[("Cloudinary")]
end

node_visitor(("Site visitor"))
node_admin_user(("Admin"))

node_visitor -->|"opens"| node_app
node_app -->|"routes to"| node_service_pages
node_service_pages -->|"loads structure"| node_service_config
node_service_pages -->|"requests gallery"| node_api_client
node_api_client -.->|"fetches published items"| node_public_gallery_api
node_service_pages -.->|"renders gallery"| node_gallery_view
node_app -->|"routes to"| node_enquiry_page
node_enquiry_page -.->|"submits enquiry"| node_api_client
node_admin_user -->|"opens admin"| node_app
node_app -->|"routes to"| node_admin_pages
node_admin_pages -.->|"uses session"| node_auth_context
node_admin_pages -.->|"manages content"| node_api_client
node_api_client -.->|"logs in"| node_auth_controller
node_auth_controller -->|"delegates login"| node_auth_service
node_auth_service -->|"looks up admin"| node_admin_store
node_admin_identity -->|"loads admin"| node_admin_store
node_api_client -.->|"manages gallery"| node_admin_gallery_api
node_admin_gallery_api -->|"delegates operations"| node_gallery_service
node_api_client -.->|"submits enquiry"| node_enquiry_api
node_enquiry_api -->|"delegates submission"| node_enquiry_service
node_api_client -.->|"reviews enquiries"| node_enquiry_admin
node_api_client -.->|"loads dashboard"| node_dashboard_api
node_dashboard_api -->|"requests statistics"| node_dashboard_service
node_gallery_service -->|"reads and writes"| node_gallery_store
node_gallery_service -->|"uploads and deletes"| node_cloudinary_service
node_cloudinary_service -->|"stores assets"| node_cloudinary
node_enquiry_service -->|"saves and reads"| node_enquiry_store
node_dashboard_service -->|"counts items"| node_gallery_store
node_dashboard_service -->|"gets gallery stats"| node_gallery_service
node_dashboard_service -->|"gets enquiry stats"| node_enquiry_service

click node_app "https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/frontend/src/App.tsx"
click node_service_pages "https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/frontend/src/pages/ServiceCategoryPage.tsx"
click node_service_config "https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/frontend/src/config/services.ts"
click node_gallery_view "https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/frontend/src/components/gallery/MasonryGallery.tsx"
click node_enquiry_page "https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/frontend/src/pages/Contact.tsx"
click node_api_client "https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/frontend/src/services/api.ts"
click node_admin_pages "https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/frontend/src/pages/admin/AdminGalleryForm.tsx"
click node_auth_context "https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/frontend/src/context/AuthContext.tsx"
click node_auth_controller "https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/controller/AuthController.java"
click node_auth_service "https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/service/AuthService.java"
click node_admin_identity "https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/security/AdminUserDetailsService.java"
click node_admin_gallery_api "https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/controller/AdminGalleryController.java"
click node_public_gallery_api "https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/controller/GalleryController.java"
click node_enquiry_api "https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/controller/EnquiryController.java"
click node_enquiry_admin "https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/controller/AdminEnquiryController.java"
click node_dashboard_api "https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/controller/AdminDashboardController.java"
click node_gallery_service "https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/service/GalleryService.java"
click node_enquiry_service "https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/service/EnquiryService.java"
click node_dashboard_service "https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/service/DashboardService.java"
click node_gallery_store "https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/repository/GalleryItemRepository.java"
click node_enquiry_store "https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/repository/EnquiryRepository.java"
click node_admin_store "https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/repository/AdminRepository.java"
click node_cloudinary_service "https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/service/CloudinaryService.java"

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_service_pages,node_service_config,node_gallery_view,node_enquiry_page,node_api_client toneBlue
class node_admin_pages,node_auth_context toneAmber
class node_auth_controller,node_auth_service,node_admin_identity,node_admin_gallery_api,node_public_gallery_api,node_enquiry_api,node_enquiry_admin,node_dashboard_api,node_gallery_service,node_enquiry_service,node_dashboard_service,node_cloudinary_service toneMint
class node_gallery_store,node_enquiry_store,node_admin_store,node_cloudinary toneRose
class node_visitor,node_admin_user toneIndigo
```

## Components

### Public website

- [Route application](https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Service pages](https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/frontend/src/pages/ServiceCategoryPage.tsx): `frontend/src/pages/ServiceCategoryPage.tsx`
- [Service structure](https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/frontend/src/config/services.ts): `frontend/src/config/services.ts`
- [Masonry gallery](https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/frontend/src/components/gallery/MasonryGallery.tsx): `frontend/src/components/gallery/MasonryGallery.tsx`
- [Contact enquiry](https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/frontend/src/pages/Contact.tsx): `frontend/src/pages/Contact.tsx`
- [API client](https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`

### Admin experience

- [Admin screens](https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/frontend/src/pages/admin/AdminGalleryForm.tsx): `frontend/src/pages/admin/AdminGalleryForm.tsx`
- [Admin session](https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/frontend/src/context/AuthContext.tsx): `frontend/src/context/AuthContext.tsx`

### Backend API

- [Authentication API](https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/controller/AuthController.java): `backend/src/main/java/com/alagu/decor/controller/AuthController.java`
- [Authentication](https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/service/AuthService.java): `backend/src/main/java/com/alagu/decor/service/AuthService.java`
- [Admin identity lookup](https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/security/AdminUserDetailsService.java): `backend/src/main/java/com/alagu/decor/security/AdminUserDetailsService.java`
- [Gallery admin API](https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/controller/AdminGalleryController.java): `backend/src/main/java/com/alagu/decor/controller/AdminGalleryController.java`
- [Public gallery API](https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/controller/GalleryController.java): `backend/src/main/java/com/alagu/decor/controller/GalleryController.java`
- [Enquiry API](https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/controller/EnquiryController.java): `backend/src/main/java/com/alagu/decor/controller/EnquiryController.java`
- [Enquiry administration](https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/controller/AdminEnquiryController.java): `backend/src/main/java/com/alagu/decor/controller/AdminEnquiryController.java`
- [Dashboard API](https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/controller/AdminDashboardController.java): `backend/src/main/java/com/alagu/decor/controller/AdminDashboardController.java`
- [Gallery workflows](https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/service/GalleryService.java): `backend/src/main/java/com/alagu/decor/service/GalleryService.java`
- [Enquiry workflows](https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/service/EnquiryService.java): `backend/src/main/java/com/alagu/decor/service/EnquiryService.java`
- [Dashboard statistics](https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/service/DashboardService.java): `backend/src/main/java/com/alagu/decor/service/DashboardService.java`
- [Image asset service](https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/service/CloudinaryService.java): `backend/src/main/java/com/alagu/decor/service/CloudinaryService.java`

### Persistence and media

- [Gallery records](https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/repository/GalleryItemRepository.java): `backend/src/main/java/com/alagu/decor/repository/GalleryItemRepository.java`
- [Enquiry records](https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/repository/EnquiryRepository.java): `backend/src/main/java/com/alagu/decor/repository/EnquiryRepository.java`
- [Admin records](https://github.com/boopathy008/azhagu-decor-wedding-planner/blob/main/backend/src/main/java/com/alagu/decor/repository/AdminRepository.java): `backend/src/main/java/com/alagu/decor/repository/AdminRepository.java`
- **Cloudinary**

### Other components

- **Site visitor**
- **Admin**

## Connections

- Site visitor → Route application: opens
- Route application → Service pages: routes to (evidence: `frontend/src/App.tsx`)
- Service pages → Service structure: loads structure
- Service pages → API client: requests gallery
- API client → Public gallery API: fetches published items
- Service pages → Masonry gallery: renders gallery
- Route application → Contact enquiry: routes to (evidence: `frontend/src/App.tsx`)
- Contact enquiry → API client: submits enquiry
- Admin → Route application: opens admin (evidence: `frontend/src/App.tsx`)
- Route application → Admin screens: routes to (evidence: `frontend/src/App.tsx`)
- Admin screens → Admin session: uses session
- Admin screens → API client: manages content
- API client → Authentication API: logs in
- Authentication API → Authentication: delegates login
- Authentication → Admin records: looks up admin (evidence: `backend/src/main/java/com/alagu/decor/service/AuthService.java`)
- Admin identity lookup → Admin records: loads admin (evidence: `backend/src/main/java/com/alagu/decor/security/AdminUserDetailsService.java`)
- API client → Gallery admin API: manages gallery
- Gallery admin API → Gallery workflows: delegates operations (evidence: `backend/src/main/java/com/alagu/decor/controller/AdminGalleryController.java`)
- API client → Enquiry API: submits enquiry
- Enquiry API → Enquiry workflows: delegates submission (evidence: `backend/src/main/java/com/alagu/decor/controller/EnquiryController.java`)
- API client → Enquiry administration: reviews enquiries
- API client → Dashboard API: loads dashboard
- Dashboard API → Dashboard statistics: requests statistics (evidence: `backend/src/main/java/com/alagu/decor/controller/AdminDashboardController.java`)
- Gallery workflows → Gallery records: reads and writes (evidence: `backend/src/main/java/com/alagu/decor/service/GalleryService.java`)
- Gallery workflows → Image asset service: uploads and deletes (evidence: `backend/src/main/java/com/alagu/decor/service/GalleryService.java`)
- Image asset service → Cloudinary: stores assets (evidence: `backend/src/main/java/com/alagu/decor/service/CloudinaryService.java`)
- Enquiry workflows → Enquiry records: saves and reads (evidence: `backend/src/main/java/com/alagu/decor/service/EnquiryService.java`)
- Dashboard statistics → Gallery records: counts items (evidence: `backend/src/main/java/com/alagu/decor/service/DashboardService.java`)
- Dashboard statistics → Gallery workflows: gets gallery stats (evidence: `backend/src/main/java/com/alagu/decor/service/DashboardService.java`)
- Dashboard statistics → Enquiry workflows: gets enquiry stats (evidence: `backend/src/main/java/com/alagu/decor/service/DashboardService.java`)
