# binarybrain-7/digital-twin- architecture

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

- Interactive diagram: https://gitdiagram.com/binarybrain-7/digital-twin-
- Repository: https://github.com/binarybrain-7/digital-twin-

## Overview

AeroPulse is a real-time piston-engine monitoring prototype comprising a physical-engine simulator and an independent digital-twin dashboard. Operators change flight controls and inject faults in the simulator; its telemetry stream feeds the dashboard, which estimates expected behavior, detects and attributes anomalies, calculates health, remaining useful life and mission risk, then presents advisories. The graph preserves these distinct stages and the shared packet protocol. Evidence is limited to the README and indexed source excerpts; connections without direct source evidence are omitted.

Main entry points: [`dashboard/main.py`](https://github.com/binarybrain-7/digital-twin-/blob/master/dashboard/main.py) (Dashboard App), [`simulator/telemetry_server.py`](https://github.com/binarybrain-7/digital-twin-/blob/master/simulator/telemetry_server.py) (Telemetry Server), [`dashboard/digital_twin.py`](https://github.com/binarybrain-7/digital-twin-/blob/master/dashboard/digital_twin.py) (Digital Twin), [`dashboard/telemetry_client.py`](https://github.com/binarybrain-7/digital-twin-/blob/master/dashboard/telemetry_client.py) (Telemetry Client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_simulation["Engine Simulation"]
  node_sim_app["Simulator App<br/>[main.py]"]
  node_sim_ui["Operator Console<br/>[app.js]"]
  node_physics["Engine Physics<br/>[physics_engine.py]"]
  node_faults["Fault Injection<br/>[fault_injector.py]"]
  node_telemetry_server["Telemetry Server"]
end

subgraph group_protocol["Telemetry Protocol"]
  node_constants["Engine Constants<br/>[constants.py]"]
  node_schema["Packet Schema"]
end

subgraph group_monitoring["Twin And Analytics"]
  node_dashboard_app["Dashboard App<br/>[main.py]"]
  node_telemetry_client["Telemetry Client"]
  node_digital_twin["Digital Twin<br/>[digital_twin.py]"]
  node_analytics["Anomaly Analytics<br/>[analytics.py]"]
  node_health_risk["Health And Risk<br/>[health_risk.py]"]
  node_advisory["Pilot Advisories<br/>[advisory.py]"]
end

subgraph group_mission["Mission Interface"]
  node_dashboard_ui["Mission Control<br/>[app.js]"]
end

node_operator(("Operator"))

node_operator -->|"controls"| node_sim_ui
node_sim_ui -->|"sends controls"| node_telemetry_server
node_telemetry_server -->|"steps simulation"| node_physics
node_physics -->|"uses fault state"| node_faults
node_telemetry_server -->|"sets faults"| node_faults
node_sim_app -->|"starts server"| node_telemetry_server
node_telemetry_server -->|"serializes packets"| node_schema
node_telemetry_server -->|"streams telemetry"| node_telemetry_client
node_telemetry_client -->|"validates packets"| node_schema
node_dashboard_app -->|"starts client"| node_telemetry_client
node_dashboard_app -->|"creates twin"| node_digital_twin
node_digital_twin -->|"uses baselines"| node_constants
node_digital_twin -->|"uses packet fields"| node_schema
node_dashboard_app -->|"creates analytics"| node_analytics
node_dashboard_app -->|"creates calculator"| node_health_risk
node_dashboard_app -->|"creates generator"| node_advisory
node_dashboard_app -->|"serves mission UI"| node_dashboard_ui
node_operator -->|"views results"| node_dashboard_ui

click node_sim_app "https://github.com/binarybrain-7/digital-twin-/blob/master/simulator/main.py"
click node_sim_ui "https://github.com/binarybrain-7/digital-twin-/blob/master/simulator/ui/app.js"
click node_physics "https://github.com/binarybrain-7/digital-twin-/blob/master/simulator/physics_engine.py"
click node_faults "https://github.com/binarybrain-7/digital-twin-/blob/master/simulator/fault_injector.py"
click node_telemetry_server "https://github.com/binarybrain-7/digital-twin-/blob/master/simulator/telemetry_server.py"
click node_constants "https://github.com/binarybrain-7/digital-twin-/blob/master/common/constants.py"
click node_schema "https://github.com/binarybrain-7/digital-twin-/blob/master/common/telemetry_schema.py"
click node_dashboard_app "https://github.com/binarybrain-7/digital-twin-/blob/master/dashboard/main.py"
click node_telemetry_client "https://github.com/binarybrain-7/digital-twin-/blob/master/dashboard/telemetry_client.py"
click node_digital_twin "https://github.com/binarybrain-7/digital-twin-/blob/master/dashboard/digital_twin.py"
click node_analytics "https://github.com/binarybrain-7/digital-twin-/blob/master/dashboard/analytics.py"
click node_health_risk "https://github.com/binarybrain-7/digital-twin-/blob/master/dashboard/health_risk.py"
click node_advisory "https://github.com/binarybrain-7/digital-twin-/blob/master/dashboard/advisory.py"
click node_dashboard_ui "https://github.com/binarybrain-7/digital-twin-/blob/master/dashboard/ui/app.js"

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_sim_app,node_sim_ui,node_physics,node_faults,node_telemetry_server toneBlue
class node_constants,node_schema toneAmber
class node_dashboard_app,node_telemetry_client,node_digital_twin,node_analytics,node_health_risk,node_advisory toneMint
class node_dashboard_ui toneRose
class node_operator toneIndigo
```

## Components

### Engine Simulation

- [Simulator App](https://github.com/binarybrain-7/digital-twin-/blob/master/simulator/main.py): `simulator/main.py`
- [Operator Console](https://github.com/binarybrain-7/digital-twin-/blob/master/simulator/ui/app.js): `simulator/ui/app.js`
- [Engine Physics](https://github.com/binarybrain-7/digital-twin-/blob/master/simulator/physics_engine.py): `simulator/physics_engine.py`
- [Fault Injection](https://github.com/binarybrain-7/digital-twin-/blob/master/simulator/fault_injector.py): `simulator/fault_injector.py`
- [Telemetry Server](https://github.com/binarybrain-7/digital-twin-/blob/master/simulator/telemetry_server.py): `simulator/telemetry_server.py`

### Telemetry Protocol

- [Engine Constants](https://github.com/binarybrain-7/digital-twin-/blob/master/common/constants.py): `common/constants.py`
- [Packet Schema](https://github.com/binarybrain-7/digital-twin-/blob/master/common/telemetry_schema.py): `common/telemetry_schema.py`

### Twin And Analytics

- [Dashboard App](https://github.com/binarybrain-7/digital-twin-/blob/master/dashboard/main.py): `dashboard/main.py`
- [Telemetry Client](https://github.com/binarybrain-7/digital-twin-/blob/master/dashboard/telemetry_client.py): `dashboard/telemetry_client.py`
- [Digital Twin](https://github.com/binarybrain-7/digital-twin-/blob/master/dashboard/digital_twin.py): `dashboard/digital_twin.py`
- [Anomaly Analytics](https://github.com/binarybrain-7/digital-twin-/blob/master/dashboard/analytics.py): `dashboard/analytics.py`
- [Health And Risk](https://github.com/binarybrain-7/digital-twin-/blob/master/dashboard/health_risk.py): `dashboard/health_risk.py`
- [Pilot Advisories](https://github.com/binarybrain-7/digital-twin-/blob/master/dashboard/advisory.py): `dashboard/advisory.py`

### Mission Interface

- [Mission Control](https://github.com/binarybrain-7/digital-twin-/blob/master/dashboard/ui/app.js): `dashboard/ui/app.js`

### Other components

- **Operator**

## Connections

- Operator → Operator Console: controls (evidence: `README.md`)
- Operator Console → Telemetry Server: sends controls (evidence: `simulator/telemetry_server.py`)
- Telemetry Server → Engine Physics: steps simulation (evidence: `simulator/telemetry_server.py`)
- Engine Physics → Fault Injection: uses fault state (evidence: `simulator/physics_engine.py`)
- Telemetry Server → Fault Injection: sets faults (evidence: `simulator/telemetry_server.py`)
- Simulator App → Telemetry Server: starts server (evidence: `simulator/main.py`)
- Telemetry Server → Packet Schema: serializes packets (evidence: `simulator/telemetry_server.py`)
- Telemetry Server → Telemetry Client: streams telemetry (evidence: `README.md`)
- Telemetry Client → Packet Schema: validates packets (evidence: `dashboard/telemetry_client.py`)
- Dashboard App → Telemetry Client: starts client (evidence: `dashboard/main.py`)
- Dashboard App → Digital Twin: creates twin (evidence: `dashboard/main.py`)
- Digital Twin → Engine Constants: uses baselines (evidence: `dashboard/digital_twin.py`)
- Digital Twin → Packet Schema: uses packet fields (evidence: `dashboard/digital_twin.py`)
- Dashboard App → Anomaly Analytics: creates analytics (evidence: `dashboard/main.py`)
- Dashboard App → Health And Risk: creates calculator (evidence: `dashboard/main.py`)
- Dashboard App → Pilot Advisories: creates generator (evidence: `dashboard/main.py`)
- Dashboard App → Mission Control: serves mission UI (evidence: `README.md`)
- Operator → Mission Control: views results (evidence: `README.md`)
