# maulana-mash/mashimurelay.apk architecture

> Architecture diagram of the GitHub repository maulana-mash/mashimurelay.apk, 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.apk
- Repository: https://github.com/maulana-mash/mashimurelay.apk

## Overview

Mashimurelay is a native Android circuit-design and real-time relay/motor-control simulator. Users create or open a schematic, place and wire IEC-style components, run and interact with its simulation, then save or export the work. The graph also preserves the documented teaching, reference, and classroom-submission capabilities. Some feature paths are represented by their exact asset directories because their implementation files were not sampled; their detailed wiring is therefore omitted.

Main entry points: [`app/src/main/java/com/mashimurelay/app/MainActivity.kt`](https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/MainActivity.kt) (Main activity), [`app/src/main/java/com/mashimurelay/app/nativecad/NativeCanvasView.kt`](https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/nativecad/NativeCanvasView.kt) (CAD canvas), [`app/src/main/java/com/mashimurelay/app/nativecad/NativeComponentRegistry.kt`](https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/nativecad/NativeComponentRegistry.kt) (Component registry), [`app/src/main/java/com/mashimurelay/app/nativecad/VisualComponentAdapter.kt`](https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/nativecad/VisualComponentAdapter.kt) (Visual component library)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App orchestration"]
  node_activity["Main activity<br/>[MainActivity.kt]"]
  node_menu["Compact menus"]
  node_settings[("User settings<br/>[SettingsManager.kt]")]
end

subgraph group_cad["Circuit design"]
  node_canvas["CAD canvas"]
  node_model["Circuit model"]
  node_registry["Component registry"]
  node_library["Visual component library"]
  node_svg["SVG renderer"]
end

subgraph group_runtime["Simulation runtime"]
  node_engine["Circuit solver"]
  node_sound["Simulation audio<br/>[SoundManager.kt]"]
end

subgraph group_projects["Projects and reports"]
  node_workspace[("Workspace files")]
  node_projectlist["Project list"]
  node_pdf["PDF reports"]
end

subgraph group_learning["Learning and classroom"]
  node_templates["Circuit examples"]
  node_instruction["Instructions and videos"]
  node_encyclopedia["Component encyclopedia<br/>[encyclopedia.json]"]
  node_teacher["Teacher lab mode"]
end

node_user(("Designer / learner"))
node_camera(("Device camera"))
node_teacherhost(("Teacher hotspot server"))

node_user -->|"uses"| node_activity
node_activity -->|"controls"| node_canvas
node_activity -->|"builds menus"| node_menu
node_activity -->|"configures library"| node_library
node_activity -->|"manages projects"| node_workspace
node_activity -->|"shows projects"| node_projectlist
node_activity -->|"exports report"| node_pdf
node_activity -->|"reads settings"| node_settings
node_canvas -.->|"holds circuit"| node_model
node_canvas -->|"looks up components"| node_registry
node_canvas -->|"steps simulation"| node_engine
node_canvas -->|"plays interaction sounds"| node_sound
node_canvas -->|"renders symbols"| node_svg
node_canvas -->|"reads preferences"| node_settings
node_library -.->|"lists components"| node_registry
node_library -->|"previews symbols"| node_svg
node_engine -->|"resolves definitions"| node_registry
node_sound -->|"checks sound setting"| node_settings
node_projectlist -.->|"lists projects"| node_workspace
node_pdf -->|"gets component geometry"| node_registry
node_pdf -->|"renders report symbols"| node_svg
node_user -->|"opens examples"| node_templates
node_user -->|"studies instructions"| node_instruction
node_user -->|"consults reference"| node_encyclopedia
node_user -->|"creates lab tasks"| node_teacher
node_teacher -.->|"scans QR tasks"| node_camera
node_teacher -.->|"syncs submissions"| node_teacherhost

