# neweraexploration/project-life-13062 architecture

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

- Interactive diagram: https://gitdiagram.com/neweraexploration/project-life-13062
- Repository: https://github.com/neweraexploration/project-life-13062

## Overview

This repository is a hands-on robotics course, with lecture-specific ESP32 sketches and resources rather than one unified application. Its principal runtime workflow is browser commands sent over WebSocket to an ESP32 handler, then dispatched to direct motor movement or increasingly capable robot-control routines. The course progresses from MPU6050/PID foundations through Wi-Fi control, heading-based turns, and estimated-distance motion. Sampled code supports the web-handler and robot-control relationships shown; links involving unsampled sketches and hardware documentation are limited to README evidence or omitted.

Main entry points: [`13062 L3/Codes/L3-Straightline-Turn/webhandler.h`](https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L3/Codes/L3-Straightline-Turn/webhandler.h) (L3 command handler), [`13062 L4/Codes/L4_Exact_Distance/webhandler.h`](https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L4/Codes/L4_Exact_Distance/webhandler.h) (L4 command handler), [`13062 L1/Codes/MPU_PID_CI/MPU_PID_CI.ino`](https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L1/Codes/MPU_PID_CI/MPU_PID_CI.ino) (L1 MPU/PID sketch), [`13062 L2/Codes/WEBSERVER-ESPROBOT/webhandler.h`](https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L2/Codes/WEBSERVER-ESPROBOT/webhandler.h) (L2 command handler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_course["Course Resources"]
  node_circuit["Circuit diagrams"]
  node_course_resources["Course resources"]
end

subgraph group_basics["IMU and PID"]
  node_l1_sketch["L1 MPU/PID sketch<br/>[MPU_PID_CI.ino]"]
  node_l1_imu["L1 MPU6050 interface<br/>[MPU.h]"]
  node_l1_pid["L1 PID library<br/>[PID.h]"]
end

subgraph group_web["Web Control"]
  node_l2_page["L2 control page<br/>[Interface.h]"]
  node_l2_handler["L2 command handler<br/>[webhandler.h]"]
  node_l2_motors["L2 motor control<br/>[motorcontrol.h]"]
  node_l2_debug["L2 debug messages<br/>[debugger.h]"]
  node_l3_page["L3 control page<br/>[Interface.h]"]
  node_l3_handler["L3 command handler<br/>[webhandler.h]"]
  node_l3_debug["L3 debug messages<br/>[debugger.h]"]
  node_l4_page["L4 control page<br/>[Interface.h]"]
  node_l4_handler["L4 command handler<br/>[webhandler.h]"]
  node_l4_debug["L4 debug messages<br/>[debugger.h]"]
end

subgraph group_navigation["Robot Navigation"]
  node_l3_nav["L3 movement routines<br/>[robotcontrol.h]"]
  node_l3_motors["L3 motor control<br/>[motorcontrol.h]"]
  node_l4_nav["L4 distance routines<br/>[robotcontrol.h]"]
  node_l4_motors["L4 motor control<br/>[motorcontrol.h]"]
end

node_learner(("Course learner"))
node_browser(("Browser controls"))

node_learner -->|"studies course"| node_course_resources
node_learner -->|"builds from"| node_circuit
node_learner -->|"uploads sketch"| node_l1_sketch
node_l1_sketch -.->|"uses IMU"| node_l1_imu
node_l1_sketch -.->|"uses PID"| node_l1_pid
node_browser -->|"uses controls"| node_l2_page
node_l2_page -->|"sends commands"| node_l2_handler
node_l2_handler -->|"dispatches movement"| node_l2_motors
node_l2_handler -->|"sends debug"| node_l2_debug
node_browser -->|"uses controls"| node_l3_page
node_l3_page -->|"sends commands"| node_l3_handler
node_l3_handler -->|"dispatches motion"| node_l3_nav
node_l3_handler -->|"dispatches movement"| node_l3_motors
node_l3_handler -->|"sends debug"| node_l3_debug
node_l3_nav -->|"sets motor output"| node_l3_motors
node_browser -->|"uses controls"| node_l4_page
node_l4_page -->|"sends commands"| node_l4_handler
node_l4_handler -->|"dispatches motion"| node_l4_nav
node_l4_handler -->|"dispatches movement"| node_l4_motors
node_l4_handler -->|"sends debug"| node_l4_debug
node_l4_nav -->|"sets motor output"| node_l4_motors

click node_circuit "https://github.com/neweraexploration/project-life-13062/tree/main/13062%20L2/Circuit%20Diagrams"
click node_course_resources "https://github.com/neweraexploration/project-life-13062/tree/main/13062%20L2/Resources"
click node_l1_sketch "https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L1/Codes/MPU_PID_CI/MPU_PID_CI.ino"
click node_l1_imu "https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L1/Codes/MPU_PID_CI/MPU.h"
click node_l1_pid "https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L1/Codes/MPU_PID_CI/PID.h"
click node_l2_page "https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L2/Codes/WEBSERVER-ESPROBOT/Interface.h"
click node_l2_handler "https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L2/Codes/WEBSERVER-ESPROBOT/webhandler.h"
click node_l2_motors "https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L2/Codes/WEBSERVER-ESPROBOT/motorcontrol.h"
click node_l2_debug "https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L2/Codes/WEBSERVER-ESPROBOT/debugger.h"
click node_l3_page "https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L3/Codes/L3-Straightline-Turn/Interface.h"
click node_l3_handler "https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L3/Codes/L3-Straightline-Turn/webhandler.h"
click node_l3_nav "https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L3/Codes/L3-Straightline-Turn/robotcontrol.h"
click node_l3_motors "https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L3/Codes/L3-Straightline-Turn/motorcontrol.h"
click node_l3_debug "https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L3/Codes/L3-Straightline-Turn/debugger.h"
click node_l4_page "https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L4/Codes/L4_Exact_Distance/Interface.h"
click node_l4_handler "https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L4/Codes/L4_Exact_Distance/webhandler.h"
click node_l4_nav "https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L4/Codes/L4_Exact_Distance/robotcontrol.h"
click node_l4_motors "https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L4/Codes/L4_Exact_Distance/motorcontrol.h"
click node_l4_debug "https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L4/Codes/L4_Exact_Distance/debugger.h"

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_circuit,node_course_resources,node_browser toneBlue
class node_l1_sketch,node_l1_imu,node_l1_pid toneAmber
class node_l2_page,node_l2_handler,node_l2_motors,node_l2_debug,node_l3_page,node_l3_handler,node_l3_debug,node_l4_page,node_l4_handler,node_l4_debug toneMint
class node_l3_nav,node_l3_motors,node_l4_nav,node_l4_motors toneRose
class node_learner toneIndigo
```

## Components

### Course Resources

- [Circuit diagrams](https://github.com/neweraexploration/project-life-13062/tree/main/13062%20L2/Circuit%20Diagrams): `13062 L2/Circuit Diagrams`
- [Course resources](https://github.com/neweraexploration/project-life-13062/tree/main/13062%20L2/Resources): `13062 L2/Resources`

### IMU and PID

- [L1 MPU/PID sketch](https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L1/Codes/MPU_PID_CI/MPU_PID_CI.ino): `13062 L1/Codes/MPU_PID_CI/MPU_PID_CI.ino`
- [L1 MPU6050 interface](https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L1/Codes/MPU_PID_CI/MPU.h): `13062 L1/Codes/MPU_PID_CI/MPU.h`
- [L1 PID library](https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L1/Codes/MPU_PID_CI/PID.h): `13062 L1/Codes/MPU_PID_CI/PID.h`

### Web Control

- [L2 control page](https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L2/Codes/WEBSERVER-ESPROBOT/Interface.h): `13062 L2/Codes/WEBSERVER-ESPROBOT/Interface.h`
- [L2 command handler](https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L2/Codes/WEBSERVER-ESPROBOT/webhandler.h): `13062 L2/Codes/WEBSERVER-ESPROBOT/webhandler.h`
- [L2 motor control](https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L2/Codes/WEBSERVER-ESPROBOT/motorcontrol.h): `13062 L2/Codes/WEBSERVER-ESPROBOT/motorcontrol.h`
- [L2 debug messages](https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L2/Codes/WEBSERVER-ESPROBOT/debugger.h): `13062 L2/Codes/WEBSERVER-ESPROBOT/debugger.h`
- [L3 control page](https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L3/Codes/L3-Straightline-Turn/Interface.h): `13062 L3/Codes/L3-Straightline-Turn/Interface.h`
- [L3 command handler](https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L3/Codes/L3-Straightline-Turn/webhandler.h): `13062 L3/Codes/L3-Straightline-Turn/webhandler.h`
- [L3 debug messages](https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L3/Codes/L3-Straightline-Turn/debugger.h): `13062 L3/Codes/L3-Straightline-Turn/debugger.h`
- [L4 control page](https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L4/Codes/L4_Exact_Distance/Interface.h): `13062 L4/Codes/L4_Exact_Distance/Interface.h`
- [L4 command handler](https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L4/Codes/L4_Exact_Distance/webhandler.h): `13062 L4/Codes/L4_Exact_Distance/webhandler.h`
- [L4 debug messages](https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L4/Codes/L4_Exact_Distance/debugger.h): `13062 L4/Codes/L4_Exact_Distance/debugger.h`

### Robot Navigation

- [L3 movement routines](https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L3/Codes/L3-Straightline-Turn/robotcontrol.h): `13062 L3/Codes/L3-Straightline-Turn/robotcontrol.h`
- [L3 motor control](https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L3/Codes/L3-Straightline-Turn/motorcontrol.h): `13062 L3/Codes/L3-Straightline-Turn/motorcontrol.h`
- [L4 distance routines](https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L4/Codes/L4_Exact_Distance/robotcontrol.h): `13062 L4/Codes/L4_Exact_Distance/robotcontrol.h`
- [L4 motor control](https://github.com/neweraexploration/project-life-13062/blob/main/13062%20L4/Codes/L4_Exact_Distance/motorcontrol.h): `13062 L4/Codes/L4_Exact_Distance/motorcontrol.h`

### Other components

- **Course learner**
- **Browser controls**

## Connections

- Course learner → Course resources: studies course (evidence: `README.md`)
- Course learner → Circuit diagrams: builds from (evidence: `README.md`)
- Course learner → L1 MPU/PID sketch: uploads sketch (evidence: `README.md`)
- L1 MPU/PID sketch → L1 MPU6050 interface: uses IMU
- L1 MPU/PID sketch → L1 PID library: uses PID
- Browser controls → L2 control page: uses controls (evidence: `13062 L2/Codes/WEBSERVER-ESPROBOT/Interface.h`)
- L2 control page → L2 command handler: sends commands (evidence: `13062 L2/Codes/WEBSERVER-ESPROBOT/Interface.h`)
- L2 command handler → L2 motor control: dispatches movement (evidence: `13062 L2/Codes/WEBSERVER-ESPROBOT/webhandler.h`)
- L2 command handler → L2 debug messages: sends debug (evidence: `13062 L2/Codes/WEBSERVER-ESPROBOT/webhandler.h`)
- Browser controls → L3 control page: uses controls (evidence: `13062 L3/Codes/L3-Straightline-Turn/Interface.h`)
- L3 control page → L3 command handler: sends commands (evidence: `13062 L3/Codes/L3-Straightline-Turn/Interface.h`)
- L3 command handler → L3 movement routines: dispatches motion (evidence: `13062 L3/Codes/L3-Straightline-Turn/webhandler.h`)
- L3 command handler → L3 motor control: dispatches movement (evidence: `13062 L3/Codes/L3-Straightline-Turn/webhandler.h`)
- L3 command handler → L3 debug messages: sends debug (evidence: `13062 L3/Codes/L3-Straightline-Turn/webhandler.h`)
- L3 movement routines → L3 motor control: sets motor output (evidence: `13062 L3/Codes/L3-Straightline-Turn/robotcontrol.h`)
- Browser controls → L4 control page: uses controls (evidence: `13062 L4/Codes/L4_Exact_Distance/Interface.h`)
- L4 control page → L4 command handler: sends commands (evidence: `13062 L4/Codes/L4_Exact_Distance/Interface.h`)
- L4 command handler → L4 distance routines: dispatches motion (evidence: `13062 L4/Codes/L4_Exact_Distance/webhandler.h`)
- L4 command handler → L4 motor control: dispatches movement (evidence: `13062 L4/Codes/L4_Exact_Distance/webhandler.h`)
- L4 command handler → L4 debug messages: sends debug (evidence: `13062 L4/Codes/L4_Exact_Distance/webhandler.h`)
- L4 distance routines → L4 motor control: sets motor output (evidence: `13062 L4/Codes/L4_Exact_Distance/robotcontrol.h`)
