# pranshulgg/weathermaster architecture

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

- Interactive diagram: https://gitdiagram.com/pranshulgg/weathermaster
- Repository: https://github.com/pranshulgg/weathermaster

## Overview

WeatherMaster is an Android weather app supporting location search, provider selection, forecasts, air quality, and alerts. The central runtime path is weather orchestration through source-backed repositories, with cached domain data persisted locally. The graph also preserves location management, backup, and scheduled refresh capabilities visible in the tree. Several connections are based on the source index or README rather than inspected implementation; those uncertain integrations are marked dashed or omitted.

Main entry points: [`app/src/main/java/com/pranshulgg/weather_master_app/data/repository/data/BaseRepository.kt`](https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/repository/data/BaseRepository.kt) (Fetch and cache), [`app/src/main/java/com/pranshulgg/weather_master_app/data/local/WeatherMasterDatabase.kt`](https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/local/WeatherMasterDatabase.kt) (Room database), [`app/src/main/java/com/pranshulgg/weather_master_app/core/managers/WeatherManager.kt`](https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/core/managers/WeatherManager.kt) (Weather orchestration), [`app/src/main/java/com/pranshulgg/weather_master_app/WeatherMasterApp.kt`](https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/WeatherMasterApp.kt) (App UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_activity["Android entry<br/>[MainActivity.kt]"]
  node_appui["App UI"]
end

subgraph group_location["Locations and sources"]
  node_searchprovider["Search provider"]
  node_contextrepo["Location context"]
  node_sourcemanager["Source selection<br/>[SourceManager.kt]"]
end

subgraph group_weather["Weather data"]
  node_weathermanager["Weather orchestration<br/>[WeatherManager.kt]"]
  node_sourcedata["Source data"]
  node_base["Fetch and cache<br/>[BaseRepository.kt]"]
  node_weathercap["Forecast capability"]
  node_aqicap["Air quality capability"]
  node_alertcap["Alert capability<br/>[AlertCapability.kt]"]
end

subgraph group_storage["Persistence and refresh"]
  node_database[("Room database")]
  node_contextdao["Location DAO"]
  node_weatherdao["Forecast DAO<br/>[WeatherDao.kt]"]
  node_alertsdao["Alerts DAO<br/>[AlertsDao.kt]"]
  node_worker["Scheduled refresh<br/>[WeatherWorker.kt]"]
  node_backup["Backup and restore"]
end

subgraph group_integration["Provider integrations"]
  node_searchrepos["Location search"]
  node_weatheradapters["Weather providers"]
  node_alertadapters["Alert providers"]
  node_aqiadapters["Air quality providers"]
end

node_user(("App user"))

node_user -.->|"opens"| node_activity
node_activity -.->|"launches"| node_appui
node_appui -.->|"searches locations"| node_searchprovider
node_searchprovider -->|"selects repository"| node_searchrepos
node_appui -.->|"requests weather"| node_weathermanager
node_weathermanager -->|"reads context"| node_contextrepo
node_weathermanager -->|"requests source data"| node_sourcedata
node_contextrepo -->|"cleans source extras"| node_sourcemanager
node_contextrepo -->|"reads and writes"| node_contextdao
node_sourcedata -.->|"delegates data"| node_base
node_base -->|"fetches forecasts"| node_weathercap
node_base -->|"fetches air quality"| node_aqicap
node_base -->|"fetches alerts"| node_alertcap
node_base -->|"saves forecasts"| node_weatherdao
node_weatheradapters -.->|"provides forecast data"| node_weathercap
node_alertadapters -.->|"provides alert data"| node_alertcap
node_aqiadapters -.->|"provides air data"| node_aqicap
node_database -.->|"hosts"| node_contextdao
node_database -.->|"hosts"| node_weatherdao
node_database -.->|"hosts"| node_alertsdao
node_worker -.->|"refreshes"| node_weathermanager
node_backup -.->|"backs up data"| node_database

click node_activity "https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/MainActivity.kt"
click node_appui "https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/WeatherMasterApp.kt"
click node_searchprovider "https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/provider/SearchRepositoryProvider.kt"
click node_searchrepos "https://github.com/pranshulgg/weathermaster/tree/main/app/src/main/java/com/pranshulgg/weather_master_app/core/network/sources/search"
click node_contextrepo "https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/repository/WeatherContextRepository.kt"
click node_sourcemanager "https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/core/managers/SourceManager.kt"
click node_weathermanager "https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/core/managers/WeatherManager.kt"
click node_sourcedata "https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/repository/data/SourceDataRepository.kt"
click node_base "https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/repository/data/BaseRepository.kt"
click node_weathercap "https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/repository/capability/WeatherCapability.kt"
click node_aqicap "https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/repository/capability/AirQualityCapability.kt"
click node_alertcap "https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/repository/capability/AlertCapability.kt"
click node_weatheradapters "https://github.com/pranshulgg/weathermaster/tree/main/app/src/main/java/com/pranshulgg/weather_master_app/core/network/sources/weather"
click node_alertadapters "https://github.com/pranshulgg/weathermaster/tree/main/app/src/main/java/com/pranshulgg/weather_master_app/core/network/sources/alerts"
click node_aqiadapters "https://github.com/pranshulgg/weathermaster/tree/main/app/src/main/java/com/pranshulgg/weather_master_app/core/network/sources/airquality"
click node_database "https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/local/WeatherMasterDatabase.kt"
click node_contextdao "https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/local/dao/weather/WeatherContextDao.kt"
click node_weatherdao "https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/local/dao/weather/WeatherDao.kt"
click node_alertsdao "https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/local/dao/alerts/AlertsDao.kt"
click node_worker "https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/worker/WeatherWorker.kt"
click node_backup "https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/backup/BackupRepository.kt"

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_activity,node_appui,node_user toneBlue
class node_searchprovider,node_contextrepo,node_sourcemanager toneAmber
class node_weathermanager,node_sourcedata,node_base,node_weathercap,node_aqicap,node_alertcap toneMint
class node_database,node_contextdao,node_weatherdao,node_alertsdao,node_worker,node_backup toneRose
class node_searchrepos,node_weatheradapters,node_alertadapters,node_aqiadapters toneIndigo
```

## Components

### App experience

- [Android entry](https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/MainActivity.kt): `app/src/main/java/com/pranshulgg/weather_master_app/MainActivity.kt`
- [App UI](https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/WeatherMasterApp.kt): `app/src/main/java/com/pranshulgg/weather_master_app/WeatherMasterApp.kt`

### Locations and sources

- [Search provider](https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/provider/SearchRepositoryProvider.kt): `app/src/main/java/com/pranshulgg/weather_master_app/data/provider/SearchRepositoryProvider.kt`
- [Location context](https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/repository/WeatherContextRepository.kt): `app/src/main/java/com/pranshulgg/weather_master_app/data/repository/WeatherContextRepository.kt`
- [Source selection](https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/core/managers/SourceManager.kt): `app/src/main/java/com/pranshulgg/weather_master_app/core/managers/SourceManager.kt`

### Weather data

- [Weather orchestration](https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/core/managers/WeatherManager.kt): `app/src/main/java/com/pranshulgg/weather_master_app/core/managers/WeatherManager.kt`
- [Source data](https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/repository/data/SourceDataRepository.kt): `app/src/main/java/com/pranshulgg/weather_master_app/data/repository/data/SourceDataRepository.kt`
- [Fetch and cache](https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/repository/data/BaseRepository.kt): `app/src/main/java/com/pranshulgg/weather_master_app/data/repository/data/BaseRepository.kt`
- [Forecast capability](https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/repository/capability/WeatherCapability.kt): `app/src/main/java/com/pranshulgg/weather_master_app/data/repository/capability/WeatherCapability.kt`
- [Air quality capability](https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/repository/capability/AirQualityCapability.kt): `app/src/main/java/com/pranshulgg/weather_master_app/data/repository/capability/AirQualityCapability.kt`
- [Alert capability](https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/repository/capability/AlertCapability.kt): `app/src/main/java/com/pranshulgg/weather_master_app/data/repository/capability/AlertCapability.kt`

### Persistence and refresh

- [Room database](https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/local/WeatherMasterDatabase.kt): `app/src/main/java/com/pranshulgg/weather_master_app/data/local/WeatherMasterDatabase.kt`
- [Location DAO](https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/local/dao/weather/WeatherContextDao.kt): `app/src/main/java/com/pranshulgg/weather_master_app/data/local/dao/weather/WeatherContextDao.kt`
- [Forecast DAO](https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/local/dao/weather/WeatherDao.kt): `app/src/main/java/com/pranshulgg/weather_master_app/data/local/dao/weather/WeatherDao.kt`
- [Alerts DAO](https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/local/dao/alerts/AlertsDao.kt): `app/src/main/java/com/pranshulgg/weather_master_app/data/local/dao/alerts/AlertsDao.kt`
- [Scheduled refresh](https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/worker/WeatherWorker.kt): `app/src/main/java/com/pranshulgg/weather_master_app/data/worker/WeatherWorker.kt`
- [Backup and restore](https://github.com/pranshulgg/weathermaster/blob/main/app/src/main/java/com/pranshulgg/weather_master_app/data/backup/BackupRepository.kt): `app/src/main/java/com/pranshulgg/weather_master_app/data/backup/BackupRepository.kt`

### Provider integrations

- [Location search](https://github.com/pranshulgg/weathermaster/tree/main/app/src/main/java/com/pranshulgg/weather_master_app/core/network/sources/search): `app/src/main/java/com/pranshulgg/weather_master_app/core/network/sources/search`
- [Weather providers](https://github.com/pranshulgg/weathermaster/tree/main/app/src/main/java/com/pranshulgg/weather_master_app/core/network/sources/weather): `app/src/main/java/com/pranshulgg/weather_master_app/core/network/sources/weather`
- [Alert providers](https://github.com/pranshulgg/weathermaster/tree/main/app/src/main/java/com/pranshulgg/weather_master_app/core/network/sources/alerts): `app/src/main/java/com/pranshulgg/weather_master_app/core/network/sources/alerts`
- [Air quality providers](https://github.com/pranshulgg/weathermaster/tree/main/app/src/main/java/com/pranshulgg/weather_master_app/core/network/sources/airquality): `app/src/main/java/com/pranshulgg/weather_master_app/core/network/sources/airquality`

### Other components

- **App user**

## Connections

- App user → Android entry: opens
- Android entry → App UI: launches
- App UI → Search provider: searches locations
- Search provider → Location search: selects repository (evidence: `app/src/main/java/com/pranshulgg/weather_master_app/data/provider/SearchRepositoryProvider.kt`)
- App UI → Weather orchestration: requests weather
- Weather orchestration → Location context: reads context (evidence: `app/src/main/java/com/pranshulgg/weather_master_app/core/managers/WeatherManager.kt`)
- Weather orchestration → Source data: requests source data (evidence: `app/src/main/java/com/pranshulgg/weather_master_app/core/managers/WeatherManager.kt`)
- Location context → Source selection: cleans source extras (evidence: `app/src/main/java/com/pranshulgg/weather_master_app/data/repository/WeatherContextRepository.kt`)
- Location context → Location DAO: reads and writes (evidence: `app/src/main/java/com/pranshulgg/weather_master_app/data/repository/WeatherContextRepository.kt`)
- Source data → Fetch and cache: delegates data
- Fetch and cache → Forecast capability: fetches forecasts (evidence: `app/src/main/java/com/pranshulgg/weather_master_app/data/repository/data/BaseRepository.kt`)
- Fetch and cache → Air quality capability: fetches air quality (evidence: `app/src/main/java/com/pranshulgg/weather_master_app/data/repository/data/BaseRepository.kt`)
- Fetch and cache → Alert capability: fetches alerts (evidence: `app/src/main/java/com/pranshulgg/weather_master_app/data/repository/data/BaseRepository.kt`)
- Fetch and cache → Forecast DAO: saves forecasts (evidence: `app/src/main/java/com/pranshulgg/weather_master_app/data/repository/data/BaseRepository.kt`)
- Weather providers → Forecast capability: provides forecast data (evidence: `app/src/main/java/com/pranshulgg/weather_master_app/core/network/sources/weather/gismeteo/GismeteoRepository.kt`)
- Alert providers → Alert capability: provides alert data
- Air quality providers → Air quality capability: provides air data
- Room database → Location DAO: hosts (evidence: `app/src/main/java/com/pranshulgg/weather_master_app/data/local/WeatherMasterDatabase.kt`)
- Room database → Forecast DAO: hosts (evidence: `app/src/main/java/com/pranshulgg/weather_master_app/data/local/WeatherMasterDatabase.kt`)
- Room database → Alerts DAO: hosts (evidence: `app/src/main/java/com/pranshulgg/weather_master_app/data/local/WeatherMasterDatabase.kt`)
- Scheduled refresh → Weather orchestration: refreshes
- Backup and restore → Room database: backs up data (evidence: `app/src/main/java/com/pranshulgg/weather_master_app/data/backup/BackupRepository.kt`)
