# angieeeeeee/dynamic-ttx architecture

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

- Interactive diagram: https://gitdiagram.com/angieeeeeee/dynamic-ttx
- Repository: https://github.com/angieeeeeee/dynamic-ttx

## Overview

This is a browser-based tabletop exercise facilitator for water-treatment incident response. A facilitator selects scenario injects, starts an exercise, and presents injects while navigating suggested branches or choosing injects manually; a separate audience window mirrors the current slide. Scenario content is held in a static JavaScript catalog. The excerpts also show optional model-context tools for reading and changing exercise state. Source coverage is limited to the supplied excerpts; the README is empty.

Main entry points: [`app.js`](https://github.com/angieeeeeee/dynamic-ttx/blob/main/app.js) (Facilitator View), [`scenarios.js`](https://github.com/angieeeeeee/dynamic-ttx/blob/main/scenarios.js) (Scenario Catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Exercise Interfaces"]
  node_facilitator_view["Facilitator View<br/>[app.js]"]
  node_audience_view["Audience View<br/>[app.js]"]
end

subgraph group_runtime["Exercise Runtime"]
  node_scenario_bank["Scenario Bank<br/>[app.js]"]
  node_exercise_flow["Exercise Flow<br/>[app.js]"]
  node_branching["Branch Recommendations<br/>[app.js]"]
  node_scenario_editor["Scenario Editor<br/>[app.js]"]
  node_model_tools["Model Context Tools<br/>[app.js]"]
end

subgraph group_content["Scenario Content"]
  node_scenario_catalog["Scenario Catalog<br/>[scenarios.js]"]
end

node_facilitator(("Facilitator"))
node_audience(("Audience Participant"))
node_model_host["Model Host"]

node_facilitator -->|"operates"| node_facilitator_view
node_facilitator_view -->|"prepares selection"| node_scenario_bank
node_scenario_bank -->|"reads scenarios"| node_scenario_catalog
node_facilitator_view -->|"starts and navigates"| node_exercise_flow
node_exercise_flow -->|"requests suggestions"| node_branching
node_branching -->|"selects candidates"| node_scenario_catalog
node_facilitator_view -->|"opens editor"| node_scenario_editor
node_scenario_editor -->|"reads scenario fields"| node_scenario_catalog
node_facilitator_view -->|"opens window"| node_audience_view
node_facilitator_view -->|"broadcasts slides"| node_audience_view
node_audience_view -->|"presents slides"| node_audience
node_model_host -->|"registers tools"| node_model_tools
node_model_tools -->|"starts or presents"| node_exercise_flow

click node_facilitator_view "https://github.com/angieeeeeee/dynamic-ttx/blob/main/app.js"
click node_audience_view "https://github.com/angieeeeeee/dynamic-ttx/blob/main/app.js"
click node_scenario_bank "https://github.com/angieeeeeee/dynamic-ttx/blob/main/app.js"
click node_exercise_flow "https://github.com/angieeeeeee/dynamic-ttx/blob/main/app.js"
click node_branching "https://github.com/angieeeeeee/dynamic-ttx/blob/main/app.js"
click node_scenario_editor "https://github.com/angieeeeeee/dynamic-ttx/blob/main/app.js"
click node_scenario_catalog "https://github.com/angieeeeeee/dynamic-ttx/blob/main/scenarios.js"
click node_model_tools "https://github.com/angieeeeeee/dynamic-ttx/blob/main/app.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_facilitator_view,node_audience_view toneBlue
class node_scenario_bank,node_exercise_flow,node_branching,node_scenario_editor,node_model_tools toneAmber
class node_scenario_catalog toneMint
class node_facilitator,node_audience,node_model_host toneIndigo
```

## Components

### Exercise Interfaces

- [Facilitator View](https://github.com/angieeeeeee/dynamic-ttx/blob/main/app.js): `app.js`
- [Audience View](https://github.com/angieeeeeee/dynamic-ttx/blob/main/app.js): `app.js`

### Exercise Runtime

- [Scenario Bank](https://github.com/angieeeeeee/dynamic-ttx/blob/main/app.js): `app.js`
- [Exercise Flow](https://github.com/angieeeeeee/dynamic-ttx/blob/main/app.js): `app.js`
- [Branch Recommendations](https://github.com/angieeeeeee/dynamic-ttx/blob/main/app.js): `app.js`
- [Scenario Editor](https://github.com/angieeeeeee/dynamic-ttx/blob/main/app.js): `app.js`
- [Model Context Tools](https://github.com/angieeeeeee/dynamic-ttx/blob/main/app.js): `app.js`

### Scenario Content

- [Scenario Catalog](https://github.com/angieeeeeee/dynamic-ttx/blob/main/scenarios.js): `scenarios.js`

### Other components

- **Facilitator**
- **Audience Participant**
- **Model Host**

## Connections

- Facilitator → Facilitator View: operates (evidence: `app.js`)
- Facilitator View → Scenario Bank: prepares selection (evidence: `app.js`)
- Scenario Bank → Scenario Catalog: reads scenarios (evidence: `app.js`)
- Facilitator View → Exercise Flow: starts and navigates (evidence: `app.js`)
- Exercise Flow → Branch Recommendations: requests suggestions (evidence: `app.js`)
- Branch Recommendations → Scenario Catalog: selects candidates (evidence: `app.js`)
- Facilitator View → Scenario Editor: opens editor (evidence: `app.js`)
- Scenario Editor → Scenario Catalog: reads scenario fields (evidence: `app.js`)
- Facilitator View → Audience View: opens window (evidence: `app.js`)
- Facilitator View → Audience View: broadcasts slides (evidence: `app.js`)
- Audience View → Audience Participant: presents slides (evidence: `app.js`)
- Model Host → Model Context Tools: registers tools (evidence: `app.js`)
- Model Context Tools → Exercise Flow: starts or presents (evidence: `app.js`)
