# master11br/gboc-new architecture

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

- Interactive diagram: https://gitdiagram.com/master11br/gboc-new
- Repository: https://github.com/master11br/gboc-new

## Overview

GBOC is an enterprise backup and operations platform split between a central server and endpoint agents. Its principal protection lifecycle spans policy, backup execution, storage, integrity checks, recovery testing, restoration, and operational evidence; the README documents this lifecycle, while the tree identifies the corresponding subsystems. The graph also preserves major documented capabilities such as fleet/RMM, ransomware protection, DR, AI diagnostics, and reporting. Some links are dashed because the excerpts do not expose their runtime wiring.

Main entry points: [`GBOC-Agent/api`](https://github.com/master11br/gboc-new/tree/main/GBOC-Agent/api) (Agent APIs), [`GBOC-Server/server_gboc.py`](https://github.com/master11br/gboc-new/blob/main/GBOC-Server/server_gboc.py) (Central Server), [`GBOC-Agent/engines/backup_engine_manager.py`](https://github.com/master11br/gboc-new/blob/main/GBOC-Agent/engines/backup_engine_manager.py) (Backup Engines), [`GBOC-Server/modules`](https://github.com/master11br/gboc-new/tree/main/GBOC-Server/modules) (Server APIs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_fleet["Fleet and API"]
  node_agentapi["Agent APIs"]
  node_serverapi["Server APIs"]
  node_rmm["Remote Management<br/>[rmm_router.py]"]
end

subgraph group_protection["Backup Protection"]
  node_policy["Backup Policies<br/>[central_policy.py]"]
  node_backup["Backup Engines"]
  node_repositories["Repositories"]
  node_storage["Storage Monitor<br/>[storage_monitor.py]"]
  node_integrity["Integrity and Security"]
end

subgraph group_recovery["Recovery and DR"]
  node_dr["DR Engine"]
  node_restore["Restore Manager"]
  node_virtual_lab["Virtual Lab"]
end

subgraph group_operations["Operations and Insights"]
  node_diagnostics["AI Diagnostics"]
  node_reports["Reports"]
  node_telemetry["Telemetry"]
end

subgraph group_platform["Agent and Server Core"]
  node_agent["Endpoint Agent<br/>[agent_gboc.py]"]
  node_server["Central Server<br/>[server_gboc.py]"]
  node_serverdb[("Server Database<br/>[database.py]")]
  node_agentcore["Shared Agent Core<br/>[shared_core.py]"]
  node_agentlink["Server Client<br/>[server_client.py]"]
end

node_operator(("Operator"))
node_serverdbservice{{"External LLM Providers"}}

node_operator -.->|"operates"| node_server
node_operator -.->|"manages locally"| node_agentapi
node_server -.->|"routes requests"| node_serverapi
node_agent -.->|"serves"| node_agentapi
node_agentlink -.->|"syncs by HTTP"| node_server
node_server -.->|"commands by WebSocket"| node_agentlink
node_agentlink -->|"dispatches commands"| node_rmm
node_agentapi -->|"uses shared core"| node_agentcore
node_agentcore -->|"initializes"| node_backup
node_operator -.->|"configures"| node_policy
node_policy -.->|"guides execution"| node_backup
node_backup -.->|"stores backups"| node_repositories
node_repositories -.->|"supplies repository data"| node_storage
node_agentapi -->|"requests scans"| node_storage
node_backup -.->|"supports protection checks"| node_integrity
node_agentapi -->|"routes DR operations"| node_dr
node_agentapi -.->|"routes restore operations"| node_restore
node_agentapi -->|"routes lab operations"| node_virtual_lab
node_dr -.->|"enables recovery"| node_restore
node_restore -.->|"validates recovery"| node_virtual_lab
node_serverapi -.->|"requests diagnosis"| node_diagnostics
node_diagnostics -.->|"queries optionally"| node_serverdbservice
node_diagnostics -.->|"uses host telemetry"| node_telemetry
node_agentcore -.->|"provides system data"| node_reports
node_operator -.->|"reviews evidence"| node_reports
node_server -.->|"persists operational data"| node_serverdb
node_serverapi -.->|"manages agent remotely"| node_rmm

click node_agent "https://github.com/master11br/gboc-new/blob/main/GBOC-Agent/agent_gboc.py"
click node_server "https://github.com/master11br/gboc-new/blob/main/GBOC-Server/server_gboc.py"
click node_serverdb "https://github.com/master11br/gboc-new/blob/main/GBOC-Server/database.py"
click node_agentcore "https://github.com/master11br/gboc-new/blob/main/GBOC-Agent/shared_core.py"
click node_agentlink "https://github.com/master11br/gboc-new/blob/main/GBOC-Agent/core/server_client.py"
click node_agentapi "https://github.com/master11br/gboc-new/tree/main/GBOC-Agent/api"
click node_serverapi "https://github.com/master11br/gboc-new/tree/main/GBOC-Server/modules"
click node_rmm "https://github.com/master11br/gboc-new/blob/main/GBOC-Agent/modules/rmm/rmm_router.py"
click node_policy "https://github.com/master11br/gboc-new/blob/main/GBOC-Agent/engines/central_policy.py"
click node_backup "https://github.com/master11br/gboc-new/blob/main/GBOC-Agent/engines/backup_engine_manager.py"
click node_repositories "https://github.com/master11br/gboc-new/blob/main/GBOC-Agent/engines/repository_manager.py"
click node_storage "https://github.com/master11br/gboc-new/blob/main/GBOC-Agent/engines/storage_monitor.py"
click node_integrity "https://github.com/master11br/gboc-new/blob/main/GBOC-Agent/engines/ransomware_detector.py"
click node_dr "https://github.com/master11br/gboc-new/blob/main/GBOC-Agent/engines/disaster_recovery_engine.py"
click node_restore "https://github.com/master11br/gboc-new/blob/main/GBOC-Agent/engines/real_restore_manager.py"
click node_virtual_lab "https://github.com/master11br/gboc-new/blob/main/GBOC-Agent/engines/virtual_lab_engine.py"
click node_diagnostics "https://github.com/master11br/gboc-new/blob/main/GBOC-Server/modules/ai_assistant/ai_diagnostic_engine.py"
click node_reports "https://github.com/master11br/gboc-new/blob/main/GBOC-Agent/engines/v4_reports_engine.py"
click node_telemetry "https://github.com/master11br/gboc-new/blob/main/GBOC-Server/modules/telemetry/telemetry_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_agentapi,node_serverapi,node_rmm toneBlue
class node_policy,node_backup,node_repositories,node_storage,node_integrity toneAmber
class node_dr,node_restore,node_virtual_lab toneMint
class node_diagnostics,node_reports,node_telemetry toneRose
class node_agent,node_server,node_serverdb,node_agentcore,node_agentlink,node_operator,node_serverdbservice toneIndigo
```

## Components

### Fleet and API

- [Agent APIs](https://github.com/master11br/gboc-new/tree/main/GBOC-Agent/api): `GBOC-Agent/api`
- [Server APIs](https://github.com/master11br/gboc-new/tree/main/GBOC-Server/modules): `GBOC-Server/modules`
- [Remote Management](https://github.com/master11br/gboc-new/blob/main/GBOC-Agent/modules/rmm/rmm_router.py): `GBOC-Agent/modules/rmm/rmm_router.py`

### Backup Protection

- [Backup Policies](https://github.com/master11br/gboc-new/blob/main/GBOC-Agent/engines/central_policy.py): `GBOC-Agent/engines/central_policy.py`
- [Backup Engines](https://github.com/master11br/gboc-new/blob/main/GBOC-Agent/engines/backup_engine_manager.py): `GBOC-Agent/engines/backup_engine_manager.py`
- [Repositories](https://github.com/master11br/gboc-new/blob/main/GBOC-Agent/engines/repository_manager.py): `GBOC-Agent/engines/repository_manager.py`
- [Storage Monitor](https://github.com/master11br/gboc-new/blob/main/GBOC-Agent/engines/storage_monitor.py): `GBOC-Agent/engines/storage_monitor.py`
- [Integrity and Security](https://github.com/master11br/gboc-new/blob/main/GBOC-Agent/engines/ransomware_detector.py): `GBOC-Agent/engines/ransomware_detector.py`

### Recovery and DR

- [DR Engine](https://github.com/master11br/gboc-new/blob/main/GBOC-Agent/engines/disaster_recovery_engine.py): `GBOC-Agent/engines/disaster_recovery_engine.py`
- [Restore Manager](https://github.com/master11br/gboc-new/blob/main/GBOC-Agent/engines/real_restore_manager.py): `GBOC-Agent/engines/real_restore_manager.py`
- [Virtual Lab](https://github.com/master11br/gboc-new/blob/main/GBOC-Agent/engines/virtual_lab_engine.py): `GBOC-Agent/engines/virtual_lab_engine.py`

### Operations and Insights

- [AI Diagnostics](https://github.com/master11br/gboc-new/blob/main/GBOC-Server/modules/ai_assistant/ai_diagnostic_engine.py): `GBOC-Server/modules/ai_assistant/ai_diagnostic_engine.py`
- [Reports](https://github.com/master11br/gboc-new/blob/main/GBOC-Agent/engines/v4_reports_engine.py): `GBOC-Agent/engines/v4_reports_engine.py`
- [Telemetry](https://github.com/master11br/gboc-new/blob/main/GBOC-Server/modules/telemetry/telemetry_engine.py): `GBOC-Server/modules/telemetry/telemetry_engine.py`

### Agent and Server Core

- [Endpoint Agent](https://github.com/master11br/gboc-new/blob/main/GBOC-Agent/agent_gboc.py): `GBOC-Agent/agent_gboc.py`
- [Central Server](https://github.com/master11br/gboc-new/blob/main/GBOC-Server/server_gboc.py): `GBOC-Server/server_gboc.py`
- [Server Database](https://github.com/master11br/gboc-new/blob/main/GBOC-Server/database.py): `GBOC-Server/database.py`
- [Shared Agent Core](https://github.com/master11br/gboc-new/blob/main/GBOC-Agent/shared_core.py): `GBOC-Agent/shared_core.py`
- [Server Client](https://github.com/master11br/gboc-new/blob/main/GBOC-Agent/core/server_client.py): `GBOC-Agent/core/server_client.py`

### Other components

- **Operator**
- **External LLM Providers**

## Connections

- Operator → Central Server: operates
- Operator → Agent APIs: manages locally
- Central Server → Server APIs: routes requests
- Endpoint Agent → Agent APIs: serves
- Server Client → Central Server: syncs by HTTP
- Central Server → Server Client: commands by WebSocket
- Server Client → Remote Management: dispatches commands (evidence: `GBOC-Agent/core/server_client.py`)
- Agent APIs → Shared Agent Core: uses shared core (evidence: `GBOC-Agent/api/engines.py`)
- Shared Agent Core → Backup Engines: initializes (evidence: `GBOC-Agent/shared_core.py`)
- Operator → Backup Policies: configures
- Backup Policies → Backup Engines: guides execution
- Backup Engines → Repositories: stores backups
- Repositories → Storage Monitor: supplies repository data
- Agent APIs → Storage Monitor: requests scans (evidence: `GBOC-Agent/api/storage_router.py`)
- Backup Engines → Integrity and Security: supports protection checks
- Agent APIs → DR Engine: routes DR operations
- Agent APIs → Restore Manager: routes restore operations
- Agent APIs → Virtual Lab: routes lab operations
- DR Engine → Restore Manager: enables recovery
- Restore Manager → Virtual Lab: validates recovery
- Server APIs → AI Diagnostics: requests diagnosis (evidence: `GBOC-Server/modules/ai_assistant/ai_diagnostic_engine.py`)
- AI Diagnostics → External LLM Providers: queries optionally
- AI Diagnostics → Telemetry: uses host telemetry
- Shared Agent Core → Reports: provides system data (evidence: `GBOC-Agent/engines/v4_reports_engine.py`)
- Operator → Reports: reviews evidence
- Central Server → Server Database: persists operational data
- Server APIs → Remote Management: manages agent remotely
