How samaysarthakswain/sight-sound-walk works
Lets Explore is a tourism and city-exploration application. Its main user journey enters the React app, browses destinations and local places, and uses dedicated pages for trip planning and experiences; additional branches provide AI travel assistance and crowd/traffic monitoring. The repository also contains separate API, location-service, narration-service, and model-training code. Edges are limited to relationships visible in excerpts or SOURCE INDEX references; many feature pages and integrations were not sampled, so their internal wiring is not asserted.
Main entry points: App.tsx React application · AnimatedRoutes.tsx Page routing · Index.tsx Explore landing · useCabServices.ts Cab data and fares
Components 31
Tourism app
- React application
src/App.tsx - Page routing
src/components/AnimatedRoutes.tsx - Explore landing
src/pages/Index.tsx - Monument browsing
src/hooks/useMonuments.ts - Food and hotels
src/pages/Food.tsx
Travel experiences
- Heritage quests
src/pages/HeritageQuests.tsx - Artisan trail
src/pages/ArtisanTrail.tsx - Soundscape
src/pages/Soundscape.tsx - Sundial simulator
src/pages/SundialSimulator.tsx - AR experiences
src/pages/ARExperience.tsx
Mobility and safety
- Journey planning
src/components/RouteSection.tsx - Cab services
src/pages/Cabs.tsx - Cab data and fares
src/hooks/useCabServices.ts - Crowd dashboard
src/pages/CrowdDashboard.tsx - Live room
src/pages/LiveRoom.tsx - Device sessions
src/contexts/WebRTCContext.tsx - Camera detection
src/components/dashboard/DetectionEngine.tsx - Detection state
src/contexts/DetectionContext.tsx - City route algorithms
src/lib/itos/graphRouting.ts - City topology
src/lib/itos/cityTopology.ts
Backend services
- REST API
backend/routes/api.js - API server
backend/server.js - Travel data models
backend/models/Monument.js - Location gRPC service
backend-services/location-service/src/main/kotlin/app/sightsoundwalk/location/grpc/MonumentGrpcService.kt - Location operations
backend-services/location-service/src/main/kotlin/app/sightsoundwalk/location/service/MonumentService.kt - Tour narration
backend-services/narration-service/src/main/java/app/sightsoundwalk/narration/service/TourGuideService.java
AI services
- Travel assistant
src/pages/Assistant.tsx - Assistant functions
supabase/functions/travel-assistant/index.ts - RAG guide
supabase/functions/rag-guide/index.ts - Recommender training
ml_training/train_recommender.py
Other components
- Traveler
Connections 23
- Traveler → React application: opens
README.md - React application → Page routing: renders routes
src/App.tsx - Page routing → Explore landing: routes to
src/components/AnimatedRoutes.tsx - Explore landing → Monument browsing: loads destinations
- Traveler → Journey planning: plans journey
- Cab services → Cab data and fares: uses fare data
- Cab data and fares → Traveler: uses account
src/hooks/useCabServices.ts - Crowd dashboard → Camera detection: runs detection
- Camera detection → Detection state: updates counts
src/components/dashboard/DetectionEngine.tsx - Live room → Device sessions: uses sessions
- City route algorithms → City topology: reads topology
src/lib/itos/graphRouting.ts - Traveler → Heritage quests: explores heritage
- Traveler → Artisan trail: explores artisans
- Traveler → Soundscape: hears local audio
- Traveler → Sundial simulator: uses simulator
- Traveler → AR experiences: opens AR
- Traveler → Travel assistant: asks for guidance
- Travel assistant → Assistant functions: requests assistance
- Traveler → RAG guide: requests guide
- API server → REST API: mounts routes
backend/server.js - REST API → Travel data models: uses models
backend/routes/api.js - Location gRPC service → Location operations: delegates operations
- Traveler → Tour narration: requests narration