# beebotv2/bee_bot_v2 architecture

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

- Interactive diagram: https://gitdiagram.com/beebotv2/bee_bot_v2
- Repository: https://github.com/beebotv2/bee_bot_v2

## Overview

Bee bot V2 is a ROS 2 mobile-manipulation robot stack, with Isaac-based reinforcement-learning environments and a host-side simulator/operator interface. A principal documented workflow is mission commands entering the mission manager, which sends execution plans to the coordinator; the manager also consumes perception signals and tracked objects. The repository tree shows broader perception, navigation, skills, hardware, and mapping capabilities. Several are unsampled, so their internal links are omitted; the README provides no additional architecture detail.

Main entry points: [`lv2_module6/isaac/rl/bee_isaac/tasks/slot_env.py`](https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/isaac/rl/bee_isaac/tasks/slot_env.py) (Slot environment), [`lv2_module6/ros2_ws/src/plan/src/mission_manager.cpp`](https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/ros2_ws/src/plan/src/mission_manager.cpp) (Mission manager), [`lv2_module6/tools/cli/operator_tool.py`](https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/tools/cli/operator_tool.py) (Operator CLI), [`lv2_module6/isaac/rl/bee_isaac/common.py`](https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/isaac/rl/bee_isaac/common.py) (Isaac shared models)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mission["Mission execution"]
  node_mission_manager["Mission manager"]
  node_mission_solver["Mission solver<br/>[mission_solver.hpp]"]
  node_coordinator["Plan coordinator<br/>[coordinator.cpp]"]
  node_skills["Robot skills"]
end

subgraph group_robot["Robot runtime"]
  node_perception["Perception"]
  node_state_manager["State manager<br/>[state_manager.cpp]"]
  node_control["Hardware control"]
  node_navigation["RL navigation"]
  node_mapping["Mapping and SLAM"]
end

subgraph group_learning["Learning and simulation"]
  node_isaac_common["Isaac shared models<br/>[common.py]"]
  node_pick_env["Pick environment<br/>[pick_env.py]"]
  node_place_env["Place environment<br/>[place_env.py]"]
  node_slot_env["Slot environment<br/>[slot_env.py]"]
  node_simulator["Host simulator<br/>[main.py]"]
end

subgraph group_operator["Operator tooling"]
  node_operator["Operator CLI<br/>[operator_tool.py]"]
  node_cli_bus["CLI bus commands<br/>[bus.py]"]
  node_monitor["Topic monitor"]
  node_input["Topic input<br/>[input_manager.cpp]"]
end

node_mission_cmd(("Mission command"))

node_mission_cmd -->|"commands"| node_mission_manager
node_mission_manager -->|"sends plans"| node_coordinator
node_mission_manager -->|"parses starts"| node_mission_solver
node_pick_env -->|"imports"| node_isaac_common
node_place_env -->|"imports"| node_isaac_common
node_slot_env -->|"imports"| node_isaac_common
node_slot_env -->|"imports"| node_pick_env
node_slot_env -->|"imports"| node_place_env
node_simulator -->|"reads debug files"| node_monitor
node_input -.->|"reads input files"| node_simulator
node_operator -->|"loads fake bus"| node_cli_bus
node_operator -->|"subscribes state"| node_state_manager
node_monitor -->|"writes debug output"| node_operator
node_input -.->|"publishes topic input"| node_state_manager

