# kaiyan910/pgo-wecatch-android architecture

> Architecture diagram of the GitHub repository kaiyan910/pgo-wecatch-android, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kaiyan910/pgo-wecatch-android
- Repository: https://github.com/kaiyan910/pgo-wecatch-android

## Overview

PGO-WeCatch is a deprecated Kotlin Android client for searching nearby Pokémon and gyms through WeCatch.net. The main workflow is location-aware map browsing, with configurable filters and map providers; a background notification service separately searches nearby Pokémon and alerts the user. The README also records OpenStreetMap support, background searching, and Pokémon generation/move-set coverage. Edges are limited to relationships shown in excerpts, the source index, or README; unsampled implementations are represented only where the tree or documentation supports them.

Main entry points: [`app/src/main/java/com/kennah/wecatch/module/main/ui/fragment/MainFragment.kt`](https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/module/main/ui/fragment/MainFragment.kt) (Main screen), [`app/src/main/java/com/kennah/wecatch/module/main/service/NotificationService.kt`](https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/module/main/service/NotificationService.kt) (Background alerts), [`app/src/main/java/com/kennah/wecatch/module/main/ui/activity/MainActivity.kt`](https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/module/main/ui/activity/MainActivity.kt) (Main activity), [`app/src/main/java/com/kennah/wecatch/module/main/presenter/MainPresenter.kt`](https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/module/main/presenter/MainPresenter.kt) (Search presenter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App entry and UI"]
  node_main_activity["Main activity<br/>[MainActivity.kt]"]
  node_main_fragment["Main screen<br/>[MainFragment.kt]"]
end

subgraph group_search["Search and alerts"]
  node_presenter["Search presenter<br/>[MainPresenter.kt]"]
  node_data_service["Search data service<br/>[DataService.kt]"]
  node_wecatch_service["WeCatch API service<br/>[WeCatchService.kt]"]
  node_location["Location helper<br/>[LocationHelper.kt]"]
  node_notification_service["Background alerts"]
  node_pokemon_gym["Pokémon and gyms<br/>[Pokemon.kt]"]
end

subgraph group_config["Filters and settings"]
  node_settings["Settings screen"]
  node_filter_ui["Filter screens<br/>[FilterActivity.kt]"]
  node_filter_manager["Filter manager<br/>[FilterManager.kt]"]
  node_filter_handlers["Filter handlers<br/>[FilterHandler.kt]"]
  node_preferences[("Preferences<br/>[Prefs.kt]")]
end

subgraph group_maps["Map presentation"]
  node_main_service["Floating map service<br/>[MainService.kt]"]
  node_map_view["Pokémon map view<br/>[PokemonMapView.kt]"]
  node_floating_view["Floating map view<br/>[FloatingMapView.kt]"]
  node_map_provider["Map providers<br/>[MapProvider.kt]"]
  node_google_map["Google Maps"]
  node_osm_map["OpenStreetMap"]
end

node_user(("App user"))
node_wecatch_site{{"WeCatch.net"}}

node_user -->|"opens"| node_main_activity
node_main_activity -->|"loads screen"| node_main_fragment
node_main_fragment -->|"opens settings"| node_settings
node_main_fragment -->|"opens filters"| node_filter_ui
node_settings -->|"opens filters"| node_filter_ui
node_settings -->|"reads and writes"| node_preferences
node_filter_ui -->|"saves filters"| node_filter_manager
node_filter_manager -->|"loads and saves"| node_preferences
node_filter_manager -.->|"applies via"| node_filter_handlers
node_main_activity -->|"starts service"| node_main_service
node_main_fragment -->|"controls alerts"| node_notification_service
node_main_fragment -->|"shows map"| node_map_view
node_main_service -->|"hosts"| node_floating_view
node_floating_view -->|"embeds"| node_map_view
node_map_view -->|"renders with"| node_map_provider
node_map_provider -->|"selects"| node_google_map
node_map_provider -->|"selects"| node_osm_map
node_notification_service -->|"gets location"| node_location
node_notification_service -->|"requests nearby"| node_presenter
node_presenter -->|"fetches results"| node_data_service
node_data_service -->|"implemented by"| node_wecatch_service
node_wecatch_service -.->|"queries"| node_wecatch_site
node_presenter -.->|"returns results"| node_pokemon_gym
node_notification_service -->|"sends alerts"| node_user

click node_main_activity "https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/module/main/ui/activity/MainActivity.kt"
click node_main_fragment "https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/module/main/ui/fragment/MainFragment.kt"
click node_settings "https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/module/settings/ui/fragment/SettingsFragment.kt"
click node_filter_ui "https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/module/filter/ui/activity/FilterActivity.kt"
click node_filter_manager "https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/local/FilterManager.kt"
click node_filter_handlers "https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/local/filter/FilterHandler.kt"
click node_preferences "https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/local/Prefs.kt"
click node_presenter "https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/module/main/presenter/MainPresenter.kt"
click node_data_service "https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/local/service/DataService.kt"
click node_wecatch_service "https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/local/service/WeCatchService.kt"
click node_location "https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/core/helper/LocationHelper.kt"
click node_notification_service "https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/module/main/service/NotificationService.kt"
click node_main_service "https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/module/main/service/MainService.kt"
click node_map_view "https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/module/main/ui/view/PokemonMapView.kt"
click node_floating_view "https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/module/main/ui/view/FloatingMapView.kt"
click node_map_provider "https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/local/map/MapProvider.kt"
click node_google_map "https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/local/map/GoogleMapProvider.kt"
click node_osm_map "https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/local/map/OpenStreetMapProvider.kt"
click node_pokemon_gym "https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/local/model/Pokemon.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_main_activity,node_main_fragment,node_user toneBlue
class node_presenter,node_data_service,node_wecatch_service,node_location,node_notification_service,node_pokemon_gym toneAmber
class node_settings,node_filter_ui,node_filter_manager,node_filter_handlers,node_preferences toneMint
class node_main_service,node_map_view,node_floating_view,node_map_provider,node_google_map,node_osm_map toneRose
class node_wecatch_site toneIndigo
```

## Components

### App entry and UI

- [Main activity](https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/module/main/ui/activity/MainActivity.kt): `app/src/main/java/com/kennah/wecatch/module/main/ui/activity/MainActivity.kt`
- [Main screen](https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/module/main/ui/fragment/MainFragment.kt): `app/src/main/java/com/kennah/wecatch/module/main/ui/fragment/MainFragment.kt`

### Search and alerts

- [Search presenter](https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/module/main/presenter/MainPresenter.kt): `app/src/main/java/com/kennah/wecatch/module/main/presenter/MainPresenter.kt`
- [Search data service](https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/local/service/DataService.kt): `app/src/main/java/com/kennah/wecatch/local/service/DataService.kt`
- [WeCatch API service](https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/local/service/WeCatchService.kt): `app/src/main/java/com/kennah/wecatch/local/service/WeCatchService.kt`
- [Location helper](https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/core/helper/LocationHelper.kt): `app/src/main/java/com/kennah/wecatch/core/helper/LocationHelper.kt`
- [Background alerts](https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/module/main/service/NotificationService.kt): `app/src/main/java/com/kennah/wecatch/module/main/service/NotificationService.kt`
- [Pokémon and gyms](https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/local/model/Pokemon.kt): `app/src/main/java/com/kennah/wecatch/local/model/Pokemon.kt`

### Filters and settings

- [Settings screen](https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/module/settings/ui/fragment/SettingsFragment.kt): `app/src/main/java/com/kennah/wecatch/module/settings/ui/fragment/SettingsFragment.kt`
- [Filter screens](https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/module/filter/ui/activity/FilterActivity.kt): `app/src/main/java/com/kennah/wecatch/module/filter/ui/activity/FilterActivity.kt`
- [Filter manager](https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/local/FilterManager.kt): `app/src/main/java/com/kennah/wecatch/local/FilterManager.kt`
- [Filter handlers](https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/local/filter/FilterHandler.kt): `app/src/main/java/com/kennah/wecatch/local/filter/FilterHandler.kt`
- [Preferences](https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/local/Prefs.kt): `app/src/main/java/com/kennah/wecatch/local/Prefs.kt`

### Map presentation

- [Floating map service](https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/module/main/service/MainService.kt): `app/src/main/java/com/kennah/wecatch/module/main/service/MainService.kt`
- [Pokémon map view](https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/module/main/ui/view/PokemonMapView.kt): `app/src/main/java/com/kennah/wecatch/module/main/ui/view/PokemonMapView.kt`
- [Floating map view](https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/module/main/ui/view/FloatingMapView.kt): `app/src/main/java/com/kennah/wecatch/module/main/ui/view/FloatingMapView.kt`
- [Map providers](https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/local/map/MapProvider.kt): `app/src/main/java/com/kennah/wecatch/local/map/MapProvider.kt`
- [Google Maps](https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/local/map/GoogleMapProvider.kt): `app/src/main/java/com/kennah/wecatch/local/map/GoogleMapProvider.kt`
- [OpenStreetMap](https://github.com/kaiyan910/pgo-wecatch-android/blob/master/app/src/main/java/com/kennah/wecatch/local/map/OpenStreetMapProvider.kt): `app/src/main/java/com/kennah/wecatch/local/map/OpenStreetMapProvider.kt`

### Other components

- **App user**
- **WeCatch.net**

## Connections

- App user → Main activity: opens (evidence: `app/src/main/java/com/kennah/wecatch/module/main/ui/activity/MainActivity.kt`)
- Main activity → Main screen: loads screen (evidence: `app/src/main/java/com/kennah/wecatch/module/main/ui/activity/MainActivity.kt`)
- Main screen → Settings screen: opens settings (evidence: `app/src/main/java/com/kennah/wecatch/module/main/ui/fragment/MainFragment.kt`)
- Main screen → Filter screens: opens filters (evidence: `app/src/main/java/com/kennah/wecatch/module/main/ui/fragment/MainFragment.kt`)
- Settings screen → Filter screens: opens filters (evidence: `app/src/main/java/com/kennah/wecatch/module/settings/ui/fragment/SettingsFragment.kt`)
- Settings screen → Preferences: reads and writes (evidence: `app/src/main/java/com/kennah/wecatch/module/settings/ui/fragment/SettingsFragment.kt`)
- Filter screens → Filter manager: saves filters (evidence: `app/src/main/java/com/kennah/wecatch/module/filter/ui/activity/FilterActivity.kt`)
- Filter manager → Preferences: loads and saves (evidence: `app/src/main/java/com/kennah/wecatch/local/FilterManager.kt`)
- Filter manager → Filter handlers: applies via
- Main activity → Floating map service: starts service (evidence: `app/src/main/java/com/kennah/wecatch/module/main/ui/activity/MainActivity.kt`)
- Main screen → Background alerts: controls alerts (evidence: `app/src/main/java/com/kennah/wecatch/module/main/ui/fragment/MainFragment.kt`)
- Main screen → Pokémon map view: shows map (evidence: `app/src/main/java/com/kennah/wecatch/module/main/ui/fragment/MainFragment.kt`)
- Floating map service → Floating map view: hosts (evidence: `app/src/main/java/com/kennah/wecatch/module/main/service/MainService.kt`)
- Floating map view → Pokémon map view: embeds (evidence: `app/src/main/java/com/kennah/wecatch/module/main/di/module/MainServiceModule.kt`)
- Pokémon map view → Map providers: renders with (evidence: `app/src/main/java/com/kennah/wecatch/module/main/di/module/MainServiceModule.kt`)
- Map providers → Google Maps: selects (evidence: `app/src/main/java/com/kennah/wecatch/module/main/di/module/MainServiceModule.kt`)
- Map providers → OpenStreetMap: selects (evidence: `app/src/main/java/com/kennah/wecatch/module/main/di/module/MainServiceModule.kt`)
- Background alerts → Location helper: gets location (evidence: `app/src/main/java/com/kennah/wecatch/module/main/service/NotificationService.kt`)
- Background alerts → Search presenter: requests nearby (evidence: `app/src/main/java/com/kennah/wecatch/module/main/service/NotificationService.kt`)
- Search presenter → Search data service: fetches results (evidence: `app/src/main/java/com/kennah/wecatch/module/main/di/module/MainServiceModule.kt`)
- Search data service → WeCatch API service: implemented by (evidence: `app/src/main/java/com/kennah/wecatch/local/service/WeCatchService.kt`)
- WeCatch API service → WeCatch.net: queries
- Search presenter → Pokémon and gyms: returns results
- Background alerts → App user: sends alerts (evidence: `app/src/main/java/com/kennah/wecatch/module/main/service/NotificationService.kt`)
