How doublenuo/szu-network-guardian works
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: ui.py Desktop UI · network.py Connection manager · GuardianService.kt Foreground monitor · GuardianModel.swift Guardian model
Components 31
Python desktop core
- Desktop entry
main.py - Desktop UI
szu_guardian/ui.py - Monitor controller
szu_guardian/monitor.py - Connection manager
szu_guardian/network.py - Direct networking
szu_guardian/direct_network.py - SRun authentication
szu_guardian/srun.py - Config and secrets
szu_guardian/storage.py - Config and status
szu_guardian/models.py - Autostart
szu_guardian/startup.py - System tray
szu_guardian/tray.py - Local logs
szu_guardian/local_log.py
Tauri desktop
- React interface
src/App.tsx - Desktop API bridge
src/api.ts - Python JSON bridge
backend_api.py
Android client
- Android activity
android/app/src/main/java/com/weno/szuguardian/MainActivity.kt - Foreground monitor
android/app/src/main/java/com/weno/szuguardian/GuardianService.kt - Android status
android/app/src/main/java/com/weno/szuguardian/GuardianState.kt - Android settings
android/app/src/main/java/com/weno/szuguardian/data/ConfigStore.kt - Android network client
android/app/src/main/java/com/weno/szuguardian/network/NetworkClient.kt - Android SRun
android/app/src/main/java/com/weno/szuguardian/network/SrunClient.kt - Boot receiver
android/app/src/main/java/com/weno/szuguardian/BootReceiver.kt
iOS client
- iOS app entry
ios/SZUNetworkGuardian/SZUNetworkGuardianApp.swift - iOS interface
ios/SZUNetworkGuardian/ContentView.swift - Guardian model
ios/SZUNetworkGuardian/GuardianModel.swift - Background scheduler
ios/SZUNetworkGuardian/BackgroundScheduler.swift - Credential store
ios/SZUNetworkGuardian/KeychainStore.swift - iOS network client
ios/SZUNetworkGuardian/NetworkClient.swift - iOS SRun
ios/SZUNetworkGuardian/SrunClient.swift
Network services
- Campus network
- Public internet
Other components
- User
Connections 36
- User → Desktop UI: configures and starts
- Desktop entry → Desktop UI: launches
main.py - Desktop UI → Monitor controller: starts and receives events
szu_guardian/ui.py - Monitor controller → Connection manager: checks connectivity
szu_guardian/monitor.py - Connection manager → Direct networking: uses direct routes
szu_guardian/network.py - Connection manager → SRun authentication: delegates SRun login
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
szu_guardian/ui.py - Desktop UI → Autostart: sets autostart
szu_guardian/ui.py - Desktop UI → System tray: controls
szu_guardian/ui.py - Desktop UI → Local logs: writes logs
szu_guardian/ui.py - Config and secrets → Config and status: loads configuration
szu_guardian/storage.py - React interface → Desktop API bridge: calls desktop API
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
backend_api.py - Android activity → Android settings: loads and saves settings
android/app/src/main/java/com/weno/szuguardian/MainActivity.kt - Android activity → Foreground monitor: starts monitoring
android/app/src/main/java/com/weno/szuguardian/MainActivity.kt - Boot receiver → Foreground monitor: starts on boot
android/app/src/main/java/com/weno/szuguardian/BootReceiver.kt - Boot receiver → Android settings: checks startup settings
android/app/src/main/java/com/weno/szuguardian/BootReceiver.kt - Foreground monitor → Android settings: loads settings
android/app/src/main/java/com/weno/szuguardian/GuardianService.kt - Foreground monitor → Android network client: runs checks
android/app/src/main/java/com/weno/szuguardian/GuardianService.kt - Foreground monitor → Android status: publishes status
android/app/src/main/java/com/weno/szuguardian/GuardianService.kt - Android network client → Android SRun: delegates SRun login
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
ios/SZUNetworkGuardian/SZUNetworkGuardianApp.swift - iOS interface → Guardian model: uses model
ios/SZUNetworkGuardian/ContentView.swift - Guardian model → Credential store: loads and saves credentials
ios/SZUNetworkGuardian/GuardianModel.swift - Guardian model → iOS network client: checks connection
ios/SZUNetworkGuardian/GuardianModel.swift - Guardian model → Background scheduler: schedules next check
ios/SZUNetworkGuardian/GuardianModel.swift - Background scheduler → Guardian model: runs background check
ios/SZUNetworkGuardian/BackgroundScheduler.swift - iOS network client → iOS SRun: delegates SRun login
ios/SZUNetworkGuardian/NetworkClient.swift - iOS network client → Campus network: authenticates
ios/SZUNetworkGuardian/NetworkClient.swift - iOS network client → Public internet: verifies access
ios/SZUNetworkGuardian/NetworkClient.swift