# uuoov/autoszuweb architecture

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

- Interactive diagram: https://gitdiagram.com/uuoov/autoszuweb
- Repository: https://github.com/uuoov/autoszuweb

## Overview

AutoSZUWeb is a Windows/macOS campus-network authenticator with an optional VPN/代理 synchronization toolset. Its main workflow initializes or reads encrypted credentials, attempts SRun authentication then falls back to dormitory ePortal, and monitors connectivity for retries. The graph also preserves the documented VPN integration branch. Some subsystem wiring is based on README descriptions because the corresponding implementation excerpts were not provided; those relationships are cited to the README rather than inferred from filenames.

Main entry points: [`src/AutoSZUWeb.cpp`](https://github.com/uuoov/autoszuweb/blob/main/src/AutoSZUWeb.cpp) (Application entry), [`src/web.cpp`](https://github.com/uuoov/autoszuweb/blob/main/src/web.cpp) (Login orchestration), [`scripts/vpn_sync.py`](https://github.com/uuoov/autoszuweb/blob/main/scripts/vpn_sync.py) (VPN synchronization), [`src/runtime.cpp`](https://github.com/uuoov/autoszuweb/blob/main/src/runtime.cpp) (Connectivity monitor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application lifecycle"]
  node_main["Application entry<br/>[AutoSZUWeb.cpp]"]
  node_instance["Single-instance guard"]
  node_onboarding["Credential onboarding<br/>[AutoSZUWeb.cpp]"]
  node_userfile["Credential template<br/>[user_data.cpp]"]
  node_monitor["Connectivity monitor<br/>[runtime.cpp]"]
end

subgraph group_auth["Campus authentication"]
  node_connectivity["Network probe<br/>[network.cpp]"]
  node_login["Login orchestration<br/>[web.cpp]"]
  node_srun["SRun authentication<br/>[srun.cpp]"]
  node_eportal["Dormitory ePortal<br/>[web.cpp]"]
end

subgraph group_platform["Platform services"]
  node_configpaths["Config paths<br/>[file_path.cpp]"]
  node_credentialprotection["Credential protection<br/>[sys.cpp]"]
  node_autostart["Login autostart<br/>[sys.cpp]"]
  node_platformui["Platform UI<br/>[sys.cpp]"]
  node_authlogs["Authentication logs<br/>[sys.cpp]"]
  node_keychain[("macOS Keychain")]
end

subgraph group_vpn["VPN synchronization"]
  node_vpnsetup["VPN setup assistant<br/>[vpn_setup.py]"]
  node_vpnsync["VPN synchronization<br/>[vpn_sync.py]"]
end

node_user(("User"))
node_campusnetwork{{"Campus authentication service"}}
node_proxy{{"Proxy endpoint"}}
node_clashapi{{"Clash/Mihomo API"}}
node_vpnclient{{"VPN client commands"}}

node_user -->|"starts"| node_main
node_main -->|"guards startup"| node_instance
node_main -->|"resolves paths"| node_configpaths
node_main -->|"configures first run"| node_onboarding
node_onboarding -->|"creates or reads"| node_userfile
node_onboarding -->|"encrypts credentials"| node_credentialprotection
node_credentialprotection -->|"uses key"| node_keychain
node_main -->|"decrypts credentials"| node_credentialprotection
node_main -->|"sets autostart"| node_autostart
node_main -->|"authenticates"| node_login
node_main -->|"starts monitor"| node_monitor
node_monitor -->|"retries offline"| node_login
node_monitor -->|"checks reachability"| node_connectivity
node_login -->|"tries first"| node_srun
node_login -->|"falls back"| node_eportal
node_srun -->|"authenticates"| node_campusnetwork
node_eportal -->|"authenticates"| node_campusnetwork
node_login -->|"writes result"| node_authlogs
node_login -->|"shows first result"| node_platformui
node_user -.->|"configures VPN"| node_vpnsetup
node_vpnsetup -.->|"supports setup"| node_vpnsync
node_vpnsync -->|"probes proxy"| node_proxy
node_vpnsync -->|"selects node"| node_clashapi
node_vpnsync -->|"runs commands"| node_vpnclient

click node_main "https://github.com/uuoov/autoszuweb/blob/main/src/AutoSZUWeb.cpp"
click node_instance "https://github.com/uuoov/autoszuweb/blob/main/src/single_instance.cpp"
click node_onboarding "https://github.com/uuoov/autoszuweb/blob/main/src/AutoSZUWeb.cpp"
click node_userfile "https://github.com/uuoov/autoszuweb/blob/main/src/user_data.cpp"
click node_configpaths "https://github.com/uuoov/autoszuweb/blob/main/src/file_path.cpp"
click node_credentialprotection "https://github.com/uuoov/autoszuweb/blob/main/src/sys.cpp"
click node_autostart "https://github.com/uuoov/autoszuweb/blob/main/src/sys.cpp"
click node_platformui "https://github.com/uuoov/autoszuweb/blob/main/src/sys.cpp"
click node_monitor "https://github.com/uuoov/autoszuweb/blob/main/src/runtime.cpp"
click node_connectivity "https://github.com/uuoov/autoszuweb/blob/main/src/network.cpp"
click node_login "https://github.com/uuoov/autoszuweb/blob/main/src/web.cpp"
click node_srun "https://github.com/uuoov/autoszuweb/blob/main/src/srun.cpp"
click node_eportal "https://github.com/uuoov/autoszuweb/blob/main/src/web.cpp"
click node_authlogs "https://github.com/uuoov/autoszuweb/blob/main/src/sys.cpp"
click node_vpnsetup "https://github.com/uuoov/autoszuweb/blob/main/scripts/vpn_setup.py"
click node_vpnsync "https://github.com/uuoov/autoszuweb/blob/main/scripts/vpn_sync.py"

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,node_instance,node_onboarding,node_userfile,node_monitor,node_user,node_vpnclient toneBlue
class node_connectivity,node_login,node_srun,node_eportal toneAmber
class node_configpaths,node_credentialprotection,node_autostart,node_platformui,node_authlogs,node_keychain,node_clashapi toneMint
class node_vpnsetup,node_vpnsync toneRose
class node_campusnetwork,node_proxy toneIndigo
```

## Components

### Application lifecycle

- [Application entry](https://github.com/uuoov/autoszuweb/blob/main/src/AutoSZUWeb.cpp): `src/AutoSZUWeb.cpp`
- [Single-instance guard](https://github.com/uuoov/autoszuweb/blob/main/src/single_instance.cpp): `src/single_instance.cpp`
- [Credential onboarding](https://github.com/uuoov/autoszuweb/blob/main/src/AutoSZUWeb.cpp): `src/AutoSZUWeb.cpp`
- [Credential template](https://github.com/uuoov/autoszuweb/blob/main/src/user_data.cpp): `src/user_data.cpp`
- [Connectivity monitor](https://github.com/uuoov/autoszuweb/blob/main/src/runtime.cpp): `src/runtime.cpp`

### Campus authentication

- [Network probe](https://github.com/uuoov/autoszuweb/blob/main/src/network.cpp): `src/network.cpp`
- [Login orchestration](https://github.com/uuoov/autoszuweb/blob/main/src/web.cpp): `src/web.cpp`
- [SRun authentication](https://github.com/uuoov/autoszuweb/blob/main/src/srun.cpp): `src/srun.cpp`
- [Dormitory ePortal](https://github.com/uuoov/autoszuweb/blob/main/src/web.cpp): `src/web.cpp`

### Platform services

- [Config paths](https://github.com/uuoov/autoszuweb/blob/main/src/file_path.cpp): `src/file_path.cpp`
- [Credential protection](https://github.com/uuoov/autoszuweb/blob/main/src/sys.cpp): `src/sys.cpp`
- [Login autostart](https://github.com/uuoov/autoszuweb/blob/main/src/sys.cpp): `src/sys.cpp`
- [Platform UI](https://github.com/uuoov/autoszuweb/blob/main/src/sys.cpp): `src/sys.cpp`
- [Authentication logs](https://github.com/uuoov/autoszuweb/blob/main/src/sys.cpp): `src/sys.cpp`
- **macOS Keychain**

### VPN synchronization

- [VPN setup assistant](https://github.com/uuoov/autoszuweb/blob/main/scripts/vpn_setup.py): `scripts/vpn_setup.py`
- [VPN synchronization](https://github.com/uuoov/autoszuweb/blob/main/scripts/vpn_sync.py): `scripts/vpn_sync.py`

### Other components

- **User**
- **Campus authentication service**
- **Proxy endpoint**
- **Clash/Mihomo API**
- **VPN client commands**

## Connections

- User → Application entry: starts (evidence: `README.md`)
- Application entry → Single-instance guard: guards startup (evidence: `src/AutoSZUWeb.cpp`)
- Application entry → Config paths: resolves paths (evidence: `src/AutoSZUWeb.cpp`)
- Application entry → Credential onboarding: configures first run (evidence: `src/AutoSZUWeb.cpp`)
- Credential onboarding → Credential template: creates or reads (evidence: `src/AutoSZUWeb.cpp`)
- Credential onboarding → Credential protection: encrypts credentials (evidence: `src/AutoSZUWeb.cpp`)
- Credential protection → macOS Keychain: uses key (evidence: `README.md`)
- Application entry → Credential protection: decrypts credentials (evidence: `src/AutoSZUWeb.cpp`)
- Application entry → Login autostart: sets autostart (evidence: `src/AutoSZUWeb.cpp`)
- Application entry → Login orchestration: authenticates (evidence: `src/AutoSZUWeb.cpp`)
- Application entry → Connectivity monitor: starts monitor (evidence: `src/AutoSZUWeb.cpp`)
- Connectivity monitor → Login orchestration: retries offline (evidence: `README.md`)
- Connectivity monitor → Network probe: checks reachability (evidence: `README.md`)
- Login orchestration → SRun authentication: tries first (evidence: `src/web.cpp`)
- Login orchestration → Dormitory ePortal: falls back (evidence: `src/web.cpp`)
- SRun authentication → Campus authentication service: authenticates (evidence: `README.md`)
- Dormitory ePortal → Campus authentication service: authenticates (evidence: `README.md`)
- Login orchestration → Authentication logs: writes result (evidence: `src/web.cpp`)
- Login orchestration → Platform UI: shows first result (evidence: `src/web.cpp`)
- User → VPN setup assistant: configures VPN (evidence: `README.md`)
- VPN setup assistant → VPN synchronization: supports setup (evidence: `scripts/vpn_setup.py`)
- VPN synchronization → Proxy endpoint: probes proxy (evidence: `README.md`)
- VPN synchronization → Clash/Mihomo API: selects node (evidence: `README.md`)
- VPN synchronization → VPN client commands: runs commands (evidence: `README.md`)