click node_activity "https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/MainActivity.kt"
click node_menu "https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/nativecad/CompactMenuHelper.kt"
click node_canvas "https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/nativecad/NativeCanvasView.kt"
click node_model "https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/nativecad/NativeCircuitModel.kt"
click node_registry "https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/nativecad/NativeComponentRegistry.kt"
click node_library "https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/nativecad/VisualComponentAdapter.kt"
click node_svg "https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/nativecad/SvgComponentRenderer.kt"
click node_engine "https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/nativecad/NativeSimulationEngine.kt"
click node_sound "https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/nativecad/SoundManager.kt"
click node_settings "https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/nativecad/SettingsManager.kt"
click node_workspace "https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/nativecad/WorkspaceManager.kt"
click node_projectlist "https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/nativecad/WorkspaceProjectsAdapter.kt"
click node_pdf "https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/nativecad/NativePdfReportGenerator.kt"
click node_templates "https://github.com/maulana-mash/mashimurelay.apk/tree/main/app/src/main/assets/assets/examples"
click node_instruction "https://github.com/maulana-mash/mashimurelay.apk/tree/main/app/src/main/assets/instructions"
click node_encyclopedia "https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/assets/encyclopedia.json"
click node_teacher "https://github.com/maulana-mash/mashimurelay.apk/blob/main/AUDIT_TEACHER_LAB_MODE.md"

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_activity,node_menu,node_settings toneBlue
class node_canvas,node_model,node_registry,node_library,node_svg toneAmber
class node_engine,node_sound,node_teacherhost toneMint
class node_workspace,node_projectlist,node_pdf toneRose
class node_templates,node_instruction,node_encyclopedia,node_teacher,node_user,node_camera toneIndigo
```

## Components

### App orchestration

- [Main activity](https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/MainActivity.kt): `app/src/main/java/com/mashimurelay/app/MainActivity.kt`
- [Compact menus](https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/nativecad/CompactMenuHelper.kt): `app/src/main/java/com/mashimurelay/app/nativecad/CompactMenuHelper.kt`
- [User settings](https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/nativecad/SettingsManager.kt): `app/src/main/java/com/mashimurelay/app/nativecad/SettingsManager.kt`

### Circuit design

- [CAD canvas](https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/nativecad/NativeCanvasView.kt): `app/src/main/java/com/mashimurelay/app/nativecad/NativeCanvasView.kt`
- [Circuit model](https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/nativecad/NativeCircuitModel.kt): `app/src/main/java/com/mashimurelay/app/nativecad/NativeCircuitModel.kt`
- [Component registry](https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/nativecad/NativeComponentRegistry.kt): `app/src/main/java/com/mashimurelay/app/nativecad/NativeComponentRegistry.kt`
- [Visual component library](https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/nativecad/VisualComponentAdapter.kt): `app/src/main/java/com/mashimurelay/app/nativecad/VisualComponentAdapter.kt`
- [SVG renderer](https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/nativecad/SvgComponentRenderer.kt): `app/src/main/java/com/mashimurelay/app/nativecad/SvgComponentRenderer.kt`

### Simulation runtime

- [Circuit solver](https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/nativecad/NativeSimulationEngine.kt): `app/src/main/java/com/mashimurelay/app/nativecad/NativeSimulationEngine.kt`
- [Simulation audio](https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/nativecad/SoundManager.kt): `app/src/main/java/com/mashimurelay/app/nativecad/SoundManager.kt`

### Projects and reports

- [Workspace files](https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/nativecad/WorkspaceManager.kt): `app/src/main/java/com/mashimurelay/app/nativecad/WorkspaceManager.kt`
- [Project list](https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/nativecad/WorkspaceProjectsAdapter.kt): `app/src/main/java/com/mashimurelay/app/nativecad/WorkspaceProjectsAdapter.kt`
- [PDF reports](https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/java/com/mashimurelay/app/nativecad/NativePdfReportGenerator.kt): `app/src/main/java/com/mashimurelay/app/nativecad/NativePdfReportGenerator.kt`

### Learning and classroom

- [Circuit examples](https://github.com/maulana-mash/mashimurelay.apk/tree/main/app/src/main/assets/assets/examples): `app/src/main/assets/assets/examples`
- [Instructions and videos](https://github.com/maulana-mash/mashimurelay.apk/tree/main/app/src/main/assets/instructions): `app/src/main/assets/instructions`
- [Component encyclopedia](https://github.com/maulana-mash/mashimurelay.apk/blob/main/app/src/main/assets/encyclopedia.json): `app/src/main/assets/encyclopedia.json`
- [Teacher lab mode](https://github.com/maulana-mash/mashimurelay.apk/blob/main/AUDIT_TEACHER_LAB_MODE.md): `AUDIT_TEACHER_LAB_MODE.md`

### Other components

- **Designer / learner**
- **Device camera**
- **Teacher hotspot server**

## Connections

- Designer / learner → Main activity: uses (evidence: `README.md`)
- Main activity → CAD canvas: controls (evidence: `app/src/main/java/com/mashimurelay/app/MainActivity.kt`)
- Main activity → Compact menus: builds menus (evidence: `app/src/main/java/com/mashimurelay/app/MainActivity.kt`)
- Main activity → Visual component library: configures library (evidence: `app/src/main/java/com/mashimurelay/app/MainActivity.kt`)
- Main activity → Workspace files: manages projects (evidence: `app/src/main/java/com/mashimurelay/app/MainActivity.kt`)
- Main activity → Project list: shows projects (evidence: `app/src/main/java/com/mashimurelay/app/MainActivity.kt`)
- Main activity → PDF reports: exports report (evidence: `app/src/main/java/com/mashimurelay/app/MainActivity.kt`)
- Main activity → User settings: reads settings (evidence: `app/src/main/java/com/mashimurelay/app/MainActivity.kt`)
- CAD canvas → Circuit model: holds circuit
- CAD canvas → Component registry: looks up components (evidence: `app/src/main/java/com/mashimurelay/app/nativecad/NativeCanvasView.kt`)
- CAD canvas → Circuit solver: steps simulation (evidence: `app/src/main/java/com/mashimurelay/app/nativecad/NativeCanvasView.kt`)
- CAD canvas → Simulation audio: plays interaction sounds (evidence: `app/src/main/java/com/mashimurelay/app/nativecad/NativeCanvasView.kt`)
- CAD canvas → SVG renderer: renders symbols (evidence: `app/src/main/java/com/mashimurelay/app/nativecad/NativeCanvasView.kt`)
- CAD canvas → User settings: reads preferences (evidence: `app/src/main/java/com/mashimurelay/app/nativecad/NativeCanvasView.kt`)
- Visual component library → Component registry: lists components
- Visual component library → SVG renderer: previews symbols (evidence: `app/src/main/java/com/mashimurelay/app/nativecad/VisualComponentAdapter.kt`)
- Circuit solver → Component registry: resolves definitions (evidence: `app/src/main/java/com/mashimurelay/app/nativecad/NativeSimulationEngine.kt`)
- Simulation audio → User settings: checks sound setting (evidence: `app/src/main/java/com/mashimurelay/app/nativecad/SoundManager.kt`)
- Project list → Workspace files: lists projects
- PDF reports → Component registry: gets component geometry (evidence: `app/src/main/java/com/mashimurelay/app/nativecad/NativePdfReportGenerator.kt`)
- PDF reports → SVG renderer: renders report symbols (evidence: `app/src/main/java/com/mashimurelay/app/nativecad/NativePdfReportGenerator.kt`)
- Designer / learner → Circuit examples: opens examples (evidence: `README.md`)
- Designer / learner → Instructions and videos: studies instructions (evidence: `README.md`)
- Designer / learner → Component encyclopedia: consults reference (evidence: `README.md`)
- Designer / learner → Teacher lab mode: creates lab tasks (evidence: `README.md`)
- Teacher lab mode → Device camera: scans QR tasks
- Teacher lab mode → Teacher hotspot server: syncs submissions
