# redward42/acm-room architecture

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

- Interactive diagram: https://gitdiagram.com/redward42/acm-room
- Repository: https://github.com/redward42/acm-room

## Overview

ACM Divisions Room is a browser-based interactive 3D introduction to ACM at UTD. A visitor explores the rendered room, selects a representative object or division button, and reads that division’s information in a panel; hover, reset, and dismiss actions support exploration. The main layers are the React entry and interface, separate division content, and the Three.js scene. The README documents interaction capabilities beyond the sampled scene excerpt; those links are shown as documented behavior rather than claims about unseen implementation details.

Main entry points: [`src/App.tsx`](https://github.com/RedWARd42/acm-room/blob/main/src/App.tsx) (Room interface), [`src/roomScene.js`](https://github.com/RedWARd42/acm-room/blob/main/src/roomScene.js) (Scene controller), [`src/main.tsx`](https://github.com/RedWARd42/acm-room/blob/main/src/main.tsx) (App entry), [`src/data/divisions.ts`](https://github.com/RedWARd42/acm-room/blob/main/src/data/divisions.ts) (Division catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["React interface"]
  node_entry["App entry<br/>[main.tsx]"]
  node_interface["Room interface<br/>[App.tsx]"]
  node_division_nav["Division buttons<br/>[App.tsx]"]
  node_info_panel["Information panel<br/>[App.tsx]"]
  node_hover_tooltip["Hover tooltip<br/>[App.tsx]"]
  node_error_display["Error display<br/>[App.tsx]"]
end

subgraph group_content["Division content"]
  node_division_catalog[("Division catalog<br/>[divisions.ts]")]
end

subgraph group_scene["3D room"]
  node_scene_controller["Scene controller<br/>[roomScene.js]"]
  node_room_rendering["Room rendering<br/>[roomScene.js]"]
  node_room_objects["Room objects<br/>[roomScene.js]"]
  node_object_picking["Object picking<br/>[roomScene.js]"]
  node_hover_highlight["Hover highlights<br/>[roomScene.js]"]
  node_camera_controls["Camera controls<br/>[roomScene.js]"]
end

node_visitor(("Visitor"))
node_threejs["Three.js"]

node_visitor -->|"explores"| node_interface
node_entry -->|"renders"| node_interface
node_interface -->|"creates"| node_scene_controller
node_interface -->|"reads"| node_division_catalog
node_division_nav -->|"selects division"| node_scene_controller
node_interface -->|"resets or closes"| node_scene_controller
node_scene_controller -->|"reports selection and hover"| node_interface
node_interface -->|"shows division details"| node_info_panel
node_interface -->|"shows hover details"| node_hover_tooltip
node_interface -->|"shows rendering errors"| node_error_display
node_scene_controller -.->|"initializes"| node_room_rendering
node_room_rendering -->|"builds"| node_room_objects
node_room_rendering -->|"renders with"| node_threejs
node_object_picking -.->|"picks from"| node_room_objects
node_object_picking -.->|"highlights"| node_hover_highlight
node_camera_controls -->|"uses"| node_threejs
node_visitor -.->|"looks around"| node_camera_controls
node_visitor -.->|"selects objects"| node_object_picking

click node_entry "https://github.com/RedWARd42/acm-room/blob/main/src/main.tsx"
click node_interface "https://github.com/RedWARd42/acm-room/blob/main/src/App.tsx"
click node_division_nav "https://github.com/RedWARd42/acm-room/blob/main/src/App.tsx"
click node_info_panel "https://github.com/RedWARd42/acm-room/blob/main/src/App.tsx"
click node_hover_tooltip "https://github.com/RedWARd42/acm-room/blob/main/src/App.tsx"
click node_error_display "https://github.com/RedWARd42/acm-room/blob/main/src/App.tsx"
click node_division_catalog "https://github.com/RedWARd42/acm-room/blob/main/src/data/divisions.ts"
click node_scene_controller "https://github.com/RedWARd42/acm-room/blob/main/src/roomScene.js"
click node_room_rendering "https://github.com/RedWARd42/acm-room/blob/main/src/roomScene.js"
click node_room_objects "https://github.com/RedWARd42/acm-room/blob/main/src/roomScene.js"
click node_object_picking "https://github.com/RedWARd42/acm-room/blob/main/src/roomScene.js"
click node_hover_highlight "https://github.com/RedWARd42/acm-room/blob/main/src/roomScene.js"
click node_camera_controls "https://github.com/RedWARd42/acm-room/blob/main/src/roomScene.js"

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_entry,node_interface,node_division_nav,node_info_panel,node_hover_tooltip,node_error_display toneBlue
class node_division_catalog toneAmber
class node_scene_controller,node_room_rendering,node_room_objects,node_object_picking,node_hover_highlight,node_camera_controls toneMint
class node_visitor,node_threejs toneIndigo
```

## Components

### React interface

- [App entry](https://github.com/RedWARd42/acm-room/blob/main/src/main.tsx): `src/main.tsx`
- [Room interface](https://github.com/RedWARd42/acm-room/blob/main/src/App.tsx): `src/App.tsx`
- [Division buttons](https://github.com/RedWARd42/acm-room/blob/main/src/App.tsx): `src/App.tsx`
- [Information panel](https://github.com/RedWARd42/acm-room/blob/main/src/App.tsx): `src/App.tsx`
- [Hover tooltip](https://github.com/RedWARd42/acm-room/blob/main/src/App.tsx): `src/App.tsx`
- [Error display](https://github.com/RedWARd42/acm-room/blob/main/src/App.tsx): `src/App.tsx`

### Division content

- [Division catalog](https://github.com/RedWARd42/acm-room/blob/main/src/data/divisions.ts): `src/data/divisions.ts`

### 3D room

- [Scene controller](https://github.com/RedWARd42/acm-room/blob/main/src/roomScene.js): `src/roomScene.js`
- [Room rendering](https://github.com/RedWARd42/acm-room/blob/main/src/roomScene.js): `src/roomScene.js`
- [Room objects](https://github.com/RedWARd42/acm-room/blob/main/src/roomScene.js): `src/roomScene.js`
- [Object picking](https://github.com/RedWARd42/acm-room/blob/main/src/roomScene.js): `src/roomScene.js`
- [Hover highlights](https://github.com/RedWARd42/acm-room/blob/main/src/roomScene.js): `src/roomScene.js`
- [Camera controls](https://github.com/RedWARd42/acm-room/blob/main/src/roomScene.js): `src/roomScene.js`

### Other components

- **Visitor**
- **Three.js**

## Connections

- Visitor → Room interface: explores (evidence: `README.md`)
- App entry → Room interface: renders (evidence: `src/main.tsx`)
- Room interface → Scene controller: creates (evidence: `src/App.tsx`)
- Room interface → Division catalog: reads (evidence: `src/App.tsx`)
- Division buttons → Scene controller: selects division (evidence: `src/App.tsx`)
- Room interface → Scene controller: resets or closes (evidence: `src/App.tsx`)
- Scene controller → Room interface: reports selection and hover (evidence: `src/App.tsx`)
- Room interface → Information panel: shows division details (evidence: `src/App.tsx`)
- Room interface → Hover tooltip: shows hover details (evidence: `src/App.tsx`)
- Room interface → Error display: shows rendering errors (evidence: `src/App.tsx`)
- Scene controller → Room rendering: initializes (evidence: `src/roomScene.js`)
- Room rendering → Room objects: builds (evidence: `src/roomScene.js`)
- Room rendering → Three.js: renders with (evidence: `src/roomScene.js`)
- Object picking → Room objects: picks from (evidence: `src/roomScene.js`)
- Object picking → Hover highlights: highlights (evidence: `src/roomScene.js`)
- Camera controls → Three.js: uses (evidence: `src/roomScene.js`)
- Visitor → Camera controls: looks around (evidence: `README.md`)
- Visitor → Object picking: selects objects (evidence: `README.md`)
