# anyel1to/atsmatrix-voxel-yard architecture

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

- Interactive diagram: https://gitdiagram.com/anyel1to/atsmatrix-voxel-yard
- Repository: https://github.com/anyel1to/atsmatrix-voxel-yard

## Overview

Voxel Yard is a browser-based Three.js/WebGL visualization of desk metrics, driven by simulated telemetry rather than a production market feed. Users orbit and zoom the yard, jump to metric towers, and pause or resume its clock. The documented world includes terrain, a beacon lock, moving named agents, metric towers, and a debug HUD. All implementation nodes point to index.html, the sole runtime source in the tree; source excerpts were unavailable, so edges rely only on README statements.

Main entry points: [`index.html`](https://github.com/anyel1to/atsmatrix-voxel-yard/blob/main/index.html) (Yard Controls)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["User Interaction"]
  node_controls["Yard Controls<br/>[index.html]"]
  node_camera["Orbit Camera<br/>[index.html]"]
  node_tower_jump["Tower Jump<br/>[index.html]"]
end

subgraph group_simulation["Simulated Desk State"]
  node_sim_clock["Simulation Clock<br/>[index.html]"]
  node_telemetry["Simulated Telemetry<br/>[index.html]"]
  node_metrics["Desk Metrics<br/>[index.html]"]
end

subgraph group_world["Voxel World"]
  node_towers["Metric Towers<br/>[index.html]"]
  node_agents["Patrol Agents<br/>[index.html]"]
  node_terrain["Terrain Path<br/>[index.html]"]
  node_beacon["Beacon Lock<br/>[index.html]"]
end

subgraph group_presentation["Visualization"]
  node_debug["Debug HUD<br/>[index.html]"]
  node_hotbar["Block Legend<br/>[index.html]"]
end

node_user(("Viewer"))
node_three["Three.js"]
node_orbit_controls["OrbitControls"]

node_user -->|"uses"| node_controls
node_controls -->|"orbits, zooms"| node_camera
node_controls -->|"selects tower"| node_tower_jump
node_controls -->|"pauses, resumes"| node_sim_clock
node_sim_clock -->|"drives"| node_telemetry
node_telemetry -->|"updates"| node_metrics
node_metrics -->|"sets height"| node_towers
node_user -->|"views patrol"| node_agents
node_user -->|"views yard"| node_terrain
node_user -->|"views lock"| node_beacon
node_user -->|"views metrics"| node_debug
node_user -->|"reads legend"| node_hotbar
node_camera -->|"renders with"| node_three
node_camera -->|"uses"| node_orbit_controls

click node_controls "https://github.com/anyel1to/atsmatrix-voxel-yard/blob/main/index.html"
click node_camera "https://github.com/anyel1to/atsmatrix-voxel-yard/blob/main/index.html"
click node_tower_jump "https://github.com/anyel1to/atsmatrix-voxel-yard/blob/main/index.html"
click node_sim_clock "https://github.com/anyel1to/atsmatrix-voxel-yard/blob/main/index.html"
click node_telemetry "https://github.com/anyel1to/atsmatrix-voxel-yard/blob/main/index.html"
click node_metrics "https://github.com/anyel1to/atsmatrix-voxel-yard/blob/main/index.html"
click node_towers "https://github.com/anyel1to/atsmatrix-voxel-yard/blob/main/index.html"
click node_agents "https://github.com/anyel1to/atsmatrix-voxel-yard/blob/main/index.html"
click node_terrain "https://github.com/anyel1to/atsmatrix-voxel-yard/blob/main/index.html"
click node_beacon "https://github.com/anyel1to/atsmatrix-voxel-yard/blob/main/index.html"
click node_debug "https://github.com/anyel1to/atsmatrix-voxel-yard/blob/main/index.html"
click node_hotbar "https://github.com/anyel1to/atsmatrix-voxel-yard/blob/main/index.html"

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_controls,node_camera,node_tower_jump,node_user toneBlue
class node_sim_clock,node_telemetry,node_metrics toneAmber
class node_towers,node_agents,node_terrain,node_beacon toneMint
class node_debug,node_hotbar toneRose
class node_three,node_orbit_controls toneIndigo
```

## Components

### User Interaction

- [Yard Controls](https://github.com/anyel1to/atsmatrix-voxel-yard/blob/main/index.html): `index.html`
- [Orbit Camera](https://github.com/anyel1to/atsmatrix-voxel-yard/blob/main/index.html): `index.html`
- [Tower Jump](https://github.com/anyel1to/atsmatrix-voxel-yard/blob/main/index.html): `index.html`

### Simulated Desk State

- [Simulation Clock](https://github.com/anyel1to/atsmatrix-voxel-yard/blob/main/index.html): `index.html`
- [Simulated Telemetry](https://github.com/anyel1to/atsmatrix-voxel-yard/blob/main/index.html): `index.html`
- [Desk Metrics](https://github.com/anyel1to/atsmatrix-voxel-yard/blob/main/index.html): `index.html`

### Voxel World

- [Metric Towers](https://github.com/anyel1to/atsmatrix-voxel-yard/blob/main/index.html): `index.html`
- [Patrol Agents](https://github.com/anyel1to/atsmatrix-voxel-yard/blob/main/index.html): `index.html`
- [Terrain Path](https://github.com/anyel1to/atsmatrix-voxel-yard/blob/main/index.html): `index.html`
- [Beacon Lock](https://github.com/anyel1to/atsmatrix-voxel-yard/blob/main/index.html): `index.html`

### Visualization

- [Debug HUD](https://github.com/anyel1to/atsmatrix-voxel-yard/blob/main/index.html): `index.html`
- [Block Legend](https://github.com/anyel1to/atsmatrix-voxel-yard/blob/main/index.html): `index.html`

### Other components

- **Viewer**
- **Three.js**
- **OrbitControls**

## Connections

- Viewer → Yard Controls: uses (evidence: `README.md`)
- Yard Controls → Orbit Camera: orbits, zooms (evidence: `README.md`)
- Yard Controls → Tower Jump: selects tower (evidence: `README.md`)
- Yard Controls → Simulation Clock: pauses, resumes (evidence: `README.md`)
- Simulation Clock → Simulated Telemetry: drives (evidence: `README.md`)
- Simulated Telemetry → Desk Metrics: updates (evidence: `README.md`)
- Desk Metrics → Metric Towers: sets height (evidence: `README.md`)
- Viewer → Patrol Agents: views patrol (evidence: `README.md`)
- Viewer → Terrain Path: views yard (evidence: `README.md`)
- Viewer → Beacon Lock: views lock (evidence: `README.md`)
- Viewer → Debug HUD: views metrics (evidence: `README.md`)
- Viewer → Block Legend: reads legend (evidence: `README.md`)
- Orbit Camera → Three.js: renders with (evidence: `README.md`)
- Orbit Camera → OrbitControls: uses (evidence: `README.md`)