# avon-roborioles/14954-biobuzz architecture

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

- Interactive diagram: https://gitdiagram.com/avon-roborioles/14954-biobuzz
- Repository: https://github.com/avon-roborioles/14954-biobuzz

## Overview

This repository is the Android FTC Robot Controller app and team-facing SDK starter project. The principal workflow is: a team starts the controller, completes permission validation, and uses its registered OpModes to control a competition robot; teams can also create programs in Blocks, OnBot Java, or Android Studio. The README documents sample OpModes and these programming modes, while sampled controller code shows startup, registration, service binding, and configuration access. Much of the SDK runtime is outside this tree or unsampled, so the graph keeps those boundaries explicit.

Main entry points: [`FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`](https://github.com/avon-roborioles/14954-biobuzz/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java) (Controller activity), [`FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/PermissionValidatorWrapper.java`](https://github.com/avon-roborioles/14954-biobuzz/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/PermissionValidatorWrapper.java) (Permission gate), [`FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples`](https://github.com/avon-roborioles/14954-biobuzz/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples) (Sample OpModes), [`FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller`](https://github.com/avon-roborioles/14954-biobuzz/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller) (Blocks programming)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_controller["Controller app"]
  node_permissions["Permission gate"]
  node_activity["Controller activity"]
  node_registration["OpMode registration"]
  node_runtime["FTC SDK runtime"]
  node_config["Robot configuration"]
end

subgraph group_programming["Robot programming"]
  node_blocks["Blocks programming"]
  node_onbot["OnBot Java"]
  node_androidstudio["Android Studio code"]
end

subgraph group_examples["Team examples"]
  node_samples["Sample OpModes"]
  node_teamcode["Team OpModes"]
end

node_team(("Team operator"))
node_robot{{"Competition robot"}}

node_team -->|"starts app"| node_permissions
node_permissions -->|"launches"| node_activity
node_activity -->|"creates registrar"| node_registration
node_activity -->|"binds service"| node_runtime
node_runtime -.->|"controls"| node_robot
node_team -->|"programs with"| node_blocks
node_team -->|"programs with"| node_onbot
node_team -->|"programs with"| node_androidstudio
node_activity -->|"sets runtime"| node_blocks
node_activity -->|"initializes helper"| node_onbot
node_team -->|"adapts examples"| node_samples
node_samples -->|"copy into"| node_teamcode
node_team -->|"configures robot"| node_config
node_activity -->|"opens editor"| node_config

click node_permissions "https://github.com/avon-roborioles/14954-biobuzz/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/PermissionValidatorWrapper.java"
click node_activity "https://github.com/avon-roborioles/14954-biobuzz/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java"
click node_registration "https://github.com/avon-roborioles/14954-biobuzz/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcOpModeRegister.java"
click node_blocks "https://github.com/avon-roborioles/14954-biobuzz/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller"
click node_onbot "https://github.com/avon-roborioles/14954-biobuzz/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller"
click node_androidstudio "https://github.com/avon-roborioles/14954-biobuzz/tree/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode"
click node_samples "https://github.com/avon-roborioles/14954-biobuzz/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples"
click node_teamcode "https://github.com/avon-roborioles/14954-biobuzz/tree/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode"
click node_config "https://github.com/avon-roborioles/14954-biobuzz/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java"

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_permissions,node_activity,node_registration,node_runtime,node_config toneBlue
class node_blocks,node_onbot,node_androidstudio toneAmber
class node_samples,node_teamcode toneMint
class node_team,node_robot toneIndigo
```

## Components

### Controller app

- [Permission gate](https://github.com/avon-roborioles/14954-biobuzz/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/PermissionValidatorWrapper.java): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/PermissionValidatorWrapper.java`
- [Controller activity](https://github.com/avon-roborioles/14954-biobuzz/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`
- [OpMode registration](https://github.com/avon-roborioles/14954-biobuzz/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcOpModeRegister.java): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcOpModeRegister.java`
- **FTC SDK runtime**
- [Robot configuration](https://github.com/avon-roborioles/14954-biobuzz/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`

### Robot programming

- [Blocks programming](https://github.com/avon-roborioles/14954-biobuzz/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller`
- [OnBot Java](https://github.com/avon-roborioles/14954-biobuzz/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller`
- [Android Studio code](https://github.com/avon-roborioles/14954-biobuzz/tree/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode`

### Team examples

- [Sample OpModes](https://github.com/avon-roborioles/14954-biobuzz/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples`
- [Team OpModes](https://github.com/avon-roborioles/14954-biobuzz/tree/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode`

### Other components

- **Team operator**
- **Competition robot**

## Connections

- Team operator → Permission gate: starts app (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/PermissionValidatorWrapper.java`)
- Permission gate → Controller activity: launches (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/PermissionValidatorWrapper.java`)
- Controller activity → OpMode registration: creates registrar (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`)
- Controller activity → FTC SDK runtime: binds service (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`)
- FTC SDK runtime → Competition robot: controls
- Team operator → Blocks programming: programs with (evidence: `README.md`)
- Team operator → OnBot Java: programs with (evidence: `README.md`)
- Team operator → Android Studio code: programs with (evidence: `README.md`)
- Controller activity → Blocks programming: sets runtime (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`)
- Controller activity → OnBot Java: initializes helper (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`)
- Team operator → Sample OpModes: adapts examples (evidence: `README.md`)
- Sample OpModes → Team OpModes: copy into (evidence: `README.md`)
- Team operator → Robot configuration: configures robot (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`)
- Controller activity → Robot configuration: opens editor (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`)
