# iustin0909/ftc21030-2026 architecture

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

- Interactive diagram: https://gitdiagram.com/iustin0909/ftc21030-2026
- Repository: https://github.com/iustin0909/ftc21030-2026

## Overview

This is the FTC DECODE-season Android robot-control SDK, alongside a sample TeamCode robot implementation. The principal team workflow is a Driver Station-selected OpMode starting the robot, mapping hardware, then translating gamepad input into subsystem actions and telemetry. The repository also supports programming through Blocks, OnBot Java, or Android Studio and includes broad hardware and vision samples. Some SDK services are only visible through the controller activity excerpt and README; their internal implementation is not represented here.

Main entry points: [`TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_03_Robot/Robot.java`](https://github.com/iustin0909/ftc21030-2026/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_03_Robot/Robot.java) (Robot coordinator), [`TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_06_OpMode/TeleOp/program.java`](https://github.com/iustin0909/ftc21030-2026/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_06_OpMode/TeleOp/program.java) (TeleOp entry), [`FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`](https://github.com/iustin0909/ftc21030-2026/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java) (Controller activity), [`TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_04_Drivers`](https://github.com/iustin0909/ftc21030-2026/tree/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_04_Drivers) (Gamepad drivers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_controller["Robot Controller"]
  node_activity["Controller activity"]
  node_permissions["Permission validation"]
  node_opmode_register["OpMode registration"]
end

subgraph group_teamcode["Team Robot Code"]
  node_teleop["TeleOp entry<br/>[program.java]"]
  node_autonomous["Autonomous entry<br/>[program.java]"]
  node_drivers["Gamepad drivers"]
  node_robot["Robot coordinator<br/>[Robot.java]"]
  node_telemetry["Telemetry manager"]
end

subgraph group_hardware["Robot Subsystems"]
  node_actions["Subsystem actions"]
  node_hardware_map["Hardware mappings"]
  node_parameters["Hardware parameters"]
end

subgraph group_examples["SDK Programming"]
  node_blocks["Blocks programming"]
  node_onbot["OnBot Java"]
  node_samples["SDK OpMode samples"]
end

node_operator(("Robot operator"))
node_team_programmer(("Team programmer"))

node_activity -->|"validates access"| node_permissions
node_activity -->|"creates registry"| node_opmode_register
node_operator -->|"uses controller"| node_activity
node_operator -.->|"selects OpMode"| node_teleop
node_teleop -->|"starts robot"| node_robot
node_autonomous -->|"uses robot"| node_robot
node_teleop -->|"dispatches control"| node_drivers
node_teleop -->|"updates telemetry"| node_telemetry
node_drivers -->|"commands subsystems"| node_robot
node_robot -->|"constructs actions"| node_actions
node_actions -->|"extends mappings"| node_hardware_map
node_hardware_map -->|"uses configuration"| node_parameters
node_telemetry -->|"reads subsystem state"| node_robot
node_team_programmer -->|"programs with"| node_blocks
node_team_programmer -->|"programs with"| node_onbot
node_team_programmer -->|"adapts examples"| node_samples

click node_activity "https://github.com/iustin0909/ftc21030-2026/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java"
click node_permissions "https://github.com/iustin0909/ftc21030-2026/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/PermissionValidatorWrapper.java"
click node_opmode_register "https://github.com/iustin0909/ftc21030-2026/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcOpModeRegister.java"
click node_teleop "https://github.com/iustin0909/ftc21030-2026/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_06_OpMode/TeleOp/program.java"
click node_autonomous "https://github.com/iustin0909/ftc21030-2026/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_06_OpMode/Auto/program.java"
click node_drivers "https://github.com/iustin0909/ftc21030-2026/tree/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_04_Drivers"
click node_robot "https://github.com/iustin0909/ftc21030-2026/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_03_Robot/Robot.java"
click node_telemetry "https://github.com/iustin0909/ftc21030-2026/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_05_Telemetry/TelemetryManager.java"
click node_actions "https://github.com/iustin0909/ftc21030-2026/tree/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_02_Actions"
click node_hardware_map "https://github.com/iustin0909/ftc21030-2026/tree/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_01_Hardware"
click node_parameters "https://github.com/iustin0909/ftc21030-2026/tree/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_00_Parameters"
click node_blocks "https://github.com/iustin0909/ftc21030-2026/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java"
click node_onbot "https://github.com/iustin0909/ftc21030-2026/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java"
click node_samples "https://github.com/iustin0909/ftc21030-2026/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples"

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_activity,node_permissions,node_opmode_register toneBlue
class node_teleop,node_autonomous,node_drivers,node_robot,node_telemetry toneAmber
class node_actions,node_hardware_map,node_parameters toneMint
class node_blocks,node_onbot,node_samples toneRose
class node_operator,node_team_programmer toneIndigo
```

## Components

### Robot Controller

- [Controller activity](https://github.com/iustin0909/ftc21030-2026/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`
- [Permission validation](https://github.com/iustin0909/ftc21030-2026/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/PermissionValidatorWrapper.java): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/PermissionValidatorWrapper.java`
- [OpMode registration](https://github.com/iustin0909/ftc21030-2026/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcOpModeRegister.java): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcOpModeRegister.java`

### Team Robot Code

- [TeleOp entry](https://github.com/iustin0909/ftc21030-2026/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_06_OpMode/TeleOp/program.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_06_OpMode/TeleOp/program.java`
- [Autonomous entry](https://github.com/iustin0909/ftc21030-2026/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_06_OpMode/Auto/program.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_06_OpMode/Auto/program.java`
- [Gamepad drivers](https://github.com/iustin0909/ftc21030-2026/tree/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_04_Drivers): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_04_Drivers`
- [Robot coordinator](https://github.com/iustin0909/ftc21030-2026/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_03_Robot/Robot.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_03_Robot/Robot.java`
- [Telemetry manager](https://github.com/iustin0909/ftc21030-2026/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_05_Telemetry/TelemetryManager.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_05_Telemetry/TelemetryManager.java`

### Robot Subsystems

- [Subsystem actions](https://github.com/iustin0909/ftc21030-2026/tree/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_02_Actions): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_02_Actions`
- [Hardware mappings](https://github.com/iustin0909/ftc21030-2026/tree/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_01_Hardware): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_01_Hardware`
- [Hardware parameters](https://github.com/iustin0909/ftc21030-2026/tree/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_00_Parameters): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_00_Parameters`

### SDK Programming

- [Blocks programming](https://github.com/iustin0909/ftc21030-2026/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`
- [OnBot Java](https://github.com/iustin0909/ftc21030-2026/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`
- [SDK OpMode samples](https://github.com/iustin0909/ftc21030-2026/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples`

### Other components

- **Robot operator**
- **Team programmer**

## Connections

- Controller activity → Permission validation: validates access (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`)
- Controller activity → OpMode registration: creates registry (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`)
- Robot operator → Controller activity: uses controller (evidence: `README.md`)
- Robot operator → TeleOp entry: selects OpMode
- TeleOp entry → Robot coordinator: starts robot (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_06_OpMode/TeleOp/program.java`)
- Autonomous entry → Robot coordinator: uses robot (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_06_OpMode/Auto/program.java`)
- TeleOp entry → Gamepad drivers: dispatches control (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_06_OpMode/TeleOp/program.java`)
- TeleOp entry → Telemetry manager: updates telemetry (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_06_OpMode/TeleOp/program.java`)
- Gamepad drivers → Robot coordinator: commands subsystems (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_04_Drivers/FirstDriver.java`)
- Robot coordinator → Subsystem actions: constructs actions (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_03_Robot/Robot.java`)
- Subsystem actions → Hardware mappings: extends mappings (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_02_Actions/DrivetrainActions.java`)
- Hardware mappings → Hardware parameters: uses configuration (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_01_Hardware/ArmHardware.java`)
- Telemetry manager → Robot coordinator: reads subsystem state (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/_05_Telemetry/TelemetryManager.java`)
- Team programmer → Blocks programming: programs with (evidence: `README.md`)
- Team programmer → OnBot Java: programs with (evidence: `README.md`)
- Team programmer → SDK OpMode samples: adapts examples (evidence: `README.md`)
