# matwin1978/simutestfall_2809 architecture

> Architecture diagram of the GitHub repository matwin1978/simutestfall_2809, 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/matwin1978/simutestfall_2809
- Repository: https://github.com/matwin1978/simutestfall_2809

## Overview

This is a browser-based interactive training simulator, apparently centered on vehicle/equipment inspection and diagnostic missions. The principal workflow is to select a mission, explore a 3D scene, perform context-sensitive actions with equipment, and review whether required actions were completed. Its internal action engine updates shared state and compares the action log with mission requirements. The README is generic Vite-template material and does not document product capabilities; several components are represented only by the tree or index, so those relationships are omitted unless the index establishes them.

Main entry points: [`src/store/store.ts`](https://github.com/matwin1978/simutestfall_2809/blob/main/src/store/store.ts) (Application stores), [`src/App.tsx`](https://github.com/matwin1978/simutestfall_2809/blob/main/src/App.tsx) (Application shell), [`src/utilities/handleActionTrigger.ts`](https://github.com/matwin1978/simutestfall_2809/blob/main/src/utilities/handleActionTrigger.ts) (Action handler), [`src/utilities/comparePerformedAndMandatoryActionsSimple.ts`](https://github.com/matwin1978/simutestfall_2809/blob/main/src/utilities/comparePerformedAndMandatoryActionsSimple.ts) (Requirement comparison)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Training experience"]
  node_app["Application shell<br/>[App.tsx]"]
  node_object_menu["Object actions menu"]
  node_inventory["Inventory<br/>[Inventory.tsx]"]
  node_equipment_inventory["Equipment inventory"]
  node_inventory_object["Inventory object"]
  node_inventory_submenu["Inventory submenu"]
end

subgraph group_scene["3D scene"]
  node_scene_canvas["Scene canvas<br/>[ThreeDCanvas.tsx]"]
  node_three_d["Scene engine<br/>[ThreeD.ts]"]
  node_spin_controls["Spin controls<br/>[SpinControls.ts]"]
end

subgraph group_actions["Actions and state"]
  node_action_handler["Action handler"]
  node_state_store["Application stores<br/>[store.ts]"]
  node_reducers["Action reducers<br/>[reducers.ts]"]
  node_mandatory_compare["Requirement comparison"]
  node_action_utilities["Action utilities<br/>[utilities.ts]"]
  node_typeguards["Action type guards<br/>[typeguards.ts]"]
  node_url_params["URL parameters<br/>[CustomUrlParams.ts]"]
  node_data_store[("Shared state<br/>[store.ts]")]
end

subgraph group_mission["Missions and results"]
  node_quick_nav["Quick navigation<br/>[QuickNav.tsx]"]
  node_mission_view["Mission detail"]
  node_mission_list["Mission selection<br/>[MissionList.tsx]"]
  node_result["Mission results<br/>[Result.tsx]"]
  node_pdf_report["PDF report<br/>[PdfReport.tsx]"]
  node_performed_actions["Action summary"]
end

subgraph group_support["Device and diagnostics"]
  node_computer["Computer diagnostics<br/>[Computer.tsx]"]
  node_expert_system["Expert system<br/>[ExpertSystem.tsx]"]
  node_smartphone["Smartphone<br/>[Smartphone.tsx]"]
  node_timer["Timer app"]
  node_performance["Performance settings"]
end

node_trainee(("Trainee"))

node_trainee -->|"uses"| node_app
node_app -->|"renders"| node_scene_canvas
node_app -->|"renders"| node_inventory
node_app -->|"renders"| node_equipment_inventory
node_app -->|"renders"| node_smartphone
node_app -->|"renders"| node_computer
node_app -->|"renders"| node_quick_nav
node_app -->|"invokes"| node_action_handler
node_app -->|"renders"| node_mission_view
node_app -->|"renders"| node_object_menu
node_scene_canvas -.->|"hosts"| node_three_d
node_three_d -->|"uses"| node_spin_controls
node_object_menu -->|"invokes"| node_action_handler
node_object_menu -->|"checks conditions"| node_action_utilities
node_inventory -->|"renders"| node_inventory_object
node_equipment_inventory -->|"renders"| node_inventory_submenu
node_inventory -->|"reads"| node_state_store
node_equipment_inventory -->|"reads"| node_state_store
node_inventory_object -->|"renders"| node_inventory_submenu
node_action_handler -->|"updates actions"| node_reducers
node_action_handler -->|"checks requirements"| node_mandatory_compare
node_action_handler -->|"processes requirements"| node_action_utilities
node_action_handler -->|"updates state"| node_state_store
node_action_handler -->|"checks action type"| node_typeguards
node_state_store -->|"initializes actions"| node_action_utilities
node_state_store -->|"reads parameters"| node_url_params
node_state_store -->|"checks completion"| node_mandatory_compare
node_quick_nav -->|"triggers actions"| node_action_handler
node_quick_nav -->|"reads state"| node_state_store
node_mission_view -->|"reads state"| node_state_store
node_result -->|"renders"| node_performed_actions
node_result -->|"renders"| node_pdf_report
node_result -->|"compares actions"| node_mandatory_compare
node_performed_actions -->|"compares actions"| node_mandatory_compare
node_performed_actions -->|"reads log"| node_state_store
node_computer -->|"opens"| node_expert_system
node_computer -->|"triggers actions"| node_action_handler
node_timer -->|"triggers actions"| node_action_handler
node_timer -->|"reads state"| node_state_store
node_performance -->|"updates settings"| node_state_store
node_data_store -.->|"stores"| node_state_store

click node_app "https://github.com/matwin1978/simutestfall_2809/blob/main/src/App.tsx"
click node_scene_canvas "https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/ThreeDCanvas/ThreeDCanvas.tsx"
click node_three_d "https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/ThreeDCanvas/ThreeD.ts"
click node_spin_controls "https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/ThreeDCanvas/SpinControls/SpinControls.ts"
click node_object_menu "https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/InteractiveObjectMenu/InteractiveObjectMenu.tsx"
click node_inventory "https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/Inventory/Inventory.tsx"
click node_equipment_inventory "https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/Inventory/EquipmentInventory.tsx"
click node_inventory_object "https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/Inventory/InventoryObject.tsx"
click node_inventory_submenu "https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/Inventory/InventorySubMenu.tsx"
click node_action_handler "https://github.com/matwin1978/simutestfall_2809/blob/main/src/utilities/handleActionTrigger.ts"
click node_state_store "https://github.com/matwin1978/simutestfall_2809/blob/main/src/store/store.ts"
click node_reducers "https://github.com/matwin1978/simutestfall_2809/blob/main/src/utilities/reducers.ts"
click node_mandatory_compare "https://github.com/matwin1978/simutestfall_2809/blob/main/src/utilities/comparePerformedAndMandatoryActionsSimple.ts"
click node_action_utilities "https://github.com/matwin1978/simutestfall_2809/blob/main/src/utilities/utilities.ts"
click node_typeguards "https://github.com/matwin1978/simutestfall_2809/blob/main/src/types/typeguards.ts"
click node_url_params "https://github.com/matwin1978/simutestfall_2809/blob/main/src/utilities/CustomUrlParams.ts"
click node_quick_nav "https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/QuickNav/QuickNav.tsx"
click node_mission_view "https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/ViewerMissionDetail/ViewerMissionDetail.tsx"
click node_mission_list "https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/MissionList/MissionList.tsx"
click node_result "https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/Result/Result.tsx"
click node_pdf_report "https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/PdfReport/PdfReport.tsx"
click node_performed_actions "https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/PerformedAndMandatoryActionsListSimple/PerformedAndMandatoryActionsListSimple.tsx"
click node_computer "https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/Computer/Computer.tsx"
click node_expert_system "https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/ExpertSystem/ExpertSystem.tsx"
click node_smartphone "https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/Smartphone/Smartphone.tsx"
click node_timer "https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/Smartphone/SmartphoneAppTimer.tsx"
click node_performance "https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/PerformanceSettings/PerformanceSettings.tsx"
click node_data_store "https://github.com/matwin1978/simutestfall_2809/blob/main/src/store/store.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_app,node_object_menu,node_inventory,node_equipment_inventory,node_inventory_object,node_inventory_submenu toneBlue
class node_scene_canvas,node_three_d,node_spin_controls toneAmber
class node_action_handler,node_state_store,node_reducers,node_mandatory_compare,node_action_utilities,node_typeguards,node_url_params,node_data_store toneMint
class node_quick_nav,node_mission_view,node_mission_list,node_result,node_pdf_report,node_performed_actions toneRose
class node_computer,node_expert_system,node_smartphone,node_timer,node_performance,node_trainee toneIndigo
```

## Components

### Training experience

- [Application shell](https://github.com/matwin1978/simutestfall_2809/blob/main/src/App.tsx): `src/App.tsx`
- [Object actions menu](https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/InteractiveObjectMenu/InteractiveObjectMenu.tsx): `src/components/InteractiveObjectMenu/InteractiveObjectMenu.tsx`
- [Inventory](https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/Inventory/Inventory.tsx): `src/components/Inventory/Inventory.tsx`
- [Equipment inventory](https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/Inventory/EquipmentInventory.tsx): `src/components/Inventory/EquipmentInventory.tsx`
- [Inventory object](https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/Inventory/InventoryObject.tsx): `src/components/Inventory/InventoryObject.tsx`
- [Inventory submenu](https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/Inventory/InventorySubMenu.tsx): `src/components/Inventory/InventorySubMenu.tsx`

### 3D scene

- [Scene canvas](https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/ThreeDCanvas/ThreeDCanvas.tsx): `src/components/ThreeDCanvas/ThreeDCanvas.tsx`
- [Scene engine](https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/ThreeDCanvas/ThreeD.ts): `src/components/ThreeDCanvas/ThreeD.ts`
- [Spin controls](https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/ThreeDCanvas/SpinControls/SpinControls.ts): `src/components/ThreeDCanvas/SpinControls/SpinControls.ts`

### Actions and state

- [Action handler](https://github.com/matwin1978/simutestfall_2809/blob/main/src/utilities/handleActionTrigger.ts): `src/utilities/handleActionTrigger.ts`
- [Application stores](https://github.com/matwin1978/simutestfall_2809/blob/main/src/store/store.ts): `src/store/store.ts`
- [Action reducers](https://github.com/matwin1978/simutestfall_2809/blob/main/src/utilities/reducers.ts): `src/utilities/reducers.ts`
- [Requirement comparison](https://github.com/matwin1978/simutestfall_2809/blob/main/src/utilities/comparePerformedAndMandatoryActionsSimple.ts): `src/utilities/comparePerformedAndMandatoryActionsSimple.ts`
- [Action utilities](https://github.com/matwin1978/simutestfall_2809/blob/main/src/utilities/utilities.ts): `src/utilities/utilities.ts`
- [Action type guards](https://github.com/matwin1978/simutestfall_2809/blob/main/src/types/typeguards.ts): `src/types/typeguards.ts`
- [URL parameters](https://github.com/matwin1978/simutestfall_2809/blob/main/src/utilities/CustomUrlParams.ts): `src/utilities/CustomUrlParams.ts`
- [Shared state](https://github.com/matwin1978/simutestfall_2809/blob/main/src/store/store.ts): `src/store/store.ts`

### Missions and results

- [Quick navigation](https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/QuickNav/QuickNav.tsx): `src/components/QuickNav/QuickNav.tsx`
- [Mission detail](https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/ViewerMissionDetail/ViewerMissionDetail.tsx): `src/components/ViewerMissionDetail/ViewerMissionDetail.tsx`
- [Mission selection](https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/MissionList/MissionList.tsx): `src/components/MissionList/MissionList.tsx`
- [Mission results](https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/Result/Result.tsx): `src/components/Result/Result.tsx`
- [PDF report](https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/PdfReport/PdfReport.tsx): `src/components/PdfReport/PdfReport.tsx`
- [Action summary](https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/PerformedAndMandatoryActionsListSimple/PerformedAndMandatoryActionsListSimple.tsx): `src/components/PerformedAndMandatoryActionsListSimple/PerformedAndMandatoryActionsListSimple.tsx`

### Device and diagnostics

- [Computer diagnostics](https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/Computer/Computer.tsx): `src/components/Computer/Computer.tsx`
- [Expert system](https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/ExpertSystem/ExpertSystem.tsx): `src/components/ExpertSystem/ExpertSystem.tsx`
- [Smartphone](https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/Smartphone/Smartphone.tsx): `src/components/Smartphone/Smartphone.tsx`
- [Timer app](https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/Smartphone/SmartphoneAppTimer.tsx): `src/components/Smartphone/SmartphoneAppTimer.tsx`
- [Performance settings](https://github.com/matwin1978/simutestfall_2809/blob/main/src/components/PerformanceSettings/PerformanceSettings.tsx): `src/components/PerformanceSettings/PerformanceSettings.tsx`

### Other components

- **Trainee**

## Connections

- Trainee → Application shell: uses
- Application shell → Scene canvas: renders (evidence: `src/App.tsx`)
- Application shell → Inventory: renders (evidence: `src/App.tsx`)
- Application shell → Equipment inventory: renders (evidence: `src/App.tsx`)
- Application shell → Smartphone: renders (evidence: `src/App.tsx`)
- Application shell → Computer diagnostics: renders (evidence: `src/App.tsx`)
- Application shell → Quick navigation: renders (evidence: `src/App.tsx`)
- Application shell → Action handler: invokes (evidence: `src/App.tsx`)
- Application shell → Mission detail: renders (evidence: `src/App.tsx`)
- Application shell → Object actions menu: renders (evidence: `src/App.tsx`)
- Scene canvas → Scene engine: hosts
- Scene engine → Spin controls: uses (evidence: `src/components/ThreeDCanvas/ThreeD.ts`)
- Object actions menu → Action handler: invokes (evidence: `src/components/InteractiveObjectMenu/InteractiveObjectMenu.tsx`)
- Object actions menu → Action utilities: checks conditions (evidence: `src/components/InteractiveObjectMenu/InteractiveObjectMenu.tsx`)
- Inventory → Inventory object: renders (evidence: `src/components/Inventory/Inventory.tsx`)
- Equipment inventory → Inventory submenu: renders (evidence: `src/components/Inventory/EquipmentInventory.tsx`)
- Inventory → Application stores: reads (evidence: `src/components/Inventory/Inventory.tsx`)
- Equipment inventory → Application stores: reads (evidence: `src/components/Inventory/EquipmentInventory.tsx`)
- Inventory object → Inventory submenu: renders (evidence: `src/components/Inventory/InventoryObject.tsx`)
- Action handler → Action reducers: updates actions (evidence: `src/utilities/handleActionTrigger.ts`)
- Action handler → Requirement comparison: checks requirements (evidence: `src/utilities/handleActionTrigger.ts`)
- Action handler → Action utilities: processes requirements (evidence: `src/utilities/handleActionTrigger.ts`)
- Action handler → Application stores: updates state (evidence: `src/utilities/handleActionTrigger.ts`)
- Action handler → Action type guards: checks action type (evidence: `src/utilities/handleActionTrigger.ts`)
- Application stores → Action utilities: initializes actions (evidence: `src/store/store.ts`)
- Application stores → URL parameters: reads parameters (evidence: `src/store/store.ts`)
- Application stores → Requirement comparison: checks completion (evidence: `src/store/store.ts`)
- Quick navigation → Action handler: triggers actions (evidence: `src/components/QuickNav/QuickNav.tsx`)
- Quick navigation → Application stores: reads state (evidence: `src/components/QuickNav/QuickNav.tsx`)
- Mission detail → Application stores: reads state (evidence: `src/components/ViewerMissionDetail/ViewerMissionDetail.tsx`)
- Mission results → Action summary: renders (evidence: `src/components/Result/Result.tsx`)
- Mission results → PDF report: renders (evidence: `src/components/Result/Result.tsx`)
- Mission results → Requirement comparison: compares actions (evidence: `src/components/Result/Result.tsx`)
- Action summary → Requirement comparison: compares actions (evidence: `src/components/PerformedAndMandatoryActionsListSimple/PerformedAndMandatoryActionsListSimple.tsx`)
- Action summary → Application stores: reads log (evidence: `src/components/PerformedAndMandatoryActionsListSimple/PerformedAndMandatoryActionsListSimple.tsx`)
- Computer diagnostics → Expert system: opens (evidence: `src/components/Computer/Computer.tsx`)
- Computer diagnostics → Action handler: triggers actions (evidence: `src/components/Computer/Computer.tsx`)
- Timer app → Action handler: triggers actions (evidence: `src/components/Smartphone/SmartphoneAppTimer.tsx`)
- Timer app → Application stores: reads state (evidence: `src/components/Smartphone/SmartphoneAppTimer.tsx`)
- Performance settings → Application stores: updates settings (evidence: `src/components/PerformanceSettings/PerformanceSettings.tsx`)
- Shared state → Application stores: stores (evidence: `src/store/store.ts`)
