# janvi-mangwana/sustaintour-india architecture

> Architecture diagram of the GitHub repository janvi-mangwana/sustaintour-india, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/janvi-mangwana/sustaintour-india
- Repository: https://github.com/janvi-mangwana/sustaintour-india

## Overview

SustainTour India is a Streamlit application for sustainable-tourism analysis and planning. Users select a dashboard module, explore tourism and sustainability indicators, compare states, run hypothetical redistribution scenarios, or ask policy questions grounded in documents. The graph includes the sampled application entry point and analytics layers, plus documented major modules whose implementation excerpts were not available. Edges to unsampled modules are limited to SOURCE INDEX references; policy-document retrieval is shown as unverified because its wiring was not excerpted.

Main entry points: [`src/data_loader.py`](https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/data_loader.py) (Data loaders), [`app.py`](https://github.com/janvi-mangwana/sustaintour-india/blob/main/app.py) (Streamlit entry), [`src/views/tourism_intelligence.py`](https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/views/tourism_intelligence.py) (Tourism dashboard), [`src/views/ai_policy_assistant.py`](https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/views/ai_policy_assistant.py) (Policy assistant)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_entry["Streamlit entry<br/>[app.py]"]
  node_styles["Theme styling<br/>[styles.py]"]
end

subgraph group_analytics["Tourism Analytics"]
  node_tourism["Tourism dashboard"]
  node_anomaly["Anomaly detection"]
  node_metrics["Tourism metrics<br/>[metrics.py]"]
  node_charts["Chart builders<br/>[charts.py]"]
  node_ml["ML intelligence<br/>[ml_intelligence.py]"]
end

subgraph group_sustainability["Sustainability Planning"]
  node_sustain["Sustainability dashboard"]
  node_comparison["State comparison"]
  node_planning["Planning simulator<br/>[planning_studio.py]"]
end

subgraph group_policy["Policy Assistant"]
  node_policy["Policy assistant"]
  node_policy_docs["Policy PDFs"]
end

subgraph group_data["Data and Mapping"]
  node_loader["Data loaders<br/>[data_loader.py]"]
  node_geo["Geo alignment<br/>[geo_utils.py]"]
  node_constants["Paths and mappings<br/>[constants.py]"]
  node_tourism_data[("Tourism datasets")]
  node_sustain_data[("Sustainability datasets")]
  node_geo_data[("State boundaries")]
end

node_user(("Dashboard user"))
node_gemini["Gemini API"]

node_user -->|"selects module"| node_entry
node_entry -->|"loads styling"| node_styles
node_entry -->|"dispatches to"| node_tourism
node_entry -->|"dispatches to"| node_sustain
node_entry -->|"dispatches to"| node_comparison
node_entry -->|"dispatches to"| node_ml
node_entry -->|"dispatches to"| node_planning
node_entry -->|"dispatches to"| node_policy
node_tourism -->|"loads datasets"| node_loader
node_tourism -->|"uses metrics"| node_metrics
node_tourism -->|"detects anomalies"| node_anomaly
node_tourism -->|"builds charts"| node_charts
node_sustain -->|"loads datasets"| node_loader
node_comparison -->|"loads datasets"| node_loader
node_planning -->|"loads tourism data"| node_loader
node_ml -->|"loads tourism data"| node_loader
node_loader -->|"reads"| node_tourism_data
node_loader -->|"reads"| node_sustain_data
node_loader -->|"reads"| node_geo_data
node_loader -->|"uses paths"| node_constants
node_charts -->|"aligns map data"| node_geo
node_geo -->|"uses state mappings"| node_constants
node_policy -->|"requests generation"| node_gemini
node_policy -.->|"retrieves passages"| node_policy_docs

click node_entry "https://github.com/janvi-mangwana/sustaintour-india/blob/main/app.py"
click node_styles "https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/styles.py"
click node_tourism "https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/views/tourism_intelligence.py"
click node_anomaly "https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/anomaly_detection.py"
click node_metrics "https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/metrics.py"
click node_charts "https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/charts.py"
click node_sustain "https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/views/sustainability_intelligence.py"
click node_comparison "https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/views/state_comparison.py"
click node_planning "https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/views/planning_studio.py"
click node_ml "https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/views/ml_intelligence.py"
click node_policy "https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/views/ai_policy_assistant.py"
click node_policy_docs "https://github.com/janvi-mangwana/sustaintour-india/tree/main/research/policies"
click node_loader "https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/data_loader.py"
click node_geo "https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/geo_utils.py"
click node_constants "https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/constants.py"
click node_tourism_data "https://github.com/janvi-mangwana/sustaintour-india/tree/main/data/processed"
click node_sustain_data "https://github.com/janvi-mangwana/sustaintour-india/tree/main/data/processed"
click node_geo_data "https://github.com/janvi-mangwana/sustaintour-india/blob/main/data/geo/india_states.geojson"

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_entry,node_styles,node_user toneBlue
class node_tourism,node_anomaly,node_metrics,node_charts,node_ml toneAmber
class node_sustain,node_comparison,node_planning,node_gemini toneMint
class node_policy,node_policy_docs toneRose
class node_loader,node_geo,node_constants,node_tourism_data,node_sustain_data,node_geo_data toneIndigo
```

## Components

### Application

- [Streamlit entry](https://github.com/janvi-mangwana/sustaintour-india/blob/main/app.py): `app.py`
- [Theme styling](https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/styles.py): `src/styles.py`

### Tourism Analytics

- [Tourism dashboard](https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/views/tourism_intelligence.py): `src/views/tourism_intelligence.py`
- [Anomaly detection](https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/anomaly_detection.py): `src/anomaly_detection.py`
- [Tourism metrics](https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/metrics.py): `src/metrics.py`
- [Chart builders](https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/charts.py): `src/charts.py`
- [ML intelligence](https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/views/ml_intelligence.py): `src/views/ml_intelligence.py`

### Sustainability Planning

- [Sustainability dashboard](https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/views/sustainability_intelligence.py): `src/views/sustainability_intelligence.py`
- [State comparison](https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/views/state_comparison.py): `src/views/state_comparison.py`
- [Planning simulator](https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/views/planning_studio.py): `src/views/planning_studio.py`

### Policy Assistant

- [Policy assistant](https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/views/ai_policy_assistant.py): `src/views/ai_policy_assistant.py`
- [Policy PDFs](https://github.com/janvi-mangwana/sustaintour-india/tree/main/research/policies): `research/policies`

### Data and Mapping

- [Data loaders](https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/data_loader.py): `src/data_loader.py`
- [Geo alignment](https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/geo_utils.py): `src/geo_utils.py`
- [Paths and mappings](https://github.com/janvi-mangwana/sustaintour-india/blob/main/src/constants.py): `src/constants.py`
- [Tourism datasets](https://github.com/janvi-mangwana/sustaintour-india/tree/main/data/processed): `data/processed`
- [Sustainability datasets](https://github.com/janvi-mangwana/sustaintour-india/tree/main/data/processed): `data/processed`
- [State boundaries](https://github.com/janvi-mangwana/sustaintour-india/blob/main/data/geo/india_states.geojson): `data/geo/india_states.geojson`

### Other components

- **Dashboard user**
- **Gemini API**

## Connections

- Dashboard user → Streamlit entry: selects module (evidence: `app.py`)
- Streamlit entry → Theme styling: loads styling (evidence: `app.py`)
- Streamlit entry → Tourism dashboard: dispatches to (evidence: `app.py`)
- Streamlit entry → Sustainability dashboard: dispatches to (evidence: `app.py`)
- Streamlit entry → State comparison: dispatches to (evidence: `app.py`)
- Streamlit entry → ML intelligence: dispatches to (evidence: `app.py`)
- Streamlit entry → Planning simulator: dispatches to (evidence: `app.py`)
- Streamlit entry → Policy assistant: dispatches to (evidence: `app.py`)
- Tourism dashboard → Data loaders: loads datasets (evidence: `src/views/tourism_intelligence.py`)
- Tourism dashboard → Tourism metrics: uses metrics (evidence: `src/views/tourism_intelligence.py`)
- Tourism dashboard → Anomaly detection: detects anomalies (evidence: `src/views/tourism_intelligence.py`)
- Tourism dashboard → Chart builders: builds charts (evidence: `src/views/tourism_intelligence.py`)
- Sustainability dashboard → Data loaders: loads datasets (evidence: `src/views/sustainability_intelligence.py`)
- State comparison → Data loaders: loads datasets (evidence: `src/views/state_comparison.py`)
- Planning simulator → Data loaders: loads tourism data (evidence: `src/views/planning_studio.py`)
- ML intelligence → Data loaders: loads tourism data (evidence: `src/views/ml_intelligence.py`)
- Data loaders → Tourism datasets: reads (evidence: `src/data_loader.py`)
- Data loaders → Sustainability datasets: reads (evidence: `src/data_loader.py`)
- Data loaders → State boundaries: reads (evidence: `src/data_loader.py`)
- Data loaders → Paths and mappings: uses paths (evidence: `src/data_loader.py`)
- Chart builders → Geo alignment: aligns map data (evidence: `src/charts.py`)
- Geo alignment → Paths and mappings: uses state mappings (evidence: `src/geo_utils.py`)
- Policy assistant → Gemini API: requests generation (evidence: `src/views/ai_policy_assistant.py`)
- Policy assistant → Policy PDFs: retrieves passages
