# sabanvurgun03-ui/aw1kpanel architecture

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

- Interactive diagram: https://gitdiagram.com/sabanvurgun03-ui/aw1kpanel
- Repository: https://github.com/sabanvurgun03-ui/aw1kpanel

## Overview

AW1K Panel is an Android control panel for an Arcadyan AW1000 OpenWrt modem and its KediRay VPN. The user connects to a modem, then uses the app’s screens to inspect status or request configuration and control changes; the ViewModel coordinates UI state and modem operations. The repository also documents usage reporting, themes, updates, logs, smart band selection, and background VPN/SMS alerts. Feature-screen relationships to the ViewModel and its data dependencies are supported by the source index; some deeper feature-to-operation links are documented only in the README.

Main entry points: [`app/src/main/java/com/saban/aw1kpanel/ui/MainScreen.kt`](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/MainScreen.kt) (Main navigation), [`app/src/main/java/com/saban/aw1kpanel/ui/PanelViewModel.kt`](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/PanelViewModel.kt) (Panel ViewModel), [`app/src/main/java/com/saban/aw1kpanel/data/PanelRepository.kt`](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/data/PanelRepository.kt) (Panel repository), [`app/src/main/java/com/saban/aw1kpanel/MainActivity.kt`](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/MainActivity.kt) (App activity)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App entry"]
  node_activity["App activity<br/>[MainActivity.kt]"]
end

subgraph group_ui["Control screens"]
  node_main_screen["Main navigation<br/>[MainScreen.kt]"]
  node_viewmodel["Panel ViewModel<br/>[PanelViewModel.kt]"]
  node_home["Home and modem<br/>[HomeCards.kt]"]
  node_devices["Devices<br/>[DevicesTab.kt]"]
  node_wifi["Wi-Fi<br/>[WifiTab.kt]"]
  node_vpn["VPN and profiles<br/>[VpnTab.kt]"]
  node_profile_editor["Profile editor<br/>[ProfileEditor.kt]"]
  node_settings_screen["KediRay settings"]
  node_band["Band selection<br/>[BandLockTab.kt]"]
  node_speed["Speed test<br/>[SpeedTab.kt]"]
  node_usage["Usage reports<br/>[UsageTab.kt]"]
  node_sms["SMS<br/>[SmsTab.kt]"]
  node_logs["VPN logs<br/>[LogTab.kt]"]
  node_update["KediRay updates<br/>[UpdateTab.kt]"]
  node_themes["Themes<br/>[ThemesScreen.kt]"]
end

subgraph group_data["Modem and app data"]
  node_settings_spec["Settings schema"]
  node_repository["Panel repository<br/>[PanelRepository.kt]"]
  node_ubus["ubus client<br/>[UbusClient.kt]"]
  node_settings_store[("Settings store<br/>[SettingsStore.kt]")]
  node_link_parser["Link parser<br/>[LinkParser.kt]"]
  node_band_scanner["Band scanner<br/>[BandScanner.kt]"]
  node_speed_test["Speed test engine<br/>[SpeedTest.kt]"]
  node_app_updater["App updater<br/>[AppUpdater.kt]"]
  node_usage_counter["Usage counter<br/>[UsageCounter.kt]"]
end

subgraph group_background["Background services"]
  node_watch["VPN/SMS monitor<br/>[VpnWatchService.kt]"]
end

node_user(("Phone user"))
node_router{{"AW1000 modem"}}

