# veer090408/udarain-dashboard architecture

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

- Interactive diagram: https://gitdiagram.com/veer090408/udarain-dashboard
- Repository: https://github.com/veer090408/udarain-dashboard

## Overview

UdaRain is a Streamlit dashboard for hourly air-quality and rain forecasts, with outdoor-activity recommendations personalized for runners, motorcyclists, and pedestrians. The user selects a location and persona; the app gathers current conditions and forecasts, scores upcoming hours, and presents status, metrics, trends, and a recommended best hour. Internally, weather data is transformed into model features and Random Forest predictions; historical data is cached locally. The excerpts show the app’s data-loading calls, but omit some UI-to-scoring and model-wrapper details, so those links are marked unverified.

Main entry points: [`app/main.py`](https://github.com/veer090408/udarain-dashboard/blob/main/app/main.py) (Streamlit dashboard), [`src/models.py`](https://github.com/veer090408/udarain-dashboard/blob/main/src/models.py) (Forecast models), [`src/data_loader.py`](https://github.com/veer090408/udarain-dashboard/blob/main/src/data_loader.py) (Weather data loader), [`src/bmkg_loader.py`](https://github.com/veer090408/udarain-dashboard/blob/main/src/bmkg_loader.py) (BMKG forecast loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dashboard["Dashboard"]
  node_ui["Streamlit dashboard<br/>[main.py]"]
  node_recommendation_ui["Score and schedule views<br/>[main.py]"]
end

subgraph group_inputs["Weather Inputs"]
  node_openmeteo{{"Open-Meteo services"}}
  node_data_loader["Weather data loader<br/>[data_loader.py]"]
  node_bmkg_loader["BMKG forecast loader<br/>[bmkg_loader.py]"]
  node_bmkg{{"BMKG forecast API"}}
  node_cache[("SQLite weather cache<br/>[udarain_cache.db]")]
end

subgraph group_prediction["Forecasting"]
  node_processing["Feature engineering<br/>[processing.py]"]
  node_models["Forecast models<br/>[models.py]"]
  node_pm_model["PM2.5 model artifact"]
  node_rain_model["Rain model artifact<br/>[rain_model.joblib]"]
  node_metrics["Model metrics<br/>[model_metrics.json]"]
end

subgraph group_recommendation["Recommendations"]
  node_scoring["Persona activity scoring<br/>[scoring.py]"]
end

node_user(("Dashboard user"))

node_user -->|"selects location"| node_ui
node_ui -->|"requests conditions"| node_data_loader
node_data_loader -->|"fetches weather"| node_openmeteo
node_ui -->|"requests forecast"| node_bmkg_loader
node_bmkg_loader -->|"fetches forecast"| node_bmkg
node_ui -->|"requests predictions"| node_models
node_models -->|"fetches current data"| node_data_loader
node_data_loader -->|"reads and writes"| node_cache
node_models -->|"builds features"| node_processing
node_models -->|"loads and saves"| node_pm_model
node_models -->|"loads and saves"| node_rain_model
node_models -->|"loads and saves"| node_metrics
node_ui -.->|"scores forecasts"| node_scoring
node_scoring -.->|"returns scores"| node_recommendation_ui
node_ui -->|"renders results"| node_recommendation_ui

click node_ui "https://github.com/veer090408/udarain-dashboard/blob/main/app/main.py"
click node_data_loader "https://github.com/veer090408/udarain-dashboard/blob/main/src/data_loader.py"
click node_bmkg_loader "https://github.com/veer090408/udarain-dashboard/blob/main/src/bmkg_loader.py"
click node_cache "https://github.com/veer090408/udarain-dashboard/blob/main/data/udarain_cache.db"
click node_processing "https://github.com/veer090408/udarain-dashboard/blob/main/src/processing.py"
click node_models "https://github.com/veer090408/udarain-dashboard/blob/main/src/models.py"
click node_pm_model "https://github.com/veer090408/udarain-dashboard/blob/main/models/air_quality_model.joblib"
click node_rain_model "https://github.com/veer090408/udarain-dashboard/blob/main/models/rain_model.joblib"
click node_metrics "https://github.com/veer090408/udarain-dashboard/blob/main/models/model_metrics.json"
click node_scoring "https://github.com/veer090408/udarain-dashboard/blob/main/src/scoring.py"
click node_recommendation_ui "https://github.com/veer090408/udarain-dashboard/blob/main/app/main.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_ui,node_recommendation_ui,node_user toneBlue
class node_openmeteo,node_data_loader,node_bmkg_loader,node_bmkg,node_cache toneAmber
class node_processing,node_models,node_pm_model,node_rain_model,node_metrics toneMint
class node_scoring toneRose
```

## Components

### Dashboard

- [Streamlit dashboard](https://github.com/veer090408/udarain-dashboard/blob/main/app/main.py): `app/main.py`
- [Score and schedule views](https://github.com/veer090408/udarain-dashboard/blob/main/app/main.py): `app/main.py`

### Weather Inputs

- **Open-Meteo services**
- [Weather data loader](https://github.com/veer090408/udarain-dashboard/blob/main/src/data_loader.py): `src/data_loader.py`
- [BMKG forecast loader](https://github.com/veer090408/udarain-dashboard/blob/main/src/bmkg_loader.py): `src/bmkg_loader.py`
- **BMKG forecast API**
- [SQLite weather cache](https://github.com/veer090408/udarain-dashboard/blob/main/data/udarain_cache.db): `data/udarain_cache.db`

### Forecasting

- [Feature engineering](https://github.com/veer090408/udarain-dashboard/blob/main/src/processing.py): `src/processing.py`
- [Forecast models](https://github.com/veer090408/udarain-dashboard/blob/main/src/models.py): `src/models.py`
- [PM2.5 model artifact](https://github.com/veer090408/udarain-dashboard/blob/main/models/air_quality_model.joblib): `models/air_quality_model.joblib`
- [Rain model artifact](https://github.com/veer090408/udarain-dashboard/blob/main/models/rain_model.joblib): `models/rain_model.joblib`
- [Model metrics](https://github.com/veer090408/udarain-dashboard/blob/main/models/model_metrics.json): `models/model_metrics.json`

### Recommendations

- [Persona activity scoring](https://github.com/veer090408/udarain-dashboard/blob/main/src/scoring.py): `src/scoring.py`

### Other components

- **Dashboard user**

## Connections

- Dashboard user → Streamlit dashboard: selects location (evidence: `app/main.py`)
- Streamlit dashboard → Weather data loader: requests conditions (evidence: `app/main.py`)
- Weather data loader → Open-Meteo services: fetches weather (evidence: `src/data_loader.py`)
- Streamlit dashboard → BMKG forecast loader: requests forecast (evidence: `app/main.py`)
- BMKG forecast loader → BMKG forecast API: fetches forecast (evidence: `src/bmkg_loader.py`)
- Streamlit dashboard → Forecast models: requests predictions (evidence: `app/main.py`)
- Forecast models → Weather data loader: fetches current data (evidence: `src/models.py`)
- Weather data loader → SQLite weather cache: reads and writes (evidence: `src/data_loader.py`)
- Forecast models → Feature engineering: builds features (evidence: `src/models.py`)
- Forecast models → PM2.5 model artifact: loads and saves (evidence: `src/models.py`)
- Forecast models → Rain model artifact: loads and saves (evidence: `src/models.py`)
- Forecast models → Model metrics: loads and saves (evidence: `src/models.py`)
- Streamlit dashboard → Persona activity scoring: scores forecasts (evidence: `app/main.py`)
- Persona activity scoring → Score and schedule views: returns scores (evidence: `app/main.py`)
- Streamlit dashboard → Score and schedule views: renders results (evidence: `app/main.py`)
