# davidcasascompetenciadigital-prog/clamguard architecture

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

- Interactive diagram: https://gitdiagram.com/davidcasascompetenciadigital-prog/clamguard
- Repository: https://github.com/davidcasascompetenciadigital-prog/clamguard

## Overview

ClamGuard is a Windows desktop frontend and resident file scanner built around separately installed ClamAV. The main workflow is launch and elevation, install/update the engine and signatures, run an on-demand scan, then present detections for quarantine or deletion; a separately managed Windows service watches configured folders and scans new or changed files. The README also documents Defender coordination, firewall settings, quarantine recovery, and application updates. Some links for installation and UI actions rely on README documentation because the relevant call sites were not excerpted.

Main entry points: [`src/MainForm.cs`](https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/MainForm.cs) (Main window), [`src/ResidentService.cs`](https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/ResidentService.cs) (Resident service), [`src/Program.cs`](https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/Program.cs) (Application entry), [`src/Defender.cs`](https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/Defender.cs) (Defender coordination)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop application"]
  node_program["Application entry<br/>[Program.cs]"]
  node_mainform["Main window<br/>[MainForm.cs]"]
  node_dialogs["Workflow dialogs<br/>[Dialogs.cs]"]
  node_theme["UI theme<br/>[Theme.cs]"]
  node_controls["UI controls<br/>[Controls.cs]"]
end

subgraph group_scan["Scanning and response"]
  node_scanner["On-demand scanner<br/>[Scanner.cs]"]
  node_clamav["ClamAV integration<br/>[ClamAv.cs]"]
  node_quarantine[("Encrypted quarantine<br/>[Quarantine.cs]")]
end

subgraph group_resident["Resident protection"]
  node_resident["Resident service<br/>[ResidentService.cs]"]
  node_service_manager["Service manager<br/>[ServiceManager.cs]"]
end

subgraph group_system["System management"]
  node_installer["Engine installer<br/>[Installer.cs]"]
  node_defender["Defender coordination<br/>[Defender.cs]"]
  node_firewall["Firewall controls<br/>[Firewall.cs]"]
  node_uninstaller["Uninstaller<br/>[Uninstaller.cs]"]
  node_updater["Application update checker<br/>[UpdateChecker.cs]"]
end

subgraph group_state["Configuration and state"]
  node_settings["Settings and scan state<br/>[AppSettings.cs]"]
  node_paths["Data locations<br/>[AppPaths.cs]"]
  node_logger["Application logging<br/>[AppLog.cs]"]
end

node_user(("Windows user"))
node_engine["ClamAV engine"]
node_windows_defender["Windows Defender"]
node_github["GitHub releases"]

node_user -->|"launches"| node_program
node_program -->|"starts UI"| node_mainform
node_program -->|"runs service mode"| node_resident
node_program -->|"initializes"| node_logger
node_program -->|"ensures layout"| node_paths
node_mainform -->|"starts scans"| node_scanner
node_mainform -->|"queries engine"| node_clamav
node_mainform -->|"reads settings"| node_settings
node_mainform -->|"opens workflows"| node_dialogs
node_mainform -.->|"manages service"| node_service_manager
node_mainform -->|"queries status"| node_defender
node_mainform -->|"checks releases"| node_updater
node_mainform -->|"registers uninstall"| node_uninstaller
node_mainform -->|"opens controls"| node_firewall
node_mainform -->|"uses styling"| node_theme
node_controls -->|"uses styling"| node_theme
node_scanner -->|"runs engine"| node_clamav
node_clamav -->|"invokes tools"| node_engine
node_scanner -.->|"offers response"| node_quarantine
node_dialogs -.->|"manages items"| node_quarantine
node_dialogs -.->|"offers installation"| node_installer
node_installer -->|"downloads and installs"| node_engine
node_installer -->|"uses locations"| node_paths
node_resident -->|"scans watched files"| node_scanner
node_resident -->|"manages daemon"| node_clamav
node_resident -->|"loads configuration"| node_settings
node_resident -->|"coordinates protection"| node_defender
node_service_manager -->|"controls service"| node_resident
node_defender -->|"updates exclusions"| node_windows_defender
node_defender -->|"stores pause marker"| node_paths
node_uninstaller -->|"removes service"| node_resident
node_uninstaller -->|"restores protection"| node_defender
node_updater -->|"checks releases"| node_github
node_settings -->|"uses file paths"| node_paths
node_logger -->|"uses log directory"| node_paths

