# jamesesc/drone-simulator-project architecture

> Architecture diagram of the GitHub repository jamesesc/drone-simulator-project, 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/jamesesc/drone-simulator-project
- Repository: https://github.com/jamesesc/drone-simulator-project

## Overview

This JavaFX drone simulator’s main workflow is to start a fleet simulation, generate drone telemetry, detect anomalies, persist anomaly records, and update the monitoring UI. The code excerpts show the application wiring, simulation scheduling, fleet generation, and UI listener updates; the README also describes database querying and the interactive simulation display. Some engine-to-storage and view-to-widget details are documented or indexed but not visible in the excerpts, so uncertain links are omitted or marked unverified.

Main entry points: [`src/view/MonitorDash.java`](https://github.com/jamesesc/drone-simulator-project/blob/main/src/view/MonitorDash.java) (Monitor dashboard), [`src/service/SimulationEngine.java`](https://github.com/jamesesc/drone-simulator-project/blob/main/src/service/SimulationEngine.java) (Simulation engine), [`src/controller/DroneMonitorApp.java`](https://github.com/jamesesc/drone-simulator-project/blob/main/src/controller/DroneMonitorApp.java) (Simulation controller), [`src/App/Simulation.java`](https://github.com/jamesesc/drone-simulator-project/blob/main/src/App/Simulation.java) (JavaFX startup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Simulation runtime"]
  node_entry["JavaFX startup<br/>[Simulation.java]"]
  node_controller["Simulation controller"]
  node_engine["Simulation engine"]
  node_timer["Timer manager<br/>[TimerManager.java]"]
  node_fleet["Fleet manager"]
  node_generator["Telemetry generator"]
  node_detector["Anomaly detector"]
end

subgraph group_domain["Drone domain"]
  node_drone["Drone models<br/>[AbstractDrone.java]"]
  node_telemetry["Telemetry data<br/>[TelemetryData.java]"]
  node_anomaly["Anomaly record<br/>[AnomalyRecord.java]"]
  node_battery["Battery state<br/>[Battery.java]"]
end

subgraph group_persistence["Anomaly storage"]
  node_database[("Anomaly database<br/>[AnomalyDB.java]")]
end

subgraph group_interface["Monitoring interface"]
  node_dashboard["Monitor dashboard<br/>[MonitorDash.java]"]
  node_listener["Simulation listener"]
  node_uiupdate["UI update adapter"]
  node_dbquery["Database query popup<br/>[DatabasePopup.java]"]
  node_menu["Application menu<br/>[AppMenuBar.java]"]
  node_droneview["Drone display"]
  node_stats["Fleet statistics<br/>[TopRightStats.java]"]
  node_anomalytable["Anomaly table<br/>[BottomTable.java]"]
end

node_user(("Operator"))

node_user -->|"operates"| node_dashboard
node_entry -->|"creates"| node_controller
node_entry -->|"creates"| node_dashboard
node_entry -->|"creates"| node_uiupdate
node_entry -->|"registers listener"| node_uiupdate
node_controller -->|"starts and stops"| node_engine
node_controller -->|"controls"| node_timer
node_controller -->|"resets and configures"| node_fleet
node_controller -->|"sets listener"| node_listener
node_engine -->|"requests telemetry"| node_fleet
node_engine -->|"detects anomalies"| node_detector
node_engine -->|"checks simulation status"| node_timer
node_fleet -->|"generates telemetry"| node_generator
node_fleet -->|"creates fleet"| node_drone
node_engine -.->|"stores anomalies"| node_database
node_engine -.->|"notifies updates"| node_listener
node_uiupdate -->|"updates display"| node_dashboard
node_dashboard -->|"starts simulation"| node_controller
node_dashboard -.->|"refreshes display"| node_droneview
node_dashboard -.->|"shows fleet stats"| node_stats
node_dashboard -.->|"shows anomalies"| node_anomalytable
node_menu -.->|"queries records"| node_database
node_dashboard -.->|"shows query results"| node_dbquery

click node_entry "https://github.com/jamesesc/drone-simulator-project/blob/main/src/App/Simulation.java"
click node_controller "https://github.com/jamesesc/drone-simulator-project/blob/main/src/controller/DroneMonitorApp.java"
click node_engine "https://github.com/jamesesc/drone-simulator-project/blob/main/src/service/SimulationEngine.java"
click node_timer "https://github.com/jamesesc/drone-simulator-project/blob/main/src/service/TimerManager.java"
click node_fleet "https://github.com/jamesesc/drone-simulator-project/blob/main/src/service/DroneFleetManager.java"
click node_generator "https://github.com/jamesesc/drone-simulator-project/blob/main/src/service/TelemetryGenerator.java"
click node_detector "https://github.com/jamesesc/drone-simulator-project/blob/main/src/service/AnomalyDetector.java"
click node_drone "https://github.com/jamesesc/drone-simulator-project/blob/main/src/Model/AbstractDrone.java"
click node_telemetry "https://github.com/jamesesc/drone-simulator-project/blob/main/src/Model/TelemetryData.java"
click node_anomaly "https://github.com/jamesesc/drone-simulator-project/blob/main/src/Model/AnomalyRecord.java"
click node_battery "https://github.com/jamesesc/drone-simulator-project/blob/main/src/Model/Battery.java"
click node_database "https://github.com/jamesesc/drone-simulator-project/blob/main/src/database/AnomalyDB.java"
click node_dashboard "https://github.com/jamesesc/drone-simulator-project/blob/main/src/view/MonitorDash.java"
click node_listener "https://github.com/jamesesc/drone-simulator-project/blob/main/src/view/SimulationListener.java"
click node_uiupdate "https://github.com/jamesesc/drone-simulator-project/blob/main/src/view/UpdateUIManager.java"
click node_dbquery "https://github.com/jamesesc/drone-simulator-project/blob/main/src/view/DatabasePopup.java"
click node_menu "https://github.com/jamesesc/drone-simulator-project/blob/main/src/view/AppMenuBar.java"
click node_droneview "https://github.com/jamesesc/drone-simulator-project/blob/main/src/view/TopLeftDroneDisplay.java"
click node_stats "https://github.com/jamesesc/drone-simulator-project/blob/main/src/view/TopRightStats.java"
click node_anomalytable "https://github.com/jamesesc/drone-simulator-project/blob/main/src/view/BottomTable.java"

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_entry,node_controller,node_engine,node_timer,node_fleet,node_generator,node_detector toneBlue
class node_drone,node_telemetry,node_anomaly,node_battery toneAmber
class node_database toneMint
class node_dashboard,node_listener,node_uiupdate,node_dbquery,node_menu,node_droneview,node_stats,node_anomalytable toneRose
class node_user toneIndigo
```

## Components

### Simulation runtime

- [JavaFX startup](https://github.com/jamesesc/drone-simulator-project/blob/main/src/App/Simulation.java): `src/App/Simulation.java`
- [Simulation controller](https://github.com/jamesesc/drone-simulator-project/blob/main/src/controller/DroneMonitorApp.java): `src/controller/DroneMonitorApp.java`
- [Simulation engine](https://github.com/jamesesc/drone-simulator-project/blob/main/src/service/SimulationEngine.java): `src/service/SimulationEngine.java`
- [Timer manager](https://github.com/jamesesc/drone-simulator-project/blob/main/src/service/TimerManager.java): `src/service/TimerManager.java`
- [Fleet manager](https://github.com/jamesesc/drone-simulator-project/blob/main/src/service/DroneFleetManager.java): `src/service/DroneFleetManager.java`
- [Telemetry generator](https://github.com/jamesesc/drone-simulator-project/blob/main/src/service/TelemetryGenerator.java): `src/service/TelemetryGenerator.java`
- [Anomaly detector](https://github.com/jamesesc/drone-simulator-project/blob/main/src/service/AnomalyDetector.java): `src/service/AnomalyDetector.java`

### Drone domain

- [Drone models](https://github.com/jamesesc/drone-simulator-project/blob/main/src/Model/AbstractDrone.java): `src/Model/AbstractDrone.java`
- [Telemetry data](https://github.com/jamesesc/drone-simulator-project/blob/main/src/Model/TelemetryData.java): `src/Model/TelemetryData.java`
- [Anomaly record](https://github.com/jamesesc/drone-simulator-project/blob/main/src/Model/AnomalyRecord.java): `src/Model/AnomalyRecord.java`
- [Battery state](https://github.com/jamesesc/drone-simulator-project/blob/main/src/Model/Battery.java): `src/Model/Battery.java`

### Anomaly storage

- [Anomaly database](https://github.com/jamesesc/drone-simulator-project/blob/main/src/database/AnomalyDB.java): `src/database/AnomalyDB.java`

### Monitoring interface

- [Monitor dashboard](https://github.com/jamesesc/drone-simulator-project/blob/main/src/view/MonitorDash.java): `src/view/MonitorDash.java`
- [Simulation listener](https://github.com/jamesesc/drone-simulator-project/blob/main/src/view/SimulationListener.java): `src/view/SimulationListener.java`
- [UI update adapter](https://github.com/jamesesc/drone-simulator-project/blob/main/src/view/UpdateUIManager.java): `src/view/UpdateUIManager.java`
- [Database query popup](https://github.com/jamesesc/drone-simulator-project/blob/main/src/view/DatabasePopup.java): `src/view/DatabasePopup.java`
- [Application menu](https://github.com/jamesesc/drone-simulator-project/blob/main/src/view/AppMenuBar.java): `src/view/AppMenuBar.java`
- [Drone display](https://github.com/jamesesc/drone-simulator-project/blob/main/src/view/TopLeftDroneDisplay.java): `src/view/TopLeftDroneDisplay.java`
- [Fleet statistics](https://github.com/jamesesc/drone-simulator-project/blob/main/src/view/TopRightStats.java): `src/view/TopRightStats.java`
- [Anomaly table](https://github.com/jamesesc/drone-simulator-project/blob/main/src/view/BottomTable.java): `src/view/BottomTable.java`

### Other components

- **Operator**

## Connections

- Operator → Monitor dashboard: operates (evidence: `README.md`)
- JavaFX startup → Simulation controller: creates (evidence: `src/App/Simulation.java`)
- JavaFX startup → Monitor dashboard: creates (evidence: `src/App/Simulation.java`)
- JavaFX startup → UI update adapter: creates (evidence: `src/App/Simulation.java`)
- JavaFX startup → UI update adapter: registers listener (evidence: `src/App/Simulation.java`)
- Simulation controller → Simulation engine: starts and stops (evidence: `src/controller/DroneMonitorApp.java`)
- Simulation controller → Timer manager: controls (evidence: `src/controller/DroneMonitorApp.java`)
- Simulation controller → Fleet manager: resets and configures (evidence: `src/controller/DroneMonitorApp.java`)
- Simulation controller → Simulation listener: sets listener (evidence: `src/controller/DroneMonitorApp.java`)
- Simulation engine → Fleet manager: requests telemetry (evidence: `src/service/SimulationEngine.java`)
- Simulation engine → Anomaly detector: detects anomalies (evidence: `src/service/SimulationEngine.java`)
- Simulation engine → Timer manager: checks simulation status (evidence: `src/service/SimulationEngine.java`)
- Fleet manager → Telemetry generator: generates telemetry (evidence: `src/service/DroneFleetManager.java`)
- Fleet manager → Drone models: creates fleet (evidence: `src/service/DroneFleetManager.java`)
- Simulation engine → Anomaly database: stores anomalies (evidence: `src/service/SimulationEngine.java`)
- Simulation engine → Simulation listener: notifies updates (evidence: `src/service/SimulationEngine.java`)
- UI update adapter → Monitor dashboard: updates display (evidence: `src/view/UpdateUIManager.java`)
- Monitor dashboard → Simulation controller: starts simulation (evidence: `src/view/MonitorDash.java`)
- Monitor dashboard → Drone display: refreshes display (evidence: `src/view/MonitorDash.java`)
- Monitor dashboard → Fleet statistics: shows fleet stats (evidence: `src/view/MonitorDash.java`)
- Monitor dashboard → Anomaly table: shows anomalies (evidence: `src/view/MonitorDash.java`)
- Application menu → Anomaly database: queries records (evidence: `src/view/AppMenuBar.java`)
- Monitor dashboard → Database query popup: shows query results (evidence: `src/view/MonitorDash.java`)
