# jashanbains-24/stormhacks2026 architecture

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

- Interactive diagram: https://gitdiagram.com/jashanbains-24/stormhacks2026
- Repository: https://github.com/jashanbains-24/stormhacks2026

## Overview

Uptime’s main loop takes the player from exploring an office and learning outage concepts to assembling an architecture, stress-testing it, and recording floor progress. The graph includes the floor-content system, world interactions, dialogue and glossary UI, and the pure simulation/evaluation layer. Some scene and floor implementation details are unsampled; edges are limited to excerpted calls, SOURCE INDEX references, or README statements.

Main entry points: [`src/core/runtime/FloorScene.ts`](https://github.com/jashanbains-24/stormhacks2026/blob/main/src/core/runtime/FloorScene.ts) (Office Scene), [`src/scenes/BuildScene.ts`](https://github.com/jashanbains-24/stormhacks2026/blob/main/src/scenes/BuildScene.ts) (Build Console), [`src/scenes/UIScene.ts`](https://github.com/jashanbains-24/stormhacks2026/blob/main/src/scenes/UIScene.ts) (HUD & UI), [`src/systems/InteractionSystem.ts`](https://github.com/jashanbains-24/stormhacks2026/blob/main/src/systems/InteractionSystem.ts) (Interactions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_world["Office World"]
  node_floor_scene["Office Scene<br/>[FloorScene.ts]"]
  node_interaction["Interactions"]
  node_player_entity["Movement<br/>[Player.ts]"]
  node_interactable["Interactable<br/>[Interactable.ts]"]
end

subgraph group_content["Learning Content"]
  node_floor_registry["Floor Registry<br/>[floorRegistry.ts]"]
  node_floor_modules["Floor Modules"]
  node_floor_content["Floor Content<br/>[content.ts]"]
  node_dialogue["Dialogue<br/>[DialogueSystem.ts]"]
  node_speech_glossary["Speech &amp; Glossary<br/>[SpeechBubble.ts]"]
end

subgraph group_build["Architecture Challenge"]
  node_build_scene["Build Console<br/>[BuildScene.ts]"]
  node_palette["Component Palette<br/>[Palette.ts]"]
  node_build_node["Architecture Nodes<br/>[BuildNode.ts]"]
  node_evaluator["Design Evaluator<br/>[evaluator.ts]"]
  node_simulation["Traffic Simulation<br/>[simulation.ts]"]
end

subgraph group_support["Shared Runtime"]
  node_progression[("Floor Progress<br/>[progression.ts]")]
  node_preferences[("Accessibility Settings<br/>[preferences.ts]")]
  node_ui_scene["HUD &amp; UI<br/>[UIScene.ts]"]
  node_events["Game Events<br/>[EventBus.ts]"]
end

node_player(("Player"))

node_player -->|"explores"| node_floor_scene
node_floor_scene -->|"loads floor"| node_floor_registry
node_floor_registry -->|"discovers"| node_floor_modules
node_floor_scene -->|"creates"| node_player_entity
node_floor_scene -->|"creates"| node_interaction
node_interaction -->|"checks distance"| node_player_entity
node_interaction -->|"invokes nearby"| node_interactable
node_floor_scene -->|"emits floor events"| node_events
node_floor_scene -.->|"uses floor definition"| node_floor_content
node_ui_scene -->|"loads floor content"| node_floor_registry
node_ui_scene -->|"sets hints"| node_dialogue
node_ui_scene -->|"shows speech"| node_speech_glossary
node_player -->|"opens console"| node_build_scene
node_build_scene -->|"creates"| node_palette
node_build_scene -->|"manages components"| node_build_node
node_build_scene -->|"evaluates design"| node_evaluator
node_build_scene -->|"runs stress test"| node_simulation
node_simulation -->|"evaluates stability"| node_evaluator
node_build_scene -.->|"records outcome"| node_progression
node_ui_scene -->|"reads results"| node_progression
node_ui_scene -->|"reads settings"| node_preferences
node_floor_scene -->|"checks motion setting"| node_preferences
node_floor_scene -->|"signals build open"| node_events

click node_floor_scene "https://github.com/jashanbains-24/stormhacks2026/blob/main/src/core/runtime/FloorScene.ts"
click node_interaction "https://github.com/jashanbains-24/stormhacks2026/blob/main/src/systems/InteractionSystem.ts"
click node_player_entity "https://github.com/jashanbains-24/stormhacks2026/blob/main/src/entities/Player.ts"
click node_interactable "https://github.com/jashanbains-24/stormhacks2026/blob/main/src/entities/Interactable.ts"
click node_floor_registry "https://github.com/jashanbains-24/stormhacks2026/blob/main/src/core/runtime/floorRegistry.ts"
click node_floor_modules "https://github.com/jashanbains-24/stormhacks2026/tree/main/src/floors"
click node_floor_content "https://github.com/jashanbains-24/stormhacks2026/blob/main/src/floors/floor-01-scalability/definition/content.ts"
click node_dialogue "https://github.com/jashanbains-24/stormhacks2026/blob/main/src/systems/DialogueSystem.ts"
click node_speech_glossary "https://github.com/jashanbains-24/stormhacks2026/blob/main/src/ui/SpeechBubble.ts"
click node_build_scene "https://github.com/jashanbains-24/stormhacks2026/blob/main/src/scenes/BuildScene.ts"
click node_palette "https://github.com/jashanbains-24/stormhacks2026/blob/main/src/ui/Palette.ts"
click node_build_node "https://github.com/jashanbains-24/stormhacks2026/blob/main/src/ui/BuildNode.ts"
click node_evaluator "https://github.com/jashanbains-24/stormhacks2026/blob/main/src/sim/evaluator.ts"
click node_simulation "https://github.com/jashanbains-24/stormhacks2026/blob/main/src/sim/simulation.ts"
click node_progression "https://github.com/jashanbains-24/stormhacks2026/blob/main/src/state/progression.ts"
click node_preferences "https://github.com/jashanbains-24/stormhacks2026/blob/main/src/state/preferences.ts"
click node_ui_scene "https://github.com/jashanbains-24/stormhacks2026/blob/main/src/scenes/UIScene.ts"
click node_events "https://github.com/jashanbains-24/stormhacks2026/blob/main/src/systems/EventBus.ts"

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_floor_scene,node_interaction,node_player_entity,node_interactable toneBlue
class node_floor_registry,node_floor_modules,node_floor_content,node_dialogue,node_speech_glossary toneAmber
class node_build_scene,node_palette,node_build_node,node_evaluator,node_simulation toneMint
class node_progression,node_preferences,node_ui_scene,node_events toneRose
class node_player toneIndigo
```

## Components

### Office World

- [Office Scene](https://github.com/jashanbains-24/stormhacks2026/blob/main/src/core/runtime/FloorScene.ts): `src/core/runtime/FloorScene.ts`
- [Interactions](https://github.com/jashanbains-24/stormhacks2026/blob/main/src/systems/InteractionSystem.ts): `src/systems/InteractionSystem.ts`
- [Movement](https://github.com/jashanbains-24/stormhacks2026/blob/main/src/entities/Player.ts): `src/entities/Player.ts`
- [Interactable](https://github.com/jashanbains-24/stormhacks2026/blob/main/src/entities/Interactable.ts): `src/entities/Interactable.ts`

### Learning Content

- [Floor Registry](https://github.com/jashanbains-24/stormhacks2026/blob/main/src/core/runtime/floorRegistry.ts): `src/core/runtime/floorRegistry.ts`
- [Floor Modules](https://github.com/jashanbains-24/stormhacks2026/tree/main/src/floors): `src/floors`
- [Floor Content](https://github.com/jashanbains-24/stormhacks2026/blob/main/src/floors/floor-01-scalability/definition/content.ts): `src/floors/floor-01-scalability/definition/content.ts`
- [Dialogue](https://github.com/jashanbains-24/stormhacks2026/blob/main/src/systems/DialogueSystem.ts): `src/systems/DialogueSystem.ts`
- [Speech & Glossary](https://github.com/jashanbains-24/stormhacks2026/blob/main/src/ui/SpeechBubble.ts): `src/ui/SpeechBubble.ts`

### Architecture Challenge

- [Build Console](https://github.com/jashanbains-24/stormhacks2026/blob/main/src/scenes/BuildScene.ts): `src/scenes/BuildScene.ts`
- [Component Palette](https://github.com/jashanbains-24/stormhacks2026/blob/main/src/ui/Palette.ts): `src/ui/Palette.ts`
- [Architecture Nodes](https://github.com/jashanbains-24/stormhacks2026/blob/main/src/ui/BuildNode.ts): `src/ui/BuildNode.ts`
- [Design Evaluator](https://github.com/jashanbains-24/stormhacks2026/blob/main/src/sim/evaluator.ts): `src/sim/evaluator.ts`
- [Traffic Simulation](https://github.com/jashanbains-24/stormhacks2026/blob/main/src/sim/simulation.ts): `src/sim/simulation.ts`

### Shared Runtime

- [Floor Progress](https://github.com/jashanbains-24/stormhacks2026/blob/main/src/state/progression.ts): `src/state/progression.ts`
- [Accessibility Settings](https://github.com/jashanbains-24/stormhacks2026/blob/main/src/state/preferences.ts): `src/state/preferences.ts`
- [HUD & UI](https://github.com/jashanbains-24/stormhacks2026/blob/main/src/scenes/UIScene.ts): `src/scenes/UIScene.ts`
- [Game Events](https://github.com/jashanbains-24/stormhacks2026/blob/main/src/systems/EventBus.ts): `src/systems/EventBus.ts`

### Other components

- **Player**

## Connections

- Player → Office Scene: explores (evidence: `README.md`)
- Office Scene → Floor Registry: loads floor (evidence: `src/core/runtime/FloorScene.ts`)
- Floor Registry → Floor Modules: discovers (evidence: `src/core/runtime/floorRegistry.ts`)
- Office Scene → Movement: creates (evidence: `src/core/runtime/FloorScene.ts`)
- Office Scene → Interactions: creates (evidence: `src/core/runtime/FloorScene.ts`)
- Interactions → Movement: checks distance (evidence: `src/systems/InteractionSystem.ts`)
- Interactions → Interactable: invokes nearby (evidence: `src/systems/InteractionSystem.ts`)
- Office Scene → Game Events: emits floor events (evidence: `src/core/runtime/FloorScene.ts`)
- Office Scene → Floor Content: uses floor definition
- HUD & UI → Floor Registry: loads floor content (evidence: `src/scenes/UIScene.ts`)
- HUD & UI → Dialogue: sets hints (evidence: `src/scenes/UIScene.ts`)
- HUD & UI → Speech & Glossary: shows speech (evidence: `src/scenes/UIScene.ts`)
- Player → Build Console: opens console (evidence: `README.md`)
- Build Console → Component Palette: creates (evidence: `src/scenes/BuildScene.ts`)
- Build Console → Architecture Nodes: manages components (evidence: `src/scenes/BuildScene.ts`)
- Build Console → Design Evaluator: evaluates design (evidence: `src/scenes/BuildScene.ts`)
- Build Console → Traffic Simulation: runs stress test (evidence: `src/scenes/BuildScene.ts`)
- Traffic Simulation → Design Evaluator: evaluates stability (evidence: `src/sim/simulation.ts`)
- Build Console → Floor Progress: records outcome (evidence: `src/scenes/BuildScene.ts`)
- HUD & UI → Floor Progress: reads results (evidence: `src/scenes/UIScene.ts`)
- HUD & UI → Accessibility Settings: reads settings (evidence: `src/scenes/UIScene.ts`)
- Office Scene → Accessibility Settings: checks motion setting (evidence: `src/core/runtime/FloorScene.ts`)
- Office Scene → Game Events: signals build open (evidence: `src/core/runtime/FloorScene.ts`)
