# jaiarobotics/jaiabot architecture

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

- Interactive diagram: https://gitdiagram.com/jaiarobotics/jaiabot
- Repository: https://github.com/jaiarobotics/jaiabot

## Overview

Jaia Robotics is an autonomous aquatic-robotics stack for fleet sensing missions, spanning onboard autonomy and sensing, communications, and operator-facing control and data visualization. A typical workflow is an operator preparing or assigning a mission in JCC, a JaiaBot executing it through mission-state logic and onboard systems, and fleet status or collected data being surfaced in JCC/JDV for monitoring and replay. The README documents major capabilities; several web and runtime relationships below are therefore shown as unverified rather than asserted as source-confirmed calls.

Main entry points: [`src/bin/mission_manager/mission_manager.cpp`](https://github.com/jaiarobotics/jaiabot/blob/2.y/src/bin/mission_manager/mission_manager.cpp) (Mission Manager), [`src/bin/comms_manager/comms_manager.cpp`](https://github.com/jaiarobotics/jaiabot/blob/2.y/src/bin/comms_manager/comms_manager.cpp) (Comms Manager), [`src/web/components/MissionsPanel/MissionSetStorage/mission-set-storage.ts`](https://github.com/jaiarobotics/jaiabot/blob/2.y/src/web/components/MissionsPanel/MissionSetStorage/mission-set-storage.ts) (Mission Set Storage), [`src/web/jcc/App.tsx`](https://github.com/jaiarobotics/jaiabot/blob/2.y/src/web/jcc/App.tsx) (JCC)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Fleet Control"]
  node_jcc["JCC<br/>[App.tsx]"]
  node_jdv["JDV<br/>[App.tsx]"]
  node_mission_panel["Mission Planning"]
  node_mission_storage["Mission Set Storage"]
  node_mission_models["Mission Models<br/>[mission-set.ts]"]
  node_zone_storage["Exclusion Zone Storage<br/>[zone-storage.ts]"]
end

subgraph group_autonomy["Autonomy &amp; Control"]
  node_mission_manager["Mission Manager"]
  node_mission_states["Mission State Machine"]
  node_pid_control["PID Control<br/>[app.cpp]"]
  node_fusion["Sensor Fusion<br/>[fusion.cpp]"]
end

subgraph group_vehicle["Vehicle Systems"]
  node_sensors["Sensor Service<br/>[app.cpp]"]
  node_sensor_drivers["Sensor Drivers<br/>[aml.h]"]
  node_ctd_manager["CTD Manager<br/>[app.cpp]"]
  node_bio_firmware["Bio Payload Firmware<br/>[main.c]"]
end

subgraph group_communications["Communications"]
  node_comms_manager["Comms Manager<br/>[comms_manager.cpp]"]
  node_xbee["XBee Transport<br/>[xbee.cpp]"]
  node_wifi["Wi-Fi Transport<br/>[udp_driver.cpp]"]
  node_udp_gateway["UDP Gateway<br/>[app.cpp]"]
end

subgraph group_webdata["Portal &amp; Data"]
  node_web_portal["Web Portal Service<br/>[app.cpp]"]
  node_web_server["Portal Server<br/>[app.py]"]
  node_rest_api["REST API<br/>[app.py]"]
  node_jaia_api["Web API Client<br/>[jaia-api.ts]"]
  node_depth_map["Depth Mapping<br/>[DepthMap3D.tsx]"]
end

node_operator(("Fleet Operator"))

node_operator -->|"controls fleet"| node_jcc
node_operator -->|"views replay"| node_jdv
node_jcc -.->|"plans missions"| node_mission_panel
node_mission_panel -->|"manages sets"| node_mission_storage
node_mission_storage -->|"captures snapshots"| node_mission_models
node_mission_storage -.->|"loads and saves"| node_jaia_api
node_jcc -.->|"manages zones"| node_zone_storage
node_zone_storage -->|"loads zones"| node_jaia_api
node_mission_manager -->|"initializes state machine"| node_mission_states
node_mission_states -->|"uses manager"| node_mission_manager
node_mission_manager -.->|"coordinates control"| node_pid_control
node_mission_manager -.->|"uses sensor estimates"| node_fusion
node_sensors -->|"uses drivers"| node_sensor_drivers
node_ctd_manager -.->|"receives payload data"| node_bio_firmware
node_mission_manager -.->|"exchanges messages"| node_comms_manager
node_comms_manager -.->|"supports XBee"| node_xbee
node_comms_manager -.->|"supports Wi-Fi"| node_wifi
node_comms_manager -.->|"routes datagrams"| node_udp_gateway
node_web_portal -.->|"serves portal"| node_web_server
node_web_server -.->|"exposes API"| node_rest_api
node_jaia_api -.->|"requests data"| node_rest_api
node_jdv -.->|"visualizes depth"| node_depth_map
node_web_server -.->|"stores mission sets"| node_mission_storage

click node_jcc "https://github.com/jaiarobotics/jaiabot/blob/2.y/src/web/jcc/App.tsx"
click node_jdv "https://github.com/jaiarobotics/jaiabot/blob/2.y/src/web/jdv/client/src/ui/App.tsx"
click node_mission_panel "https://github.com/jaiarobotics/jaiabot/blob/2.y/src/web/components/MissionsPanel/MissionSetStorage/MissionSetStorageDialog.tsx"
click node_mission_storage "https://github.com/jaiarobotics/jaiabot/blob/2.y/src/web/components/MissionsPanel/MissionSetStorage/mission-set-storage.ts"
click node_mission_models "https://github.com/jaiarobotics/jaiabot/blob/2.y/src/web/data/mission_set/mission-set.ts"
click node_zone_storage "https://github.com/jaiarobotics/jaiabot/blob/2.y/src/web/components/ExclusionZonesPanel/ZoneStorage/zone-storage.ts"
click node_mission_manager "https://github.com/jaiarobotics/jaiabot/blob/2.y/src/bin/mission_manager/mission_manager.cpp"
click node_mission_states "https://github.com/jaiarobotics/jaiabot/blob/2.y/src/bin/mission_manager/mission_manager_state_machine.h"
click node_pid_control "https://github.com/jaiarobotics/jaiabot/blob/2.y/src/bin/pid_control/app.cpp"
click node_fusion "https://github.com/jaiarobotics/jaiabot/blob/2.y/src/bin/fusion/fusion.cpp"
click node_sensors "https://github.com/jaiarobotics/jaiabot/blob/2.y/src/bin/sensors/app.cpp"
click node_sensor_drivers "https://github.com/jaiarobotics/jaiabot/blob/2.y/src/bin/sensors/drivers/aml.h"
click node_ctd_manager "https://github.com/jaiarobotics/jaiabot/blob/2.y/src/bin/ctd_manager/app.cpp"
click node_bio_firmware "https://github.com/jaiarobotics/jaiabot/blob/2.y/src/stm32/bio_payload/Core/Src/main.c"
click node_comms_manager "https://github.com/jaiarobotics/jaiabot/blob/2.y/src/bin/comms_manager/comms_manager.cpp"
click node_xbee "https://github.com/jaiarobotics/jaiabot/blob/2.y/src/lib/comms/xbee/xbee.cpp"
click node_wifi "https://github.com/jaiarobotics/jaiabot/blob/2.y/src/lib/comms/wifi/udp_driver.cpp"
click node_udp_gateway "https://github.com/jaiarobotics/jaiabot/blob/2.y/src/bin/udp_gateway/app.cpp"
click node_web_portal "https://github.com/jaiarobotics/jaiabot/blob/2.y/src/bin/web_portal/app.cpp"
click node_web_server "https://github.com/jaiarobotics/jaiabot/blob/2.y/src/web/server/app.py"
click node_rest_api "https://github.com/jaiarobotics/jaiabot/blob/2.y/src/web/rest_api/app.py"
click node_jaia_api "https://github.com/jaiarobotics/jaiabot/blob/2.y/src/web/utils/jaia-api.ts"
click node_depth_map "https://github.com/jaiarobotics/jaiabot/blob/2.y/src/web/components/DepthMap3D/DepthMap3D.tsx"

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_jcc,node_jdv,node_mission_panel,node_mission_storage,node_mission_models,node_zone_storage toneBlue
class node_mission_manager,node_mission_states,node_pid_control,node_fusion toneAmber
class node_sensors,node_sensor_drivers,node_ctd_manager,node_bio_firmware toneMint
class node_comms_manager,node_xbee,node_wifi,node_udp_gateway toneRose
class node_web_portal,node_web_server,node_rest_api,node_jaia_api,node_depth_map,node_operator toneIndigo
```

## Components

### Fleet Control

- [JCC](https://github.com/jaiarobotics/jaiabot/blob/2.y/src/web/jcc/App.tsx): `src/web/jcc/App.tsx`
- [JDV](https://github.com/jaiarobotics/jaiabot/blob/2.y/src/web/jdv/client/src/ui/App.tsx): `src/web/jdv/client/src/ui/App.tsx`
- [Mission Planning](https://github.com/jaiarobotics/jaiabot/blob/2.y/src/web/components/MissionsPanel/MissionSetStorage/MissionSetStorageDialog.tsx): `src/web/components/MissionsPanel/MissionSetStorage/MissionSetStorageDialog.tsx`
- [Mission Set Storage](https://github.com/jaiarobotics/jaiabot/blob/2.y/src/web/components/MissionsPanel/MissionSetStorage/mission-set-storage.ts): `src/web/components/MissionsPanel/MissionSetStorage/mission-set-storage.ts`
- [Mission Models](https://github.com/jaiarobotics/jaiabot/blob/2.y/src/web/data/mission_set/mission-set.ts): `src/web/data/mission_set/mission-set.ts`
- [Exclusion Zone Storage](https://github.com/jaiarobotics/jaiabot/blob/2.y/src/web/components/ExclusionZonesPanel/ZoneStorage/zone-storage.ts): `src/web/components/ExclusionZonesPanel/ZoneStorage/zone-storage.ts`

### Autonomy & Control

- [Mission Manager](https://github.com/jaiarobotics/jaiabot/blob/2.y/src/bin/mission_manager/mission_manager.cpp): `src/bin/mission_manager/mission_manager.cpp`
- [Mission State Machine](https://github.com/jaiarobotics/jaiabot/blob/2.y/src/bin/mission_manager/mission_manager_state_machine.h): `src/bin/mission_manager/mission_manager_state_machine.h`
- [PID Control](https://github.com/jaiarobotics/jaiabot/blob/2.y/src/bin/pid_control/app.cpp): `src/bin/pid_control/app.cpp`
- [Sensor Fusion](https://github.com/jaiarobotics/jaiabot/blob/2.y/src/bin/fusion/fusion.cpp): `src/bin/fusion/fusion.cpp`

### Vehicle Systems

- [Sensor Service](https://github.com/jaiarobotics/jaiabot/blob/2.y/src/bin/sensors/app.cpp): `src/bin/sensors/app.cpp`
- [Sensor Drivers](https://github.com/jaiarobotics/jaiabot/blob/2.y/src/bin/sensors/drivers/aml.h): `src/bin/sensors/drivers/aml.h`
- [CTD Manager](https://github.com/jaiarobotics/jaiabot/blob/2.y/src/bin/ctd_manager/app.cpp): `src/bin/ctd_manager/app.cpp`
- [Bio Payload Firmware](https://github.com/jaiarobotics/jaiabot/blob/2.y/src/stm32/bio_payload/Core/Src/main.c): `src/stm32/bio_payload/Core/Src/main.c`

### Communications

- [Comms Manager](https://github.com/jaiarobotics/jaiabot/blob/2.y/src/bin/comms_manager/comms_manager.cpp): `src/bin/comms_manager/comms_manager.cpp`
- [XBee Transport](https://github.com/jaiarobotics/jaiabot/blob/2.y/src/lib/comms/xbee/xbee.cpp): `src/lib/comms/xbee/xbee.cpp`
- [Wi-Fi Transport](https://github.com/jaiarobotics/jaiabot/blob/2.y/src/lib/comms/wifi/udp_driver.cpp): `src/lib/comms/wifi/udp_driver.cpp`
- [UDP Gateway](https://github.com/jaiarobotics/jaiabot/blob/2.y/src/bin/udp_gateway/app.cpp): `src/bin/udp_gateway/app.cpp`

### Portal & Data

- [Web Portal Service](https://github.com/jaiarobotics/jaiabot/blob/2.y/src/bin/web_portal/app.cpp): `src/bin/web_portal/app.cpp`
- [Portal Server](https://github.com/jaiarobotics/jaiabot/blob/2.y/src/web/server/app.py): `src/web/server/app.py`
- [REST API](https://github.com/jaiarobotics/jaiabot/blob/2.y/src/web/rest_api/app.py): `src/web/rest_api/app.py`
- [Web API Client](https://github.com/jaiarobotics/jaiabot/blob/2.y/src/web/utils/jaia-api.ts): `src/web/utils/jaia-api.ts`
- [Depth Mapping](https://github.com/jaiarobotics/jaiabot/blob/2.y/src/web/components/DepthMap3D/DepthMap3D.tsx): `src/web/components/DepthMap3D/DepthMap3D.tsx`

### Other components

- **Fleet Operator**

## Connections

- Fleet Operator → JCC: controls fleet (evidence: `README.md`)
- Fleet Operator → JDV: views replay (evidence: `README.md`)
- JCC → Mission Planning: plans missions
- Mission Planning → Mission Set Storage: manages sets (evidence: `src/web/components/MissionsPanel/MissionSetStorage/MissionSetStorageDialog.tsx`)
- Mission Set Storage → Mission Models: captures snapshots (evidence: `src/web/components/MissionsPanel/MissionSetStorage/mission-set-storage.ts`)
- Mission Set Storage → Web API Client: loads and saves (evidence: `src/web/components/MissionsPanel/MissionSetStorage/mission-set-storage.ts`)
- JCC → Exclusion Zone Storage: manages zones
- Exclusion Zone Storage → Web API Client: loads zones (evidence: `src/web/components/ExclusionZonesPanel/ZoneStorage/zone-storage.ts`)
- Mission Manager → Mission State Machine: initializes state machine (evidence: `src/bin/mission_manager/mission_manager.cpp`)
- Mission State Machine → Mission Manager: uses manager (evidence: `src/bin/mission_manager/mission_manager_state_machine.h`)
- Mission Manager → PID Control: coordinates control
- Mission Manager → Sensor Fusion: uses sensor estimates
- Sensor Service → Sensor Drivers: uses drivers (evidence: `src/bin/sensors/app.cpp`)
- CTD Manager → Bio Payload Firmware: receives payload data
- Mission Manager → Comms Manager: exchanges messages
- Comms Manager → XBee Transport: supports XBee (evidence: `README.md`)
- Comms Manager → Wi-Fi Transport: supports Wi-Fi (evidence: `README.md`)
- Comms Manager → UDP Gateway: routes datagrams
- Web Portal Service → Portal Server: serves portal
- Portal Server → REST API: exposes API (evidence: `src/web/server/app.py`)
- Web API Client → REST API: requests data
- JDV → Depth Mapping: visualizes depth
- Portal Server → Mission Set Storage: stores mission sets
