# xty64xty/xdows-security-5 architecture

> Architecture diagram of the GitHub repository xty64xty/xdows-security-5, 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/xty64xty/xdows-security-5
- Repository: https://github.com/xty64xty/xdows-security-5

## Overview

Xdows Security 5 is a WinUI 3 antivirus and Windows protection application. The user-facing workflow is to launch the app, scan files or the system, review detections, and manage trust or quarantine. Alongside on-demand scanning, the repository includes driver-backed real-time protection, boot protection, system repair, and shell-management capabilities. Relationships below use README statements or SOURCE INDEX references; unsampled subsystems and integrations are shown without speculative call chains.

Main entry points: [`Protection/Drivers/Runtime/Protection.cs`](https://github.com/xty64xty/xdows-security-5/blob/main/Protection/Drivers/Runtime/Protection.cs) (Protection runtime), [`Xdows-Security/Views/SecurityPage.xaml.cs`](https://github.com/xty64xty/xdows-security-5/blob/main/Xdows-Security/Views/SecurityPage.xaml.cs) (Security page), [`Helper/ScanEngine.cs`](https://github.com/xty64xty/xdows-security-5/blob/main/Helper/ScanEngine.cs) (Scan engine), [`Xdows-Security/App.xaml.cs`](https://github.com/xty64xty/xdows-security-5/blob/main/Xdows-Security/App.xaml.cs) (App startup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and UI"]
  node_app["App startup<br/>[App.xaml.cs]"]
  node_security_ui["Security page"]
  node_browser["Browser protection<br/>[background.js]"]
end

subgraph group_scan["Threat scanning"]
  node_scan_engine["Scan engine<br/>[ScanEngine.cs]"]
  node_archive["Archive scanning<br/>[ArchiveScanner.cs]"]
  node_family["Family detection"]
  node_infector_detect["Infector detection"]
  node_infector_clean["Infector repair<br/>[InfectorCleaner.cs]"]
  node_model["Native model runtime"]
end

subgraph group_protection["Active protection"]
  node_runtime["Protection runtime<br/>[Protection.cs]"]
  node_driver["Security driver<br/>[BridgeClient.cs]"]
  node_boot["Boot protection<br/>[BootProtection.cs]"]
  node_boot_client["Boot filter client"]
  node_installer["Driver installation<br/>[Installer.cs]"]
end

subgraph group_response["Threat response"]
  node_trust[("Trusted files<br/>[TrustManager.cs]")]
  node_quarantine[("Quarantine")]
  node_signer["Signer trust"]
end

subgraph group_tools["System tools"]
  node_repair["System repair"]
  node_context_menu["Shell menu manager"]
end

node_user(("User"))
node_windows(("Windows system"))

node_user -->|"launches"| node_app
node_app -->|"initializes"| node_runtime
node_app -->|"configures"| node_boot
node_app -.->|"opens"| node_security_ui
node_user -.->|"requests scans"| node_security_ui
node_security_ui -->|"scans files"| node_scan_engine
node_scan_engine -.->|"scans archives"| node_archive
node_scan_engine -->|"checks infection"| node_infector_detect
node_scan_engine -.->|"classifies threats"| node_family
node_scan_engine -.->|"runs model"| node_model
node_security_ui -->|"uses detection"| node_family
node_security_ui -->|"repairs infection"| node_infector_clean
node_infector_detect -->|"analyzes files for"| node_infector_clean
node_runtime -->|"communicates via"| node_driver
node_runtime -->|"uses"| node_boot_client
node_runtime -->|"scans threats with"| node_model
node_runtime -->|"manages threats with"| node_quarantine
node_runtime -->|"checks trust with"| node_trust
node_runtime -->|"checks signers with"| node_signer
node_boot -->|"uses"| node_runtime
node_boot_client -.->|"sends filter requests"| node_windows
node_installer -.->|"installs driver"| node_windows
node_security_ui -->|"manages trust"| node_trust
node_security_ui -->|"manages quarantine"| node_quarantine
node_user -.->|"requests repair"| node_repair
node_user -.->|"manages shell menus"| node_context_menu
node_user -.->|"uses browser protection"| node_browser

click node_app "https://github.com/xty64xty/xdows-security-5/blob/main/Xdows-Security/App.xaml.cs"
click node_security_ui "https://github.com/xty64xty/xdows-security-5/blob/main/Xdows-Security/Views/SecurityPage.xaml.cs"
click node_browser "https://github.com/xty64xty/xdows-security-5/blob/main/BrowserProtection/background.js"
click node_scan_engine "https://github.com/xty64xty/xdows-security-5/blob/main/Helper/ScanEngine.cs"
click node_archive "https://github.com/xty64xty/xdows-security-5/blob/main/Helper/ArchiveScanner.cs"
click node_family "https://github.com/xty64xty/xdows-security-5/blob/main/Xdows-Local/VirusFamilyEngine.cs"
click node_infector_detect "https://github.com/xty64xty/xdows-security-5/blob/main/Helper/InfectorCleaner/InfectorDetector.cs"
click node_infector_clean "https://github.com/xty64xty/xdows-security-5/blob/main/Helper/InfectorCleaner/InfectorCleaner.cs"
click node_model "https://github.com/xty64xty/xdows-security-5/blob/main/Protection/NativeModelScanner.cs"
click node_runtime "https://github.com/xty64xty/xdows-security-5/blob/main/Protection/Drivers/Runtime/Protection.cs"
click node_driver "https://github.com/xty64xty/xdows-security-5/blob/main/Protection/Drivers/Communication/BridgeClient.cs"
click node_boot "https://github.com/xty64xty/xdows-security-5/blob/main/Protection/Compatibility/BootProtection.cs"
click node_boot_client "https://github.com/xty64xty/xdows-security-5/blob/main/Protection/Drivers/BootProtection/BootFilterClient.cs"
click node_installer "https://github.com/xty64xty/xdows-security-5/blob/main/Protection/Drivers/Installation/Installer.cs"
click node_trust "https://github.com/xty64xty/xdows-security-5/blob/main/TrustQuarantine/TrustManager.cs"
click node_quarantine "https://github.com/xty64xty/xdows-security-5/blob/main/TrustQuarantine/QuarantineManager.cs"
click node_signer "https://github.com/xty64xty/xdows-security-5/blob/main/Protection/SignerTrustService.cs"
click node_repair "https://github.com/xty64xty/xdows-security-5/blob/main/Xdows-Local/SystemRepairService.cs"
click node_context_menu "https://github.com/xty64xty/xdows-security-5/blob/main/Xdows-Security/Services/ShellContextMenuService.cs"

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_app,node_security_ui,node_browser,node_user toneBlue
class node_scan_engine,node_archive,node_family,node_infector_detect,node_infector_clean,node_model toneAmber
class node_runtime,node_driver,node_boot,node_boot_client,node_installer toneMint
class node_trust,node_quarantine,node_signer toneRose
class node_repair,node_context_menu,node_windows toneIndigo
```

## Components

### App and UI

- [App startup](https://github.com/xty64xty/xdows-security-5/blob/main/Xdows-Security/App.xaml.cs): `Xdows-Security/App.xaml.cs`
- [Security page](https://github.com/xty64xty/xdows-security-5/blob/main/Xdows-Security/Views/SecurityPage.xaml.cs): `Xdows-Security/Views/SecurityPage.xaml.cs`
- [Browser protection](https://github.com/xty64xty/xdows-security-5/blob/main/BrowserProtection/background.js): `BrowserProtection/background.js`

### Threat scanning

- [Scan engine](https://github.com/xty64xty/xdows-security-5/blob/main/Helper/ScanEngine.cs): `Helper/ScanEngine.cs`
- [Archive scanning](https://github.com/xty64xty/xdows-security-5/blob/main/Helper/ArchiveScanner.cs): `Helper/ArchiveScanner.cs`
- [Family detection](https://github.com/xty64xty/xdows-security-5/blob/main/Xdows-Local/VirusFamilyEngine.cs): `Xdows-Local/VirusFamilyEngine.cs`
- [Infector detection](https://github.com/xty64xty/xdows-security-5/blob/main/Helper/InfectorCleaner/InfectorDetector.cs): `Helper/InfectorCleaner/InfectorDetector.cs`
- [Infector repair](https://github.com/xty64xty/xdows-security-5/blob/main/Helper/InfectorCleaner/InfectorCleaner.cs): `Helper/InfectorCleaner/InfectorCleaner.cs`
- [Native model runtime](https://github.com/xty64xty/xdows-security-5/blob/main/Protection/NativeModelScanner.cs): `Protection/NativeModelScanner.cs`

### Active protection

- [Protection runtime](https://github.com/xty64xty/xdows-security-5/blob/main/Protection/Drivers/Runtime/Protection.cs): `Protection/Drivers/Runtime/Protection.cs`
- [Security driver](https://github.com/xty64xty/xdows-security-5/blob/main/Protection/Drivers/Communication/BridgeClient.cs): `Protection/Drivers/Communication/BridgeClient.cs`
- [Boot protection](https://github.com/xty64xty/xdows-security-5/blob/main/Protection/Compatibility/BootProtection.cs): `Protection/Compatibility/BootProtection.cs`
- [Boot filter client](https://github.com/xty64xty/xdows-security-5/blob/main/Protection/Drivers/BootProtection/BootFilterClient.cs): `Protection/Drivers/BootProtection/BootFilterClient.cs`
- [Driver installation](https://github.com/xty64xty/xdows-security-5/blob/main/Protection/Drivers/Installation/Installer.cs): `Protection/Drivers/Installation/Installer.cs`

### Threat response

- [Trusted files](https://github.com/xty64xty/xdows-security-5/blob/main/TrustQuarantine/TrustManager.cs): `TrustQuarantine/TrustManager.cs`
- [Quarantine](https://github.com/xty64xty/xdows-security-5/blob/main/TrustQuarantine/QuarantineManager.cs): `TrustQuarantine/QuarantineManager.cs`
- [Signer trust](https://github.com/xty64xty/xdows-security-5/blob/main/Protection/SignerTrustService.cs): `Protection/SignerTrustService.cs`

### System tools

- [System repair](https://github.com/xty64xty/xdows-security-5/blob/main/Xdows-Local/SystemRepairService.cs): `Xdows-Local/SystemRepairService.cs`
- [Shell menu manager](https://github.com/xty64xty/xdows-security-5/blob/main/Xdows-Security/Services/ShellContextMenuService.cs): `Xdows-Security/Services/ShellContextMenuService.cs`

### Other components

- **User**
- **Windows system**

## Connections

- User → App startup: launches (evidence: `README.md`)
- App startup → Protection runtime: initializes (evidence: `Xdows-Security/App.xaml.cs`)
- App startup → Boot protection: configures (evidence: `Xdows-Security/App.xaml.cs`)
- App startup → Security page: opens
- User → Security page: requests scans
- Security page → Scan engine: scans files (evidence: `Xdows-Security/Views/SecurityPage.xaml.cs`)
- Scan engine → Archive scanning: scans archives
- Scan engine → Infector detection: checks infection (evidence: `Helper/ScanEngine.cs`)
- Scan engine → Family detection: classifies threats
- Scan engine → Native model runtime: runs model
- Security page → Family detection: uses detection (evidence: `Xdows-Security/Views/SecurityPage.xaml.cs`)
- Security page → Infector repair: repairs infection (evidence: `Xdows-Security/Views/SecurityPage.xaml.cs`)
- Infector detection → Infector repair: analyzes files for (evidence: `Helper/InfectorCleaner/InfectorCleaner.cs`)
- Protection runtime → Security driver: communicates via (evidence: `Protection/Drivers/Runtime/Protection.cs`)
- Protection runtime → Boot filter client: uses (evidence: `Protection/Drivers/Runtime/Protection.cs`)
- Protection runtime → Native model runtime: scans threats with (evidence: `Protection/Drivers/Runtime/Protection.cs`)
- Protection runtime → Quarantine: manages threats with (evidence: `Protection/Drivers/Runtime/Protection.cs`)
- Protection runtime → Trusted files: checks trust with (evidence: `Protection/Drivers/Runtime/Protection.cs`)
- Protection runtime → Signer trust: checks signers with (evidence: `Protection/Drivers/Runtime/Protection.cs`)
- Boot protection → Protection runtime: uses (evidence: `Protection/Compatibility/BootProtection.cs`)
- Boot filter client → Windows system: sends filter requests
- Driver installation → Windows system: installs driver
- Security page → Trusted files: manages trust (evidence: `Xdows-Security/Views/SecurityPage.xaml.cs`)
- Security page → Quarantine: manages quarantine (evidence: `Xdows-Security/Views/SecurityPage.xaml.cs`)
- User → System repair: requests repair
- User → Shell menu manager: manages shell menus
- User → Browser protection: uses browser protection