click node_program "https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/Program.cs"
click node_mainform "https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/MainForm.cs"
click node_dialogs "https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/Dialogs.cs"
click node_settings "https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/AppSettings.cs"
click node_paths "https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/AppPaths.cs"
click node_scanner "https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/Scanner.cs"
click node_clamav "https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/ClamAv.cs"
click node_quarantine "https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/Quarantine.cs"
click node_installer "https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/Installer.cs"
click node_resident "https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/ResidentService.cs"
click node_service_manager "https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/ServiceManager.cs"
click node_defender "https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/Defender.cs"
click node_firewall "https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/Firewall.cs"
click node_uninstaller "https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/Uninstaller.cs"
click node_updater "https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/UpdateChecker.cs"
click node_logger "https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/AppLog.cs"
click node_theme "https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/Theme.cs"
click node_controls "https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/Controls.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_program,node_mainform,node_dialogs,node_theme,node_controls,node_user toneBlue
class node_scanner,node_clamav,node_quarantine toneAmber
class node_resident,node_service_manager toneMint
class node_installer,node_defender,node_firewall,node_uninstaller,node_updater toneRose
class node_settings,node_paths,node_logger,node_engine,node_windows_defender,node_github toneIndigo
```

## Components

### Desktop application

- [Application entry](https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/Program.cs): `src/Program.cs`
- [Main window](https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/MainForm.cs): `src/MainForm.cs`
- [Workflow dialogs](https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/Dialogs.cs): `src/Dialogs.cs`
- [UI theme](https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/Theme.cs): `src/Theme.cs`
- [UI controls](https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/Controls.cs): `src/Controls.cs`

### Scanning and response

- [On-demand scanner](https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/Scanner.cs): `src/Scanner.cs`
- [ClamAV integration](https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/ClamAv.cs): `src/ClamAv.cs`
- [Encrypted quarantine](https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/Quarantine.cs): `src/Quarantine.cs`

### Resident protection

- [Resident service](https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/ResidentService.cs): `src/ResidentService.cs`
- [Service manager](https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/ServiceManager.cs): `src/ServiceManager.cs`

### System management

- [Engine installer](https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/Installer.cs): `src/Installer.cs`
- [Defender coordination](https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/Defender.cs): `src/Defender.cs`
- [Firewall controls](https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/Firewall.cs): `src/Firewall.cs`
- [Uninstaller](https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/Uninstaller.cs): `src/Uninstaller.cs`
- [Application update checker](https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/UpdateChecker.cs): `src/UpdateChecker.cs`

### Configuration and state

- [Settings and scan state](https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/AppSettings.cs): `src/AppSettings.cs`
- [Data locations](https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/AppPaths.cs): `src/AppPaths.cs`
- [Application logging](https://github.com/davidcasascompetenciadigital-prog/clamguard/blob/main/src/AppLog.cs): `src/AppLog.cs`

### Other components

- **Windows user**
- **ClamAV engine**
- **Windows Defender**
- **GitHub releases**

## Connections

- Windows user → Application entry: launches (evidence: `README.md`)
- Application entry → Main window: starts UI (evidence: `src/Program.cs`)
- Application entry → Resident service: runs service mode (evidence: `src/Program.cs`)
- Application entry → Application logging: initializes (evidence: `src/Program.cs`)
- Application entry → Data locations: ensures layout (evidence: `src/Program.cs`)
- Main window → On-demand scanner: starts scans (evidence: `src/MainForm.cs`)
- Main window → ClamAV integration: queries engine (evidence: `src/MainForm.cs`)
- Main window → Settings and scan state: reads settings (evidence: `src/MainForm.cs`)
- Main window → Workflow dialogs: opens workflows (evidence: `src/Dialogs.cs`)
- Main window → Service manager: manages service (evidence: `README.md`)
- Main window → Defender coordination: queries status (evidence: `src/MainForm.cs`)
- Main window → Application update checker: checks releases (evidence: `src/MainForm.cs`)
- Main window → Uninstaller: registers uninstall (evidence: `src/MainForm.cs`)
- Main window → Firewall controls: opens controls (evidence: `src/MainForm.cs`)
- Main window → UI theme: uses styling (evidence: `src/MainForm.cs`)
- UI controls → UI theme: uses styling (evidence: `src/Controls.cs`)
- On-demand scanner → ClamAV integration: runs engine (evidence: `src/Scanner.cs`)
- ClamAV integration → ClamAV engine: invokes tools (evidence: `README.md`)
- On-demand scanner → Encrypted quarantine: offers response (evidence: `README.md`)
- Workflow dialogs → Encrypted quarantine: manages items (evidence: `README.md`)
- Workflow dialogs → Engine installer: offers installation (evidence: `README.md`)
- Engine installer → ClamAV engine: downloads and installs (evidence: `README.md`)
- Engine installer → Data locations: uses locations (evidence: `src/Installer.cs`)
- Resident service → On-demand scanner: scans watched files (evidence: `src/ResidentService.cs`)
- Resident service → ClamAV integration: manages daemon (evidence: `src/ResidentService.cs`)
- Resident service → Settings and scan state: loads configuration (evidence: `src/ResidentService.cs`)
- Resident service → Defender coordination: coordinates protection (evidence: `src/ResidentService.cs`)
- Service manager → Resident service: controls service (evidence: `src/ServiceManager.cs`)
- Defender coordination → Windows Defender: updates exclusions (evidence: `README.md`)
- Defender coordination → Data locations: stores pause marker (evidence: `src/Defender.cs`)
- Uninstaller → Resident service: removes service (evidence: `src/Uninstaller.cs`)
- Uninstaller → Defender coordination: restores protection (evidence: `src/Uninstaller.cs`)
- Application update checker → GitHub releases: checks releases (evidence: `README.md`)
- Settings and scan state → Data locations: uses file paths (evidence: `src/AppSettings.cs`)
- Application logging → Data locations: uses log directory (evidence: `src/AppLog.cs`)
