# yuvaraj-ui132/belagavi_tourism architecture

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

- Interactive diagram: https://gitdiagram.com/yuvaraj-ui132/belagavi_tourism
- Repository: https://github.com/yuvaraj-ui132/belagavi_tourism

## Overview

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: [`backend/app/services/rag_service.py`](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/backend/app/services/rag_service.py) (RAG orchestration), [`backend/app/api/routes.py`](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/backend/app/api/routes.py) (FastAPI routes), [`public/static/main.js`](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/public/static/main.js) (Web application), [`backend/app/services/search_service.py`](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/backend/app/services/search_service.py) (Semantic retrieval)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Travel clients"]
  node_android["Android app<br/>[MainActivity.kt]"]
  node_android_nav["Android navigation<br/>[NavGraph.kt]"]
  node_android_explore["Place exploration<br/>[ExploreView.kt]"]
  node_android_place["Place details<br/>[PlaceDetailView.kt]"]
  node_android_ai["AI chat UI<br/>[AiChatView.kt]"]
  node_android_ai_vm["Chat state<br/>[AiChatViewModel.kt]"]
  node_android_ai_repo["AI client<br/>[AiRepository.kt]"]
  node_android_api["Chat API client<br/>[AiApiService.kt]"]
  node_web["Web application<br/>[main.js]"]
  node_web_ai["Web AI assistant<br/>[ai-assistant.js]"]
end

subgraph group_trip["Trip planning"]
  node_web_reviews["Reviews UI<br/>[reviews.js]"]
  node_web_settings["Web settings<br/>[settings.js]"]
  node_android_auth["Android authentication<br/>[AuthViewModel.kt]"]
  node_android_expenses["Expense tracker<br/>[ExpenseView.kt]"]
  node_android_profile["Profile and wishlist<br/>[ProfileView.kt]"]
end

subgraph group_backend["AI and search backend"]
  node_api["FastAPI routes<br/>[routes.py]"]
  node_auth["Firebase token verification<br/>[firebase.py]"]
  node_limiter["Chat rate limiting<br/>[rate_limiter.py]"]
  node_rag["RAG orchestration<br/>[rag_service.py]"]
  node_query_router["Research routing<br/>[query_router.py]"]
  node_search["Semantic retrieval<br/>[search_service.py]"]
  node_web_research["Web research"]
  node_context["Context building<br/>[context_builder.py]"]
  node_llm["Answer generation<br/>[llm_client.py]"]
  node_embedder["Query embeddings<br/>[embedder.py]"]
  node_db_session["Database sessions<br/>[database.py]"]
end

subgraph group_data["Data and integrations"]
  node_places["Place catalog"]
  node_place_model["Place model<br/>[Place.kt]"]
  node_destination[("Destination records<br/>[destination.py]")]
  node_postgres[("PostgreSQL and pgvector")]
  node_firebase_auth["Firebase Authentication"]
  node_firestore[("Cloud Firestore")]
  node_gemini["Google Gemini"]
end

node_traveler(("Traveler"))

node_traveler -->|"uses"| node_android
node_traveler -->|"uses"| node_web
node_android -->|"starts navigation"| node_android_nav
node_android_nav -->|"routes to"| node_android_ai
node_android_nav -->|"routes to"| node_android_place
node_android_nav -->|"routes to"| node_android_auth
node_android_explore -->|"reads places"| node_places
node_places -->|"provides"| node_place_model
node_android_ai -->|"uses state"| node_android_ai_vm
node_android_ai_repo -->|"sends chat"| node_android_api
node_android -.->|"calls chat API"| node_api
node_web -.->|"calls backend"| node_api
node_web -.->|"provides assistant"| node_web_ai
node_traveler -->|"signs in"| node_android_auth
node_android_auth -.->|"authenticates"| node_firebase_auth
node_android -.->|"syncs trip data"| node_firestore
node_web -.->|"authenticates"| node_firebase_auth
node_web -.->|"syncs trip data"| node_firestore
node_api -->|"verifies identity"| node_auth
node_api -->|"checks limit"| node_limiter
node_api -->|"delegates chat"| node_rag
node_api -->|"delegates search"| node_search
node_rag -->|"classifies query"| node_query_router
node_rag -->|"retrieves context"| node_search
node_rag -->|"requests live sources"| node_web_research
node_rag -->|"builds context"| node_context
node_rag -->|"generates answer"| node_llm
node_search -->|"embeds query"| node_embedder
node_search -->|"queries records"| node_destination
node_db_session -->|"opens sessions"| node_postgres
node_search -.->|"uses database"| node_db_session
node_embedder -.->|"creates embeddings"| node_gemini
node_llm -->|"generates text"| node_gemini
node_web_research -.->|"searches current web"| node_traveler