node_user -->|"opens"| node_activity
node_activity -->|"creates"| node_viewmodel
node_activity -->|"shows"| node_main_screen
node_main_screen -->|"dispatches actions"| node_viewmodel
node_main_screen -->|"routes to"| node_devices
node_main_screen -->|"routes to"| node_wifi
node_main_screen -->|"routes to"| node_vpn
node_main_screen -->|"routes to"| node_band
node_main_screen -->|"routes to"| node_speed
node_main_screen -->|"routes to"| node_usage
node_main_screen -->|"routes to"| node_sms
node_main_screen -->|"routes to"| node_logs
node_main_screen -->|"routes to"| node_update
node_viewmodel -->|"requests modem data"| node_repository
node_viewmodel -->|"reads and saves"| node_settings_store
node_viewmodel -->|"checks app releases"| node_app_updater
node_viewmodel -->|"runs scans"| node_band_scanner
node_viewmodel -->|"records usage"| node_usage_counter
node_profile_editor -->|"parses links"| node_link_parser
node_vpn -->|"opens editor"| node_profile_editor
node_settings_screen -->|"saves changes"| node_viewmodel
node_settings_screen -->|"renders options"| node_settings_spec
node_repository -->|"calls methods"| node_ubus
node_ubus -->|"sends RPC"| node_router
node_band_scanner -->|"uses modem operations"| node_repository
node_activity -->|"starts monitoring"| node_watch
node_watch -->|"polls modem"| node_repository
node_watch -->|"reads alert settings"| node_settings_store
node_speed -->|"requests tests"| node_viewmodel
node_repository -.->|"runs speed checks"| node_speed_test
node_usage -.->|"displays totals"| node_usage_counter
node_viewmodel -.->|"provides theme state"| node_themes
node_viewmodel -.->|"provides settings data"| node_settings_screen

