# factzerdx/a12bypass architecture

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

- Interactive diagram: https://gitdiagram.com/factzerdx/a12bypass
- Repository: https://github.com/factzerdx/a12bypass

## Overview

This Windows/PyQt application presents an iOS device activation-bypass workflow. The user launches the GUI and connects a device; the detector gathers device information and handles model/authorization checks, while a worker coordinates GUID extraction, server communication, SQLite-file transfer, reboot waits, and activation-status retries. Results and failures can be reported to Telegram. The graph reflects the sampled source and README; several detector methods and worker sections were omitted, so uncertain device-command details and UI-dialog wiring are not shown.

Main entry points: [`core/detector.py`](https://github.com/factzerdx/a12bypass/blob/main/core/detector.py) (Device detector), [`core/worker.py`](https://github.com/factzerdx/a12bypass/blob/main/core/worker.py) (Activation worker), [`main.py`](https://github.com/factzerdx/a12bypass/blob/main/main.py) (Application entry), [`telegram/notifier.py`](https://github.com/factzerdx/a12bypass/blob/main/telegram/notifier.py) (Telegram notifier)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application UI"]
  node_entry["Application entry<br/>[main.py]"]
  node_detector["Device detector<br/>[detector.py]"]
  node_main_ui["Main window UI<br/>[mainUI.ui]"]
  node_dialogs["Result dialogs<br/>[dialogs.py]"]
end

subgraph group_activation["Activation Workflow"]
  node_worker["Activation worker<br/>[worker.py]"]
  node_device_tools["Device command tools"]
  node_helpers["Process helpers<br/>[helpers.py]"]
end

subgraph group_services["Remote Services"]
  node_api["API URL builder<br/>[api.py]"]
  node_config["Service configuration<br/>[config.py]"]
  node_notifier["Telegram notifier<br/>[notifier.py]"]
end

subgraph group_security["Security Monitoring"]
  node_monitor["Security monitor<br/>[monitor.py]"]
end

node_user(("Operator"))
node_server(("Activation API"))
node_device(("Connected iOS device"))
node_telegram(("Telegram service"))

node_user -->|"launches"| node_entry
node_entry -->|"opens"| node_detector
node_detector -->|"loads"| node_main_ui
node_detector -->|"starts activation"| node_worker
node_worker -->|"checks threats"| node_monitor
node_worker -->|"requests device operations"| node_detector
node_detector -->|"runs commands"| node_device_tools
node_device_tools -->|"communicates"| node_device
node_detector -->|"builds endpoint URLs"| node_api
node_api -->|"reads endpoints"| node_config
node_detector -->|"checks model and authorization"| node_server
node_worker -->|"requests GUID submission and file download"| node_detector
node_detector -->|"submits GUID and downloads file"| node_server
node_detector -->|"transfers and executes file"| node_device_tools
node_worker -->|"checks activation status and reboots"| node_detector
node_worker -->|"reports outcome"| node_notifier
node_notifier -->|"checks proxy use"| node_monitor
node_notifier -->|"sends notifications"| node_telegram
node_monitor -->|"sends security alerts"| node_telegram
node_entry -->|"hides console"| node_helpers

click node_entry "https://github.com/factzerdx/a12bypass/blob/main/main.py"
click node_detector "https://github.com/factzerdx/a12bypass/blob/main/core/detector.py"
click node_main_ui "https://github.com/factzerdx/a12bypass/blob/main/mainUI.ui"
click node_dialogs "https://github.com/factzerdx/a12bypass/blob/main/gui/dialogs.py"
click node_worker "https://github.com/factzerdx/a12bypass/blob/main/core/worker.py"
click node_api "https://github.com/factzerdx/a12bypass/blob/main/core/api.py"
click node_config "https://github.com/factzerdx/a12bypass/blob/main/config.py"
click node_device_tools "https://github.com/factzerdx/a12bypass/tree/main/libs"
click node_notifier "https://github.com/factzerdx/a12bypass/blob/main/telegram/notifier.py"
click node_monitor "https://github.com/factzerdx/a12bypass/blob/main/security/monitor.py"
click node_helpers "https://github.com/factzerdx/a12bypass/blob/main/utils/helpers.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_entry,node_detector,node_main_ui,node_dialogs toneBlue
class node_worker,node_device_tools,node_helpers toneAmber
class node_api,node_config,node_notifier,node_server toneMint
class node_monitor toneRose
class node_user,node_device,node_telegram toneIndigo
```

## Components

### Application UI

- [Application entry](https://github.com/factzerdx/a12bypass/blob/main/main.py): `main.py`
- [Device detector](https://github.com/factzerdx/a12bypass/blob/main/core/detector.py): `core/detector.py`
- [Main window UI](https://github.com/factzerdx/a12bypass/blob/main/mainUI.ui): `mainUI.ui`
- [Result dialogs](https://github.com/factzerdx/a12bypass/blob/main/gui/dialogs.py): `gui/dialogs.py`

### Activation Workflow

- [Activation worker](https://github.com/factzerdx/a12bypass/blob/main/core/worker.py): `core/worker.py`
- [Device command tools](https://github.com/factzerdx/a12bypass/tree/main/libs): `libs`
- [Process helpers](https://github.com/factzerdx/a12bypass/blob/main/utils/helpers.py): `utils/helpers.py`

### Remote Services

- [API URL builder](https://github.com/factzerdx/a12bypass/blob/main/core/api.py): `core/api.py`
- [Service configuration](https://github.com/factzerdx/a12bypass/blob/main/config.py): `config.py`
- [Telegram notifier](https://github.com/factzerdx/a12bypass/blob/main/telegram/notifier.py): `telegram/notifier.py`

### Security Monitoring

- [Security monitor](https://github.com/factzerdx/a12bypass/blob/main/security/monitor.py): `security/monitor.py`

### Other components

- **Operator**
- **Activation API**
- **Connected iOS device**
- **Telegram service**

## Connections

- Operator → Application entry: launches
- Application entry → Device detector: opens
- Device detector → Main window UI: loads
- Device detector → Activation worker: starts activation
- Activation worker → Security monitor: checks threats
- Activation worker → Device detector: requests device operations
- Device detector → Device command tools: runs commands
- Device command tools → Connected iOS device: communicates
- Device detector → API URL builder: builds endpoint URLs
- API URL builder → Service configuration: reads endpoints
- Device detector → Activation API: checks model and authorization
- Activation worker → Device detector: requests GUID submission and file download
- Device detector → Activation API: submits GUID and downloads file
- Device detector → Device command tools: transfers and executes file
- Activation worker → Device detector: checks activation status and reboots
- Activation worker → Telegram notifier: reports outcome
- Telegram notifier → Security monitor: checks proxy use
- Telegram notifier → Telegram service: sends notifications
- Security monitor → Telegram service: sends security alerts
- Application entry → Process helpers: hides console