# emilpasca/vast architecture

> Architecture diagram of the GitHub repository emilpasca/vast, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/emilpasca/vast
- Repository: https://github.com/emilpasca/vast

## Overview

VAST is a vulnerable-by-design agricultural IoT research testbed. Its main workflow simulates sensor readings, exposes them through a gateway, and supports monitoring and security experiments; dataset tools collect and analyze measurements from those experiments. The sampled server code supports links among its API, generator, registry, and in-memory reading store. Other runtime relationships are shown only where the README documents them; source excerpts for those components were not provided.

Main entry points: [`data-server/main.py`](https://github.com/emilpasca/vast/blob/main/data-server/main.py) (Data Server API), [`dataset-tools/shared_metrics_utils.py`](https://github.com/emilpasca/vast/blob/main/dataset-tools/shared_metrics_utils.py) (Shared Metrics Analysis), [`dataset-tools/data_collector.py`](https://github.com/emilpasca/vast/blob/main/dataset-tools/data_collector.py) (Metrics Collector), [`sensors/temp/app.py`](https://github.com/emilpasca/vast/blob/main/sensors/temp/app.py) (Temperature Sensor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_device_stack["IoT Runtime"]
  node_sensor["Temperature Sensor<br/>[app.py]"]
  node_gateway["IoT Gateway<br/>[gateway.py]"]
  node_broker{{"MQTT Broker"}}
end

subgraph group_simulation["Data Simulation"]
  node_api["Data Server API<br/>[main.py]"]
  node_registry[("Sensor Registry<br/>[sensor_registry.py]")]
  node_generator["Reading Generator<br/>[data_generator.py]"]
  node_weather["Weather Events"]
  node_vuln_manager["Vulnerability Controls"]
  node_reading_models["Reading Models<br/>[models.py]"]
  node_reading_store[("Reading Store<br/>[data_storage.py]")]
  node_formatter["Reading Formatter<br/>[data_formatter.py]"]
end

subgraph group_security["Security Research"]
  node_bola["BOLA Exploits"]
  node_malicious_firmware["Firmware Attacks"]
end

subgraph group_observability["Monitoring"]
  node_exporter["Metrics Exporter<br/>[sensor_metrics.py]"]
  node_prometheus[("Prometheus")]
  node_grafana["Grafana"]
end

subgraph group_datasets["Dataset Tools"]
  node_collector["Metrics Collector<br/>[data_collector.py]"]
  node_general_collector["General Collector"]
  node_resource_generator["Resource Dataset Generator"]
  node_metrics_utils["Shared Metrics Analysis"]
  node_bola_processor["BOLA Analysis"]
  node_command_processor["Command Injection Analysis"]
  node_ddos_processor["DDoS Analysis<br/>[ddos_processor.py]"]
  node_fault_processor["Fault Analysis"]
  node_lstm_processor["LSTM Analysis"]
  node_lstm_custom["Custom LSTM Analysis"]
  node_resource_processor["Resource Analysis"]
  node_llm_prep["LLM Data Preparation"]
  node_heatwave_case["Heatwave Use Case"]
end

node_user(("Researcher"))

node_user -->|"requests data"| node_gateway
node_sensor -.->|"publishes readings"| node_broker
node_gateway -.->|"uses broker"| node_broker
node_sensor -.->|"provides sensor data"| node_api
node_api -->|"looks up sensors"| node_registry
node_api -->|"generates readings"| node_generator
node_api -->|"stores and reads"| node_reading_store
node_api -->|"uses events"| node_weather
node_api -->|"uses controls"| node_vuln_manager
node_api -->|"formats readings"| node_formatter
node_generator -->|"creates readings"| node_reading_models
node_reading_store -->|"stores readings"| node_reading_models
node_user -->|"tests access flaws"| node_bola
node_user -.->|"tests firmware attack"| node_malicious_firmware
node_exporter -.->|"exports metrics"| node_prometheus
node_grafana -->|"visualizes metrics"| node_prometheus
node_collector -->|"queries metrics"| node_prometheus
node_general_collector -->|"reuses collector"| node_collector
node_resource_generator -->|"collects metrics"| node_collector
node_bola_processor -->|"uses metrics utilities"| node_metrics_utils
node_command_processor -->|"uses metrics utilities"| node_metrics_utils
node_ddos_processor -->|"uses metrics utilities"| node_metrics_utils
node_fault_processor -->|"uses metrics utilities"| node_metrics_utils
node_lstm_processor -->|"uses metrics utilities"| node_metrics_utils
node_lstm_custom -->|"uses metrics utilities"| node_metrics_utils
node_resource_processor -->|"uses metrics utilities"| node_metrics_utils

click node_sensor "https://github.com/emilpasca/vast/blob/main/sensors/temp/app.py"
click node_gateway "https://github.com/emilpasca/vast/blob/main/iot-gateway/gateway.py"
click node_api "https://github.com/emilpasca/vast/blob/main/data-server/main.py"
click node_registry "https://github.com/emilpasca/vast/blob/main/data-server/sensor_registry.py"
click node_generator "https://github.com/emilpasca/vast/blob/main/data-server/data_generator.py"
click node_weather "https://github.com/emilpasca/vast/blob/main/data-server/weather_event_manager.py"
click node_vuln_manager "https://github.com/emilpasca/vast/blob/main/data-server/vulnerability_manager.py"
click node_reading_models "https://github.com/emilpasca/vast/blob/main/data-server/models/models.py"
click node_reading_store "https://github.com/emilpasca/vast/blob/main/data-server/data_storage.py"
click node_formatter "https://github.com/emilpasca/vast/blob/main/data-server/data_formatter.py"
click node_bola "https://github.com/emilpasca/vast/tree/main/vulnerabilities/BOLA"
click node_malicious_firmware "https://github.com/emilpasca/vast/tree/main/vulnerabilities/MaliciousFile"
click node_exporter "https://github.com/emilpasca/vast/blob/main/observability/sensor-metrics-exporter/sensor_metrics.py"
click node_collector "https://github.com/emilpasca/vast/blob/main/dataset-tools/data_collector.py"
click node_general_collector "https://github.com/emilpasca/vast/blob/main/dataset-tools/general_dataset_collector.py"
click node_resource_generator "https://github.com/emilpasca/vast/blob/main/dataset-tools/generate_resource_exhaustion_dataset.py"
click node_metrics_utils "https://github.com/emilpasca/vast/blob/main/dataset-tools/shared_metrics_utils.py"
click node_bola_processor "https://github.com/emilpasca/vast/blob/main/dataset-tools/bola_dataset_processor.py"
click node_command_processor "https://github.com/emilpasca/vast/blob/main/dataset-tools/command_injection_processor.py"
click node_ddos_processor "https://github.com/emilpasca/vast/blob/main/dataset-tools/ddos_processor.py"
click node_fault_processor "https://github.com/emilpasca/vast/blob/main/dataset-tools/fault_dataset_processor.py"
click node_lstm_processor "https://github.com/emilpasca/vast/blob/main/dataset-tools/lstm_dataset_processor.py"
click node_lstm_custom "https://github.com/emilpasca/vast/blob/main/dataset-tools/lstm_dataset_processor_custom.py"
click node_resource_processor "https://github.com/emilpasca/vast/blob/main/dataset-tools/resource_exhaustion_processor.py"
click node_llm_prep "https://github.com/emilpasca/vast/blob/main/dataset-tools/prepare_llm_data.py"
click node_heatwave_case "https://github.com/emilpasca/vast/blob/main/dataset-tools/use-cases/heatwave/tomato_greenhouse_heatwave.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_sensor,node_gateway,node_broker toneBlue
class node_api,node_registry,node_generator,node_weather,node_vuln_manager,node_reading_models,node_reading_store,node_formatter toneAmber
class node_bola,node_malicious_firmware toneMint
class node_exporter,node_prometheus,node_grafana toneRose
class node_collector,node_general_collector,node_resource_generator,node_metrics_utils,node_bola_processor,node_command_processor,node_ddos_processor,node_fault_processor,node_lstm_processor,node_lstm_custom,node_resource_processor,node_llm_prep,node_heatwave_case,node_user toneIndigo
```

## Components

### IoT Runtime

- [Temperature Sensor](https://github.com/emilpasca/vast/blob/main/sensors/temp/app.py): `sensors/temp/app.py`
- [IoT Gateway](https://github.com/emilpasca/vast/blob/main/iot-gateway/gateway.py): `iot-gateway/gateway.py`
- **MQTT Broker**

### Data Simulation

- [Data Server API](https://github.com/emilpasca/vast/blob/main/data-server/main.py): `data-server/main.py`
- [Sensor Registry](https://github.com/emilpasca/vast/blob/main/data-server/sensor_registry.py): `data-server/sensor_registry.py`
- [Reading Generator](https://github.com/emilpasca/vast/blob/main/data-server/data_generator.py): `data-server/data_generator.py`
- [Weather Events](https://github.com/emilpasca/vast/blob/main/data-server/weather_event_manager.py): `data-server/weather_event_manager.py`
- [Vulnerability Controls](https://github.com/emilpasca/vast/blob/main/data-server/vulnerability_manager.py): `data-server/vulnerability_manager.py`
- [Reading Models](https://github.com/emilpasca/vast/blob/main/data-server/models/models.py): `data-server/models/models.py`
- [Reading Store](https://github.com/emilpasca/vast/blob/main/data-server/data_storage.py): `data-server/data_storage.py`
- [Reading Formatter](https://github.com/emilpasca/vast/blob/main/data-server/data_formatter.py): `data-server/data_formatter.py`

### Security Research

- [BOLA Exploits](https://github.com/emilpasca/vast/tree/main/vulnerabilities/BOLA): `vulnerabilities/BOLA`
- [Firmware Attacks](https://github.com/emilpasca/vast/tree/main/vulnerabilities/MaliciousFile): `vulnerabilities/MaliciousFile`

### Monitoring

- [Metrics Exporter](https://github.com/emilpasca/vast/blob/main/observability/sensor-metrics-exporter/sensor_metrics.py): `observability/sensor-metrics-exporter/sensor_metrics.py`
- **Prometheus**
- **Grafana**

### Dataset Tools

- [Metrics Collector](https://github.com/emilpasca/vast/blob/main/dataset-tools/data_collector.py): `dataset-tools/data_collector.py`
- [General Collector](https://github.com/emilpasca/vast/blob/main/dataset-tools/general_dataset_collector.py): `dataset-tools/general_dataset_collector.py`
- [Resource Dataset Generator](https://github.com/emilpasca/vast/blob/main/dataset-tools/generate_resource_exhaustion_dataset.py): `dataset-tools/generate_resource_exhaustion_dataset.py`
- [Shared Metrics Analysis](https://github.com/emilpasca/vast/blob/main/dataset-tools/shared_metrics_utils.py): `dataset-tools/shared_metrics_utils.py`
- [BOLA Analysis](https://github.com/emilpasca/vast/blob/main/dataset-tools/bola_dataset_processor.py): `dataset-tools/bola_dataset_processor.py`
- [Command Injection Analysis](https://github.com/emilpasca/vast/blob/main/dataset-tools/command_injection_processor.py): `dataset-tools/command_injection_processor.py`
- [DDoS Analysis](https://github.com/emilpasca/vast/blob/main/dataset-tools/ddos_processor.py): `dataset-tools/ddos_processor.py`
- [Fault Analysis](https://github.com/emilpasca/vast/blob/main/dataset-tools/fault_dataset_processor.py): `dataset-tools/fault_dataset_processor.py`
- [LSTM Analysis](https://github.com/emilpasca/vast/blob/main/dataset-tools/lstm_dataset_processor.py): `dataset-tools/lstm_dataset_processor.py`
- [Custom LSTM Analysis](https://github.com/emilpasca/vast/blob/main/dataset-tools/lstm_dataset_processor_custom.py): `dataset-tools/lstm_dataset_processor_custom.py`
- [Resource Analysis](https://github.com/emilpasca/vast/blob/main/dataset-tools/resource_exhaustion_processor.py): `dataset-tools/resource_exhaustion_processor.py`
- [LLM Data Preparation](https://github.com/emilpasca/vast/blob/main/dataset-tools/prepare_llm_data.py): `dataset-tools/prepare_llm_data.py`
- [Heatwave Use Case](https://github.com/emilpasca/vast/blob/main/dataset-tools/use-cases/heatwave/tomato_greenhouse_heatwave.py): `dataset-tools/use-cases/heatwave/tomato_greenhouse_heatwave.py`

### Other components

- **Researcher**

## Connections

- Researcher → IoT Gateway: requests data (evidence: `README.md`)
- Temperature Sensor → MQTT Broker: publishes readings (evidence: `README.md`)
- IoT Gateway → MQTT Broker: uses broker (evidence: `README.md`)
- Temperature Sensor → Data Server API: provides sensor data (evidence: `README.md`)
- Data Server API → Sensor Registry: looks up sensors (evidence: `data-server/main.py`)
- Data Server API → Reading Generator: generates readings (evidence: `data-server/main.py`)
- Data Server API → Reading Store: stores and reads (evidence: `data-server/main.py`)
- Data Server API → Weather Events: uses events (evidence: `data-server/main.py`)
- Data Server API → Vulnerability Controls: uses controls (evidence: `data-server/main.py`)
- Data Server API → Reading Formatter: formats readings (evidence: `data-server/main.py`)
- Reading Generator → Reading Models: creates readings (evidence: `data-server/data_generator.py`)
- Reading Store → Reading Models: stores readings (evidence: `data-server/data_storage.py`)
- Researcher → BOLA Exploits: tests access flaws (evidence: `README.md`)
- Researcher → Firmware Attacks: tests firmware attack
- Metrics Exporter → Prometheus: exports metrics (evidence: `README.md`)
- Grafana → Prometheus: visualizes metrics (evidence: `README.md`)
- Metrics Collector → Prometheus: queries metrics (evidence: `dataset-tools/data_collector.py`)
- General Collector → Metrics Collector: reuses collector (evidence: `dataset-tools/general_dataset_collector.py`)
- Resource Dataset Generator → Metrics Collector: collects metrics (evidence: `dataset-tools/generate_resource_exhaustion_dataset.py`)
- BOLA Analysis → Shared Metrics Analysis: uses metrics utilities (evidence: `dataset-tools/bola_dataset_processor.py`)
- Command Injection Analysis → Shared Metrics Analysis: uses metrics utilities (evidence: `dataset-tools/command_injection_processor.py`)
- DDoS Analysis → Shared Metrics Analysis: uses metrics utilities (evidence: `dataset-tools/ddos_processor.py`)
- Fault Analysis → Shared Metrics Analysis: uses metrics utilities (evidence: `dataset-tools/fault_dataset_processor.py`)
- LSTM Analysis → Shared Metrics Analysis: uses metrics utilities (evidence: `dataset-tools/lstm_dataset_processor.py`)
- Custom LSTM Analysis → Shared Metrics Analysis: uses metrics utilities (evidence: `dataset-tools/lstm_dataset_processor_custom.py`)
- Resource Analysis → Shared Metrics Analysis: uses metrics utilities (evidence: `dataset-tools/resource_exhaustion_processor.py`)