click node_activity "https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/MainActivity.kt"
click node_main_screen "https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/MainScreen.kt"
click node_viewmodel "https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/PanelViewModel.kt"
click node_home "https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/HomeCards.kt"
click node_devices "https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/DevicesTab.kt"
click node_wifi "https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/WifiTab.kt"
click node_vpn "https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/VpnTab.kt"
click node_profile_editor "https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/ProfileEditor.kt"
click node_settings_screen "https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/KediSettingsScreen.kt"
click node_settings_spec "https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/data/KediSettingsSpec.kt"
click node_band "https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/BandLockTab.kt"
click node_speed "https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/SpeedTab.kt"
click node_usage "https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/UsageTab.kt"
click node_sms "https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/SmsTab.kt"
click node_logs "https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/LogTab.kt"
click node_update "https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/UpdateTab.kt"
click node_themes "https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/ThemesScreen.kt"
click node_repository "https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/data/PanelRepository.kt"
click node_ubus "https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/data/UbusClient.kt"
click node_settings_store "https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/data/SettingsStore.kt"
click node_link_parser "https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/data/LinkParser.kt"
click node_band_scanner "https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/data/BandScanner.kt"
click node_speed_test "https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/data/SpeedTest.kt"
click node_app_updater "https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/data/AppUpdater.kt"
click node_usage_counter "https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/data/UsageCounter.kt"
click node_watch "https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/watch/VpnWatchService.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_user toneBlue
class node_main_screen,node_viewmodel,node_home,node_devices,node_wifi,node_vpn,node_profile_editor,node_settings_screen,node_band,node_speed,node_usage,node_sms,node_logs,node_update,node_themes toneAmber
class node_settings_spec,node_repository,node_ubus,node_settings_store,node_link_parser,node_band_scanner,node_speed_test,node_app_updater,node_usage_counter toneMint
class node_watch toneRose
class node_router toneIndigo
```

## Components

### App entry

- [App activity](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/MainActivity.kt): `app/src/main/java/com/saban/aw1kpanel/MainActivity.kt`

### Control screens

- [Main navigation](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/MainScreen.kt): `app/src/main/java/com/saban/aw1kpanel/ui/MainScreen.kt`
- [Panel ViewModel](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/PanelViewModel.kt): `app/src/main/java/com/saban/aw1kpanel/ui/PanelViewModel.kt`
- [Home and modem](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/HomeCards.kt): `app/src/main/java/com/saban/aw1kpanel/ui/HomeCards.kt`
- [Devices](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/DevicesTab.kt): `app/src/main/java/com/saban/aw1kpanel/ui/DevicesTab.kt`
- [Wi-Fi](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/WifiTab.kt): `app/src/main/java/com/saban/aw1kpanel/ui/WifiTab.kt`
- [VPN and profiles](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/VpnTab.kt): `app/src/main/java/com/saban/aw1kpanel/ui/VpnTab.kt`
- [Profile editor](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/ProfileEditor.kt): `app/src/main/java/com/saban/aw1kpanel/ui/ProfileEditor.kt`
- [KediRay settings](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/KediSettingsScreen.kt): `app/src/main/java/com/saban/aw1kpanel/ui/KediSettingsScreen.kt`
- [Band selection](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/BandLockTab.kt): `app/src/main/java/com/saban/aw1kpanel/ui/BandLockTab.kt`
- [Speed test](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/SpeedTab.kt): `app/src/main/java/com/saban/aw1kpanel/ui/SpeedTab.kt`
- [Usage reports](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/UsageTab.kt): `app/src/main/java/com/saban/aw1kpanel/ui/UsageTab.kt`
- [SMS](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/SmsTab.kt): `app/src/main/java/com/saban/aw1kpanel/ui/SmsTab.kt`
- [VPN logs](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/LogTab.kt): `app/src/main/java/com/saban/aw1kpanel/ui/LogTab.kt`
- [KediRay updates](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/UpdateTab.kt): `app/src/main/java/com/saban/aw1kpanel/ui/UpdateTab.kt`
- [Themes](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/ui/ThemesScreen.kt): `app/src/main/java/com/saban/aw1kpanel/ui/ThemesScreen.kt`

### Modem and app data

- [Settings schema](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/data/KediSettingsSpec.kt): `app/src/main/java/com/saban/aw1kpanel/data/KediSettingsSpec.kt`
- [Panel repository](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/data/PanelRepository.kt): `app/src/main/java/com/saban/aw1kpanel/data/PanelRepository.kt`
- [ubus client](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/data/UbusClient.kt): `app/src/main/java/com/saban/aw1kpanel/data/UbusClient.kt`
- [Settings store](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/data/SettingsStore.kt): `app/src/main/java/com/saban/aw1kpanel/data/SettingsStore.kt`
- [Link parser](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/data/LinkParser.kt): `app/src/main/java/com/saban/aw1kpanel/data/LinkParser.kt`
- [Band scanner](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/data/BandScanner.kt): `app/src/main/java/com/saban/aw1kpanel/data/BandScanner.kt`
- [Speed test engine](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/data/SpeedTest.kt): `app/src/main/java/com/saban/aw1kpanel/data/SpeedTest.kt`
- [App updater](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/data/AppUpdater.kt): `app/src/main/java/com/saban/aw1kpanel/data/AppUpdater.kt`
- [Usage counter](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/data/UsageCounter.kt): `app/src/main/java/com/saban/aw1kpanel/data/UsageCounter.kt`

### Background services

- [VPN/SMS monitor](https://github.com/sabanvurgun03-ui/aw1kpanel/blob/main/app/src/main/java/com/saban/aw1kpanel/watch/VpnWatchService.kt): `app/src/main/java/com/saban/aw1kpanel/watch/VpnWatchService.kt`

### Other components

- **Phone user**
- **AW1000 modem**

## Connections

- Phone user → App activity: opens
- App activity → Panel ViewModel: creates (evidence: `app/src/main/java/com/saban/aw1kpanel/MainActivity.kt`)
- App activity → Main navigation: shows (evidence: `app/src/main/java/com/saban/aw1kpanel/MainActivity.kt`)
- Main navigation → Panel ViewModel: dispatches actions (evidence: `app/src/main/java/com/saban/aw1kpanel/ui/MainScreen.kt`)
- Main navigation → Devices: routes to (evidence: `app/src/main/java/com/saban/aw1kpanel/ui/MainScreen.kt`)
- Main navigation → Wi-Fi: routes to (evidence: `app/src/main/java/com/saban/aw1kpanel/ui/MainScreen.kt`)
- Main navigation → VPN and profiles: routes to (evidence: `app/src/main/java/com/saban/aw1kpanel/ui/MainScreen.kt`)
- Main navigation → Band selection: routes to (evidence: `app/src/main/java/com/saban/aw1kpanel/ui/MainScreen.kt`)
- Main navigation → Speed test: routes to (evidence: `app/src/main/java/com/saban/aw1kpanel/ui/MainScreen.kt`)
- Main navigation → Usage reports: routes to (evidence: `app/src/main/java/com/saban/aw1kpanel/ui/MainScreen.kt`)
- Main navigation → SMS: routes to (evidence: `app/src/main/java/com/saban/aw1kpanel/ui/MainScreen.kt`)
- Main navigation → VPN logs: routes to (evidence: `app/src/main/java/com/saban/aw1kpanel/ui/MainScreen.kt`)
- Main navigation → KediRay updates: routes to (evidence: `app/src/main/java/com/saban/aw1kpanel/ui/MainScreen.kt`)
- Panel ViewModel → Panel repository: requests modem data (evidence: `app/src/main/java/com/saban/aw1kpanel/ui/PanelViewModel.kt`)
- Panel ViewModel → Settings store: reads and saves (evidence: `app/src/main/java/com/saban/aw1kpanel/ui/PanelViewModel.kt`)
- Panel ViewModel → App updater: checks app releases (evidence: `app/src/main/java/com/saban/aw1kpanel/ui/PanelViewModel.kt`)
- Panel ViewModel → Band scanner: runs scans (evidence: `app/src/main/java/com/saban/aw1kpanel/ui/PanelViewModel.kt`)
- Panel ViewModel → Usage counter: records usage (evidence: `app/src/main/java/com/saban/aw1kpanel/ui/PanelViewModel.kt`)
- Profile editor → Link parser: parses links (evidence: `app/src/main/java/com/saban/aw1kpanel/ui/ProfileEditor.kt`)
- VPN and profiles → Profile editor: opens editor (evidence: `app/src/main/java/com/saban/aw1kpanel/ui/VpnTab.kt`)
- KediRay settings → Panel ViewModel: saves changes (evidence: `app/src/main/java/com/saban/aw1kpanel/ui/KediSettingsScreen.kt`)
- KediRay settings → Settings schema: renders options (evidence: `app/src/main/java/com/saban/aw1kpanel/ui/KediSettingsScreen.kt`)
- Panel repository → ubus client: calls methods (evidence: `app/src/main/java/com/saban/aw1kpanel/data/PanelRepository.kt`)
- ubus client → AW1000 modem: sends RPC (evidence: `app/src/main/java/com/saban/aw1kpanel/data/UbusClient.kt`)
- Band scanner → Panel repository: uses modem operations (evidence: `app/src/main/java/com/saban/aw1kpanel/data/BandScanner.kt`)
- App activity → VPN/SMS monitor: starts monitoring (evidence: `app/src/main/java/com/saban/aw1kpanel/MainActivity.kt`)
- VPN/SMS monitor → Panel repository: polls modem (evidence: `app/src/main/java/com/saban/aw1kpanel/watch/VpnWatchService.kt`)
- VPN/SMS monitor → Settings store: reads alert settings (evidence: `app/src/main/java/com/saban/aw1kpanel/watch/VpnWatchService.kt`)
- Speed test → Panel ViewModel: requests tests (evidence: `app/src/main/java/com/saban/aw1kpanel/ui/SpeedTab.kt`)
- Panel repository → Speed test engine: runs speed checks
- Usage reports → Usage counter: displays totals
- Panel ViewModel → Themes: provides theme state (evidence: `app/src/main/java/com/saban/aw1kpanel/ui/ThemesScreen.kt`)
- Panel ViewModel → KediRay settings: provides settings data (evidence: `app/src/main/java/com/saban/aw1kpanel/ui/KediSettingsScreen.kt`)
