# vishal-bhilwariya/bharatyatra architecture

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

- Interactive diagram: https://gitdiagram.com/vishal-bhilwariya/bharatyatra
- Repository: https://github.com/vishal-bhilwariya/bharatyatra

## Overview

BharatYatra is an India travel discovery and planning platform with a React client, Express API, MongoDB persistence, and an admin CMS. A typical user explores destinations, then uses recommendations, itinerary generation, transport planning, translation, or chat assistance; the client’s pages are routed through the API to backend handlers and data. Admins manage travel content through protected CMS pages and API routes. The README documents these capabilities; several backend route and controller implementations were not sampled, so some subsystem links are documented or left unverified rather than inferred from names.

Main entry points: [`client/src/App.jsx`](https://github.com/vishal-bhilwariya/bharatyatra/blob/main/client/src/App.jsx) (Web application), [`client/src/api/api.jsx`](https://github.com/vishal-bhilwariya/bharatyatra/blob/main/client/src/api/api.jsx) (API client), [`server/models`](https://github.com/vishal-bhilwariya/bharatyatra/tree/main/server/models) (Mongoose models), [`client/src/pages/Transportation.jsx`](https://github.com/vishal-bhilwariya/bharatyatra/blob/main/client/src/pages/Transportation.jsx) (Transport planner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Traveler client"]
  node_webapp["Web application<br/>[App.jsx]"]
  node_explore["Destination discovery<br/>[ExploreStates.jsx]"]
  node_home["Home and search<br/>[Home.jsx]"]
  node_culture["Culture explorer<br/>[ExploreCulture.jsx]"]
  node_itineraryui["Itinerary planner<br/>[Itinerary.jsx]"]
  node_recommendui["Recommendations"]
  node_transportui["Transport planner<br/>[Transportation.jsx]"]
  node_translatorui["Translator<br/>[Translator.jsx]"]
  node_assistant["Travel assistant"]
  node_api_client["API client<br/>[api.jsx]"]
  node_authui["User authentication UI<br/>[AuthContext.jsx]"]
end

subgraph group_travel["Travel services"]
  node_travelroutes["Travel API routes"]
  node_travelcontrollers["Travel handlers"]
end

subgraph group_identity["Identity and access"]
  node_authroutes["Authentication routes<br/>[authRoutes.js]"]
  node_authcontroller["Authentication handlers<br/>[authController.js]"]
  node_authservices["OTP, token, email services"]
end

subgraph group_cms["Content administration"]
  node_adminui["Admin CMS pages"]
  node_adminroutes["Admin API routes"]
  node_admincontrollers["Admin handlers"]
  node_adminauth["Admin token middleware<br/>[auth.middleware.js]"]
end

subgraph group_data["Persistence"]
  node_models[("Mongoose models")]
end

node_traveler(("Traveler"))
node_external_ai["Gemini API"]
node_database[("MongoDB")]

node_traveler -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_explore
node_webapp -->|"routes to"| node_home
node_webapp -->|"routes to"| node_culture
node_webapp -->|"routes to"| node_itineraryui
node_webapp -->|"routes to"| node_recommendui
node_webapp -->|"routes to"| node_transportui
node_webapp -->|"routes to"| node_translatorui
node_explore -.->|"requests data"| node_api_client
node_home -.->|"requests data"| node_api_client
node_culture -.->|"requests data"| node_api_client
node_itineraryui -.->|"requests plans"| node_api_client
node_recommendui -.->|"requests results"| node_api_client
node_transportui -->|"requests routes"| node_api_client
node_transportui -.->|"estimates route"| node_external_ai
node_translatorui -.->|"requests translation"| node_api_client
node_assistant -.->|"requests parsing"| node_api_client
node_api_client -.->|"calls API"| node_travelroutes
node_travelroutes -.->|"dispatches"| node_travelcontrollers
node_travelcontrollers -.->|"reads and writes"| node_models
node_models -.->|"persists"| node_database
node_authui -->|"calls API"| node_api_client
node_webapp -->|"provides context"| node_authui
node_authroutes -->|"dispatches"| node_authcontroller
node_authcontroller -->|"uses services"| node_authservices
node_authcontroller -->|"reads and writes"| node_models
node_adminui -.->|"requests CMS"| node_api_client
node_adminroutes -->|"checks token"| node_adminauth
node_adminroutes -->|"dispatches"| node_admincontrollers
node_admincontrollers -->|"reads and writes"| node_models
node_models -.->|"persists"| node_database
node_webapp -->|"routes to"| node_adminui
node_webapp -->|"serves API"| node_travelroutes

click node_webapp "https://github.com/vishal-bhilwariya/bharatyatra/blob/main/client/src/App.jsx"
click node_explore "https://github.com/vishal-bhilwariya/bharatyatra/blob/main/client/src/pages/ExploreStates.jsx"
click node_home "https://github.com/vishal-bhilwariya/bharatyatra/blob/main/client/src/pages/Home.jsx"
click node_culture "https://github.com/vishal-bhilwariya/bharatyatra/blob/main/client/src/pages/ExploreCulture.jsx"
click node_itineraryui "https://github.com/vishal-bhilwariya/bharatyatra/blob/main/client/src/pages/Itinerary.jsx"
click node_recommendui "https://github.com/vishal-bhilwariya/bharatyatra/blob/main/client/src/pages/Recommendations.jsx"
click node_transportui "https://github.com/vishal-bhilwariya/bharatyatra/blob/main/client/src/pages/Transportation.jsx"
click node_translatorui "https://github.com/vishal-bhilwariya/bharatyatra/blob/main/client/src/pages/Translator.jsx"
click node_assistant "https://github.com/vishal-bhilwariya/bharatyatra/blob/main/client/src/components/TravelAssistant.jsx"
click node_api_client "https://github.com/vishal-bhilwariya/bharatyatra/blob/main/client/src/api/api.jsx"
click node_travelroutes "https://github.com/vishal-bhilwariya/bharatyatra/tree/main/server/routes"
click node_travelcontrollers "https://github.com/vishal-bhilwariya/bharatyatra/tree/main/server/controllers"
click node_authui "https://github.com/vishal-bhilwariya/bharatyatra/blob/main/client/src/context/AuthContext.jsx"
click node_authroutes "https://github.com/vishal-bhilwariya/bharatyatra/blob/main/server/routes/authRoutes.js"
click node_authcontroller "https://github.com/vishal-bhilwariya/bharatyatra/blob/main/server/controllers/authController.js"
click node_authservices "https://github.com/vishal-bhilwariya/bharatyatra/tree/main/server/services"
click node_adminui "https://github.com/vishal-bhilwariya/bharatyatra/tree/main/client/src/pages/admin"
click node_adminroutes "https://github.com/vishal-bhilwariya/bharatyatra/tree/main/server/routes"
click node_admincontrollers "https://github.com/vishal-bhilwariya/bharatyatra/tree/main/server/controllers"
click node_adminauth "https://github.com/vishal-bhilwariya/bharatyatra/blob/main/server/middlewares/auth.middleware.js"
click node_models "https://github.com/vishal-bhilwariya/bharatyatra/tree/main/server/models"

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_webapp,node_explore,node_home,node_culture,node_itineraryui,node_recommendui,node_transportui,node_translatorui,node_assistant,node_api_client,node_authui toneBlue
class node_travelroutes,node_travelcontrollers,node_database toneAmber
class node_authroutes,node_authcontroller,node_authservices,node_external_ai toneMint
class node_adminui,node_adminroutes,node_admincontrollers,node_adminauth toneRose
class node_models,node_traveler toneIndigo
```

## Components

### Traveler client

- [Web application](https://github.com/vishal-bhilwariya/bharatyatra/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Destination discovery](https://github.com/vishal-bhilwariya/bharatyatra/blob/main/client/src/pages/ExploreStates.jsx): `client/src/pages/ExploreStates.jsx`
- [Home and search](https://github.com/vishal-bhilwariya/bharatyatra/blob/main/client/src/pages/Home.jsx): `client/src/pages/Home.jsx`
- [Culture explorer](https://github.com/vishal-bhilwariya/bharatyatra/blob/main/client/src/pages/ExploreCulture.jsx): `client/src/pages/ExploreCulture.jsx`
- [Itinerary planner](https://github.com/vishal-bhilwariya/bharatyatra/blob/main/client/src/pages/Itinerary.jsx): `client/src/pages/Itinerary.jsx`
- [Recommendations](https://github.com/vishal-bhilwariya/bharatyatra/blob/main/client/src/pages/Recommendations.jsx): `client/src/pages/Recommendations.jsx`
- [Transport planner](https://github.com/vishal-bhilwariya/bharatyatra/blob/main/client/src/pages/Transportation.jsx): `client/src/pages/Transportation.jsx`
- [Translator](https://github.com/vishal-bhilwariya/bharatyatra/blob/main/client/src/pages/Translator.jsx): `client/src/pages/Translator.jsx`
- [Travel assistant](https://github.com/vishal-bhilwariya/bharatyatra/blob/main/client/src/components/TravelAssistant.jsx): `client/src/components/TravelAssistant.jsx`
- [API client](https://github.com/vishal-bhilwariya/bharatyatra/blob/main/client/src/api/api.jsx): `client/src/api/api.jsx`
- [User authentication UI](https://github.com/vishal-bhilwariya/bharatyatra/blob/main/client/src/context/AuthContext.jsx): `client/src/context/AuthContext.jsx`

### Travel services

- [Travel API routes](https://github.com/vishal-bhilwariya/bharatyatra/tree/main/server/routes): `server/routes`
- [Travel handlers](https://github.com/vishal-bhilwariya/bharatyatra/tree/main/server/controllers): `server/controllers`

### Identity and access

- [Authentication routes](https://github.com/vishal-bhilwariya/bharatyatra/blob/main/server/routes/authRoutes.js): `server/routes/authRoutes.js`
- [Authentication handlers](https://github.com/vishal-bhilwariya/bharatyatra/blob/main/server/controllers/authController.js): `server/controllers/authController.js`
- [OTP, token, email services](https://github.com/vishal-bhilwariya/bharatyatra/tree/main/server/services): `server/services`

### Content administration

- [Admin CMS pages](https://github.com/vishal-bhilwariya/bharatyatra/tree/main/client/src/pages/admin): `client/src/pages/admin`
- [Admin API routes](https://github.com/vishal-bhilwariya/bharatyatra/tree/main/server/routes): `server/routes`
- [Admin handlers](https://github.com/vishal-bhilwariya/bharatyatra/tree/main/server/controllers): `server/controllers`
- [Admin token middleware](https://github.com/vishal-bhilwariya/bharatyatra/blob/main/server/middlewares/auth.middleware.js): `server/middlewares/auth.middleware.js`

### Persistence

- [Mongoose models](https://github.com/vishal-bhilwariya/bharatyatra/tree/main/server/models): `server/models`

### Other components

- **Traveler**
- **Gemini API**
- **MongoDB**

## Connections

- Traveler → Web application: uses (evidence: `README.md`)
- Web application → Destination discovery: routes to (evidence: `client/src/App.jsx`)
- Web application → Home and search: routes to (evidence: `client/src/App.jsx`)
- Web application → Culture explorer: routes to (evidence: `client/src/App.jsx`)
- Web application → Itinerary planner: routes to (evidence: `README.md`)
- Web application → Recommendations: routes to (evidence: `README.md`)
- Web application → Transport planner: routes to (evidence: `client/src/App.jsx`)
- Web application → Translator: routes to (evidence: `client/src/App.jsx`)
- Destination discovery → API client: requests data
- Home and search → API client: requests data
- Culture explorer → API client: requests data
- Itinerary planner → API client: requests plans (evidence: `README.md`)
- Recommendations → API client: requests results (evidence: `README.md`)
- Transport planner → API client: requests routes (evidence: `client/src/pages/Transportation.jsx`)
- Transport planner → Gemini API: estimates route (evidence: `README.md`)
- Translator → API client: requests translation (evidence: `README.md`)
- Travel assistant → API client: requests parsing (evidence: `README.md`)
- API client → Travel API routes: calls API (evidence: `README.md`)
- Travel API routes → Travel handlers: dispatches (evidence: `README.md`)
- Travel handlers → Mongoose models: reads and writes (evidence: `README.md`)
- Mongoose models → MongoDB: persists (evidence: `README.md`)
- User authentication UI → API client: calls API (evidence: `client/src/context/AuthContext.jsx`)
- Web application → User authentication UI: provides context (evidence: `client/src/App.jsx`)
- Authentication routes → Authentication handlers: dispatches (evidence: `server/routes/authRoutes.js`)
- Authentication handlers → OTP, token, email services: uses services (evidence: `server/controllers/authController.js`)
- Authentication handlers → Mongoose models: reads and writes (evidence: `server/controllers/authController.js`)
- Admin CMS pages → API client: requests CMS (evidence: `README.md`)
- Admin API routes → Admin token middleware: checks token (evidence: `server/routes/adminStateRoutes.js`)
- Admin API routes → Admin handlers: dispatches (evidence: `server/routes/adminStateRoutes.js`)
- Admin handlers → Mongoose models: reads and writes (evidence: `server/controllers/adminStateController.js`)
- Mongoose models → MongoDB: persists (evidence: `README.md`)
- Web application → Admin CMS pages: routes to (evidence: `client/src/App.jsx`)
- Web application → Travel API routes: serves API
