How yuvaraj-ui132/belagavi_tourism works
Belagavi Tourism combines Android and web travel clients with authenticated AI search and trip-planning capabilities. The principal AI workflow accepts a client query, verifies chat identity and rate limits, retrieves destination context (and, when needed, current web information), synthesizes a grounded answer, and returns it through the API. The graph also preserves discovery, trip organization, and community capabilities documented in the README. Some frontend and backend modules are unsampled; their links are shown only where the README or source index supports them.
Main entry points: rag_service.py RAG orchestration · routes.py FastAPI routes · main.js Web application · search_service.py Semantic retrieval
Components 34
Travel clients
- Android app
android-app/app/src/main/java/com/belagavi/tourism/MainActivity.kt - Android navigation
android-app/app/src/main/java/com/belagavi/tourism/ui/navigation/NavGraph.kt - Place exploration
android-app/app/src/main/java/com/belagavi/tourism/ui/dashboard/ExploreView.kt - Place details
android-app/app/src/main/java/com/belagavi/tourism/ui/dashboard/PlaceDetailView.kt - AI chat UI
android-app/app/src/main/java/com/belagavi/tourism/ui/ai/AiChatView.kt - Chat state
android-app/app/src/main/java/com/belagavi/tourism/ui/ai/AiChatViewModel.kt - AI client
android-app/app/src/main/java/com/belagavi/tourism/data/repository/AiRepository.kt - Chat API client
android-app/app/src/main/java/com/belagavi/tourism/data/network/AiApiService.kt - Web application
public/static/main.js - Web AI assistant
public/static/ai-assistant.js
Trip planning
- Reviews UI
public/static/reviews.js - Web settings
public/static/settings.js - Android authentication
android-app/app/src/main/java/com/belagavi/tourism/ui/auth/AuthViewModel.kt - Expense tracker
android-app/app/src/main/java/com/belagavi/tourism/ui/dashboard/ExpenseView.kt - Profile and wishlist
android-app/app/src/main/java/com/belagavi/tourism/ui/dashboard/ProfileView.kt
AI and search backend
- FastAPI routes
backend/app/api/routes.py - Firebase token verification
backend/app/auth/firebase.py - Chat rate limiting
backend/app/auth/rate_limiter.py - RAG orchestration
backend/app/services/rag_service.py - Research routing
backend/app/services/query_router.py - Semantic retrieval
backend/app/services/search_service.py - Web research
backend/app/services/web_research_service.py - Context building
backend/app/rag/context_builder.py - Answer generation
backend/app/rag/llm_client.py - Query embeddings
backend/app/embeddings/embedder.py - Database sessions
backend/app/db/database.py
Data and integrations
- Place catalog
android-app/app/src/main/java/com/belagavi/tourism/data/repository/PlacesRepository.kt - Place model
android-app/app/src/main/java/com/belagavi/tourism/data/model/Place.kt - Destination records
backend/app/models/destination.py - PostgreSQL and pgvector
- Firebase Authentication
- Cloud Firestore
- Google Gemini
Other components
- Traveler
Connections 34
- Traveler → Android app: uses
- Traveler → Web application: uses
- Android app → Android navigation: starts navigation
android-app/app/src/main/java/com/belagavi/tourism/MainActivity.kt - Android navigation → AI chat UI: routes to
android-app/app/src/main/java/com/belagavi/tourism/ui/navigation/NavGraph.kt - Android navigation → Place details: routes to
android-app/app/src/main/java/com/belagavi/tourism/ui/navigation/NavGraph.kt - Android navigation → Android authentication: routes to
android-app/app/src/main/java/com/belagavi/tourism/ui/navigation/NavGraph.kt - Place exploration → Place catalog: reads places
android-app/app/src/main/java/com/belagavi/tourism/ui/dashboard/ExploreView.kt - Place catalog → Place model: provides
android-app/app/src/main/java/com/belagavi/tourism/data/repository/PlacesRepository.kt - AI chat UI → Chat state: uses state
android-app/app/src/main/java/com/belagavi/tourism/ui/ai/AiChatView.kt - AI client → Chat API client: sends chat
android-app/app/src/main/java/com/belagavi/tourism/data/repository/AiRepository.kt - Android app → FastAPI routes: calls chat API
- Web application → FastAPI routes: calls backend
- Web application → Web AI assistant: provides assistant
- Traveler → Android authentication: signs in
- Android authentication → Firebase Authentication: authenticates
- Android app → Cloud Firestore: syncs trip data
- Web application → Firebase Authentication: authenticates
- Web application → Cloud Firestore: syncs trip data
- FastAPI routes → Firebase token verification: verifies identity
backend/app/api/routes.py - FastAPI routes → Chat rate limiting: checks limit
backend/app/api/routes.py - FastAPI routes → RAG orchestration: delegates chat
backend/app/api/routes.py - FastAPI routes → Semantic retrieval: delegates search
backend/app/api/routes.py - RAG orchestration → Research routing: classifies query
backend/app/services/rag_service.py - RAG orchestration → Semantic retrieval: retrieves context
backend/app/services/rag_service.py - RAG orchestration → Web research: requests live sources
backend/app/services/rag_service.py - RAG orchestration → Context building: builds context
backend/app/services/rag_service.py - RAG orchestration → Answer generation: generates answer
backend/app/services/rag_service.py - Semantic retrieval → Query embeddings: embeds query
backend/app/services/search_service.py - Semantic retrieval → Destination records: queries records
backend/app/services/search_service.py - Database sessions → PostgreSQL and pgvector: opens sessions
backend/app/db/database.py - Semantic retrieval → Database sessions: uses database
- Query embeddings → Google Gemini: creates embeddings
- Answer generation → Google Gemini: generates text
backend/app/rag/llm_client.py - Web research → Traveler: searches current web