How saketgupta-crypto/bharat-darshan-complete works
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: api.ts API client · models MongoDB models · App.tsx Web application · itinerary.controller.ts Trip handler
Components 28
Traveller experience
- Web application
frontend/src/App.tsx - Trip pages
frontend/src/pages/ItineraryPage.tsx - Discovery pages
frontend/src/pages/DestinationsPage.tsx - Account pages
frontend/src/pages/auth/LoginPage.tsx - API client
frontend/src/services/api.ts - Trip service
frontend/src/services/itinerary.service.ts - Auth service
frontend/src/services/auth.service.ts
Backend API
- Content routes
backend/src/routes/content.routes.ts - Trip routes
backend/src/routes/itinerary.routes.ts - Auth routes
backend/src/routes/auth.routes.ts - Content handlers
backend/src/controllers/destination.controller.ts - Review handlers
backend/src/controllers/review.controller.ts - Trip handler
backend/src/controllers/itinerary.controller.ts - Auth handler
backend/src/controllers/auth.controller.ts - MongoDB models
backend/src/models
AI trip planning
- Itinerary engine
backend/src/services/ai.service.ts - Verified place data
backend/src/services/travel/places.service.ts - Gemini adapter
backend/src/services/gemini.service.ts - PDF export
backend/src/services/pdf.service.ts - Travel data providers
- Google Gemini
Identity and operations
- Authentication service
backend/src/services/auth.service.ts - Admin routes
backend/src/routes/admin.routes.ts - Administration
backend/src/controllers/admin.controller.ts - Rating service
backend/src/services/review.service.ts - Email delivery
backend/src/services/email.service.ts - Cloudinary
Other components
- Traveller
Connections 33
- Traveller → Web application: uses
README.md - Web application → Trip pages: routes to
frontend/src/App.tsx - Web application → Discovery pages: routes to
frontend/src/App.tsx - Web application → Account pages: routes to
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
frontend/src/services/itinerary.service.ts - Auth service → API client: uses
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
backend/src/routes/content.routes.ts - Content routes → Review handlers: dispatches
backend/src/routes/content.routes.ts - Trip routes → Trip handler: dispatches
backend/src/routes/itinerary.routes.ts - Auth routes → Auth handler: dispatches
- Trip handler → Itinerary engine: generates or modifies
backend/src/controllers/itinerary.controller.ts - Trip handler → MongoDB models: reads and saves trips
backend/src/controllers/itinerary.controller.ts - Trip handler → PDF export: exports PDF
backend/src/controllers/itinerary.controller.ts - Itinerary engine → Verified place data: uses verified data
README.md - Itinerary engine → Gemini adapter: composes itinerary
README.md - Verified place data → Travel data providers: fetches places and routes
README.md - Gemini adapter → Google Gemini: calls model
README.md - Review handlers → Rating service: recomputes ratings
backend/src/controllers/review.controller.ts - Review handlers → MongoDB models: reads and writes reviews
backend/src/controllers/review.controller.ts - Rating service → MongoDB models: updates target ratings
backend/src/services/review.service.ts - Auth handler → Authentication service: handles account actions
- Authentication service → MongoDB models: uses account records
backend/src/services/auth.service.ts - Authentication service → Email delivery: sends verification and reset mail
backend/src/services/auth.service.ts - Admin routes → Administration: dispatches
backend/src/routes/admin.routes.ts - Administration → MongoDB models: manages platform records
backend/src/controllers/admin.controller.ts - Administration → Rating service: recomputes ratings
backend/src/controllers/admin.controller.ts - Content handlers → Cloudinary: uploads media