# vbu00/zapret-klutz architecture

> Architecture diagram of the GitHub repository vbu00/zapret-klutz, 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/vbu00/zapret-klutz
- Repository: https://github.com/vbu00/zapret-klutz

## Overview

Klutz is a Windows desktop control panel for Flowseal’s zapret and an integrated Telegram WebSocket proxy. The main workflow is: the user requests automatic strategy selection, Klutz probes the network, tests candidate configurations, and applies the best one; background monitoring can then retry alternatives. Other documented branches cover diagnosis, UDP checks, game-server discovery, maintenance, and tray controls. The README supports these product capabilities; source excerpts and the index identify implementation areas, but do not expose every runtime call path, so uncertain links are omitted or marked unverified.

Main entry points: [`src-tauri/src/commands.rs`](https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/commands.rs) (App commands), [`src-tauri/src/recon.rs`](https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/recon.rs) (Network reconnaissance), [`src-tauri/src/winws.rs`](https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/winws.rs) (zapret process), [`src-tauri/src/maintenance.rs`](https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/maintenance.rs) (Lists and upkeep)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Desktop interface"]
  node_ui["Klutz window<br/>[renderer.js]"]
  node_bridge["Tauri bridge<br/>[tauri-bridge.js]"]
  node_commands["App commands<br/>[commands.rs]"]
  node_tray["Tray controls<br/>[tray.rs]"]
end

subgraph group_strategy["Strategy and diagnosis"]
  node_recon["Network reconnaissance<br/>[recon.rs]"]
  node_probe["HTTP path probes<br/>[probe.rs]"]
  node_tlsprobe["TLS split probe<br/>[tlsprobe.rs]"]
  node_targets["Target checks<br/>[targets.rs]"]
  node_tests["Strategy runner<br/>[tests.rs]"]
  node_monitor["Auto-healing monitor<br/>[monitor.rs]"]
end

subgraph group_runtime["Runtime management"]
  node_state[("Persisted state<br/>[state.rs]")]
  node_release["Release configuration<br/>[release.rs]"]
  node_winws["zapret process<br/>[winws.rs]"]
  node_service["Windows service<br/>[service.rs]"]
  node_sys["Windows system access<br/>[sys.rs]"]
end

subgraph group_telegram["Telegram proxy"]
  node_tgws["Telegram controller<br/>[tgws.rs]"]
  node_proxy["Telegram WS proxy<br/>[tg_ws_proxy.py]"]
  node_proxyconfig["Proxy configuration<br/>[config.py]"]
end

subgraph group_support["Maintenance and discovery"]
  node_maintenance["Lists and upkeep<br/>[maintenance.rs]"]
  node_gamescan["Game traffic scan<br/>[gamescan.rs]"]
end

node_user(("Windows user"))
node_github(("GitHub releases"))
node_ripe(("RIPEstat"))

node_user -->|"operates"| node_ui
node_ui -.->|"requests actions"| node_bridge
node_bridge -.->|"invokes commands"| node_commands
node_commands -.->|"requests diagnosis"| node_recon
node_commands -.->|"starts tests"| node_tests
node_tests -->|"lists configs"| node_release
node_tests -->|"starts candidate"| node_winws
node_monitor -->|"checks targets"| node_targets
node_monitor -->|"switches strategy"| node_winws
node_recon -->|"runs probes"| node_probe
node_recon -->|"tests TLS split"| node_tlsprobe
node_recon -->|"checks targets"| node_targets
node_commands -->|"loads settings"| node_state
node_commands -->|"validates release"| node_release
node_tray -->|"reads status"| node_state
node_tray -->|"controls process"| node_winws
node_winws -->|"harvests logs"| node_gamescan
node_service -->|"queries service"| node_sys
node_maintenance -->|"uses system tools"| node_sys
node_maintenance -->|"updates game lists"| node_gamescan
node_tgws -->|"reads settings"| node_state
node_tgws -.->|"starts proxy"| node_proxy
node_proxy -->|"loads configuration"| node_proxyconfig
node_maintenance -->|"checks updates"| node_github
node_gamescan -.->|"looks up networks"| node_ripe

