# leoabubucker/towson_terminators_codebase architecture

> Architecture diagram of the GitHub repository leoabubucker/towson_terminators_codebase, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/leoabubucker/towson_terminators_codebase
- Repository: https://github.com/leoabubucker/towson_terminators_codebase

## Overview

##### Project Type and Main Components
This is a multi-purpose robotics software repository containing:
- Competitive VEX robotics code (C++)
- Non-competitive VEX robotics code (C++)
- An attendance tracking application (Python)
- Multiple seasons of code (2021-Present)
- Both VEX API and PROS API implementations

**[Towson Terminators Codebase]**

**[Competitive] [Non-Competitive] [Attendance Tracker]**

**[Project Layer]**

**[API Layer (VEX/PROS)]**

**[Implementation Layer]**
- /    |    \
**[Source] [Headers] [Config]**

##### Implementation Notes

- Clear separation between competitive and non-competitive code
- API version transitions
- Season-based organization
- Build system integration
- Code reuse patterns
- Documentation links

##### Architectural Patterns

Highlight:
- Modular design approach
- Season-based versioning
- API abstraction layers
- Configuration management
- Build system integration
- Documentation integration

This system design should provide a clear understanding of the codebase's structure while maintaining the appropriate level of detail for a principal software engineer to understand the overall architecture and relationships between components.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Main Project Container
    subgraph TT["Towson Terminators Codebase"]
        %% Main Sections
        CC["Competitive Code"]:::competitive
        NC["Non-Competitive Code"]:::noncompetitive
        AT["Attendance Tracker"]:::attendance

        %% Competitive Code Structure
        subgraph CompCode["Competitive Code Seasons"]
            C2122["2021-2022"]:::competitive
            C2223["2022-2023"]:::competitive
            C2324["2023-2024"]:::competitive
            C2425["2024-2025"]:::competitive
        end

        %% Non-Competitive Code Structure
        subgraph NonCompCode["Non-Competitive Code Seasons"]
            NC2122["2021-2022"]:::noncompetitive
            NC2324["2023-2024"]:::noncompetitive
            NC2425["2024-2025"]:::noncompetitive
        end

        %% API Integration
        subgraph APIs["API Integration"]
            VAPI["VEX API"]:::api
            PAPI["PROS API"]:::api
        end

        %% Source Structure
        subgraph CodeStructure["Code Structure"]
            SRC["Source Files"]:::source
            HDR["Header Files"]:::header
            CFG["Build Configuration"]:::config
        end

        %% Attendance Tracker Components
        subgraph AttTracker["Attendance System"]
            APP["Main Application"]:::attendance
            DOC["Documentation"]:::doc
        end
    end

    %% Relationships
    CC --> CompCode
    NC --> NonCompCode
    CC --> APIs
    NC --> APIs
    VAPI --> CodeStructure
    PAPI --> CodeStructure

    %% Click Events
    click CC "https://github.com/leoabubucker/Towson_Terminators_Codebase/tree/master/Competitive_Code"
    click NC "https://github.com/leoabubucker/Towson_Terminators_Codebase/tree/master/Non-Competitive_Code"
    click AT "https://github.com/leoabubucker/Towson_Terminators_Codebase/tree/master/Attendance_Tracker"
    click C2122 "https://github.com/leoabubucker/Towson_Terminators_Codebase/tree/master/Competitive_Code/2021-2022"
    click C2223 "https://github.com/leoabubucker/Towson_Terminators_Codebase/tree/master/Competitive_Code/2022-2023"
    click C2324 "https://github.com/leoabubucker/Towson_Terminators_Codebase/tree/master/Competitive_Code/2023-2024"
    click C2425 "https://github.com/leoabubucker/Towson_Terminators_Codebase/tree/master/Competitive_Code/2024-2025"
    click NC2122 "https://github.com/leoabubucker/Towson_Terminators_Codebase/tree/master/Non-Competitive_Code/2021-2022"
    click NC2324 "https://github.com/leoabubucker/Towson_Terminators_Codebase/tree/master/Non-Competitive_Code/2023-2024"
    click NC2425 "https://github.com/leoabubucker/Towson_Terminators_Codebase/tree/master/Non-Competitive_Code/2024-2025"
    click APP "https://github.com/leoabubucker/Towson_Terminators_Codebase/blob/master/Attendance_Tracker/app.py"
    click DOC "https://github.com/leoabubucker/Towson_Terminators_Codebase/blob/master/Attendance_Tracker/AttendanceTracker_README.md"
    click VAPI "https://github.com/leoabubucker/Towson_Terminators_Codebase/blob/master/Competitive_Code/2023-2024/H2H_23-24/vex/mkenv.mk"
    click PAPI "https://github.com/leoabubucker/Towson_Terminators_Codebase/tree/master/Competitive_Code/2024-2025/934A Pros"
    click SRC "https://github.com/leoabubucker/Towson_Terminators_Codebase/blob/master/Competitive_Code/2023-2024/H2H_23-24/src/main.cpp"
    click HDR "https://github.com/leoabubucker/Towson_Terminators_Codebase/blob/master/Competitive_Code/2023-2024/H2H_23-24/include/vex.h"
    click CFG "https://github.com/leoabubucker/Towson_Terminators_Codebase/tree/master/Competitive_Code/2023-2024/H2H_23-24/makefile"

    %% Styling
    classDef competitive fill:#3498db,stroke:#2980b9,color:white
    classDef noncompetitive fill:#2ecc71,stroke:#27ae60,color:white
    classDef attendance fill:#e67e22,stroke:#d35400,color:white
    classDef api fill:#9b59b6,stroke:#8e44ad,color:white
    classDef config fill:#95a5a6,stroke:#7f8c8d,color:white
    classDef source fill:#f1c40f,stroke:#f39c12,color:black
    classDef header fill:#e74c3c,stroke:#c0392b,color:white
    classDef doc fill:#1abc9c,stroke:#16a085,color:white
```