click node_mission_manager "https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/ros2_ws/src/plan/src/mission_manager.cpp"
click node_mission_solver "https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/ros2_ws/src/plan/include/plan/mission_solver.hpp"
click node_coordinator "https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/ros2_ws/src/plan/src/coordinator.cpp"
click node_skills "https://github.com/beebotv2/bee_bot_v2/tree/develop/lv2_module6/ros2_ws/src/skills"
click node_perception "https://github.com/beebotv2/bee_bot_v2/tree/develop/lv2_module6/ros2_ws/src/perception"
click node_state_manager "https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/ros2_ws/src/manager/src/state_manager.cpp"
click node_control "https://github.com/beebotv2/bee_bot_v2/tree/develop/lv2_module6/ros2_ws/src/control"
click node_navigation "https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/ros2_ws/src/ml/src/rl_nav_controller.cpp"
click node_mapping "https://github.com/beebotv2/bee_bot_v2/tree/develop/lv2_module6/ros2_ws/src/ros_system"
click node_isaac_common "https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/isaac/rl/bee_isaac/common.py"
click node_pick_env "https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/isaac/rl/bee_isaac/tasks/pick_env.py"
click node_place_env "https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/isaac/rl/bee_isaac/tasks/place_env.py"
click node_slot_env "https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/isaac/rl/bee_isaac/tasks/slot_env.py"
click node_simulator "https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/tools/cli/ros/docker/vazebo/main.py"
click node_operator "https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/tools/cli/operator_tool.py"
click node_cli_bus "https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/tools/cli/op/bus.py"
click node_monitor "https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/ros2_ws/src/faker/src/monitor_manager.cpp"
click node_input "https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/ros2_ws/src/faker/src/input_manager.cpp"

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_mission_manager,node_mission_solver,node_coordinator,node_skills toneBlue
class node_perception,node_state_manager,node_control,node_navigation,node_mapping toneAmber
class node_isaac_common,node_pick_env,node_place_env,node_slot_env,node_simulator toneMint
class node_operator,node_cli_bus,node_monitor,node_input toneRose
class node_mission_cmd toneIndigo
```

## Components

### Mission execution

- [Mission manager](https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/ros2_ws/src/plan/src/mission_manager.cpp): `lv2_module6/ros2_ws/src/plan/src/mission_manager.cpp`
- [Mission solver](https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/ros2_ws/src/plan/include/plan/mission_solver.hpp): `lv2_module6/ros2_ws/src/plan/include/plan/mission_solver.hpp`
- [Plan coordinator](https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/ros2_ws/src/plan/src/coordinator.cpp): `lv2_module6/ros2_ws/src/plan/src/coordinator.cpp`
- [Robot skills](https://github.com/beebotv2/bee_bot_v2/tree/develop/lv2_module6/ros2_ws/src/skills): `lv2_module6/ros2_ws/src/skills`

### Robot runtime

- [Perception](https://github.com/beebotv2/bee_bot_v2/tree/develop/lv2_module6/ros2_ws/src/perception): `lv2_module6/ros2_ws/src/perception`
- [State manager](https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/ros2_ws/src/manager/src/state_manager.cpp): `lv2_module6/ros2_ws/src/manager/src/state_manager.cpp`
- [Hardware control](https://github.com/beebotv2/bee_bot_v2/tree/develop/lv2_module6/ros2_ws/src/control): `lv2_module6/ros2_ws/src/control`
- [RL navigation](https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/ros2_ws/src/ml/src/rl_nav_controller.cpp): `lv2_module6/ros2_ws/src/ml/src/rl_nav_controller.cpp`
- [Mapping and SLAM](https://github.com/beebotv2/bee_bot_v2/tree/develop/lv2_module6/ros2_ws/src/ros_system): `lv2_module6/ros2_ws/src/ros_system`

### Learning and simulation

- [Isaac shared models](https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/isaac/rl/bee_isaac/common.py): `lv2_module6/isaac/rl/bee_isaac/common.py`
- [Pick environment](https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/isaac/rl/bee_isaac/tasks/pick_env.py): `lv2_module6/isaac/rl/bee_isaac/tasks/pick_env.py`
- [Place environment](https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/isaac/rl/bee_isaac/tasks/place_env.py): `lv2_module6/isaac/rl/bee_isaac/tasks/place_env.py`
- [Slot environment](https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/isaac/rl/bee_isaac/tasks/slot_env.py): `lv2_module6/isaac/rl/bee_isaac/tasks/slot_env.py`
- [Host simulator](https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/tools/cli/ros/docker/vazebo/main.py): `lv2_module6/tools/cli/ros/docker/vazebo/main.py`

### Operator tooling

- [Operator CLI](https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/tools/cli/operator_tool.py): `lv2_module6/tools/cli/operator_tool.py`
- [CLI bus commands](https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/tools/cli/op/bus.py): `lv2_module6/tools/cli/op/bus.py`
- [Topic monitor](https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/ros2_ws/src/faker/src/monitor_manager.cpp): `lv2_module6/ros2_ws/src/faker/src/monitor_manager.cpp`
- [Topic input](https://github.com/beebotv2/bee_bot_v2/blob/develop/lv2_module6/ros2_ws/src/faker/src/input_manager.cpp): `lv2_module6/ros2_ws/src/faker/src/input_manager.cpp`

### Other components

- **Mission command**

## Connections

- Mission command → Mission manager: commands
- Mission manager → Plan coordinator: sends plans
- Mission manager → Mission solver: parses starts
- Pick environment → Isaac shared models: imports (evidence: `lv2_module6/isaac/rl/bee_isaac/tasks/pick_env.py`)
- Place environment → Isaac shared models: imports (evidence: `lv2_module6/isaac/rl/bee_isaac/tasks/place_env.py`)
- Slot environment → Isaac shared models: imports (evidence: `lv2_module6/isaac/rl/bee_isaac/tasks/slot_env.py`)
- Slot environment → Pick environment: imports (evidence: `lv2_module6/isaac/rl/bee_isaac/tasks/slot_env.py`)
- Slot environment → Place environment: imports (evidence: `lv2_module6/isaac/rl/bee_isaac/tasks/slot_env.py`)
- Host simulator → Topic monitor: reads debug files (evidence: `lv2_module6/tools/cli/ros/docker/vazebo/main.py`)
- Topic input → Host simulator: reads input files
- Operator CLI → CLI bus commands: loads fake bus (evidence: `lv2_module6/tools/cli/operator_tool.py`)
- Operator CLI → State manager: subscribes state (evidence: `lv2_module6/tools/cli/operator_tool.py`)
- Topic monitor → Operator CLI: writes debug output
- Topic input → State manager: publishes topic input
