# sanchitna06-cell/guardian_ids architecture

> Architecture diagram of the GitHub repository sanchitna06-cell/guardian_ids, 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/sanchitna06-cell/guardian_ids
- Repository: https://github.com/sanchitna06-cell/guardian_ids

## Overview

Guardian IDS is a modular desktop network-monitoring and intrusion-detection application. Its main workflow captures traffic on a selected interface, normalizes packets, and distributes packet events to statistics and detection services; detected threats feed threat management, persistence, and GUI/analysis features. A separate simulation mode generates attack traffic into the event bus. The graph reflects documented architecture and indexed or excerpted references; some event-bus wiring and unsampled subsystem internals are not shown as direct calls.

Main entry points: [`src/core/event_bus.py`](https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/core/event_bus.py) (Event Bus), [`src/core/application.py`](https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/core/application.py) (Application Core), [`src/core/analysis/analysis_engine.py`](https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/core/analysis/analysis_engine.py) (Analysis Engine), [`src/core/detection/detection_engine.py`](https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/core/detection/detection_engine.py) (Detection Engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop Interface"]
  node_gui["Dashboard GUI<br/>[dashboard.py]"]
  node_analysis_dialog["Analysis Dialog<br/>[analysis_dialog.py]"]
end

subgraph group_network["Network Capture"]
  node_interfaces["Interface Manager"]
  node_capture["Capture Controller"]
  node_sniffer["Packet Sniffer<br/>[packet_sniffer.py]"]
  node_parser["Packet Parser<br/>[packet_parser.py]"]
  node_packet["Guardian Packet<br/>[packet_models.py]"]
end

subgraph group_core["Core Processing"]
  node_application["Application Core<br/>[application.py]"]
  node_bus["Event Bus<br/>[event_bus.py]"]
  node_statistics["Statistics Engine"]
  node_detection["Detection Engine"]
  node_detectors["Detector Registry"]
end

subgraph group_threat["Threat Services"]
  node_threats["Threat Manager<br/>[threat_manager.py]"]
  node_state["Guardian State"]
  node_persistence[("SQLite Persistence")]
  node_analysis["Analysis Engine<br/>[analysis_engine.py]"]
  node_report["Analysis Report<br/>[analysis_report.py]"]
end

subgraph group_simulation["Simulation"]
  node_simulation["Simulation Engine"]
  node_factory["Attack Factory<br/>[attack_factory.py]"]
  node_attacks["Attack Implementations"]
  node_generator["Packet Generator"]
end

node_user(("Operator"))
node_network_traffic(("Network Traffic"))

node_user -->|"operates"| node_gui
node_gui -->|"starts"| node_application
node_application -->|"constructs"| node_interfaces
node_application -->|"constructs"| node_capture
node_application -->|"constructs"| node_statistics
node_application -->|"constructs"| node_detection
node_application -->|"constructs"| node_threats
node_application -->|"constructs"| node_simulation
node_application -->|"constructs"| node_analysis
node_capture -->|"selects interface"| node_interfaces
node_capture -->|"starts capture"| node_sniffer
node_network_traffic -->|"supplies packets"| node_sniffer
node_sniffer -->|"forwards packets"| node_parser
node_parser -->|"normalizes to"| node_packet
node_parser -->|"publishes parsed packets"| node_bus
node_bus -->|"dispatches packets"| node_statistics
node_bus -->|"dispatches packets"| node_detection
node_detection -->|"loads detectors"| node_detectors
node_detection -->|"emits threats"| node_bus
node_bus -->|"delivers threat events"| node_threats
node_threats -->|"stores history"| node_persistence
node_analysis_dialog -.->|"requests analysis"| node_analysis
node_analysis -->|"reads active threats"| node_threats
node_analysis -->|"builds report"| node_report
node_analysis -->|"publishes report"| node_bus
node_bus -->|"delivers threat events"| node_state
node_bus -->|"starts simulation"| node_simulation
node_simulation -->|"creates attack"| node_factory
node_factory -->|"selects implementation"| node_attacks
node_attacks -->|"generates packets"| node_generator
node_simulation -->|"publishes raw packets"| node_bus

click node_gui "https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/gui/components/dashboard.py"
click node_analysis_dialog "https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/gui/dialogs/analysis_dialog.py"
click node_application "https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/core/application.py"
click node_interfaces "https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/network/interface_manager.py"
click node_capture "https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/network/capture_controller.py"
click node_sniffer "https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/network/packet_sniffer.py"
click node_parser "https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/network/packet_parser.py"
click node_packet "https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/network/packet_models.py"
click node_bus "https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/core/event_bus.py"
click node_statistics "https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/core/statistics/statistics_engine.py"
click node_detection "https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/core/detection/detection_engine.py"
click node_detectors "https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/core/detection/detector_registry.py"
click node_threats "https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/core/threats/threat_manager.py"
click node_state "https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/core/guardian_state_manager.py"
click node_persistence "https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/core/persistence/persistence_manager.py"
click node_analysis "https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/core/analysis/analysis_engine.py"
click node_report "https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/core/analysis/analysis_report.py"
click node_simulation "https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/simulation/simulation_engine.py"
click node_factory "https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/simulation/attack_factory.py"
click node_attacks "https://github.com/sanchitna06-cell/guardian_ids/tree/main/src/simulation/attacks"
click node_generator "https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/simulation/packet_generator.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_gui,node_analysis_dialog toneBlue
class node_interfaces,node_capture,node_sniffer,node_parser,node_packet toneAmber
class node_application,node_bus,node_statistics,node_detection,node_detectors toneMint
class node_threats,node_state,node_persistence,node_analysis,node_report toneRose
class node_simulation,node_factory,node_attacks,node_generator,node_user,node_network_traffic toneIndigo
```

## Components

### Desktop Interface

- [Dashboard GUI](https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/gui/components/dashboard.py): `src/gui/components/dashboard.py`
- [Analysis Dialog](https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/gui/dialogs/analysis_dialog.py): `src/gui/dialogs/analysis_dialog.py`

### Network Capture

- [Interface Manager](https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/network/interface_manager.py): `src/network/interface_manager.py`
- [Capture Controller](https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/network/capture_controller.py): `src/network/capture_controller.py`
- [Packet Sniffer](https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/network/packet_sniffer.py): `src/network/packet_sniffer.py`
- [Packet Parser](https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/network/packet_parser.py): `src/network/packet_parser.py`
- [Guardian Packet](https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/network/packet_models.py): `src/network/packet_models.py`

### Core Processing

- [Application Core](https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/core/application.py): `src/core/application.py`
- [Event Bus](https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/core/event_bus.py): `src/core/event_bus.py`
- [Statistics Engine](https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/core/statistics/statistics_engine.py): `src/core/statistics/statistics_engine.py`
- [Detection Engine](https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/core/detection/detection_engine.py): `src/core/detection/detection_engine.py`
- [Detector Registry](https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/core/detection/detector_registry.py): `src/core/detection/detector_registry.py`

### Threat Services

- [Threat Manager](https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/core/threats/threat_manager.py): `src/core/threats/threat_manager.py`
- [Guardian State](https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/core/guardian_state_manager.py): `src/core/guardian_state_manager.py`
- [SQLite Persistence](https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/core/persistence/persistence_manager.py): `src/core/persistence/persistence_manager.py`
- [Analysis Engine](https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/core/analysis/analysis_engine.py): `src/core/analysis/analysis_engine.py`
- [Analysis Report](https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/core/analysis/analysis_report.py): `src/core/analysis/analysis_report.py`

### Simulation

- [Simulation Engine](https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/simulation/simulation_engine.py): `src/simulation/simulation_engine.py`
- [Attack Factory](https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/simulation/attack_factory.py): `src/simulation/attack_factory.py`
- [Attack Implementations](https://github.com/sanchitna06-cell/guardian_ids/tree/main/src/simulation/attacks): `src/simulation/attacks`
- [Packet Generator](https://github.com/sanchitna06-cell/guardian_ids/blob/main/src/simulation/packet_generator.py): `src/simulation/packet_generator.py`

### Other components

- **Operator**
- **Network Traffic**

## Connections

- Operator → Dashboard GUI: operates (evidence: `README.md`)
- Dashboard GUI → Application Core: starts (evidence: `src/gui/main_window.py`)
- Application Core → Interface Manager: constructs (evidence: `src/core/application.py`)
- Application Core → Capture Controller: constructs (evidence: `src/core/application.py`)
- Application Core → Statistics Engine: constructs (evidence: `src/core/application.py`)
- Application Core → Detection Engine: constructs (evidence: `src/core/application.py`)
- Application Core → Threat Manager: constructs (evidence: `src/core/application.py`)
- Application Core → Simulation Engine: constructs (evidence: `src/core/application.py`)
- Application Core → Analysis Engine: constructs (evidence: `src/core/application.py`)
- Capture Controller → Interface Manager: selects interface (evidence: `src/network/capture_controller.py`)
- Capture Controller → Packet Sniffer: starts capture (evidence: `src/network/capture_controller.py`)
- Network Traffic → Packet Sniffer: supplies packets (evidence: `README.md`)
- Packet Sniffer → Packet Parser: forwards packets (evidence: `README.md`)
- Packet Parser → Guardian Packet: normalizes to (evidence: `src/network/packet_parser.py`)
- Packet Parser → Event Bus: publishes parsed packets (evidence: `src/network/packet_parser.py`)
- Event Bus → Statistics Engine: dispatches packets (evidence: `src/core/statistics/statistics_engine.py`)
- Event Bus → Detection Engine: dispatches packets (evidence: `README.md`)
- Detection Engine → Detector Registry: loads detectors (evidence: `src/core/detection/detection_engine.py`)
- Detection Engine → Event Bus: emits threats (evidence: `src/core/detection/detection_engine.py`)
- Event Bus → Threat Manager: delivers threat events (evidence: `README.md`)
- Threat Manager → SQLite Persistence: stores history (evidence: `src/core/threats/threat_manager.py`)
- Analysis Dialog → Analysis Engine: requests analysis
- Analysis Engine → Threat Manager: reads active threats (evidence: `src/core/analysis/analysis_engine.py`)
- Analysis Engine → Analysis Report: builds report (evidence: `src/core/analysis/analysis_engine.py`)
- Analysis Engine → Event Bus: publishes report (evidence: `src/core/analysis/analysis_engine.py`)
- Event Bus → Guardian State: delivers threat events (evidence: `src/core/guardian_state_manager.py`)
- Event Bus → Simulation Engine: starts simulation (evidence: `src/simulation/simulation_engine.py`)
- Simulation Engine → Attack Factory: creates attack (evidence: `src/simulation/simulation_engine.py`)
- Attack Factory → Attack Implementations: selects implementation (evidence: `src/simulation/attack_factory.py`)
- Attack Implementations → Packet Generator: generates packets (evidence: `src/simulation/attacks/base_attack.py`)
- Simulation Engine → Event Bus: publishes raw packets (evidence: `src/simulation/simulation_engine.py`)
