# adaaraujo/mini-siem-dashboard architecture

> Architecture diagram of the GitHub repository adaaraujo/mini-siem-dashboard, 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/adaaraujo/mini-siem-dashboard
- Repository: https://github.com/adaaraujo/mini-siem-dashboard

## Overview

Mini SIEM Dashboard is a Python/Flask security-log pipeline: simulated or supplied SSH, firewall, and web logs are parsed into SQLite events, detection rules generate alerts, and a browser dashboard queries and manages the results. The graph preserves threat-intelligence matching and the simulator as distinct capabilities. The README documents the overall stages; source excerpts show ingestion, detection, API, and client calls. The template’s static-asset wiring and any live-streaming behavior were not inspected, so no such links are asserted.

Main entry points: [`src/ingestion/ingest.py`](https://github.com/adaaraujo/mini-siem-dashboard/blob/main/src/ingestion/ingest.py) (Log Ingestion), [`src/dashboard/app.py`](https://github.com/adaaraujo/mini-siem-dashboard/blob/main/src/dashboard/app.py) (Flask API), [`src/detection/detect.py`](https://github.com/adaaraujo/mini-siem-dashboard/blob/main/src/detection/detect.py) (Detection Rules), [`src/dashboard/static/js/dashboard.js`](https://github.com/adaaraujo/mini-siem-dashboard/blob/main/src/dashboard/static/js/dashboard.js) (Dashboard Client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Log Inputs"]
  node_simulator["Log Simulator<br/>[log_simulator.py]"]
  node_logfiles["Log Files"]
end

subgraph group_analysis["Ingestion &amp; Detection"]
  node_ingest["Log Ingestion<br/>[ingest.py]"]
  node_intelfile["Malicious IP List"]
  node_detect["Detection Rules<br/>[detect.py]"]
end

subgraph group_store["SIEM Data"]
  node_database[("SQLite Database")]
end

subgraph group_dashboard["Dashboard"]
  node_flask["Flask API<br/>[app.py]"]
  node_template["Dashboard Page<br/>[index.html]"]
  node_client["Dashboard Client<br/>[dashboard.js]"]
  node_styles["Dashboard Styling<br/>[style.css]"]
end

node_operator(("Operator"))

node_simulator -->|"writes logs"| node_logfiles
node_logfiles -->|"reads logs"| node_ingest
node_ingest -->|"writes events"| node_database
node_intelfile -->|"loads IPs"| node_ingest
node_ingest -->|"loads intel"| node_database
node_detect -->|"reads events"| node_database
node_detect -->|"writes alerts"| node_database
node_operator -->|"opens dashboard"| node_flask
node_flask -->|"renders page"| node_template
node_client -->|"requests API"| node_flask
node_flask -->|"queries and updates"| node_database
node_operator -->|"filters and closes alerts"| node_client

click node_simulator "https://github.com/adaaraujo/mini-siem-dashboard/blob/main/src/ingestion/log_simulator.py"
click node_ingest "https://github.com/adaaraujo/mini-siem-dashboard/blob/main/src/ingestion/ingest.py"
click node_detect "https://github.com/adaaraujo/mini-siem-dashboard/blob/main/src/detection/detect.py"
click node_flask "https://github.com/adaaraujo/mini-siem-dashboard/blob/main/src/dashboard/app.py"
click node_template "https://github.com/adaaraujo/mini-siem-dashboard/blob/main/src/dashboard/templates/index.html"
click node_client "https://github.com/adaaraujo/mini-siem-dashboard/blob/main/src/dashboard/static/js/dashboard.js"
click node_styles "https://github.com/adaaraujo/mini-siem-dashboard/blob/main/src/dashboard/static/css/style.css"

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_simulator,node_logfiles toneBlue
class node_ingest,node_intelfile,node_detect toneAmber
class node_database toneMint
class node_flask,node_template,node_client,node_styles toneRose
class node_operator toneIndigo
```

## Components

### Log Inputs

- [Log Simulator](https://github.com/adaaraujo/mini-siem-dashboard/blob/main/src/ingestion/log_simulator.py): `src/ingestion/log_simulator.py`
- **Log Files**

### Ingestion & Detection

- [Log Ingestion](https://github.com/adaaraujo/mini-siem-dashboard/blob/main/src/ingestion/ingest.py): `src/ingestion/ingest.py`
- **Malicious IP List**
- [Detection Rules](https://github.com/adaaraujo/mini-siem-dashboard/blob/main/src/detection/detect.py): `src/detection/detect.py`

### SIEM Data

- **SQLite Database**

### Dashboard

- [Flask API](https://github.com/adaaraujo/mini-siem-dashboard/blob/main/src/dashboard/app.py): `src/dashboard/app.py`
- [Dashboard Page](https://github.com/adaaraujo/mini-siem-dashboard/blob/main/src/dashboard/templates/index.html): `src/dashboard/templates/index.html`
- [Dashboard Client](https://github.com/adaaraujo/mini-siem-dashboard/blob/main/src/dashboard/static/js/dashboard.js): `src/dashboard/static/js/dashboard.js`
- [Dashboard Styling](https://github.com/adaaraujo/mini-siem-dashboard/blob/main/src/dashboard/static/css/style.css): `src/dashboard/static/css/style.css`

### Other components

- **Operator**

## Connections

- Log Simulator → Log Files: writes logs (evidence: `src/ingestion/log_simulator.py`)
- Log Files → Log Ingestion: reads logs (evidence: `README.md`)
- Log Ingestion → SQLite Database: writes events (evidence: `src/ingestion/ingest.py`)
- Malicious IP List → Log Ingestion: loads IPs (evidence: `src/ingestion/ingest.py`)
- Log Ingestion → SQLite Database: loads intel (evidence: `src/ingestion/ingest.py`)
- Detection Rules → SQLite Database: reads events (evidence: `src/detection/detect.py`)
- Detection Rules → SQLite Database: writes alerts (evidence: `src/detection/detect.py`)
- Operator → Flask API: opens dashboard (evidence: `README.md`)
- Flask API → Dashboard Page: renders page (evidence: `src/dashboard/app.py`)
- Dashboard Client → Flask API: requests API (evidence: `src/dashboard/static/js/dashboard.js`)
- Flask API → SQLite Database: queries and updates (evidence: `src/dashboard/app.py`)
- Operator → Dashboard Client: filters and closes alerts (evidence: `src/dashboard/static/js/dashboard.js`)