click node_android "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/android-app/app/src/main/java/com/belagavi/tourism/MainActivity.kt"
click node_android_nav "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/android-app/app/src/main/java/com/belagavi/tourism/ui/navigation/NavGraph.kt"
click node_android_explore "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/android-app/app/src/main/java/com/belagavi/tourism/ui/dashboard/ExploreView.kt"
click node_android_place "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/android-app/app/src/main/java/com/belagavi/tourism/ui/dashboard/PlaceDetailView.kt"
click node_android_ai "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/android-app/app/src/main/java/com/belagavi/tourism/ui/ai/AiChatView.kt"
click node_android_ai_vm "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/android-app/app/src/main/java/com/belagavi/tourism/ui/ai/AiChatViewModel.kt"
click node_android_ai_repo "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/android-app/app/src/main/java/com/belagavi/tourism/data/repository/AiRepository.kt"
click node_android_api "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/android-app/app/src/main/java/com/belagavi/tourism/data/network/AiApiService.kt"
click node_web "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/public/static/main.js"
click node_web_ai "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/public/static/ai-assistant.js"
click node_web_reviews "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/public/static/reviews.js"
click node_web_settings "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/public/static/settings.js"
click node_android_auth "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/android-app/app/src/main/java/com/belagavi/tourism/ui/auth/AuthViewModel.kt"
click node_android_expenses "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/android-app/app/src/main/java/com/belagavi/tourism/ui/dashboard/ExpenseView.kt"
click node_android_profile "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/android-app/app/src/main/java/com/belagavi/tourism/ui/dashboard/ProfileView.kt"
click node_places "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/android-app/app/src/main/java/com/belagavi/tourism/data/repository/PlacesRepository.kt"
click node_place_model "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/android-app/app/src/main/java/com/belagavi/tourism/data/model/Place.kt"
click node_api "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/backend/app/api/routes.py"
click node_auth "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/backend/app/auth/firebase.py"
click node_limiter "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/backend/app/auth/rate_limiter.py"
click node_rag "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/backend/app/services/rag_service.py"
click node_query_router "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/backend/app/services/query_router.py"
click node_search "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/backend/app/services/search_service.py"
click node_web_research "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/backend/app/services/web_research_service.py"
click node_context "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/backend/app/rag/context_builder.py"
click node_llm "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/backend/app/rag/llm_client.py"
click node_embedder "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/backend/app/embeddings/embedder.py"
click node_db_session "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/backend/app/db/database.py"
click node_destination "https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/backend/app/models/destination.py"

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_android,node_android_nav,node_android_explore,node_android_place,node_android_ai,node_android_ai_vm,node_android_ai_repo,node_android_api,node_web,node_web_ai toneBlue
class node_web_reviews,node_web_settings,node_android_auth,node_android_expenses,node_android_profile toneAmber
class node_api,node_auth,node_limiter,node_rag,node_query_router,node_search,node_web_research,node_context,node_llm,node_embedder,node_db_session toneMint
class node_places,node_place_model,node_destination,node_postgres,node_firebase_auth,node_firestore,node_gemini toneRose
class node_traveler toneIndigo
```

## Components

### Travel clients

- [Android app](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/android-app/app/src/main/java/com/belagavi/tourism/MainActivity.kt): `android-app/app/src/main/java/com/belagavi/tourism/MainActivity.kt`
- [Android navigation](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/android-app/app/src/main/java/com/belagavi/tourism/ui/navigation/NavGraph.kt): `android-app/app/src/main/java/com/belagavi/tourism/ui/navigation/NavGraph.kt`
- [Place exploration](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/android-app/app/src/main/java/com/belagavi/tourism/ui/dashboard/ExploreView.kt): `android-app/app/src/main/java/com/belagavi/tourism/ui/dashboard/ExploreView.kt`
- [Place details](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/android-app/app/src/main/java/com/belagavi/tourism/ui/dashboard/PlaceDetailView.kt): `android-app/app/src/main/java/com/belagavi/tourism/ui/dashboard/PlaceDetailView.kt`
- [AI chat UI](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/android-app/app/src/main/java/com/belagavi/tourism/ui/ai/AiChatView.kt): `android-app/app/src/main/java/com/belagavi/tourism/ui/ai/AiChatView.kt`
- [Chat state](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/android-app/app/src/main/java/com/belagavi/tourism/ui/ai/AiChatViewModel.kt): `android-app/app/src/main/java/com/belagavi/tourism/ui/ai/AiChatViewModel.kt`
- [AI client](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/android-app/app/src/main/java/com/belagavi/tourism/data/repository/AiRepository.kt): `android-app/app/src/main/java/com/belagavi/tourism/data/repository/AiRepository.kt`
- [Chat API client](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/android-app/app/src/main/java/com/belagavi/tourism/data/network/AiApiService.kt): `android-app/app/src/main/java/com/belagavi/tourism/data/network/AiApiService.kt`
- [Web application](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/public/static/main.js): `public/static/main.js`
- [Web AI assistant](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/public/static/ai-assistant.js): `public/static/ai-assistant.js`

### Trip planning

- [Reviews UI](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/public/static/reviews.js): `public/static/reviews.js`
- [Web settings](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/public/static/settings.js): `public/static/settings.js`
- [Android authentication](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/android-app/app/src/main/java/com/belagavi/tourism/ui/auth/AuthViewModel.kt): `android-app/app/src/main/java/com/belagavi/tourism/ui/auth/AuthViewModel.kt`
- [Expense tracker](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/android-app/app/src/main/java/com/belagavi/tourism/ui/dashboard/ExpenseView.kt): `android-app/app/src/main/java/com/belagavi/tourism/ui/dashboard/ExpenseView.kt`
- [Profile and wishlist](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/android-app/app/src/main/java/com/belagavi/tourism/ui/dashboard/ProfileView.kt): `android-app/app/src/main/java/com/belagavi/tourism/ui/dashboard/ProfileView.kt`

### AI and search backend

- [FastAPI routes](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/backend/app/api/routes.py): `backend/app/api/routes.py`
- [Firebase token verification](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/backend/app/auth/firebase.py): `backend/app/auth/firebase.py`
- [Chat rate limiting](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/backend/app/auth/rate_limiter.py): `backend/app/auth/rate_limiter.py`
- [RAG orchestration](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/backend/app/services/rag_service.py): `backend/app/services/rag_service.py`
- [Research routing](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/backend/app/services/query_router.py): `backend/app/services/query_router.py`
- [Semantic retrieval](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/backend/app/services/search_service.py): `backend/app/services/search_service.py`
- [Web research](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/backend/app/services/web_research_service.py): `backend/app/services/web_research_service.py`
- [Context building](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/backend/app/rag/context_builder.py): `backend/app/rag/context_builder.py`
- [Answer generation](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/backend/app/rag/llm_client.py): `backend/app/rag/llm_client.py`
- [Query embeddings](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/backend/app/embeddings/embedder.py): `backend/app/embeddings/embedder.py`
- [Database sessions](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/backend/app/db/database.py): `backend/app/db/database.py`

### Data and integrations

- [Place catalog](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/android-app/app/src/main/java/com/belagavi/tourism/data/repository/PlacesRepository.kt): `android-app/app/src/main/java/com/belagavi/tourism/data/repository/PlacesRepository.kt`
- [Place model](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/android-app/app/src/main/java/com/belagavi/tourism/data/model/Place.kt): `android-app/app/src/main/java/com/belagavi/tourism/data/model/Place.kt`
- [Destination records](https://github.com/yuvaraj-ui132/belagavi_tourism/blob/main/backend/app/models/destination.py): `backend/app/models/destination.py`
- **PostgreSQL and pgvector**
- **Firebase Authentication**
- **Cloud Firestore**
- **Google Gemini**

### Other components

- **Traveler**

## Connections

- Traveler → Android app: uses
- Traveler → Web application: uses
- Android app → Android navigation: starts navigation (evidence: `android-app/app/src/main/java/com/belagavi/tourism/MainActivity.kt`)
- Android navigation → AI chat UI: routes to (evidence: `android-app/app/src/main/java/com/belagavi/tourism/ui/navigation/NavGraph.kt`)
- Android navigation → Place details: routes to (evidence: `android-app/app/src/main/java/com/belagavi/tourism/ui/navigation/NavGraph.kt`)
- Android navigation → Android authentication: routes to (evidence: `android-app/app/src/main/java/com/belagavi/tourism/ui/navigation/NavGraph.kt`)
- Place exploration → Place catalog: reads places (evidence: `android-app/app/src/main/java/com/belagavi/tourism/ui/dashboard/ExploreView.kt`)
- Place catalog → Place model: provides (evidence: `android-app/app/src/main/java/com/belagavi/tourism/data/repository/PlacesRepository.kt`)
- AI chat UI → Chat state: uses state (evidence: `android-app/app/src/main/java/com/belagavi/tourism/ui/ai/AiChatView.kt`)
- AI client → Chat API client: sends chat (evidence: `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 (evidence: `backend/app/api/routes.py`)
- FastAPI routes → Chat rate limiting: checks limit (evidence: `backend/app/api/routes.py`)
- FastAPI routes → RAG orchestration: delegates chat (evidence: `backend/app/api/routes.py`)
- FastAPI routes → Semantic retrieval: delegates search (evidence: `backend/app/api/routes.py`)
- RAG orchestration → Research routing: classifies query (evidence: `backend/app/services/rag_service.py`)
- RAG orchestration → Semantic retrieval: retrieves context (evidence: `backend/app/services/rag_service.py`)
- RAG orchestration → Web research: requests live sources (evidence: `backend/app/services/rag_service.py`)
- RAG orchestration → Context building: builds context (evidence: `backend/app/services/rag_service.py`)
- RAG orchestration → Answer generation: generates answer (evidence: `backend/app/services/rag_service.py`)
- Semantic retrieval → Query embeddings: embeds query (evidence: `backend/app/services/search_service.py`)
- Semantic retrieval → Destination records: queries records (evidence: `backend/app/services/search_service.py`)
- Database sessions → PostgreSQL and pgvector: opens sessions (evidence: `backend/app/db/database.py`)
- Semantic retrieval → Database sessions: uses database
- Query embeddings → Google Gemini: creates embeddings
- Answer generation → Google Gemini: generates text (evidence: `backend/app/rag/llm_client.py`)
- Web research → Traveler: searches current web
