# maulana-mash/mashimurelay architecture

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

- Interactive diagram: https://gitdiagram.com/maulana-mash/mashimurelay
- Repository: https://github.com/maulana-mash/mashimurelay

## Overview

Mashimurelay is an IEC 60617 relay-and-motor-control CAD workspace with real-time circuit simulation. Its principal workflow is to assemble and edit a schematic, simulate electrical behavior and protection, then save or export the design. The README also documents templates, component reference and instruction tools, teacher-lock/QR assignments, technical reports, and offline PWA operation. The tree is JavaScript-only; native Android and Tauri implementations are not represented here. Several links are dashed because the relevant orchestration code was not shown.

Main entry points: [`src_dev/js/app.js`](https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/app.js) (Workspace controller), [`src_dev/js/engine.js`](https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/engine.js) (Circuit solver), [`src_dev/js/sound_manager.js`](https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/sound_manager.js) (Simulation audio), [`src_dev/sw.js`](https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/sw.js) (Offline service worker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["CAD Workspace"]
  node_app["Workspace controller<br/>[app.js]"]
  node_canvas["Schematic canvas<br/>[canvas.js]"]
  node_symbols["IEC symbol library<br/>[components_data.js]"]
  node_router["Workspace routing<br/>[router.js]"]
  node_loading["Loading screen<br/>[loading_screen.js]"]
end

subgraph group_simulation["Circuit Simulation"]
  node_engine["Circuit solver<br/>[engine.js]"]
  node_sound["Simulation audio<br/>[sound_manager.js]"]
  node_sounddata["Embedded sound data<br/>[sounds_data.js]"]
end

subgraph group_learning["Learning Tools"]
  node_examples["Circuit templates<br/>[examples_data.js]"]
  node_encyclopedia["Component encyclopedia"]
  node_video["Interactive video guide"]
  node_review["Review tabs<br/>[review_tabs.js]"]
end

subgraph group_projects["Projects and Output"]
  node_projects["Project management<br/>[projects.js]"]
  node_qr["QR code exchange<br/>[qrcode.js]"]
  node_pdf["PDF and BOM export"]
end

subgraph group_platform["Web Platform"]
  node_tauri["Desktop bridge<br/>[tauri_bridge.js]"]
  node_serviceworker["Offline service worker<br/>[sw.js]"]
end

node_user(("Engineer or learner"))
node_browser(("Web browser"))
node_localstorage[("Browser storage")]

node_user -->|"edits design"| node_app
node_app -.->|"coordinates workspace"| node_canvas
node_app -.->|"runs simulation"| node_engine
node_app -.->|"uses symbol library"| node_symbols
node_app -.->|"loads templates"| node_examples
node_app -.->|"opens reference"| node_encyclopedia
node_app -.->|"opens guide"| node_video
node_app -.->|"shows review tools"| node_review
node_app -.->|"manages projects"| node_projects
node_app -.->|"exchanges QR codes"| node_qr
node_app -.->|"exports report"| node_pdf
node_app -.->|"shows loading state"| node_loading
node_engine -.->|"provides simulation state"| node_sound
node_sound -.->|"decodes embedded audio"| node_sounddata
node_app -.->|"routes workspace"| node_router
node_app -.->|"uses desktop bridge"| node_tauri
node_browser -->|"registers offline worker"| node_serviceworker
node_serviceworker -->|"caches app assets"| node_browser
node_app -.->|"stores preferences"| node_localstorage

click node_app "https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/app.js"
click node_canvas "https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/canvas.js"
click node_symbols "https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/components_data.js"
click node_router "https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/router.js"
click node_engine "https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/engine.js"
click node_sound "https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/sound_manager.js"
click node_sounddata "https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/sounds_data.js"
click node_examples "https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/examples_data.js"
click node_encyclopedia "https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/encyclopedia_data.js"
click node_video "https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/instruction_video.js"
click node_review "https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/review_tabs.js"
click node_projects "https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/projects.js"
click node_qr "https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/qrcode.js"
click node_pdf "https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/pdf_report_generator.js"
click node_loading "https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/loading_screen.js"
click node_tauri "https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/tauri_bridge.js"
click node_serviceworker "https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/sw.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_app,node_canvas,node_symbols,node_router,node_loading,node_browser toneBlue
class node_engine,node_sound,node_sounddata,node_localstorage toneAmber
class node_examples,node_encyclopedia,node_video,node_review toneMint
class node_projects,node_qr,node_pdf toneRose
class node_tauri,node_serviceworker,node_user toneIndigo
```

## Components

### CAD Workspace

- [Workspace controller](https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/app.js): `src_dev/js/app.js`
- [Schematic canvas](https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/canvas.js): `src_dev/js/canvas.js`
- [IEC symbol library](https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/components_data.js): `src_dev/js/components_data.js`
- [Workspace routing](https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/router.js): `src_dev/js/router.js`
- [Loading screen](https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/loading_screen.js): `src_dev/js/loading_screen.js`

### Circuit Simulation

- [Circuit solver](https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/engine.js): `src_dev/js/engine.js`
- [Simulation audio](https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/sound_manager.js): `src_dev/js/sound_manager.js`
- [Embedded sound data](https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/sounds_data.js): `src_dev/js/sounds_data.js`

### Learning Tools

- [Circuit templates](https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/examples_data.js): `src_dev/js/examples_data.js`
- [Component encyclopedia](https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/encyclopedia_data.js): `src_dev/js/encyclopedia_data.js`
- [Interactive video guide](https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/instruction_video.js): `src_dev/js/instruction_video.js`
- [Review tabs](https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/review_tabs.js): `src_dev/js/review_tabs.js`

### Projects and Output

- [Project management](https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/projects.js): `src_dev/js/projects.js`
- [QR code exchange](https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/qrcode.js): `src_dev/js/qrcode.js`
- [PDF and BOM export](https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/pdf_report_generator.js): `src_dev/js/pdf_report_generator.js`

### Web Platform

- [Desktop bridge](https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/js/tauri_bridge.js): `src_dev/js/tauri_bridge.js`
- [Offline service worker](https://github.com/maulana-mash/mashimurelay/blob/main/src_dev/sw.js): `src_dev/sw.js`

### Other components

- **Engineer or learner**
- **Web browser**
- **Browser storage**

## Connections

- Engineer or learner → Workspace controller: edits design
- Workspace controller → Schematic canvas: coordinates workspace
- Workspace controller → Circuit solver: runs simulation
- Workspace controller → IEC symbol library: uses symbol library
- Workspace controller → Circuit templates: loads templates
- Workspace controller → Component encyclopedia: opens reference
- Workspace controller → Interactive video guide: opens guide
- Workspace controller → Review tabs: shows review tools
- Workspace controller → Project management: manages projects
- Workspace controller → QR code exchange: exchanges QR codes
- Workspace controller → PDF and BOM export: exports report
- Workspace controller → Loading screen: shows loading state
- Circuit solver → Simulation audio: provides simulation state
- Simulation audio → Embedded sound data: decodes embedded audio
- Workspace controller → Workspace routing: routes workspace
- Workspace controller → Desktop bridge: uses desktop bridge
- Web browser → Offline service worker: registers offline worker
- Offline service worker → Web browser: caches app assets (evidence: `src_dev/sw.js`)
- Workspace controller → Browser storage: stores preferences
