# praewa-japan1350/final-project architecture

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

- Interactive diagram: https://gitdiagram.com/praewa-japan1350/final-project
- Repository: https://github.com/praewa-japan1350/final-project

## Overview

This is a RoboMaster EP maze- mission system. The operator starts a dashboard or CLI run; the coordinator supports mapping and target-navigation modes, combining exploration/path planning, robot control, and vision before presenting status and exporting evaluation artifacts. The README documents two rounds, resume/continuous operation, live visualization, and mission timing. Source excerpts and the SOURCE INDEX establish the main module relationships; links to map and result persistence are documented, though some implementation details were not sampled.

Main entry points: [`slam.py`](https://github.com/praewa-japan1350/final-project/blob/main/slam.py) (Mission Coordinator), [`dashboard.py`](https://github.com/praewa-japan1350/final-project/blob/main/dashboard.py) (Live Dashboard), [`vision.py`](https://github.com/praewa-japan1350/final-project/blob/main/vision.py) (Target Detection), [`evaluation.py`](https://github.com/praewa-japan1350/final-project/blob/main/evaluation.py) (Evaluation and Export)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Mission Control"]
  node_launcher["CLI Launcher<br/>[run.py]"]
  node_coordinator["Mission Coordinator<br/>[slam.py]"]
  node_config["Runtime Configuration<br/>[config.py]"]
  node_planner["Exploration and A*<br/>[navigation.py]"]
end

subgraph group_sensing["Mapping and Vision"]
  node_state[("Shared Mission State<br/>[state.py]")]
  node_vision["Target Detection<br/>[vision.py]"]
end

subgraph group_robot["Robot Operations"]
  node_robotcontrol["Robot and Sensors<br/>[robot_control.py]"]
end

subgraph group_interface["Operator Interface"]
  node_dashboard["Live Dashboard<br/>[dashboard.py]"]
  node_preview["Vision Preview<br/>[vision_preview.py]"]
end

subgraph group_records["Mission Records"]
  node_map["Mission Map<br/>[mission_map.json]"]
  node_evaluation["Evaluation and Export<br/>[evaluation.py]"]
  node_results[("Mission Logs and Snapshots")]
end

node_operator(("Operator"))
node_robot["RoboMaster EP"]

node_operator -->|"launches"| node_launcher
node_operator -->|"starts mission"| node_dashboard
node_launcher -->|"runs mission"| node_coordinator
node_launcher -->|"requests evaluation"| node_evaluation
node_dashboard -->|"starts mission"| node_coordinator
node_dashboard -->|"sets grid"| node_config
node_coordinator -->|"configures grid"| node_config
node_coordinator -->|"plans routes"| node_planner
node_coordinator -->|"controls robot"| node_robotcontrol
node_coordinator -->|"processes targets"| node_vision
node_robotcontrol -.->|"commands and senses"| node_robot
node_robotcontrol -->|"uses detections"| node_vision
node_vision -.->|"shares detections"| node_state
node_coordinator -->|"updates mission state"| node_state
node_dashboard -->|"reads live state"| node_state
node_preview -->|"analyzes frames"| node_vision
node_preview -->|"connects camera"| node_robot
node_coordinator -->|"loads and saves"| node_map
node_coordinator -->|"records mission"| node_results
node_coordinator -.->|"sends status"| node_dashboard
node_coordinator -.->|"requests reports"| node_evaluation
node_evaluation -->|"exports reports"| node_results
node_dashboard -->|"imports evaluation"| node_evaluation

click node_launcher "https://github.com/praewa-japan1350/final-project/blob/main/run.py"
click node_coordinator "https://github.com/praewa-japan1350/final-project/blob/main/slam.py"
click node_config "https://github.com/praewa-japan1350/final-project/blob/main/config.py"
click node_planner "https://github.com/praewa-japan1350/final-project/blob/main/navigation.py"
click node_dashboard "https://github.com/praewa-japan1350/final-project/blob/main/dashboard.py"
click node_preview "https://github.com/praewa-japan1350/final-project/blob/main/vision_preview.py"
click node_state "https://github.com/praewa-japan1350/final-project/blob/main/state.py"
click node_vision "https://github.com/praewa-japan1350/final-project/blob/main/vision.py"
click node_robotcontrol "https://github.com/praewa-japan1350/final-project/blob/main/robot_control.py"
click node_map "https://github.com/praewa-japan1350/final-project/blob/main/maps/mission_map.json"
click node_evaluation "https://github.com/praewa-japan1350/final-project/blob/main/evaluation.py"
click node_results "https://github.com/praewa-japan1350/final-project/tree/main/results"

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_launcher,node_coordinator,node_config,node_planner toneBlue
class node_state,node_vision toneAmber
class node_robotcontrol toneMint
class node_dashboard,node_preview toneRose
class node_map,node_evaluation,node_results,node_operator,node_robot toneIndigo
```

## Components

### Mission Control

- [CLI Launcher](https://github.com/praewa-japan1350/final-project/blob/main/run.py): `run.py`
- [Mission Coordinator](https://github.com/praewa-japan1350/final-project/blob/main/slam.py): `slam.py`
- [Runtime Configuration](https://github.com/praewa-japan1350/final-project/blob/main/config.py): `config.py`
- [Exploration and A*](https://github.com/praewa-japan1350/final-project/blob/main/navigation.py): `navigation.py`

### Mapping and Vision

- [Shared Mission State](https://github.com/praewa-japan1350/final-project/blob/main/state.py): `state.py`
- [Target Detection](https://github.com/praewa-japan1350/final-project/blob/main/vision.py): `vision.py`

### Robot Operations

- [Robot and Sensors](https://github.com/praewa-japan1350/final-project/blob/main/robot_control.py): `robot_control.py`

### Operator Interface

- [Live Dashboard](https://github.com/praewa-japan1350/final-project/blob/main/dashboard.py): `dashboard.py`
- [Vision Preview](https://github.com/praewa-japan1350/final-project/blob/main/vision_preview.py): `vision_preview.py`

### Mission Records

- [Mission Map](https://github.com/praewa-japan1350/final-project/blob/main/maps/mission_map.json): `maps/mission_map.json`
- [Evaluation and Export](https://github.com/praewa-japan1350/final-project/blob/main/evaluation.py): `evaluation.py`
- [Mission Logs and Snapshots](https://github.com/praewa-japan1350/final-project/tree/main/results): `results`

### Other components

- **Operator**
- **RoboMaster EP**

## Connections

- Operator → CLI Launcher: launches (evidence: `README.md`)
- Operator → Live Dashboard: starts mission (evidence: `README.md`)
- CLI Launcher → Mission Coordinator: runs mission (evidence: `run.py`)
- CLI Launcher → Evaluation and Export: requests evaluation (evidence: `run.py`)
- Live Dashboard → Mission Coordinator: starts mission (evidence: `README.md`)
- Live Dashboard → Runtime Configuration: sets grid (evidence: `dashboard.py`)
- Mission Coordinator → Runtime Configuration: configures grid (evidence: `slam.py`)
- Mission Coordinator → Exploration and A*: plans routes (evidence: `slam.py`)
- Mission Coordinator → Robot and Sensors: controls robot (evidence: `slam.py`)
- Mission Coordinator → Target Detection: processes targets (evidence: `README.md`)
- Robot and Sensors → RoboMaster EP: commands and senses
- Robot and Sensors → Target Detection: uses detections (evidence: `robot_control.py`)
- Target Detection → Shared Mission State: shares detections
- Mission Coordinator → Shared Mission State: updates mission state (evidence: `README.md`)
- Live Dashboard → Shared Mission State: reads live state (evidence: `README.md`)
- Vision Preview → Target Detection: analyzes frames (evidence: `vision_preview.py`)
- Vision Preview → RoboMaster EP: connects camera (evidence: `vision_preview.py`)
- Mission Coordinator → Mission Map: loads and saves (evidence: `README.md`)
- Mission Coordinator → Mission Logs and Snapshots: records mission (evidence: `README.md`)
- Mission Coordinator → Live Dashboard: sends status (evidence: `slam.py`)
- Mission Coordinator → Evaluation and Export: requests reports (evidence: `slam.py`)
- Evaluation and Export → Mission Logs and Snapshots: exports reports (evidence: `evaluation.py`)
- Live Dashboard → Evaluation and Export: imports evaluation (evidence: `dashboard.py`)