click node_ui "https://github.com/vbu00/zapret-klutz/blob/main/src/renderer.js"
click node_bridge "https://github.com/vbu00/zapret-klutz/blob/main/src/tauri-bridge.js"
click node_commands "https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/commands.rs"
click node_tray "https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/tray.rs"
click node_state "https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/state.rs"
click node_recon "https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/recon.rs"
click node_probe "https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/probe.rs"
click node_tlsprobe "https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/tlsprobe.rs"
click node_targets "https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/targets.rs"
click node_tests "https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/tests.rs"
click node_monitor "https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/monitor.rs"
click node_release "https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/release.rs"
click node_winws "https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/winws.rs"
click node_service "https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/service.rs"
click node_sys "https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/sys.rs"
click node_tgws "https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/tgws.rs"
click node_proxy "https://github.com/vbu00/zapret-klutz/blob/main/tools/tgwsproxy-build/proxy/tg_ws_proxy.py"
click node_proxyconfig "https://github.com/vbu00/zapret-klutz/blob/main/tools/tgwsproxy-build/proxy/config.py"
click node_maintenance "https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/maintenance.rs"
click node_gamescan "https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/gamescan.rs"

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_ui,node_bridge,node_commands,node_tray,node_user toneBlue
class node_recon,node_probe,node_tlsprobe,node_targets,node_tests,node_monitor toneAmber
class node_state,node_release,node_winws,node_service,node_sys toneMint
class node_tgws,node_proxy,node_proxyconfig toneRose
class node_maintenance,node_gamescan,node_github,node_ripe toneIndigo
```

## Components

### Desktop interface

- [Klutz window](https://github.com/vbu00/zapret-klutz/blob/main/src/renderer.js): `src/renderer.js`
- [Tauri bridge](https://github.com/vbu00/zapret-klutz/blob/main/src/tauri-bridge.js): `src/tauri-bridge.js`
- [App commands](https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/commands.rs): `src-tauri/src/commands.rs`
- [Tray controls](https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/tray.rs): `src-tauri/src/tray.rs`

### Strategy and diagnosis

- [Network reconnaissance](https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/recon.rs): `src-tauri/src/recon.rs`
- [HTTP path probes](https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/probe.rs): `src-tauri/src/probe.rs`
- [TLS split probe](https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/tlsprobe.rs): `src-tauri/src/tlsprobe.rs`
- [Target checks](https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/targets.rs): `src-tauri/src/targets.rs`
- [Strategy runner](https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/tests.rs): `src-tauri/src/tests.rs`
- [Auto-healing monitor](https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/monitor.rs): `src-tauri/src/monitor.rs`

### Runtime management

- [Persisted state](https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/state.rs): `src-tauri/src/state.rs`
- [Release configuration](https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/release.rs): `src-tauri/src/release.rs`
- [zapret process](https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/winws.rs): `src-tauri/src/winws.rs`
- [Windows service](https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/service.rs): `src-tauri/src/service.rs`
- [Windows system access](https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/sys.rs): `src-tauri/src/sys.rs`

### Telegram proxy

- [Telegram controller](https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/tgws.rs): `src-tauri/src/tgws.rs`
- [Telegram WS proxy](https://github.com/vbu00/zapret-klutz/blob/main/tools/tgwsproxy-build/proxy/tg_ws_proxy.py): `tools/tgwsproxy-build/proxy/tg_ws_proxy.py`
- [Proxy configuration](https://github.com/vbu00/zapret-klutz/blob/main/tools/tgwsproxy-build/proxy/config.py): `tools/tgwsproxy-build/proxy/config.py`

### Maintenance and discovery

- [Lists and upkeep](https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/maintenance.rs): `src-tauri/src/maintenance.rs`
- [Game traffic scan](https://github.com/vbu00/zapret-klutz/blob/main/src-tauri/src/gamescan.rs): `src-tauri/src/gamescan.rs`

### Other components

- **Windows user**
- **GitHub releases**
- **RIPEstat**

## Connections

- Windows user → Klutz window: operates
- Klutz window → Tauri bridge: requests actions
- Tauri bridge → App commands: invokes commands
- App commands → Network reconnaissance: requests diagnosis (evidence: `src-tauri/src/commands.rs`)
- App commands → Strategy runner: starts tests (evidence: `src-tauri/src/commands.rs`)
- Strategy runner → Release configuration: lists configs (evidence: `src-tauri/src/tests.rs`)
- Strategy runner → zapret process: starts candidate (evidence: `src-tauri/src/tests.rs`)
- Auto-healing monitor → Target checks: checks targets (evidence: `src-tauri/src/monitor.rs`)
- Auto-healing monitor → zapret process: switches strategy (evidence: `src-tauri/src/monitor.rs`)
- Network reconnaissance → HTTP path probes: runs probes (evidence: `src-tauri/src/recon.rs`)
- Network reconnaissance → TLS split probe: tests TLS split (evidence: `src-tauri/src/recon.rs`)
- Network reconnaissance → Target checks: checks targets (evidence: `src-tauri/src/recon.rs`)
- App commands → Persisted state: loads settings (evidence: `src-tauri/src/commands.rs`)
- App commands → Release configuration: validates release (evidence: `src-tauri/src/commands.rs`)
- Tray controls → Persisted state: reads status (evidence: `src-tauri/src/tray.rs`)
- Tray controls → zapret process: controls process (evidence: `src-tauri/src/tray.rs`)
- zapret process → Game traffic scan: harvests logs (evidence: `src-tauri/src/winws.rs`)
- Windows service → Windows system access: queries service (evidence: `src-tauri/src/service.rs`)
- Lists and upkeep → Windows system access: uses system tools (evidence: `src-tauri/src/maintenance.rs`)
- Lists and upkeep → Game traffic scan: updates game lists (evidence: `src-tauri/src/maintenance.rs`)
- Telegram controller → Persisted state: reads settings (evidence: `src-tauri/src/tgws.rs`)
- Telegram controller → Telegram WS proxy: starts proxy
- Telegram WS proxy → Proxy configuration: loads configuration (evidence: `tools/tgwsproxy-build/proxy/tg_ws_proxy.py`)
- Lists and upkeep → GitHub releases: checks updates (evidence: `src-tauri/src/maintenance.rs`)
- Game traffic scan → RIPEstat: looks up networks
