# saketgupta-crypto/bharat-darshan-complete architecture

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

- Interactive diagram: https://gitdiagram.com/saketgupta-crypto/bharat-darshan-complete
- Repository: https://github.com/saketgupta-crypto/bharat-darshan-complete

## Overview

Bharat Darshan is a full-stack tourism platform for discovering Indian destinations, hotels, and guides, then planning and managing trips. The principal workflow runs from traveller-facing React pages through API services and backend routes/controllers to itinerary generation, persistence, and trip outputs. Separate branches cover authentication, reviews, public content, and role-based administration. The README documents major capabilities and integrations; edges between sampled modules cite their visible imports or calls. Some frontend page-to-service and backend wiring is unsampled, so those links are documented at a higher level rather than inferred between siblings.

Main entry points: [`frontend/src/services/api.ts`](https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/frontend/src/services/api.ts) (API client), [`backend/src/models`](https://github.com/saketgupta-crypto/bharat-darshan-complete/tree/main/backend/src/models) (MongoDB models), [`frontend/src/App.tsx`](https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/frontend/src/App.tsx) (Web application), [`backend/src/controllers/itinerary.controller.ts`](https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/controllers/itinerary.controller.ts) (Trip handler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Traveller experience"]
  node_frontend["Web application<br/>[App.tsx]"]
  node_trip_pages["Trip pages<br/>[ItineraryPage.tsx]"]
  node_content_pages["Discovery pages"]
  node_auth_pages["Account pages<br/>[LoginPage.tsx]"]
  node_api_client["API client<br/>[api.ts]"]
  node_itinerary_client["Trip service"]
  node_auth_client["Auth service<br/>[auth.service.ts]"]
end

subgraph group_api["Backend API"]
  node_content_routes["Content routes<br/>[content.routes.ts]"]
  node_itinerary_routes["Trip routes"]
  node_auth_routes["Auth routes<br/>[auth.routes.ts]"]
  node_content_controllers["Content handlers"]
  node_review_controller["Review handlers"]
  node_trip_controller["Trip handler"]
  node_auth_controller["Auth handler<br/>[auth.controller.ts]"]
  node_models[("MongoDB models")]
end

subgraph group_planning["AI trip planning"]
  node_ai_service["Itinerary engine<br/>[ai.service.ts]"]
  node_places["Verified place data<br/>[places.service.ts]"]
  node_gemini["Gemini adapter<br/>[gemini.service.ts]"]
  node_pdf["PDF export<br/>[pdf.service.ts]"]
  node_travel_providers["Travel data providers"]
  node_gemini_provider["Google Gemini"]
end

subgraph group_platform["Identity and operations"]
  node_identity["Authentication service<br/>[auth.service.ts]"]
  node_admin_routes["Admin routes<br/>[admin.routes.ts]"]
  node_admin_controller["Administration"]
  node_review_service["Rating service<br/>[review.service.ts]"]
  node_email["Email delivery<br/>[email.service.ts]"]
  node_cloudinary["Cloudinary"]
end

node_traveller(("Traveller"))

node_traveller -->|"uses"| node_frontend
node_frontend -->|"routes to"| node_trip_pages
node_frontend -->|"routes to"| node_content_pages
node_frontend -->|"routes to"| node_auth_pages
node_trip_pages -.->|"requests trips"| node_itinerary_client
node_content_pages -.->|"requests content"| node_api_client
node_auth_pages -.->|"requests auth"| node_auth_client
node_itinerary_client -->|"uses"| node_api_client
node_auth_client -->|"uses"| node_api_client
node_api_client -.->|"calls API"| node_itinerary_routes
node_api_client -.->|"calls API"| node_content_routes
node_api_client -.->|"calls API"| node_auth_routes
node_content_routes -->|"dispatches"| node_content_controllers
node_content_routes -->|"dispatches"| node_review_controller
node_itinerary_routes -->|"dispatches"| node_trip_controller
node_auth_routes -->|"dispatches"| node_auth_controller
node_trip_controller -->|"generates or modifies"| node_ai_service
node_trip_controller -->|"reads and saves trips"| node_models
node_trip_controller -->|"exports PDF"| node_pdf
node_ai_service -->|"uses verified data"| node_places
node_ai_service -->|"composes itinerary"| node_gemini
node_places -->|"fetches places and routes"| node_travel_providers
node_gemini -->|"calls model"| node_gemini_provider
node_review_controller -->|"recomputes ratings"| node_review_service
node_review_controller -->|"reads and writes reviews"| node_models
node_review_service -->|"updates target ratings"| node_models
node_auth_controller -.->|"handles account actions"| node_identity
node_identity -->|"uses account records"| node_models
node_identity -->|"sends verification and reset mail"| node_email
node_admin_routes -->|"dispatches"| node_admin_controller
node_admin_controller -->|"manages platform records"| node_models
node_admin_controller -->|"recomputes ratings"| node_review_service
node_content_controllers -.->|"uploads media"| node_cloudinary

click node_frontend "https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/frontend/src/App.tsx"
click node_trip_pages "https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/frontend/src/pages/ItineraryPage.tsx"
click node_content_pages "https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/frontend/src/pages/DestinationsPage.tsx"
click node_auth_pages "https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/frontend/src/pages/auth/LoginPage.tsx"
click node_api_client "https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/frontend/src/services/api.ts"
click node_itinerary_client "https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/frontend/src/services/itinerary.service.ts"
click node_auth_client "https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/frontend/src/services/auth.service.ts"
click node_content_routes "https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/routes/content.routes.ts"
click node_itinerary_routes "https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/routes/itinerary.routes.ts"
click node_auth_routes "https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/routes/auth.routes.ts"
click node_content_controllers "https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/controllers/destination.controller.ts"
click node_review_controller "https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/controllers/review.controller.ts"
click node_trip_controller "https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/controllers/itinerary.controller.ts"
click node_auth_controller "https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/controllers/auth.controller.ts"
click node_models "https://github.com/saketgupta-crypto/bharat-darshan-complete/tree/main/backend/src/models"
click node_ai_service "https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/services/ai.service.ts"
click node_places "https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/services/travel/places.service.ts"
click node_gemini "https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/services/gemini.service.ts"
click node_pdf "https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/services/pdf.service.ts"
click node_identity "https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/services/auth.service.ts"
click node_admin_routes "https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/routes/admin.routes.ts"
click node_admin_controller "https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/controllers/admin.controller.ts"
click node_review_service "https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/services/review.service.ts"
click node_email "https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/services/email.service.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_frontend,node_trip_pages,node_content_pages,node_auth_pages,node_api_client,node_itinerary_client,node_auth_client toneBlue
class node_content_routes,node_itinerary_routes,node_auth_routes,node_content_controllers,node_review_controller,node_trip_controller,node_auth_controller,node_models toneAmber
class node_ai_service,node_places,node_gemini,node_pdf,node_travel_providers,node_gemini_provider toneMint
class node_identity,node_admin_routes,node_admin_controller,node_review_service,node_email,node_cloudinary toneRose
class node_traveller toneIndigo
```

## Components

### Traveller experience

- [Web application](https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Trip pages](https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/frontend/src/pages/ItineraryPage.tsx): `frontend/src/pages/ItineraryPage.tsx`
- [Discovery pages](https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/frontend/src/pages/DestinationsPage.tsx): `frontend/src/pages/DestinationsPage.tsx`
- [Account pages](https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/frontend/src/pages/auth/LoginPage.tsx): `frontend/src/pages/auth/LoginPage.tsx`
- [API client](https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`
- [Trip service](https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/frontend/src/services/itinerary.service.ts): `frontend/src/services/itinerary.service.ts`
- [Auth service](https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/frontend/src/services/auth.service.ts): `frontend/src/services/auth.service.ts`

### Backend API

- [Content routes](https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/routes/content.routes.ts): `backend/src/routes/content.routes.ts`
- [Trip routes](https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/routes/itinerary.routes.ts): `backend/src/routes/itinerary.routes.ts`
- [Auth routes](https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/routes/auth.routes.ts): `backend/src/routes/auth.routes.ts`
- [Content handlers](https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/controllers/destination.controller.ts): `backend/src/controllers/destination.controller.ts`
- [Review handlers](https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/controllers/review.controller.ts): `backend/src/controllers/review.controller.ts`
- [Trip handler](https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/controllers/itinerary.controller.ts): `backend/src/controllers/itinerary.controller.ts`
- [Auth handler](https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/controllers/auth.controller.ts): `backend/src/controllers/auth.controller.ts`
- [MongoDB models](https://github.com/saketgupta-crypto/bharat-darshan-complete/tree/main/backend/src/models): `backend/src/models`

### AI trip planning

- [Itinerary engine](https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/services/ai.service.ts): `backend/src/services/ai.service.ts`
- [Verified place data](https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/services/travel/places.service.ts): `backend/src/services/travel/places.service.ts`
- [Gemini adapter](https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/services/gemini.service.ts): `backend/src/services/gemini.service.ts`
- [PDF export](https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/services/pdf.service.ts): `backend/src/services/pdf.service.ts`
- **Travel data providers**
- **Google Gemini**

### Identity and operations

- [Authentication service](https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/services/auth.service.ts): `backend/src/services/auth.service.ts`
- [Admin routes](https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/routes/admin.routes.ts): `backend/src/routes/admin.routes.ts`
- [Administration](https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/controllers/admin.controller.ts): `backend/src/controllers/admin.controller.ts`
- [Rating service](https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/services/review.service.ts): `backend/src/services/review.service.ts`
- [Email delivery](https://github.com/saketgupta-crypto/bharat-darshan-complete/blob/main/backend/src/services/email.service.ts): `backend/src/services/email.service.ts`
- **Cloudinary**

### Other components

- **Traveller**

## Connections

- Traveller → Web application: uses (evidence: `README.md`)
- Web application → Trip pages: routes to (evidence: `frontend/src/App.tsx`)
- Web application → Discovery pages: routes to (evidence: `frontend/src/App.tsx`)
- Web application → Account pages: routes to (evidence: `frontend/src/App.tsx`)
- Trip pages → Trip service: requests trips
- Discovery pages → API client: requests content
- Account pages → Auth service: requests auth
- Trip service → API client: uses (evidence: `frontend/src/services/itinerary.service.ts`)
- Auth service → API client: uses (evidence: `frontend/src/services/auth.service.ts`)
- API client → Trip routes: calls API
- API client → Content routes: calls API
- API client → Auth routes: calls API
- Content routes → Content handlers: dispatches (evidence: `backend/src/routes/content.routes.ts`)
- Content routes → Review handlers: dispatches (evidence: `backend/src/routes/content.routes.ts`)
- Trip routes → Trip handler: dispatches (evidence: `backend/src/routes/itinerary.routes.ts`)
- Auth routes → Auth handler: dispatches
- Trip handler → Itinerary engine: generates or modifies (evidence: `backend/src/controllers/itinerary.controller.ts`)
- Trip handler → MongoDB models: reads and saves trips (evidence: `backend/src/controllers/itinerary.controller.ts`)
- Trip handler → PDF export: exports PDF (evidence: `backend/src/controllers/itinerary.controller.ts`)
- Itinerary engine → Verified place data: uses verified data (evidence: `README.md`)
- Itinerary engine → Gemini adapter: composes itinerary (evidence: `README.md`)
- Verified place data → Travel data providers: fetches places and routes (evidence: `README.md`)
- Gemini adapter → Google Gemini: calls model (evidence: `README.md`)
- Review handlers → Rating service: recomputes ratings (evidence: `backend/src/controllers/review.controller.ts`)
- Review handlers → MongoDB models: reads and writes reviews (evidence: `backend/src/controllers/review.controller.ts`)
- Rating service → MongoDB models: updates target ratings (evidence: `backend/src/services/review.service.ts`)
- Auth handler → Authentication service: handles account actions
- Authentication service → MongoDB models: uses account records (evidence: `backend/src/services/auth.service.ts`)
- Authentication service → Email delivery: sends verification and reset mail (evidence: `backend/src/services/auth.service.ts`)
- Admin routes → Administration: dispatches (evidence: `backend/src/routes/admin.routes.ts`)
- Administration → MongoDB models: manages platform records (evidence: `backend/src/controllers/admin.controller.ts`)
- Administration → Rating service: recomputes ratings (evidence: `backend/src/controllers/admin.controller.ts`)
- Content handlers → Cloudinary: uploads media
