# psu-edu/agile_stem_basic_game architecture

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

- Interactive diagram: https://gitdiagram.com/psu-edu/agile_stem_basic_game
- Repository: https://github.com/psu-edu/agile_stem_basic_game

## Overview

AGILE STEM is a Unity-based, game-based STEM learning environment centered on operating a simulated production system. The documented learner workflow is to select a level, configure bottle orders and production controls, then observe forklifts and conveyor lanes move and process bottles. The README also describes free play, tutorials, buffer gates, and adaptable content. The tree shows no game-specific source files, so nodes use the existing Assets directory as the only supported enclosing path; edges reflect README documentation, not inspected runtime calls.

Main entry points: [`AGILE_STEM_GAME/Assets`](https://github.com/psu-edu/agile_stem_basic_game/tree/main/AGILE_STEM_GAME/Assets) (Production controls)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Learning experience"]
  node_level["Levels and free play"]
  node_tutorial["Tutorial system"]
  node_adaptation["Adaptable content"]
end

subgraph group_planning["Production planning"]
  node_orderui["Order menu"]
  node_orderqueue["Production orders"]
  node_controls["Production controls"]
end

subgraph group_simulation["Facility simulation"]
  node_facility["Production facility"]
  node_forklift["Forklift delivery"]
  node_bottles["Bottle flow"]
  node_conveyors["Conveyor lanes"]
  node_buffer["Conveyor buffer"]
end

node_learner(("Learner"))

node_learner -->|"selects"| node_level
node_learner -->|"uses"| node_tutorial
node_learner -->|"configures"| node_orderui
node_learner -->|"adjusts"| node_controls
node_level -->|"resets level"| node_facility
node_orderui -->|"sets orders"| node_orderqueue
node_orderqueue -->|"guides delivery"| node_forklift
node_forklift -->|"brings into system"| node_bottles
node_controls -->|"sets speed"| node_conveyors
node_controls -->|"sets release rate"| node_bottles
node_controls -->|"controls gates"| node_buffer
node_bottles -->|"moves along"| node_conveyors
node_conveyors -->|"feeds buffer"| node_buffer
node_adaptation -.->|"adapts content"| node_level

click node_level "https://github.com/psu-edu/agile_stem_basic_game/tree/main/AGILE_STEM_GAME/Assets"
click node_tutorial "https://github.com/psu-edu/agile_stem_basic_game/tree/main/AGILE_STEM_GAME/Assets"
click node_adaptation "https://github.com/psu-edu/agile_stem_basic_game/tree/main/AGILE_STEM_GAME/Assets"
click node_orderui "https://github.com/psu-edu/agile_stem_basic_game/tree/main/AGILE_STEM_GAME/Assets"
click node_orderqueue "https://github.com/psu-edu/agile_stem_basic_game/tree/main/AGILE_STEM_GAME/Assets"
click node_controls "https://github.com/psu-edu/agile_stem_basic_game/tree/main/AGILE_STEM_GAME/Assets"
click node_facility "https://github.com/psu-edu/agile_stem_basic_game/tree/main/AGILE_STEM_GAME/Assets"
click node_forklift "https://github.com/psu-edu/agile_stem_basic_game/tree/main/AGILE_STEM_GAME/Assets"
click node_bottles "https://github.com/psu-edu/agile_stem_basic_game/tree/main/AGILE_STEM_GAME/Assets"
click node_conveyors "https://github.com/psu-edu/agile_stem_basic_game/tree/main/AGILE_STEM_GAME/Assets"
click node_buffer "https://github.com/psu-edu/agile_stem_basic_game/tree/main/AGILE_STEM_GAME/Assets"

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_level,node_tutorial,node_adaptation toneBlue
class node_orderui,node_orderqueue,node_controls toneAmber
class node_facility,node_forklift,node_bottles,node_conveyors,node_buffer toneMint
class node_learner toneIndigo
```

## Components

### Learning experience

- [Levels and free play](https://github.com/psu-edu/agile_stem_basic_game/tree/main/AGILE_STEM_GAME/Assets): `AGILE_STEM_GAME/Assets`
- [Tutorial system](https://github.com/psu-edu/agile_stem_basic_game/tree/main/AGILE_STEM_GAME/Assets): `AGILE_STEM_GAME/Assets`
- [Adaptable content](https://github.com/psu-edu/agile_stem_basic_game/tree/main/AGILE_STEM_GAME/Assets): `AGILE_STEM_GAME/Assets`

### Production planning

- [Order menu](https://github.com/psu-edu/agile_stem_basic_game/tree/main/AGILE_STEM_GAME/Assets): `AGILE_STEM_GAME/Assets`
- [Production orders](https://github.com/psu-edu/agile_stem_basic_game/tree/main/AGILE_STEM_GAME/Assets): `AGILE_STEM_GAME/Assets`
- [Production controls](https://github.com/psu-edu/agile_stem_basic_game/tree/main/AGILE_STEM_GAME/Assets): `AGILE_STEM_GAME/Assets`

### Facility simulation

- [Production facility](https://github.com/psu-edu/agile_stem_basic_game/tree/main/AGILE_STEM_GAME/Assets): `AGILE_STEM_GAME/Assets`
- [Forklift delivery](https://github.com/psu-edu/agile_stem_basic_game/tree/main/AGILE_STEM_GAME/Assets): `AGILE_STEM_GAME/Assets`
- [Bottle flow](https://github.com/psu-edu/agile_stem_basic_game/tree/main/AGILE_STEM_GAME/Assets): `AGILE_STEM_GAME/Assets`
- [Conveyor lanes](https://github.com/psu-edu/agile_stem_basic_game/tree/main/AGILE_STEM_GAME/Assets): `AGILE_STEM_GAME/Assets`
- [Conveyor buffer](https://github.com/psu-edu/agile_stem_basic_game/tree/main/AGILE_STEM_GAME/Assets): `AGILE_STEM_GAME/Assets`

### Other components

- **Learner**

## Connections

- Learner → Levels and free play: selects (evidence: `README.md`)
- Learner → Tutorial system: uses (evidence: `README.md`)
- Learner → Order menu: configures (evidence: `README.md`)
- Learner → Production controls: adjusts (evidence: `README.md`)
- Levels and free play → Production facility: resets level (evidence: `README.md`)
- Order menu → Production orders: sets orders (evidence: `README.md`)
- Production orders → Forklift delivery: guides delivery (evidence: `README.md`)
- Forklift delivery → Bottle flow: brings into system (evidence: `README.md`)
- Production controls → Conveyor lanes: sets speed (evidence: `README.md`)
- Production controls → Bottle flow: sets release rate (evidence: `README.md`)
- Production controls → Conveyor buffer: controls gates (evidence: `README.md`)
- Bottle flow → Conveyor lanes: moves along (evidence: `README.md`)
- Conveyor lanes → Conveyor buffer: feeds buffer (evidence: `README.md`)
- Adaptable content → Levels and free play: adapts content
