# arshathhaq/industrial-security-analysis-coursework architecture

> Architecture diagram of the GitHub repository arshathhaq/industrial-security-analysis-coursework, 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/arshathhaq/industrial-security-analysis-coursework
- Repository: https://github.com/arshathhaq/industrial-security-analysis-coursework

## Overview

AQUASHIELD documents a water-tank OT/SCADA system. Its sampled runtime shows the PLC simulator serving Modbus process values and a SCADA monitoring agent polling the PLC, detecting alarms/anomalies, and logging events. FUXA controls, firewall, reverse proxy, IDS/Wazuh, historian, and assessment capabilities are README-documented but their implementation is not in the supplied tree; edges for those documented paths cite the README. The report’s illustrative project layout is not treated as repository source.

Main entry points: [`modbus-sim/LevelSim.py`](https://github.com/arshathhaq/industrial-security-analysis-coursework/blob/main/modbus-sim/LevelSim.py) (PLC Simulator), [`scada-monitor/monitor.py`](https://github.com/arshathhaq/industrial-security-analysis-coursework/blob/main/scada-monitor/monitor.py) (Monitor Agent)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_process["Tank Process"]
  node_plc["PLC Simulator<br/>[LevelSim.py]"]
  node_tank["Virtual Tank<br/>[LevelSim.py]"]
end

subgraph group_scada["SCADA Monitoring"]
  node_fuxa["FUXA HMI/SCADA"]
  node_monitor["Monitor Agent<br/>[monitor.py]"]
  node_eventlog[("Event Log<br/>[monitor.py]")]
  node_historian[("SQLite Historian")]
  node_alarms["Alarms and Trends"]
end

subgraph group_security["Security Operations"]
  node_suricata["Suricata IDS"]
  node_wazuhagent["Wazuh Agent"]
  node_wazuhmanager["Wazuh Manager"]
  node_alertreview["Alert Review"]
  node_mqtt["MQTT Broker"]
  node_assessment["Security Assessment"]
end

subgraph group_network["Network Boundary"]
  node_proxy["Nginx Proxy"]
  node_firewall["OT Firewall"]
end

node_operator(("Operator"))

node_operator -->|"operates and monitors"| node_fuxa
node_fuxa -->|"accesses through"| node_proxy
node_proxy -->|"proxies access"| node_fuxa
node_fuxa -->|"Modbus control and reads"| node_plc
node_plc -->|"updates process state"| node_tank
node_monitor -->|"polls Modbus state"| node_plc
node_monitor -->|"writes events"| node_eventlog
node_monitor -->|"detects alarm conditions"| node_alarms
node_fuxa -->|"records process values"| node_historian
node_historian -->|"supports trend review"| node_alarms
node_fuxa -->|"crosses permitted conduits"| node_firewall
node_firewall -->|"permits HTTP access"| node_proxy
node_firewall -->|"permits Modbus traffic"| node_plc
node_firewall -->|"hosts traffic inspection"| node_suricata
node_suricata -->|"forwards EVE events"| node_wazuhagent
node_wazuhagent -->|"forwards security events"| node_wazuhmanager
node_wazuhmanager -->|"presents alerts for review"| node_alertreview
node_mqtt -.->|"traffic monitored"| node_suricata
node_assessment -.->|"assesses controls"| node_firewall
node_assessment -.->|"assesses access controls"| node_fuxa
node_assessment -.->|"assesses monitoring"| node_suricata

click node_plc "https://github.com/arshathhaq/industrial-security-analysis-coursework/blob/main/modbus-sim/LevelSim.py"
click node_tank "https://github.com/arshathhaq/industrial-security-analysis-coursework/blob/main/modbus-sim/LevelSim.py"
click node_monitor "https://github.com/arshathhaq/industrial-security-analysis-coursework/blob/main/scada-monitor/monitor.py"
click node_eventlog "https://github.com/arshathhaq/industrial-security-analysis-coursework/blob/main/scada-monitor/monitor.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_plc,node_tank toneBlue
class node_fuxa,node_monitor,node_eventlog,node_historian,node_alarms toneAmber
class node_suricata,node_wazuhagent,node_wazuhmanager,node_alertreview,node_mqtt,node_assessment toneMint
class node_proxy,node_firewall toneRose
class node_operator toneIndigo
```

## Components

### Tank Process

- [PLC Simulator](https://github.com/arshathhaq/industrial-security-analysis-coursework/blob/main/modbus-sim/LevelSim.py): `modbus-sim/LevelSim.py`
- [Virtual Tank](https://github.com/arshathhaq/industrial-security-analysis-coursework/blob/main/modbus-sim/LevelSim.py): `modbus-sim/LevelSim.py`

### SCADA Monitoring

- **FUXA HMI/SCADA**
- [Monitor Agent](https://github.com/arshathhaq/industrial-security-analysis-coursework/blob/main/scada-monitor/monitor.py): `scada-monitor/monitor.py`
- [Event Log](https://github.com/arshathhaq/industrial-security-analysis-coursework/blob/main/scada-monitor/monitor.py): `scada-monitor/monitor.py`
- **SQLite Historian**
- **Alarms and Trends**

### Security Operations

- **Suricata IDS**
- **Wazuh Agent**
- **Wazuh Manager**
- **Alert Review**
- **MQTT Broker**
- **Security Assessment**

### Network Boundary

- **Nginx Proxy**
- **OT Firewall**

### Other components

- **Operator**

## Connections

- Operator → FUXA HMI/SCADA: operates and monitors (evidence: `README.md`)
- FUXA HMI/SCADA → Nginx Proxy: accesses through (evidence: `README.md`)
- Nginx Proxy → FUXA HMI/SCADA: proxies access (evidence: `README.md`)
- FUXA HMI/SCADA → PLC Simulator: Modbus control and reads (evidence: `README.md`)
- PLC Simulator → Virtual Tank: updates process state (evidence: `modbus-sim/LevelSim.py`)
- Monitor Agent → PLC Simulator: polls Modbus state (evidence: `scada-monitor/monitor.py`)
- Monitor Agent → Event Log: writes events (evidence: `scada-monitor/monitor.py`)
- Monitor Agent → Alarms and Trends: detects alarm conditions (evidence: `scada-monitor/monitor.py`)
- FUXA HMI/SCADA → SQLite Historian: records process values (evidence: `README.md`)
- SQLite Historian → Alarms and Trends: supports trend review (evidence: `README.md`)
- FUXA HMI/SCADA → OT Firewall: crosses permitted conduits (evidence: `README.md`)
- OT Firewall → Nginx Proxy: permits HTTP access (evidence: `README.md`)
- OT Firewall → PLC Simulator: permits Modbus traffic (evidence: `README.md`)
- OT Firewall → Suricata IDS: hosts traffic inspection (evidence: `README.md`)
- Suricata IDS → Wazuh Agent: forwards EVE events (evidence: `README.md`)
- Wazuh Agent → Wazuh Manager: forwards security events (evidence: `README.md`)
- Wazuh Manager → Alert Review: presents alerts for review (evidence: `README.md`)
- MQTT Broker → Suricata IDS: traffic monitored (evidence: `README.md`)
- Security Assessment → OT Firewall: assesses controls (evidence: `README.md`)
- Security Assessment → FUXA HMI/SCADA: assesses access controls (evidence: `README.md`)
- Security Assessment → Suricata IDS: assesses monitoring (evidence: `README.md`)
