# t2hopetechnik/rmf_ros2_jazzy architecture

> Architecture diagram of the GitHub repository t2hopetechnik/rmf_ros2_jazzy, 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/t2hopetechnik/rmf_ros2_jazzy
- Repository: https://github.com/t2hopetechnik/rmf_ros2_jazzy

## Overview

This repository integrates RMF fleet, task, and traffic capabilities into ROS 2, with supporting charging-schedule and WebSocket packages. The principal workflow is a fleet adapter receiving task assignments, managing robot/task state, and coordinating robot execution with traffic reservations. The graph also shows traffic scheduling and optional messaging capabilities. Evidence is limited to the README, source index, and sampled excerpts; links without direct evidence are omitted or marked unverified.

Main entry points: [`rmf_fleet_adapter/src/full_control/main.cpp`](https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_fleet_adapter/src/full_control/main.cpp) (Fleet Adapter), [`rmf_fleet_adapter/src/rmf_fleet_adapter/TaskManager.cpp`](https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_fleet_adapter/src/rmf_fleet_adapter/TaskManager.cpp) (Task Manager), [`rmf_fleet_adapter/src/rmf_fleet_adapter/agv/internal_FleetUpdateHandle.hpp`](https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_fleet_adapter/src/rmf_fleet_adapter/agv/internal_FleetUpdateHandle.hpp) (Fleet API), [`rmf_fleet_adapter/src/rmf_fleet_adapter/agv/RobotContext.hpp`](https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_fleet_adapter/src/rmf_fleet_adapter/agv/RobotContext.hpp) (Robot Context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_fleet["Fleet Control"]
  node_adapter["Fleet Adapter<br/>[main.cpp]"]
  node_fleet_api["Fleet API"]
  node_robot_context["Robot Context<br/>[RobotContext.hpp]"]
  node_parse_args["Argument Parsing<br/>[ParseArgs.hpp]"]
  node_estimation["State Estimation<br/>[estimation.hpp]"]
end

subgraph group_tasks["Task Execution"]
  node_task_dispatch["Task Dispatcher<br/>[Dispatcher.cpp]"]
  node_auctioneer["Task Auctioneer<br/>[Auctioneer.cpp]"]
  node_task_manager["Task Manager<br/>[TaskManager.cpp]"]
  node_legacy_task["Task Phases<br/>[LegacyTask.hpp]"]
  node_task_types["Task Types"]
end

subgraph group_traffic["Traffic Coordination"]
  node_reservation_manager["Reservation Manager"]
  node_reservation_service["Reservation Node<br/>[main.cpp]"]
  node_schedule_node["Traffic Schedule<br/>[main.cpp]"]
  node_schedule_mirror["Schedule Mirror<br/>[MirrorManager.cpp]"]
end

subgraph group_integration["ROS 2 Integration"]
  node_charging_schedule["Charging Schedule<br/>[main.py]"]
  node_websocket_client["Broadcast Client"]
  node_websocket_endpoint["WebSocket Endpoint"]
  node_rxcpp["Reactive Streams<br/>[rx-observable.hpp]"]
end

node_operator(("Fleet Operator"))
node_ros2(("ROS 2 System"))

node_operator -.->|"configures"| node_adapter
node_adapter -->|"parses arguments"| node_parse_args
node_adapter -->|"uses estimation"| node_estimation
node_adapter -->|"creates fleet"| node_fleet_api
node_fleet_api -->|"tracks robots"| node_robot_context
node_task_dispatch -.->|"bids tasks"| node_auctioneer
node_task_manager -->|"reads fleet state"| node_fleet_api
node_task_manager -->|"manages robot tasks"| node_robot_context
node_task_manager -->|"manages task phases"| node_legacy_task
node_task_manager -->|"creates task types"| node_task_types
node_robot_context -->|"uses reservations"| node_reservation_manager
node_reservation_manager -->|"publishes releases"| node_ros2
node_schedule_node -.->|"runs schedule mirror"| node_schedule_mirror
node_charging_schedule -.->|"integrates with ROS 2"| node_ros2
node_websocket_client -->|"connects and sends"| node_websocket_endpoint
node_adapter -.->|"uses reactive streams"| node_rxcpp
node_task_dispatch -.->|"uses ROS 2"| node_ros2
node_schedule_node -->|"runs on ROS 2"| node_ros2

click node_adapter "https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_fleet_adapter/src/full_control/main.cpp"
click node_fleet_api "https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_fleet_adapter/src/rmf_fleet_adapter/agv/internal_FleetUpdateHandle.hpp"
click node_robot_context "https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_fleet_adapter/src/rmf_fleet_adapter/agv/RobotContext.hpp"
click node_parse_args "https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_fleet_adapter/src/rmf_fleet_adapter/ParseArgs.hpp"
click node_estimation "https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_fleet_adapter/src/rmf_fleet_adapter/estimation.hpp"
click node_task_dispatch "https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_task_ros2/src/rmf_task_ros2/Dispatcher.cpp"
click node_auctioneer "https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_task_ros2/src/rmf_task_ros2/bidding/Auctioneer.cpp"
click node_task_manager "https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_fleet_adapter/src/rmf_fleet_adapter/TaskManager.cpp"
click node_legacy_task "https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_fleet_adapter/src/rmf_fleet_adapter/LegacyTask.hpp"
click node_task_types "https://github.com/t2hopetechnik/rmf_ros2_jazzy/tree/main/rmf_fleet_adapter/src/rmf_fleet_adapter/tasks"
click node_reservation_manager "https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_fleet_adapter/src/rmf_fleet_adapter/agv/ReservationManager.cpp"
click node_reservation_service "https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_reservation_node/src/main.cpp"
click node_schedule_node "https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_traffic_ros2/src/rmf_traffic_schedule/main.cpp"
click node_schedule_mirror "https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_traffic_ros2/src/rmf_traffic_ros2/schedule/MirrorManager.cpp"
click node_charging_schedule "https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_charging_schedule/rmf_charging_schedule/main.py"
click node_websocket_client "https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_websocket/src/rmf_websocket/BroadcastClient.cpp"
click node_websocket_endpoint "https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_websocket/src/rmf_websocket/client/ClientWebSocketEndpoint.cpp"
click node_rxcpp "https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_fleet_adapter/rmf_rxcpp/RxCpp-4.1.0/Rx/v2/src/rxcpp/rx-observable.hpp"

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_adapter,node_fleet_api,node_robot_context,node_parse_args,node_estimation toneBlue
class node_task_dispatch,node_auctioneer,node_task_manager,node_legacy_task,node_task_types toneAmber
class node_reservation_manager,node_reservation_service,node_schedule_node,node_schedule_mirror toneMint
class node_charging_schedule,node_websocket_client,node_websocket_endpoint,node_rxcpp toneRose
class node_operator,node_ros2 toneIndigo
```

## Components

### Fleet Control

- [Fleet Adapter](https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_fleet_adapter/src/full_control/main.cpp): `rmf_fleet_adapter/src/full_control/main.cpp`
- [Fleet API](https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_fleet_adapter/src/rmf_fleet_adapter/agv/internal_FleetUpdateHandle.hpp): `rmf_fleet_adapter/src/rmf_fleet_adapter/agv/internal_FleetUpdateHandle.hpp`
- [Robot Context](https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_fleet_adapter/src/rmf_fleet_adapter/agv/RobotContext.hpp): `rmf_fleet_adapter/src/rmf_fleet_adapter/agv/RobotContext.hpp`
- [Argument Parsing](https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_fleet_adapter/src/rmf_fleet_adapter/ParseArgs.hpp): `rmf_fleet_adapter/src/rmf_fleet_adapter/ParseArgs.hpp`
- [State Estimation](https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_fleet_adapter/src/rmf_fleet_adapter/estimation.hpp): `rmf_fleet_adapter/src/rmf_fleet_adapter/estimation.hpp`

### Task Execution

- [Task Dispatcher](https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_task_ros2/src/rmf_task_ros2/Dispatcher.cpp): `rmf_task_ros2/src/rmf_task_ros2/Dispatcher.cpp`
- [Task Auctioneer](https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_task_ros2/src/rmf_task_ros2/bidding/Auctioneer.cpp): `rmf_task_ros2/src/rmf_task_ros2/bidding/Auctioneer.cpp`
- [Task Manager](https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_fleet_adapter/src/rmf_fleet_adapter/TaskManager.cpp): `rmf_fleet_adapter/src/rmf_fleet_adapter/TaskManager.cpp`
- [Task Phases](https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_fleet_adapter/src/rmf_fleet_adapter/LegacyTask.hpp): `rmf_fleet_adapter/src/rmf_fleet_adapter/LegacyTask.hpp`
- [Task Types](https://github.com/t2hopetechnik/rmf_ros2_jazzy/tree/main/rmf_fleet_adapter/src/rmf_fleet_adapter/tasks): `rmf_fleet_adapter/src/rmf_fleet_adapter/tasks`

### Traffic Coordination

- [Reservation Manager](https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_fleet_adapter/src/rmf_fleet_adapter/agv/ReservationManager.cpp): `rmf_fleet_adapter/src/rmf_fleet_adapter/agv/ReservationManager.cpp`
- [Reservation Node](https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_reservation_node/src/main.cpp): `rmf_reservation_node/src/main.cpp`
- [Traffic Schedule](https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_traffic_ros2/src/rmf_traffic_schedule/main.cpp): `rmf_traffic_ros2/src/rmf_traffic_schedule/main.cpp`
- [Schedule Mirror](https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_traffic_ros2/src/rmf_traffic_ros2/schedule/MirrorManager.cpp): `rmf_traffic_ros2/src/rmf_traffic_ros2/schedule/MirrorManager.cpp`

### ROS 2 Integration

- [Charging Schedule](https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_charging_schedule/rmf_charging_schedule/main.py): `rmf_charging_schedule/rmf_charging_schedule/main.py`
- [Broadcast Client](https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_websocket/src/rmf_websocket/BroadcastClient.cpp): `rmf_websocket/src/rmf_websocket/BroadcastClient.cpp`
- [WebSocket Endpoint](https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_websocket/src/rmf_websocket/client/ClientWebSocketEndpoint.cpp): `rmf_websocket/src/rmf_websocket/client/ClientWebSocketEndpoint.cpp`
- [Reactive Streams](https://github.com/t2hopetechnik/rmf_ros2_jazzy/blob/main/rmf_fleet_adapter/rmf_rxcpp/RxCpp-4.1.0/Rx/v2/src/rxcpp/rx-observable.hpp): `rmf_fleet_adapter/rmf_rxcpp/RxCpp-4.1.0/Rx/v2/src/rxcpp/rx-observable.hpp`

### Other components

- **Fleet Operator**
- **ROS 2 System**

## Connections

- Fleet Operator → Fleet Adapter: configures
- Fleet Adapter → Argument Parsing: parses arguments (evidence: `rmf_fleet_adapter/src/full_control/main.cpp`)
- Fleet Adapter → State Estimation: uses estimation (evidence: `rmf_fleet_adapter/src/full_control/main.cpp`)
- Fleet Adapter → Fleet API: creates fleet (evidence: `rmf_fleet_adapter/src/full_control/main.cpp`)
- Fleet API → Robot Context: tracks robots (evidence: `rmf_fleet_adapter/src/rmf_fleet_adapter/agv/internal_FleetUpdateHandle.hpp`)
- Task Dispatcher → Task Auctioneer: bids tasks
- Task Manager → Fleet API: reads fleet state (evidence: `rmf_fleet_adapter/src/rmf_fleet_adapter/TaskManager.cpp`)
- Task Manager → Robot Context: manages robot tasks
- Task Manager → Task Phases: manages task phases
- Task Manager → Task Types: creates task types (evidence: `rmf_fleet_adapter/src/rmf_fleet_adapter/TaskManager.cpp`)
- Robot Context → Reservation Manager: uses reservations (evidence: `rmf_fleet_adapter/src/rmf_fleet_adapter/agv/RobotContext.hpp`)
- Reservation Manager → ROS 2 System: publishes releases (evidence: `rmf_fleet_adapter/src/rmf_fleet_adapter/agv/ReservationManager.cpp`)
- Traffic Schedule → Schedule Mirror: runs schedule mirror
- Charging Schedule → ROS 2 System: integrates with ROS 2
- Broadcast Client → WebSocket Endpoint: connects and sends (evidence: `rmf_websocket/src/rmf_websocket/BroadcastClient.cpp`)
- Fleet Adapter → Reactive Streams: uses reactive streams
- Task Dispatcher → ROS 2 System: uses ROS 2
- Traffic Schedule → ROS 2 System: runs on ROS 2
