# doublenuo/szu-network-guardian architecture

> Architecture diagram of the GitHub repository doublenuo/szu-network-guardian, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/doublenuo/szu-network-guardian
- Repository: https://github.com/doublenuo/szu-network-guardian

## Overview

SZU Network Guardian monitors campus connectivity and restores authentication when needed. The primary desktop flow is configuration and monitoring through a UI/controller, network probing, region-specific SRun or ePortal authentication, and post-login verification. The repository also contains a Tauri desktop frontend bridged to the Python core, plus independent Android and iOS clients. The graph preserves these distinct runtimes and documented capabilities; some subsystem links are based on the README or SOURCE INDEX rather than sampled implementation excerpts.

Main entry points: [`szu_guardian/ui.py`](https://github.com/doublenuo/szu-network-guardian/blob/main/szu_guardian/ui.py) (Desktop UI), [`szu_guardian/network.py`](https://github.com/doublenuo/szu-network-guardian/blob/main/szu_guardian/network.py) (Connection manager), [`android/app/src/main/java/com/weno/szuguardian/GuardianService.kt`](https://github.com/doublenuo/szu-network-guardian/blob/main/android/app/src/main/java/com/weno/szuguardian/GuardianService.kt) (Foreground monitor), [`ios/SZUNetworkGuardian/GuardianModel.swift`](https://github.com/doublenuo/szu-network-guardian/blob/main/ios/SZUNetworkGuardian/GuardianModel.swift) (Guardian model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_py["Python desktop core"]
  node_py_entry["Desktop entry<br/>[main.py]"]
  node_py_ui["Desktop UI<br/>[ui.py]"]
  node_monitor["Monitor controller<br/>[monitor.py]"]
  node_network["Connection manager<br/>[network.py]"]
  node_direct["Direct networking<br/>[direct_network.py]"]
  node_srun["SRun authentication<br/>[srun.py]"]
  node_config[("Config and secrets<br/>[storage.py]")]
  node_models["Config and status<br/>[models.py]"]
  node_startup["Autostart<br/>[startup.py]"]
  node_tray["System tray<br/>[tray.py]"]
  node_logs[("Local logs<br/>[local_log.py]")]
end

subgraph group_tauri["Tauri desktop"]
  node_web_ui["React interface<br/>[App.tsx]"]
  node_tauri_api["Desktop API bridge<br/>[api.ts]"]
  node_bridge["Python JSON bridge<br/>[backend_api.py]"]
end

subgraph group_android["Android client"]
  node_android_ui["Android activity<br/>[MainActivity.kt]"]
  node_android_service["Foreground monitor<br/>[GuardianService.kt]"]
  node_android_state["Android status<br/>[GuardianState.kt]"]
  node_android_config[("Android settings<br/>[ConfigStore.kt]")]
  node_android_net["Android network client<br/>[NetworkClient.kt]"]
  node_android_srun["Android SRun<br/>[SrunClient.kt]"]
  node_boot["Boot receiver<br/>[BootReceiver.kt]"]
end

subgraph group_ios["iOS client"]
  node_ios_app["iOS app entry"]
  node_ios_view["iOS interface<br/>[ContentView.swift]"]
  node_ios_model["Guardian model"]
  node_scheduler["Background scheduler"]
  node_ios_store[("Credential store")]
  node_ios_net["iOS network client"]
  node_ios_srun["iOS SRun<br/>[SrunClient.swift]"]
end

subgraph group_external["Network services"]
  node_campus{{"Campus network"}}
  node_internet{{"Public internet"}}
end

node_user(("User"))

node_user -->|"configures and starts"| node_py_ui
node_py_entry -->|"launches"| node_py_ui
node_py_ui -->|"starts and receives events"| node_monitor
node_monitor -->|"checks connectivity"| node_network
node_network -->|"uses direct routes"| node_direct
node_network -->|"delegates SRun login"| node_srun
node_network -->|"probes and authenticates"| node_campus
node_network -->|"verifies access"| node_internet
node_py_ui -->|"loads and saves"| node_config
node_py_ui -->|"sets autostart"| node_startup
node_py_ui -->|"controls"| node_tray
node_py_ui -->|"writes logs"| node_logs
node_config -->|"loads configuration"| node_models
node_web_ui -->|"calls desktop API"| node_tauri_api
node_user -->|"configures and starts"| node_web_ui
node_tauri_api -->|"invokes local JSON bridge"| node_bridge
node_bridge -->|"calls Python core"| node_network
node_android_ui -->|"loads and saves settings"| node_android_config
node_android_ui -->|"starts monitoring"| node_android_service
node_boot -->|"starts on boot"| node_android_service
node_boot -->|"checks startup settings"| node_android_config
node_android_service -->|"loads settings"| node_android_config
node_android_service -->|"runs checks"| node_android_net
node_android_service -->|"publishes status"| node_android_state
node_android_net -->|"delegates SRun login"| node_android_srun
node_android_net -->|"authenticates"| node_campus
node_android_net -->|"checks access"| node_internet
node_ios_app -->|"shows interface"| node_ios_view
node_ios_view -->|"uses model"| node_ios_model
node_ios_model -->|"loads and saves credentials"| node_ios_store
node_ios_model -->|"checks connection"| node_ios_net
node_ios_model -->|"schedules next check"| node_scheduler
node_scheduler -->|"runs background check"| node_ios_model
node_ios_net -->|"delegates SRun login"| node_ios_srun
node_ios_net -->|"authenticates"| node_campus
node_ios_net -->|"verifies access"| node_internet

click node_py_entry "https://github.com/doublenuo/szu-network-guardian/blob/main/main.py"
click node_py_ui "https://github.com/doublenuo/szu-network-guardian/blob/main/szu_guardian/ui.py"
click node_monitor "https://github.com/doublenuo/szu-network-guardian/blob/main/szu_guardian/monitor.py"
click node_network "https://github.com/doublenuo/szu-network-guardian/blob/main/szu_guardian/network.py"
click node_direct "https://github.com/doublenuo/szu-network-guardian/blob/main/szu_guardian/direct_network.py"
click node_srun "https://github.com/doublenuo/szu-network-guardian/blob/main/szu_guardian/srun.py"
click node_config "https://github.com/doublenuo/szu-network-guardian/blob/main/szu_guardian/storage.py"
click node_models "https://github.com/doublenuo/szu-network-guardian/blob/main/szu_guardian/models.py"
click node_startup "https://github.com/doublenuo/szu-network-guardian/blob/main/szu_guardian/startup.py"
click node_tray "https://github.com/doublenuo/szu-network-guardian/blob/main/szu_guardian/tray.py"
click node_logs "https://github.com/doublenuo/szu-network-guardian/blob/main/szu_guardian/local_log.py"
click node_web_ui "https://github.com/doublenuo/szu-network-guardian/blob/main/src/App.tsx"
click node_tauri_api "https://github.com/doublenuo/szu-network-guardian/blob/main/src/api.ts"
click node_bridge "https://github.com/doublenuo/szu-network-guardian/blob/main/backend_api.py"
click node_android_ui "https://github.com/doublenuo/szu-network-guardian/blob/main/android/app/src/main/java/com/weno/szuguardian/MainActivity.kt"
click node_android_service "https://github.com/doublenuo/szu-network-guardian/blob/main/android/app/src/main/java/com/weno/szuguardian/GuardianService.kt"
click node_android_state "https://github.com/doublenuo/szu-network-guardian/blob/main/android/app/src/main/java/com/weno/szuguardian/GuardianState.kt"
click node_android_config "https://github.com/doublenuo/szu-network-guardian/blob/main/android/app/src/main/java/com/weno/szuguardian/data/ConfigStore.kt"
click node_android_net "https://github.com/doublenuo/szu-network-guardian/blob/main/android/app/src/main/java/com/weno/szuguardian/network/NetworkClient.kt"
click node_android_srun "https://github.com/doublenuo/szu-network-guardian/blob/main/android/app/src/main/java/com/weno/szuguardian/network/SrunClient.kt"
click node_boot "https://github.com/doublenuo/szu-network-guardian/blob/main/android/app/src/main/java/com/weno/szuguardian/BootReceiver.kt"
click node_ios_app "https://github.com/doublenuo/szu-network-guardian/blob/main/ios/SZUNetworkGuardian/SZUNetworkGuardianApp.swift"
click node_ios_view "https://github.com/doublenuo/szu-network-guardian/blob/main/ios/SZUNetworkGuardian/ContentView.swift"
click node_ios_model "https://github.com/doublenuo/szu-network-guardian/blob/main/ios/SZUNetworkGuardian/GuardianModel.swift"
click node_scheduler "https://github.com/doublenuo/szu-network-guardian/blob/main/ios/SZUNetworkGuardian/BackgroundScheduler.swift"
click node_ios_store "https://github.com/doublenuo/szu-network-guardian/blob/main/ios/SZUNetworkGuardian/KeychainStore.swift"
click node_ios_net "https://github.com/doublenuo/szu-network-guardian/blob/main/ios/SZUNetworkGuardian/NetworkClient.swift"
click node_ios_srun "https://github.com/doublenuo/szu-network-guardian/blob/main/ios/SZUNetworkGuardian/SrunClient.swift"

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_py_entry,node_py_ui,node_monitor,node_network,node_direct,node_srun,node_config,node_models,node_startup,node_tray,node_logs,node_user toneBlue
class node_web_ui,node_tauri_api,node_bridge toneAmber
class node_android_ui,node_android_service,node_android_state,node_android_config,node_android_net,node_android_srun,node_boot toneMint
class node_ios_app,node_ios_view,node_ios_model,node_scheduler,node_ios_store,node_ios_net,node_ios_srun toneRose
class node_campus,node_internet toneIndigo
```

## Components

### Python desktop core

- [Desktop entry](https://github.com/doublenuo/szu-network-guardian/blob/main/main.py): `main.py`
- [Desktop UI](https://github.com/doublenuo/szu-network-guardian/blob/main/szu_guardian/ui.py): `szu_guardian/ui.py`
- [Monitor controller](https://github.com/doublenuo/szu-network-guardian/blob/main/szu_guardian/monitor.py): `szu_guardian/monitor.py`
- [Connection manager](https://github.com/doublenuo/szu-network-guardian/blob/main/szu_guardian/network.py): `szu_guardian/network.py`
- [Direct networking](https://github.com/doublenuo/szu-network-guardian/blob/main/szu_guardian/direct_network.py): `szu_guardian/direct_network.py`
- [SRun authentication](https://github.com/doublenuo/szu-network-guardian/blob/main/szu_guardian/srun.py): `szu_guardian/srun.py`
- [Config and secrets](https://github.com/doublenuo/szu-network-guardian/blob/main/szu_guardian/storage.py): `szu_guardian/storage.py`
- [Config and status](https://github.com/doublenuo/szu-network-guardian/blob/main/szu_guardian/models.py): `szu_guardian/models.py`
- [Autostart](https://github.com/doublenuo/szu-network-guardian/blob/main/szu_guardian/startup.py): `szu_guardian/startup.py`
- [System tray](https://github.com/doublenuo/szu-network-guardian/blob/main/szu_guardian/tray.py): `szu_guardian/tray.py`
- [Local logs](https://github.com/doublenuo/szu-network-guardian/blob/main/szu_guardian/local_log.py): `szu_guardian/local_log.py`

### Tauri desktop

- [React interface](https://github.com/doublenuo/szu-network-guardian/blob/main/src/App.tsx): `src/App.tsx`
- [Desktop API bridge](https://github.com/doublenuo/szu-network-guardian/blob/main/src/api.ts): `src/api.ts`
- [Python JSON bridge](https://github.com/doublenuo/szu-network-guardian/blob/main/backend_api.py): `backend_api.py`

### Android client

- [Android activity](https://github.com/doublenuo/szu-network-guardian/blob/main/android/app/src/main/java/com/weno/szuguardian/MainActivity.kt): `android/app/src/main/java/com/weno/szuguardian/MainActivity.kt`
- [Foreground monitor](https://github.com/doublenuo/szu-network-guardian/blob/main/android/app/src/main/java/com/weno/szuguardian/GuardianService.kt): `android/app/src/main/java/com/weno/szuguardian/GuardianService.kt`
- [Android status](https://github.com/doublenuo/szu-network-guardian/blob/main/android/app/src/main/java/com/weno/szuguardian/GuardianState.kt): `android/app/src/main/java/com/weno/szuguardian/GuardianState.kt`
- [Android settings](https://github.com/doublenuo/szu-network-guardian/blob/main/android/app/src/main/java/com/weno/szuguardian/data/ConfigStore.kt): `android/app/src/main/java/com/weno/szuguardian/data/ConfigStore.kt`
- [Android network client](https://github.com/doublenuo/szu-network-guardian/blob/main/android/app/src/main/java/com/weno/szuguardian/network/NetworkClient.kt): `android/app/src/main/java/com/weno/szuguardian/network/NetworkClient.kt`
- [Android SRun](https://github.com/doublenuo/szu-network-guardian/blob/main/android/app/src/main/java/com/weno/szuguardian/network/SrunClient.kt): `android/app/src/main/java/com/weno/szuguardian/network/SrunClient.kt`
- [Boot receiver](https://github.com/doublenuo/szu-network-guardian/blob/main/android/app/src/main/java/com/weno/szuguardian/BootReceiver.kt): `android/app/src/main/java/com/weno/szuguardian/BootReceiver.kt`

### iOS client

- [iOS app entry](https://github.com/doublenuo/szu-network-guardian/blob/main/ios/SZUNetworkGuardian/SZUNetworkGuardianApp.swift): `ios/SZUNetworkGuardian/SZUNetworkGuardianApp.swift`
- [iOS interface](https://github.com/doublenuo/szu-network-guardian/blob/main/ios/SZUNetworkGuardian/ContentView.swift): `ios/SZUNetworkGuardian/ContentView.swift`
- [Guardian model](https://github.com/doublenuo/szu-network-guardian/blob/main/ios/SZUNetworkGuardian/GuardianModel.swift): `ios/SZUNetworkGuardian/GuardianModel.swift`
- [Background scheduler](https://github.com/doublenuo/szu-network-guardian/blob/main/ios/SZUNetworkGuardian/BackgroundScheduler.swift): `ios/SZUNetworkGuardian/BackgroundScheduler.swift`
- [Credential store](https://github.com/doublenuo/szu-network-guardian/blob/main/ios/SZUNetworkGuardian/KeychainStore.swift): `ios/SZUNetworkGuardian/KeychainStore.swift`
- [iOS network client](https://github.com/doublenuo/szu-network-guardian/blob/main/ios/SZUNetworkGuardian/NetworkClient.swift): `ios/SZUNetworkGuardian/NetworkClient.swift`
- [iOS SRun](https://github.com/doublenuo/szu-network-guardian/blob/main/ios/SZUNetworkGuardian/SrunClient.swift): `ios/SZUNetworkGuardian/SrunClient.swift`

### Network services

- **Campus network**
- **Public internet**

### Other components

- **User**

## Connections

- User → Desktop UI: configures and starts
- Desktop entry → Desktop UI: launches (evidence: `main.py`)
- Desktop UI → Monitor controller: starts and receives events (evidence: `szu_guardian/ui.py`)
- Monitor controller → Connection manager: checks connectivity (evidence: `szu_guardian/monitor.py`)
- Connection manager → Direct networking: uses direct routes (evidence: `szu_guardian/network.py`)
- Connection manager → SRun authentication: delegates SRun login (evidence: `szu_guardian/network.py`)
- Connection manager → Campus network: probes and authenticates
- Connection manager → Public internet: verifies access
- Desktop UI → Config and secrets: loads and saves (evidence: `szu_guardian/ui.py`)
- Desktop UI → Autostart: sets autostart (evidence: `szu_guardian/ui.py`)
- Desktop UI → System tray: controls (evidence: `szu_guardian/ui.py`)
- Desktop UI → Local logs: writes logs (evidence: `szu_guardian/ui.py`)
- Config and secrets → Config and status: loads configuration (evidence: `szu_guardian/storage.py`)
- React interface → Desktop API bridge: calls desktop API (evidence: `src/App.tsx`)
- User → React interface: configures and starts
- Desktop API bridge → Python JSON bridge: invokes local JSON bridge
- Python JSON bridge → Connection manager: calls Python core (evidence: `backend_api.py`)
- Android activity → Android settings: loads and saves settings (evidence: `android/app/src/main/java/com/weno/szuguardian/MainActivity.kt`)
- Android activity → Foreground monitor: starts monitoring (evidence: `android/app/src/main/java/com/weno/szuguardian/MainActivity.kt`)
- Boot receiver → Foreground monitor: starts on boot (evidence: `android/app/src/main/java/com/weno/szuguardian/BootReceiver.kt`)
- Boot receiver → Android settings: checks startup settings (evidence: `android/app/src/main/java/com/weno/szuguardian/BootReceiver.kt`)
- Foreground monitor → Android settings: loads settings (evidence: `android/app/src/main/java/com/weno/szuguardian/GuardianService.kt`)
- Foreground monitor → Android network client: runs checks (evidence: `android/app/src/main/java/com/weno/szuguardian/GuardianService.kt`)
- Foreground monitor → Android status: publishes status (evidence: `android/app/src/main/java/com/weno/szuguardian/GuardianService.kt`)
- Android network client → Android SRun: delegates SRun login (evidence: `android/app/src/main/java/com/weno/szuguardian/network/NetworkClient.kt`)
- Android network client → Campus network: authenticates
- Android network client → Public internet: checks access
- iOS app entry → iOS interface: shows interface (evidence: `ios/SZUNetworkGuardian/SZUNetworkGuardianApp.swift`)
- iOS interface → Guardian model: uses model (evidence: `ios/SZUNetworkGuardian/ContentView.swift`)
- Guardian model → Credential store: loads and saves credentials (evidence: `ios/SZUNetworkGuardian/GuardianModel.swift`)
- Guardian model → iOS network client: checks connection (evidence: `ios/SZUNetworkGuardian/GuardianModel.swift`)
- Guardian model → Background scheduler: schedules next check (evidence: `ios/SZUNetworkGuardian/GuardianModel.swift`)
- Background scheduler → Guardian model: runs background check (evidence: `ios/SZUNetworkGuardian/BackgroundScheduler.swift`)
- iOS network client → iOS SRun: delegates SRun login (evidence: `ios/SZUNetworkGuardian/NetworkClient.swift`)
- iOS network client → Campus network: authenticates (evidence: `ios/SZUNetworkGuardian/NetworkClient.swift`)
- iOS network client → Public internet: verifies access (evidence: `ios/SZUNetworkGuardian/NetworkClient.swift`)
