# ics-range-team/ics_range_v2 architecture

> Architecture diagram of the GitHub repository ics-range-team/ics_range_v2, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ics-range-team/ics_range_v2
- Repository: https://github.com/ics-range-team/ics_range_v2

## Overview

OT_RANGE_V2 is a lightweight, multi-zone operational-technology cyber range: it deploys two PLC stations, three FUXA SCADA instances, attacker and operator workstations, network routers, a mirrored-traffic sensor, a user portal, and a minimal 3D station viewer. The intended workflow spans operating the simulated stations and observing mirrored network traffic; the README documents the mirroring path but not the detailed control or data links between station services. SCADA capabilities are represented from the source tree and sampled modules; unsampled connections are omitted.

Main entry points: [`scada_central/server/main.js`](https://github.com/ics-range-team/ics_range_v2/blob/main/scada_central/server/main.js) (SCADA Central), [`kali-attacker/carto_client.py`](https://github.com/ics-range-team/ics_range_v2/blob/main/kali-attacker/carto_client.py) (Kali Attacker), [`router1/app.py`](https://github.com/ics-range-team/ics_range_v2/blob/main/router1/app.py) (R1 Router), [`router2/app.py`](https://github.com/ics-range-team/ics_range_v2/blob/main/router2/app.py) (R2 Router)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_stations["OT Stations"]
  node_plca["PLC-A Webserver<br/>[webserver.py]"]
  node_plcb["PLC-B Webserver<br/>[webserver.py]"]
end

subgraph group_scada["SCADA Systems"]
  node_scadaa["SCADA-A<br/>[main.js]"]
  node_scadab["SCADA-B<br/>[main.js]"]
  node_central["SCADA Central<br/>[main.js]"]
  node_scada_ui["SCADA Client"]
  node_daq[("DAQ Storage<br/>[daqstorage.js]")]
  node_alarms[("Alarm Storage<br/>[alarmstorage.js]")]
end

subgraph group_network["Network Monitoring"]
  node_station_a_router["R1 Router<br/>[app.py]"]
  node_station_b_router["R2 Router<br/>[app.py]"]
  node_sensor["OT Sensor"]
end

subgraph group_interfaces["User Interfaces"]
  node_attacker["Kali Attacker<br/>[carto_client.py]"]
  node_ews["Engineering Workstation"]
  node_viewer["Station B 3D Viewer<br/>[modbus_mapping.py]"]
end

subgraph group_management["Range Management"]
  node_portal["User Portal<br/>[server.js]"]
  node_users[("Portal User Records")]
end

node_operator(("Operator"))

node_station_a_router -->|"mirrors traffic"| node_sensor
node_station_b_router -->|"mirrors traffic"| node_sensor
node_operator -->|"manages users"| node_portal
node_portal -->|"persists users"| node_users
node_operator -.->|"uses"| node_scada_ui
node_attacker -.->|"sends traffic"| node_station_a_router
node_attacker -.->|"sends traffic"| node_station_b_router
node_central -.->|"stores DAQ data"| node_daq
node_central -.->|"stores alarms"| node_alarms

click node_attacker "https://github.com/ics-range-team/ics_range_v2/blob/main/kali-attacker/carto_client.py"
click node_plca "https://github.com/ics-range-team/ics_range_v2/blob/main/station_a/plc_a/webserver/webserver.py"
click node_plcb "https://github.com/ics-range-team/ics_range_v2/blob/main/station_b/plc_b/webserver/webserver.py"
click node_scadaa "https://github.com/ics-range-team/ics_range_v2/blob/main/station_a/scada_a/server/main.js"
click node_scadab "https://github.com/ics-range-team/ics_range_v2/blob/main/station_b/scada_b/server/main.js"
click node_central "https://github.com/ics-range-team/ics_range_v2/blob/main/scada_central/server/main.js"
click node_scada_ui "https://github.com/ics-range-team/ics_range_v2/blob/main/scada_central/client/src/app/editor/editor.component.ts"
click node_daq "https://github.com/ics-range-team/ics_range_v2/blob/main/scada_central/server/runtime/storage/daqstorage.js"
click node_alarms "https://github.com/ics-range-team/ics_range_v2/blob/main/scada_central/server/runtime/alarms/alarmstorage.js"
click node_station_a_router "https://github.com/ics-range-team/ics_range_v2/blob/main/router1/app.py"
click node_station_b_router "https://github.com/ics-range-team/ics_range_v2/blob/main/router2/app.py"
click node_portal "https://github.com/ics-range-team/ics_range_v2/blob/main/portal/backend/server.js"
click node_viewer "https://github.com/ics-range-team/ics_range_v2/blob/main/viewer3d-station-b/backend/modbus_mapping.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_plca,node_plcb toneBlue
class node_scadaa,node_scadab,node_central,node_scada_ui,node_daq,node_alarms toneAmber
class node_station_a_router,node_station_b_router,node_sensor toneMint
class node_attacker,node_ews,node_viewer toneRose
class node_portal,node_users,node_operator toneIndigo
```

## Components

### OT Stations

- [PLC-A Webserver](https://github.com/ics-range-team/ics_range_v2/blob/main/station_a/plc_a/webserver/webserver.py): `station_a/plc_a/webserver/webserver.py`
- [PLC-B Webserver](https://github.com/ics-range-team/ics_range_v2/blob/main/station_b/plc_b/webserver/webserver.py): `station_b/plc_b/webserver/webserver.py`

### SCADA Systems

- [SCADA-A](https://github.com/ics-range-team/ics_range_v2/blob/main/station_a/scada_a/server/main.js): `station_a/scada_a/server/main.js`
- [SCADA-B](https://github.com/ics-range-team/ics_range_v2/blob/main/station_b/scada_b/server/main.js): `station_b/scada_b/server/main.js`
- [SCADA Central](https://github.com/ics-range-team/ics_range_v2/blob/main/scada_central/server/main.js): `scada_central/server/main.js`
- [SCADA Client](https://github.com/ics-range-team/ics_range_v2/blob/main/scada_central/client/src/app/editor/editor.component.ts): `scada_central/client/src/app/editor/editor.component.ts`
- [DAQ Storage](https://github.com/ics-range-team/ics_range_v2/blob/main/scada_central/server/runtime/storage/daqstorage.js): `scada_central/server/runtime/storage/daqstorage.js`
- [Alarm Storage](https://github.com/ics-range-team/ics_range_v2/blob/main/scada_central/server/runtime/alarms/alarmstorage.js): `scada_central/server/runtime/alarms/alarmstorage.js`

### Network Monitoring

- [R1 Router](https://github.com/ics-range-team/ics_range_v2/blob/main/router1/app.py): `router1/app.py`
- [R2 Router](https://github.com/ics-range-team/ics_range_v2/blob/main/router2/app.py): `router2/app.py`
- **OT Sensor**

### User Interfaces

- [Kali Attacker](https://github.com/ics-range-team/ics_range_v2/blob/main/kali-attacker/carto_client.py): `kali-attacker/carto_client.py`
- **Engineering Workstation**
- [Station B 3D Viewer](https://github.com/ics-range-team/ics_range_v2/blob/main/viewer3d-station-b/backend/modbus_mapping.py): `viewer3d-station-b/backend/modbus_mapping.py`

### Range Management

- [User Portal](https://github.com/ics-range-team/ics_range_v2/blob/main/portal/backend/server.js): `portal/backend/server.js`
- **Portal User Records**

### Other components

- **Operator**

## Connections

- R1 Router → OT Sensor: mirrors traffic
- R2 Router → OT Sensor: mirrors traffic
- Operator → User Portal: manages users
- User Portal → Portal User Records: persists users
- Operator → SCADA Client: uses
- Kali Attacker → R1 Router: sends traffic
- Kali Attacker → R2 Router: sends traffic
- SCADA Central → DAQ Storage: stores DAQ data
- SCADA Central → Alarm Storage: stores alarms
