# zapret-discordyoutube/zapretgui architecture

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

- Interactive diagram: https://gitdiagram.com/zapret-discordyoutube/zapretgui
- Repository: https://github.com/zapret-discordyoutube/zapretgui

## Overview

Zapret 2 is a desktop GUI for managing network-circumvention strategies and diagnosing access problems. The user-facing flow is to launch the GUI, choose or configure a strategy, run it through the platform engine, and inspect results; users can also diagnose connectivity, manage DNS/hosts and lists, and run live strategy orchestration. The graph preserves these documented product branches. Its edges are limited to relationships visible in the README or SOURCE INDEX; several feature-to-runtime connections are therefore omitted rather than inferred from directory names.

Main entry points: [`src/blockcheck/strategy_search/engine.py`](https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/blockcheck/strategy_search/engine.py) (Strategy search), [`src/presets`](https://github.com/zapret-discordyoutube/zapretgui/tree/main/src/presets) (Presets and modes), [`src/settings`](https://github.com/zapret-discordyoutube/zapretgui/tree/main/src/settings) (Persistent settings), [`src/log/log.py`](https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/log/log.py) (Logging)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_controller["Application controller"]
  node_app_runtime["App runtime<br/>[runtime.py]"]
end

subgraph group_strategies["Strategies and runtime"]
  node_presets["Presets and modes"]
  node_profiles["Profile editor"]
  node_profile_loader["Profile setup loader"]
  node_search["Strategy search<br/>[engine.py]"]
  node_search_order["Search ordering<br/>[ordering.py]"]
  node_probe_profile["Probe profiles<br/>[probe_profile.py]"]
  node_orchestra["Live orchestrator"]
  node_platform["Platform engines<br/>[factory_engine.py]"]
end

subgraph group_network["Network tools"]
  node_diagnostics["Network diagnostics<br/>[engine.py]"]
  node_service_view["Service reporting<br/>[service_view.py]"]
  node_dns["DNS tools"]
  node_hosts["Hosts manager<br/>[address_engine.py]"]
  node_lists["Domain and IP lists<br/>[layered_files.py]"]
end

subgraph group_support["Support features"]
  node_telegram_proxy["Telegram proxy<br/>[manager.py]"]
  node_premium[("Premium support<br/>[storage.py]")]
  node_updater["Updater downloads<br/>[engine.py]"]
end

subgraph group_infra["Shared services"]
  node_settings[("Persistent settings")]
  node_logs["Logging<br/>[log.py]"]
end

node_user(("Desktop user"))

node_user -->|"launches GUI"| node_controller
node_controller -->|"builds runtime"| node_app_runtime
node_app_runtime -->|"assembles features"| node_presets
node_profiles -->|"loads profile"| node_profile_loader
node_search -->|"orders strategies"| node_search_order
node_search -->|"uses probe profile"| node_probe_profile
node_diagnostics -->|"builds service report"| node_service_view
node_lists -->|"reads paths"| node_settings
node_telegram_proxy -->|"uses settings"| node_settings
node_premium -->|"reads settings"| node_settings
node_telegram_proxy -->|"logs activity"| node_logs
node_premium -->|"logs activity"| node_logs
node_updater -->|"logs downloads"| node_logs
node_user -.->|"selects strategies"| node_presets
node_user -.->|"checks access"| node_diagnostics
node_user -.->|"configures DNS"| node_dns
node_user -.->|"manages hosts"| node_hosts
node_user -.->|"starts orchestration"| node_orchestra
node_presets -.->|"runs strategy"| node_platform
node_search -.->|"tests strategies"| node_platform

click node_controller "https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/main/application_controller.py"
click node_app_runtime "https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/app/runtime.py"
click node_presets "https://github.com/zapret-discordyoutube/zapretgui/tree/main/src/presets"
click node_profiles "https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/profile/ui/profile_setup_page.py"
click node_profile_loader "https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/profile/profile_setup_loader.py"
click node_search "https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/blockcheck/strategy_search/engine.py"
click node_search_order "https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/blockcheck/strategy_search/ordering.py"
click node_probe_profile "https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/blockcheck/strategy_search/probe_profile.py"
click node_orchestra "https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/orchestra/orchestra_runner.py"
click node_platform "https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/platforms/factory_engine.py"
click node_diagnostics "https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/diagnostics/engine.py"
click node_service_view "https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/diagnostics/service_view.py"
click node_dns "https://github.com/zapret-discordyoutube/zapretgui/tree/main/src/dns"
click node_hosts "https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/hosts/address_engine.py"
click node_lists "https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/lists/core/layered_files.py"
click node_settings "https://github.com/zapret-discordyoutube/zapretgui/tree/main/src/settings"
click node_logs "https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/log/log.py"
click node_telegram_proxy "https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/telegram_proxy/manager.py"
click node_premium "https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/donater/storage.py"
click node_updater "https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/updater/download/engine.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_controller,node_app_runtime,node_user toneBlue
class node_presets,node_profiles,node_profile_loader,node_search,node_search_order,node_probe_profile,node_orchestra,node_platform toneAmber
class node_diagnostics,node_service_view,node_dns,node_hosts,node_lists toneMint
class node_telegram_proxy,node_premium,node_updater toneRose
class node_settings,node_logs toneIndigo
```

## Components

### Application shell

- [Application controller](https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/main/application_controller.py): `src/main/application_controller.py`
- [App runtime](https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/app/runtime.py): `src/app/runtime.py`

### Strategies and runtime

- [Presets and modes](https://github.com/zapret-discordyoutube/zapretgui/tree/main/src/presets): `src/presets`
- [Profile editor](https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/profile/ui/profile_setup_page.py): `src/profile/ui/profile_setup_page.py`
- [Profile setup loader](https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/profile/profile_setup_loader.py): `src/profile/profile_setup_loader.py`
- [Strategy search](https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/blockcheck/strategy_search/engine.py): `src/blockcheck/strategy_search/engine.py`
- [Search ordering](https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/blockcheck/strategy_search/ordering.py): `src/blockcheck/strategy_search/ordering.py`
- [Probe profiles](https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/blockcheck/strategy_search/probe_profile.py): `src/blockcheck/strategy_search/probe_profile.py`
- [Live orchestrator](https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/orchestra/orchestra_runner.py): `src/orchestra/orchestra_runner.py`
- [Platform engines](https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/platforms/factory_engine.py): `src/platforms/factory_engine.py`

### Network tools

- [Network diagnostics](https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/diagnostics/engine.py): `src/diagnostics/engine.py`
- [Service reporting](https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/diagnostics/service_view.py): `src/diagnostics/service_view.py`
- [DNS tools](https://github.com/zapret-discordyoutube/zapretgui/tree/main/src/dns): `src/dns`
- [Hosts manager](https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/hosts/address_engine.py): `src/hosts/address_engine.py`
- [Domain and IP lists](https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/lists/core/layered_files.py): `src/lists/core/layered_files.py`

### Support features

- [Telegram proxy](https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/telegram_proxy/manager.py): `src/telegram_proxy/manager.py`
- [Premium support](https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/donater/storage.py): `src/donater/storage.py`
- [Updater downloads](https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/updater/download/engine.py): `src/updater/download/engine.py`

### Shared services

- [Persistent settings](https://github.com/zapret-discordyoutube/zapretgui/tree/main/src/settings): `src/settings`
- [Logging](https://github.com/zapret-discordyoutube/zapretgui/blob/main/src/log/log.py): `src/log/log.py`

### Other components

- **Desktop user**

## Connections

- Desktop user → Application controller: launches GUI
- Application controller → App runtime: builds runtime (evidence: `src/main/application_controller.py`)
- App runtime → Presets and modes: assembles features (evidence: `src/app/runtime.py`)
- Profile editor → Profile setup loader: loads profile (evidence: `src/profile/ui/profile_setup_page.py`)
- Strategy search → Search ordering: orders strategies (evidence: `src/blockcheck/strategy_search/engine.py`)
- Strategy search → Probe profiles: uses probe profile (evidence: `src/blockcheck/strategy_search/engine.py`)
- Network diagnostics → Service reporting: builds service report (evidence: `src/diagnostics/engine.py`)
- Domain and IP lists → Persistent settings: reads paths
- Telegram proxy → Persistent settings: uses settings (evidence: `src/telegram_proxy/manager.py`)
- Premium support → Persistent settings: reads settings (evidence: `src/donater/storage.py`)
- Telegram proxy → Logging: logs activity (evidence: `src/telegram_proxy/manager.py`)
- Premium support → Logging: logs activity (evidence: `src/donater/storage.py`)
- Updater downloads → Logging: logs downloads (evidence: `src/updater/download/engine.py`)
- Desktop user → Presets and modes: selects strategies
- Desktop user → Network diagnostics: checks access
- Desktop user → DNS tools: configures DNS
- Desktop user → Hosts manager: manages hosts
- Desktop user → Live orchestrator: starts orchestration
- Presets and modes → Platform engines: runs strategy
- Strategy search → Platform engines: tests strategies
