# primepro7676/bangalore_32_vibes architecture

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

- Interactive diagram: https://gitdiagram.com/primepro7676/bangalore_32_vibes
- Repository: https://github.com/primepro7676/bangalore_32_vibes

## Overview

Bangalore 32 Vibes is a venue-events and private-party booking product with customer-facing discovery, booking, account and review features, plus administrative management. The main workflow is customers browsing celebrations and booking through the frontend, which calls backend APIs; backend booking logic handles availability and booking records. Admins manage venue content and operations, while an AI assistant can answer venue questions using current business data. The README is only a project title, so capabilities are inferred from the source tree and excerpts; several subsystem links are omitted where sampled source does not establish the caller.

Main entry points: [`frontend/src/services/api.ts`](https://github.com/primepro7676/bangalore_32_vibes/blob/main/frontend/src/services/api.ts) (API client), [`backend/src/services/booking.service.ts`](https://github.com/primepro7676/bangalore_32_vibes/blob/main/backend/src/services/booking.service.ts) (Booking rules), [`frontend/src/components/admin`](https://github.com/primepro7676/bangalore_32_vibes/tree/main/frontend/src/components/admin) (Admin console), [`backend/src/app.ts`](https://github.com/primepro7676/bangalore_32_vibes/blob/main/backend/src/app.ts) (HTTP application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_customer["Customer experience"]
  node_app["Web application<br/>[App.tsx]"]
  node_booking_ui["Booking flow<br/>[BookingStepper.tsx]"]
  node_reviews_ui["Reviews<br/>[ReviewsSection.tsx]"]
  node_customer_ui["Customer dashboard"]
  node_api_client["API client<br/>[api.ts]"]
end

subgraph group_operations["Venue operations"]
  node_admin_ui["Admin console"]
  node_admin_events["Event management<br/>[EventManager.tsx]"]
  node_admin_calendar["Calendar management"]
  node_admin_payments["Payment management<br/>[PaymentManager.tsx]"]
  node_review_admin["Review moderation<br/>[ReviewManager.tsx]"]
end

subgraph group_backend["Backend services"]
  node_server_app["HTTP application<br/>[app.ts]"]
  node_booking_controller["Booking endpoints"]
  node_booking_service["Booking rules<br/>[booking.service.ts]"]
  node_availability["Availability rules"]
  node_ai["AI assistant tools<br/>[aiTools.service.ts]"]
  node_reviews_controller["Review endpoints"]
end

subgraph group_data["Domain data"]
  node_booking_data[("Booking records<br/>[Booking.ts]")]
  node_catalog_data[("Venue catalog<br/>[Event.ts]")]
  node_review_data[("Review records<br/>[Review.ts]")]
  node_settings_data[("Venue settings<br/>[Setting.ts]")]
  node_user_data[("User accounts<br/>[User.ts]")]
  node_audit_data[("Audit records<br/>[AuditLog.ts]")]
end

node_visitor(("Customer"))

node_visitor -->|"browses"| node_app
node_app -->|"opens booking"| node_booking_ui
node_app -->|"calls"| node_api_client
node_booking_ui -.->|"submits booking"| node_api_client
node_reviews_ui -->|"loads reviews"| node_api_client
node_customer_ui -.->|"uses"| node_api_client
node_admin_ui -.->|"manages events"| node_admin_events
node_admin_ui -.->|"manages calendar"| node_admin_calendar
node_admin_ui -.->|"manages payments"| node_admin_payments
node_admin_ui -.->|"moderates reviews"| node_review_admin
node_admin_events -->|"calls"| node_api_client
node_admin_calendar -->|"calls"| node_api_client
node_admin_payments -->|"calls"| node_api_client
node_review_admin -->|"calls"| node_api_client
node_api_client -.->|"requests API"| node_server_app
node_server_app -->|"mounts routes"| node_booking_controller
node_booking_controller -->|"delegates"| node_booking_service
node_booking_service -->|"reads and writes"| node_booking_data
node_booking_service -->|"reads"| node_catalog_data
node_booking_service -->|"reads"| node_settings_data
node_booking_service -.->|"checks availability"| node_availability
node_server_app -->|"mounts routes"| node_reviews_controller
node_reviews_controller -->|"reads and writes"| node_review_data
node_ai -->|"reads"| node_catalog_data
node_ai -->|"reads"| node_settings_data
node_reviews_controller -.->|"uses account"| node_user_data
node_server_app -.->|"serves audit routes"| node_audit_data

click node_app "https://github.com/primepro7676/bangalore_32_vibes/blob/main/frontend/src/App.tsx"
click node_booking_ui "https://github.com/primepro7676/bangalore_32_vibes/blob/main/frontend/src/components/BookingStepper.tsx"
click node_reviews_ui "https://github.com/primepro7676/bangalore_32_vibes/blob/main/frontend/src/components/ReviewsSection.tsx"
click node_customer_ui "https://github.com/primepro7676/bangalore_32_vibes/blob/main/frontend/src/components/customer/CustomerDashboard.tsx"
click node_api_client "https://github.com/primepro7676/bangalore_32_vibes/blob/main/frontend/src/services/api.ts"
click node_admin_ui "https://github.com/primepro7676/bangalore_32_vibes/tree/main/frontend/src/components/admin"
click node_admin_events "https://github.com/primepro7676/bangalore_32_vibes/blob/main/frontend/src/components/admin/EventManager.tsx"
click node_admin_calendar "https://github.com/primepro7676/bangalore_32_vibes/blob/main/frontend/src/components/admin/CalendarManager.tsx"
click node_admin_payments "https://github.com/primepro7676/bangalore_32_vibes/blob/main/frontend/src/components/admin/PaymentManager.tsx"
click node_review_admin "https://github.com/primepro7676/bangalore_32_vibes/blob/main/frontend/src/components/admin/ReviewManager.tsx"
click node_server_app "https://github.com/primepro7676/bangalore_32_vibes/blob/main/backend/src/app.ts"
click node_booking_controller "https://github.com/primepro7676/bangalore_32_vibes/blob/main/backend/src/controllers/booking.controller.ts"
click node_booking_service "https://github.com/primepro7676/bangalore_32_vibes/blob/main/backend/src/services/booking.service.ts"
click node_availability "https://github.com/primepro7676/bangalore_32_vibes/blob/main/backend/src/services/availability.service.ts"
click node_ai "https://github.com/primepro7676/bangalore_32_vibes/blob/main/backend/src/services/aiTools.service.ts"
click node_reviews_controller "https://github.com/primepro7676/bangalore_32_vibes/blob/main/backend/src/controllers/review.controller.ts"
click node_booking_data "https://github.com/primepro7676/bangalore_32_vibes/blob/main/backend/src/models/Booking.ts"
click node_catalog_data "https://github.com/primepro7676/bangalore_32_vibes/blob/main/backend/src/models/Event.ts"
click node_review_data "https://github.com/primepro7676/bangalore_32_vibes/blob/main/backend/src/models/Review.ts"
click node_settings_data "https://github.com/primepro7676/bangalore_32_vibes/blob/main/backend/src/models/Setting.ts"
click node_user_data "https://github.com/primepro7676/bangalore_32_vibes/blob/main/backend/src/models/User.ts"
click node_audit_data "https://github.com/primepro7676/bangalore_32_vibes/blob/main/backend/src/models/AuditLog.ts"

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_booking_ui,node_reviews_ui,node_customer_ui,node_api_client toneBlue
class node_admin_ui,node_admin_events,node_admin_calendar,node_admin_payments,node_review_admin toneAmber
class node_server_app,node_booking_controller,node_booking_service,node_availability,node_ai,node_reviews_controller toneMint
class node_booking_data,node_catalog_data,node_review_data,node_settings_data,node_user_data,node_audit_data toneRose
class node_visitor toneIndigo
```

## Components

### Customer experience

- [Web application](https://github.com/primepro7676/bangalore_32_vibes/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Booking flow](https://github.com/primepro7676/bangalore_32_vibes/blob/main/frontend/src/components/BookingStepper.tsx): `frontend/src/components/BookingStepper.tsx`
- [Reviews](https://github.com/primepro7676/bangalore_32_vibes/blob/main/frontend/src/components/ReviewsSection.tsx): `frontend/src/components/ReviewsSection.tsx`
- [Customer dashboard](https://github.com/primepro7676/bangalore_32_vibes/blob/main/frontend/src/components/customer/CustomerDashboard.tsx): `frontend/src/components/customer/CustomerDashboard.tsx`
- [API client](https://github.com/primepro7676/bangalore_32_vibes/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`

### Venue operations

- [Admin console](https://github.com/primepro7676/bangalore_32_vibes/tree/main/frontend/src/components/admin): `frontend/src/components/admin`
- [Event management](https://github.com/primepro7676/bangalore_32_vibes/blob/main/frontend/src/components/admin/EventManager.tsx): `frontend/src/components/admin/EventManager.tsx`
- [Calendar management](https://github.com/primepro7676/bangalore_32_vibes/blob/main/frontend/src/components/admin/CalendarManager.tsx): `frontend/src/components/admin/CalendarManager.tsx`
- [Payment management](https://github.com/primepro7676/bangalore_32_vibes/blob/main/frontend/src/components/admin/PaymentManager.tsx): `frontend/src/components/admin/PaymentManager.tsx`
- [Review moderation](https://github.com/primepro7676/bangalore_32_vibes/blob/main/frontend/src/components/admin/ReviewManager.tsx): `frontend/src/components/admin/ReviewManager.tsx`

### Backend services

- [HTTP application](https://github.com/primepro7676/bangalore_32_vibes/blob/main/backend/src/app.ts): `backend/src/app.ts`
- [Booking endpoints](https://github.com/primepro7676/bangalore_32_vibes/blob/main/backend/src/controllers/booking.controller.ts): `backend/src/controllers/booking.controller.ts`
- [Booking rules](https://github.com/primepro7676/bangalore_32_vibes/blob/main/backend/src/services/booking.service.ts): `backend/src/services/booking.service.ts`
- [Availability rules](https://github.com/primepro7676/bangalore_32_vibes/blob/main/backend/src/services/availability.service.ts): `backend/src/services/availability.service.ts`
- [AI assistant tools](https://github.com/primepro7676/bangalore_32_vibes/blob/main/backend/src/services/aiTools.service.ts): `backend/src/services/aiTools.service.ts`
- [Review endpoints](https://github.com/primepro7676/bangalore_32_vibes/blob/main/backend/src/controllers/review.controller.ts): `backend/src/controllers/review.controller.ts`

### Domain data

- [Booking records](https://github.com/primepro7676/bangalore_32_vibes/blob/main/backend/src/models/Booking.ts): `backend/src/models/Booking.ts`
- [Venue catalog](https://github.com/primepro7676/bangalore_32_vibes/blob/main/backend/src/models/Event.ts): `backend/src/models/Event.ts`
- [Review records](https://github.com/primepro7676/bangalore_32_vibes/blob/main/backend/src/models/Review.ts): `backend/src/models/Review.ts`
- [Venue settings](https://github.com/primepro7676/bangalore_32_vibes/blob/main/backend/src/models/Setting.ts): `backend/src/models/Setting.ts`
- [User accounts](https://github.com/primepro7676/bangalore_32_vibes/blob/main/backend/src/models/User.ts): `backend/src/models/User.ts`
- [Audit records](https://github.com/primepro7676/bangalore_32_vibes/blob/main/backend/src/models/AuditLog.ts): `backend/src/models/AuditLog.ts`

### Other components

- **Customer**

## Connections

- Customer → Web application: browses
- Web application → Booking flow: opens booking (evidence: `frontend/src/App.tsx`)
- Web application → API client: calls (evidence: `frontend/src/App.tsx`)
- Booking flow → API client: submits booking
- Reviews → API client: loads reviews (evidence: `frontend/src/components/ReviewsSection.tsx`)
- Customer dashboard → API client: uses
- Admin console → Event management: manages events
- Admin console → Calendar management: manages calendar
- Admin console → Payment management: manages payments
- Admin console → Review moderation: moderates reviews
- Event management → API client: calls (evidence: `frontend/src/components/admin/EventManager.tsx`)
- Calendar management → API client: calls (evidence: `frontend/src/components/admin/CalendarManager.tsx`)
- Payment management → API client: calls (evidence: `frontend/src/components/admin/PaymentManager.tsx`)
- Review moderation → API client: calls (evidence: `frontend/src/components/admin/ReviewManager.tsx`)
- API client → HTTP application: requests API (evidence: `frontend/src/services/api.ts`)
- HTTP application → Booking endpoints: mounts routes (evidence: `backend/src/app.ts`)
- Booking endpoints → Booking rules: delegates (evidence: `backend/src/controllers/booking.controller.ts`)
- Booking rules → Booking records: reads and writes (evidence: `backend/src/services/booking.service.ts`)
- Booking rules → Venue catalog: reads (evidence: `backend/src/services/booking.service.ts`)
- Booking rules → Venue settings: reads (evidence: `backend/src/services/booking.service.ts`)
- Booking rules → Availability rules: checks availability
- HTTP application → Review endpoints: mounts routes (evidence: `backend/src/app.ts`)
- Review endpoints → Review records: reads and writes (evidence: `backend/src/controllers/review.controller.ts`)
- AI assistant tools → Venue catalog: reads (evidence: `backend/src/services/aiTools.service.ts`)
- AI assistant tools → Venue settings: reads (evidence: `backend/src/services/aiTools.service.ts`)
- Review endpoints → User accounts: uses account
- HTTP application → Audit records: serves audit routes
