# cecur-it/cs3-v1.1.0 architecture

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

- Interactive diagram: https://gitdiagram.com/cecur-it/cs3-v1.1.0
- Repository: https://github.com/cecur-it/cs3-v1.1.0

## Overview

This repository documents the CS3 Platform’s cloud and on-prem deployment paths, with Errow penetration testing and the Vendetta XDR/SIEM stack as companion components. A typical on-prem workflow sends endpoint telemetry to the console and/or Vendetta’s OpenSearch pipeline, while local inference can be routed through the gateway. Errow provides a separate scan-to-report workflow. The graph preserves these documented product branches and sampled internal layers; several deployment and integration links are based on README statements rather than inspected runtime wiring.

Main entry points: [`errow/errow/report/state.py`](https://github.com/cecur-it/cs3-v1.1.0/blob/main/errow/errow/report/state.py) (Findings and reports), [`errow/errow/interface/main.py`](https://github.com/cecur-it/cs3-v1.1.0/blob/main/errow/errow/interface/main.py) (Errow CLI), [`vendetta-stack/llm-gateway/server.py`](https://github.com/cecur-it/cs3-v1.1.0/blob/main/vendetta-stack/llm-gateway/server.py) (LLM gateway), [`deployment`](https://github.com/cecur-it/cs3-v1.1.0/tree/main/deployment) (Deployment tooling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_platform["CS3 Platform"]
  node_installer["Deployment tooling"]
  node_console["CS3 console"]
  node_forwarders["Telemetry forwarders"]
end

subgraph group_errow["Errow Scanning"]
  node_errow_cli["Errow CLI<br/>[main.py]"]
  node_errow_config["Scan configuration<br/>[loader.py]"]
  node_scan_runtime["Scan runtime<br/>[session_manager.py]"]
  node_scan_report[("Findings and reports<br/>[state.py]")]
  node_errow_viewer["Run viewer<br/>[server.py]"]
  node_tui_backend["TUI backend<br/>[controller.py]"]
end

subgraph group_vendetta["Vendetta Stack"]
  node_gateway["LLM gateway<br/>[server.py]"]
  node_local_models["Local Ollama models"]
  node_mcp_server["Errow MCP bridge<br/>[server.py]"]
  node_mcp_executor["MCP tool executor<br/>[executor.py]"]
  node_shipper["Telemetry shipper<br/>[shipper.py]"]
  node_opensearch[("OpenSearch")]
end

subgraph group_audit["Configuration Audit"]
  node_cfgaudit["Network config auditor<br/>[engine.py]"]
end

node_operator(("Platform operator"))

node_operator -->|"deploys"| node_installer
node_installer -.->|"installs"| node_console
node_forwarders -->|"send telemetry"| node_console
node_forwarders -->|"send telemetry"| node_shipper
node_shipper -->|"ingests into"| node_opensearch
node_operator -.->|"runs scans"| node_errow_cli
node_errow_cli -->|"loads settings"| node_errow_config
node_errow_cli -->|"records results"| node_scan_report
node_scan_runtime -.->|"persists scan state"| node_scan_report
node_scan_report -->|"serves run data"| node_errow_viewer
node_tui_backend -->|"reads scan state"| node_scan_report
node_gateway -.->|"routes inference"| node_local_models
node_gateway -.->|"calls MCP tools"| node_mcp_server
node_mcp_server -->|"dispatches calls"| node_mcp_executor
node_operator -.->|"audits configs"| node_cfgaudit

click node_installer "https://github.com/cecur-it/cs3-v1.1.0/tree/main/deployment"
click node_errow_cli "https://github.com/cecur-it/cs3-v1.1.0/blob/main/errow/errow/interface/main.py"
click node_errow_config "https://github.com/cecur-it/cs3-v1.1.0/blob/main/errow/errow/config/loader.py"
click node_scan_runtime "https://github.com/cecur-it/cs3-v1.1.0/blob/main/errow/errow/runtime/session_manager.py"
click node_scan_report "https://github.com/cecur-it/cs3-v1.1.0/blob/main/errow/errow/report/state.py"
click node_errow_viewer "https://github.com/cecur-it/cs3-v1.1.0/blob/main/errow/errow/interface/viewer/server.py"
click node_tui_backend "https://github.com/cecur-it/cs3-v1.1.0/blob/main/errow/errow/interface/tui/backend/controller.py"
click node_gateway "https://github.com/cecur-it/cs3-v1.1.0/blob/main/vendetta-stack/llm-gateway/server.py"
click node_local_models "https://github.com/cecur-it/cs3-v1.1.0/tree/main/vendetta-stack/ollama"
click node_mcp_server "https://github.com/cecur-it/cs3-v1.1.0/blob/main/vendetta-stack/errow/mcp/server.py"
click node_mcp_executor "https://github.com/cecur-it/cs3-v1.1.0/blob/main/vendetta-stack/errow/mcp/executor.py"
click node_shipper "https://github.com/cecur-it/cs3-v1.1.0/blob/main/vendetta-stack/errow/shipper/shipper.py"
click node_opensearch "https://github.com/cecur-it/cs3-v1.1.0/tree/main/vendetta-stack/opensearch"
click node_cfgaudit "https://github.com/cecur-it/cs3-v1.1.0/blob/main/vendetta-stack/cfgaudit/cfgaudit/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_installer,node_console,node_forwarders toneBlue
class node_errow_cli,node_errow_config,node_scan_runtime,node_scan_report,node_errow_viewer,node_tui_backend toneAmber
class node_gateway,node_local_models,node_mcp_server,node_mcp_executor,node_shipper,node_opensearch toneMint
class node_cfgaudit toneRose
class node_operator toneIndigo
```

## Components

### CS3 Platform

- [Deployment tooling](https://github.com/cecur-it/cs3-v1.1.0/tree/main/deployment): `deployment`
- **CS3 console**
- **Telemetry forwarders**

### Errow Scanning

- [Errow CLI](https://github.com/cecur-it/cs3-v1.1.0/blob/main/errow/errow/interface/main.py): `errow/errow/interface/main.py`
- [Scan configuration](https://github.com/cecur-it/cs3-v1.1.0/blob/main/errow/errow/config/loader.py): `errow/errow/config/loader.py`
- [Scan runtime](https://github.com/cecur-it/cs3-v1.1.0/blob/main/errow/errow/runtime/session_manager.py): `errow/errow/runtime/session_manager.py`
- [Findings and reports](https://github.com/cecur-it/cs3-v1.1.0/blob/main/errow/errow/report/state.py): `errow/errow/report/state.py`
- [Run viewer](https://github.com/cecur-it/cs3-v1.1.0/blob/main/errow/errow/interface/viewer/server.py): `errow/errow/interface/viewer/server.py`
- [TUI backend](https://github.com/cecur-it/cs3-v1.1.0/blob/main/errow/errow/interface/tui/backend/controller.py): `errow/errow/interface/tui/backend/controller.py`

### Vendetta Stack

- [LLM gateway](https://github.com/cecur-it/cs3-v1.1.0/blob/main/vendetta-stack/llm-gateway/server.py): `vendetta-stack/llm-gateway/server.py`
- [Local Ollama models](https://github.com/cecur-it/cs3-v1.1.0/tree/main/vendetta-stack/ollama): `vendetta-stack/ollama`
- [Errow MCP bridge](https://github.com/cecur-it/cs3-v1.1.0/blob/main/vendetta-stack/errow/mcp/server.py): `vendetta-stack/errow/mcp/server.py`
- [MCP tool executor](https://github.com/cecur-it/cs3-v1.1.0/blob/main/vendetta-stack/errow/mcp/executor.py): `vendetta-stack/errow/mcp/executor.py`
- [Telemetry shipper](https://github.com/cecur-it/cs3-v1.1.0/blob/main/vendetta-stack/errow/shipper/shipper.py): `vendetta-stack/errow/shipper/shipper.py`
- [OpenSearch](https://github.com/cecur-it/cs3-v1.1.0/tree/main/vendetta-stack/opensearch): `vendetta-stack/opensearch`

### Configuration Audit

- [Network config auditor](https://github.com/cecur-it/cs3-v1.1.0/blob/main/vendetta-stack/cfgaudit/cfgaudit/engine.py): `vendetta-stack/cfgaudit/cfgaudit/engine.py`

### Other components

- **Platform operator**

## Connections

- Platform operator → Deployment tooling: deploys (evidence: `README.md`)
- Deployment tooling → CS3 console: installs
- Telemetry forwarders → CS3 console: send telemetry (evidence: `README.md`)
- Telemetry forwarders → Telemetry shipper: send telemetry (evidence: `README.md`)
- Telemetry shipper → OpenSearch: ingests into (evidence: `README.md`)
- Platform operator → Errow CLI: runs scans
- Errow CLI → Scan configuration: loads settings (evidence: `errow/errow/interface/main.py`)
- Errow CLI → Findings and reports: records results (evidence: `errow/errow/interface/main.py`)
- Scan runtime → Findings and reports: persists scan state
- Findings and reports → Run viewer: serves run data (evidence: `errow/errow/interface/viewer/server.py`)
- TUI backend → Findings and reports: reads scan state (evidence: `errow/errow/interface/tui/backend/controller.py`)
- LLM gateway → Local Ollama models: routes inference
- LLM gateway → Errow MCP bridge: calls MCP tools
- Errow MCP bridge → MCP tool executor: dispatches calls (evidence: `vendetta-stack/errow/mcp/server.py`)
- Platform operator → Network config auditor: audits configs
