# vincent-p-essy/cyber-dashboard architecture

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

- Interactive diagram: https://gitdiagram.com/vincent-p-essy/cyber-dashboard
- Repository: https://github.com/vincent-p-essy/cyber-dashboard

## Overview

cyber-dashboard is a Flask-backed SOC console that combines incident data, audit events, and vulnerability reports into a polled dashboard. Its main workflow is: the browser requests metrics, the Flask routes fetch source data, and the metrics calculator derives incident KPIs and trends for the response. The README documents additional dashboard views and a 30-second refresh; the frontend source was not sampled, so those details are documented rather than independently verified. Unavailable APIs and reports use demonstration fallback data.

Main entry points: [`backend/app.py`](https://github.com/vincent-p-essy/cyber-dashboard/blob/main/backend/app.py) (Flask routes), [`frontend/index.html`](https://github.com/vincent-p-essy/cyber-dashboard/blob/main/frontend/index.html) (SOC dashboard), [`backend/sources/incident_tracker.py`](https://github.com/vincent-p-essy/cyber-dashboard/blob/main/backend/sources/incident_tracker.py) (Incident connector), [`backend/sources/audit_logger.py`](https://github.com/vincent-p-essy/cyber-dashboard/blob/main/backend/sources/audit_logger.py) (Audit connector)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Dashboard"]
  node_dashboard["SOC dashboard<br/>[index.html]"]
end

subgraph group_api["HTTP API"]
  node_flask["Flask routes<br/>[app.py]"]
  node_dashboard_payload["Metrics response<br/>[app.py]"]
  node_incident_response["Incident response<br/>[app.py]"]
  node_critical_vuln_response["Critical CVE response<br/>[app.py]"]
end

subgraph group_sources["Data sources"]
  node_incident_source["Incident connector"]
  node_audit_source["Audit connector<br/>[audit_logger.py]"]
  node_vuln_source["Vulnerability reports<br/>[vuln_digest.py]"]
end

subgraph group_analysis["Metrics"]
  node_calculator["KPI calculator<br/>[metrics.py]"]
end

node_analyst(("SOC analyst"))
node_incident_api["Incident tracker API"]
node_audit_api["Audit logger API"]
node_digest_reports["Digest JSON reports"]

node_analyst -->|"views"| node_dashboard
node_dashboard -->|"polls metrics"| node_flask
node_flask -->|"serves page"| node_dashboard
node_flask -->|"fetches incidents"| node_incident_source
node_flask -->|"fetches IPs"| node_audit_source
node_flask -->|"fetches CVEs"| node_vuln_source
node_incident_source -->|"requests incidents"| node_incident_api
node_audit_source -->|"requests events"| node_audit_api
node_vuln_source -->|"reads reports"| node_digest_reports
node_flask -->|"computes KPIs"| node_calculator
node_flask -->|"returns metrics"| node_dashboard_payload
node_flask -->|"returns incidents"| node_incident_response
node_flask -->|"returns CVEs"| node_critical_vuln_response
node_dashboard_payload -->|"renders dashboard"| node_dashboard
node_incident_response -.->|"supports incident view"| node_dashboard
node_critical_vuln_response -.->|"supports CVE view"| node_dashboard

click node_dashboard "https://github.com/vincent-p-essy/cyber-dashboard/blob/main/frontend/index.html"
click node_flask "https://github.com/vincent-p-essy/cyber-dashboard/blob/main/backend/app.py"
click node_incident_source "https://github.com/vincent-p-essy/cyber-dashboard/blob/main/backend/sources/incident_tracker.py"
click node_audit_source "https://github.com/vincent-p-essy/cyber-dashboard/blob/main/backend/sources/audit_logger.py"
click node_vuln_source "https://github.com/vincent-p-essy/cyber-dashboard/blob/main/backend/sources/vuln_digest.py"
click node_calculator "https://github.com/vincent-p-essy/cyber-dashboard/blob/main/backend/metrics.py"
click node_dashboard_payload "https://github.com/vincent-p-essy/cyber-dashboard/blob/main/backend/app.py"
click node_incident_response "https://github.com/vincent-p-essy/cyber-dashboard/blob/main/backend/app.py"
click node_critical_vuln_response "https://github.com/vincent-p-essy/cyber-dashboard/blob/main/backend/app.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_dashboard toneBlue
class node_flask,node_dashboard_payload,node_incident_response,node_critical_vuln_response toneAmber
class node_incident_source,node_audit_source,node_vuln_source,node_incident_api,node_audit_api toneMint
class node_calculator toneRose
class node_analyst,node_digest_reports toneIndigo
```

## Components

### Dashboard

- [SOC dashboard](https://github.com/vincent-p-essy/cyber-dashboard/blob/main/frontend/index.html): `frontend/index.html`

### HTTP API

- [Flask routes](https://github.com/vincent-p-essy/cyber-dashboard/blob/main/backend/app.py): `backend/app.py`
- [Metrics response](https://github.com/vincent-p-essy/cyber-dashboard/blob/main/backend/app.py): `backend/app.py`
- [Incident response](https://github.com/vincent-p-essy/cyber-dashboard/blob/main/backend/app.py): `backend/app.py`
- [Critical CVE response](https://github.com/vincent-p-essy/cyber-dashboard/blob/main/backend/app.py): `backend/app.py`

### Data sources

- [Incident connector](https://github.com/vincent-p-essy/cyber-dashboard/blob/main/backend/sources/incident_tracker.py): `backend/sources/incident_tracker.py`
- [Audit connector](https://github.com/vincent-p-essy/cyber-dashboard/blob/main/backend/sources/audit_logger.py): `backend/sources/audit_logger.py`
- [Vulnerability reports](https://github.com/vincent-p-essy/cyber-dashboard/blob/main/backend/sources/vuln_digest.py): `backend/sources/vuln_digest.py`

### Metrics

- [KPI calculator](https://github.com/vincent-p-essy/cyber-dashboard/blob/main/backend/metrics.py): `backend/metrics.py`

### Other components

- **SOC analyst**
- **Incident tracker API**
- **Audit logger API**
- **Digest JSON reports**

## Connections

- SOC analyst → SOC dashboard: views (evidence: `README.md`)
- SOC dashboard → Flask routes: polls metrics (evidence: `README.md`)
- Flask routes → SOC dashboard: serves page (evidence: `backend/app.py`)
- Flask routes → Incident connector: fetches incidents (evidence: `backend/app.py`)
- Flask routes → Audit connector: fetches IPs (evidence: `backend/app.py`)
- Flask routes → Vulnerability reports: fetches CVEs (evidence: `backend/app.py`)
- Incident connector → Incident tracker API: requests incidents (evidence: `backend/sources/incident_tracker.py`)
- Audit connector → Audit logger API: requests events (evidence: `backend/sources/audit_logger.py`)
- Vulnerability reports → Digest JSON reports: reads reports (evidence: `backend/sources/vuln_digest.py`)
- Flask routes → KPI calculator: computes KPIs (evidence: `backend/app.py`)
- Flask routes → Metrics response: returns metrics (evidence: `backend/app.py`)
- Flask routes → Incident response: returns incidents (evidence: `backend/app.py`)
- Flask routes → Critical CVE response: returns CVEs (evidence: `backend/app.py`)
- Metrics response → SOC dashboard: renders dashboard (evidence: `README.md`)
- Incident response → SOC dashboard: supports incident view
- Critical CVE response → SOC dashboard: supports CVE view
