# yoyuqre/iot_a-p_capstone architecture

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

- Interactive diagram: https://gitdiagram.com/yoyuqre/iot_a-p_capstone
- Repository: https://github.com/yoyuqre/iot_a-p_capstone

## Overview

This is a reproducible synthetic IoT-traffic research pipeline, not a real-device monitoring product. Its primary workflow generates normal device traffic, fingerprints each device, injects labeled anomaly scenarios, detects deviations, runs experiments, evaluates results, and visualizes findings. The README also describes interactive dashboard exploration; dashboard modules exist in the tree, though the dashboard entry point is not. Edges follow the documented workflow or shown module references; unsampled implementation details and dashboard wiring are not assumed.

Main entry points: [`main.py`](https://github.com/yoyuqre/iot_a-p_capstone/blob/main/main.py) (Pipeline Runner), [`src/experiments.py`](https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/experiments.py) (Experiment Runner), [`src/schemas.py`](https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/schemas.py) (Data Schemas), [`src/detector.py`](https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/detector.py) (Statistical Detector)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_simulation["Traffic Simulation"]
  node_traffic["Traffic Simulator<br/>[simulator.py]"]
  node_anomaly_injection["Anomaly Scenarios<br/>[anomalies.py]"]
  node_wokwi_bridge["Wokwi Log Bridge<br/>[io_bridge.py]"]
end

subgraph group_analysis["Detection Pipeline"]
  node_fingerprints["Device Fingerprints<br/>[fingerprint.py]"]
  node_detector["Statistical Detector<br/>[detector.py]"]
end

subgraph group_research["Experiments &amp; Results"]
  node_orchestrator["Pipeline Runner<br/>[main.py]"]
  node_experiments["Experiment Runner<br/>[experiments.py]"]
  node_evaluation["Metrics Evaluation<br/>[evaluation.py]"]
end

subgraph group_exploration["User Exploration"]
  node_visualization["Result Visualizations<br/>[visualization.py]"]
  node_dashboard_data["Dashboard Data<br/>[dashboard_data.py]"]
  node_dashboard_utils["Dashboard Utilities<br/>[dashboard_utils.py]"]
end

subgraph group_foundation["Shared Foundation"]
  node_config["Simulation Config<br/>[config.py]"]
  node_schema["Data Schemas<br/>[schemas.py]"]
  node_utilities["Shared Utilities<br/>[utils.py]"]
end

node_researcher(("Researcher"))

node_researcher -->|"runs pipeline"| node_orchestrator
node_orchestrator -->|"generates traffic"| node_traffic
node_orchestrator -->|"computes baselines"| node_fingerprints
node_orchestrator -->|"injects scenarios"| node_anomaly_injection
node_orchestrator -->|"runs detection"| node_detector
node_orchestrator -->|"runs experiments"| node_experiments
node_orchestrator -->|"evaluates results"| node_evaluation
node_orchestrator -->|"creates figures"| node_visualization
node_experiments -->|"generates baseline"| node_traffic
node_experiments -->|"computes baseline"| node_fingerprints
node_experiments -->|"injects scenarios"| node_anomaly_injection
node_experiments -->|"scores observations"| node_detector
node_dashboard_utils -->|"uses dashboard data"| node_dashboard_data
node_researcher -.->|"explores results"| node_dashboard_utils
node_traffic -->|"reads parameters"| node_config
node_fingerprints -->|"uses data types"| node_schema
node_anomaly_injection -->|"uses data types"| node_schema
node_detector -->|"uses baselines"| node_fingerprints
node_detector -->|"uses data types"| node_schema
node_experiments -->|"uses data types"| node_schema
node_evaluation -->|"uses data types"| node_schema
node_wokwi_bridge -->|"uses data types"| node_schema

click node_orchestrator "https://github.com/yoyuqre/iot_a-p_capstone/blob/main/main.py"
click node_config "https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/config.py"
click node_schema "https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/schemas.py"
click node_utilities "https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/utils.py"
click node_traffic "https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/simulator.py"
click node_fingerprints "https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/fingerprint.py"
click node_anomaly_injection "https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/anomalies.py"
click node_detector "https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/detector.py"
click node_experiments "https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/experiments.py"
click node_evaluation "https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/evaluation.py"
click node_visualization "https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/visualization.py"
click node_dashboard_data "https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/dashboard_data.py"
click node_dashboard_utils "https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/dashboard_utils.py"
click node_wokwi_bridge "https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/io_bridge.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_traffic,node_anomaly_injection,node_wokwi_bridge toneBlue
class node_fingerprints,node_detector toneAmber
class node_orchestrator,node_experiments,node_evaluation toneMint
class node_visualization,node_dashboard_data,node_dashboard_utils toneRose
class node_config,node_schema,node_utilities,node_researcher toneIndigo
```

## Components

### Traffic Simulation

- [Traffic Simulator](https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/simulator.py): `src/simulator.py`
- [Anomaly Scenarios](https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/anomalies.py): `src/anomalies.py`
- [Wokwi Log Bridge](https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/io_bridge.py): `src/io_bridge.py`

### Detection Pipeline

- [Device Fingerprints](https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/fingerprint.py): `src/fingerprint.py`
- [Statistical Detector](https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/detector.py): `src/detector.py`

### Experiments & Results

- [Pipeline Runner](https://github.com/yoyuqre/iot_a-p_capstone/blob/main/main.py): `main.py`
- [Experiment Runner](https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/experiments.py): `src/experiments.py`
- [Metrics Evaluation](https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/evaluation.py): `src/evaluation.py`

### User Exploration

- [Result Visualizations](https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/visualization.py): `src/visualization.py`
- [Dashboard Data](https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/dashboard_data.py): `src/dashboard_data.py`
- [Dashboard Utilities](https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/dashboard_utils.py): `src/dashboard_utils.py`

### Shared Foundation

- [Simulation Config](https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/config.py): `src/config.py`
- [Data Schemas](https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/schemas.py): `src/schemas.py`
- [Shared Utilities](https://github.com/yoyuqre/iot_a-p_capstone/blob/main/src/utils.py): `src/utils.py`

### Other components

- **Researcher**

## Connections

- Researcher → Pipeline Runner: runs pipeline (evidence: `README.md`)
- Pipeline Runner → Traffic Simulator: generates traffic (evidence: `main.py`)
- Pipeline Runner → Device Fingerprints: computes baselines (evidence: `main.py`)
- Pipeline Runner → Anomaly Scenarios: injects scenarios (evidence: `main.py`)
- Pipeline Runner → Statistical Detector: runs detection (evidence: `main.py`)
- Pipeline Runner → Experiment Runner: runs experiments (evidence: `main.py`)
- Pipeline Runner → Metrics Evaluation: evaluates results (evidence: `main.py`)
- Pipeline Runner → Result Visualizations: creates figures (evidence: `main.py`)
- Experiment Runner → Traffic Simulator: generates baseline (evidence: `src/experiments.py`)
- Experiment Runner → Device Fingerprints: computes baseline (evidence: `src/experiments.py`)
- Experiment Runner → Anomaly Scenarios: injects scenarios (evidence: `src/experiments.py`)
- Experiment Runner → Statistical Detector: scores observations (evidence: `src/experiments.py`)
- Dashboard Utilities → Dashboard Data: uses dashboard data (evidence: `src/dashboard_utils.py`)
- Researcher → Dashboard Utilities: explores results (evidence: `README.md`)
- Traffic Simulator → Simulation Config: reads parameters (evidence: `src/simulator.py`)
- Device Fingerprints → Data Schemas: uses data types (evidence: `src/fingerprint.py`)
- Anomaly Scenarios → Data Schemas: uses data types (evidence: `src/anomalies.py`)
- Statistical Detector → Device Fingerprints: uses baselines (evidence: `src/detector.py`)
- Statistical Detector → Data Schemas: uses data types (evidence: `src/detector.py`)
- Experiment Runner → Data Schemas: uses data types (evidence: `src/experiments.py`)
- Metrics Evaluation → Data Schemas: uses data types (evidence: `src/evaluation.py`)
- Wokwi Log Bridge → Data Schemas: uses data types (evidence: `src/io_bridge.py`)
