# arsalanyavari/mano-simulator architecture

> Architecture diagram of the GitHub repository arsalanyavari/mano-simulator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/arsalanyavari/mano-simulator
- Repository: https://github.com/arsalanyavari/mano-simulator

## Overview

##### Project type and purpose
- This is a standalone desktop simulator for the “Mano Basic Computer,” implemented in C++ using the Qt framework.
- It’s a course project that provides a GUI for loading machine-language programs, stepping through instructions, viewing registers/memory, etc.

##### File structure
- Top level:
- ARYA INSTALLER.exe (installer)
- README.md
- windows portable exe/ – the compiled manosimulator.exe plus all required Qt plugins for Windows
- main.cpp – application entry point (creates QApplication + MainWindow)
- mainwindow.ui – Qt Designer UI definition
- mainwindow.cpp/h – MainWindow class: wires buttons, views, and the simulation engine
- manosimulator.pro – QMake project file

##### README
- Confirms the app is a “Mano Basic Computer” simulator and shows a screenshot of the GUI.

## Diagram (Mermaid)

```mermaid
flowchart TB
    User((User)):::external

    subgraph "User Interface Layer"
        UI_MainUI["mainwindow.ui"]:::ui
        UI_MainCPP["mainwindow.cpp/h"]:::ui
    end

    subgraph "Application Entry Point"
        APP_MainCPP["main.cpp"]:::ui
    end

    subgraph "Simulation Engine"
        SIM_Engine["Simulation Engine\n(Mano CPU model, registers, ALU, control unit)"]:::simulation
    end

    subgraph "Resource Manager"
        RES_QRC["pic.qrc"]:::resource
    end

    subgraph "Build & Qt Framework Integration"
        FW_PRO["manosimulator.pro"]:::framework
        FW_QT["QtCore / QtWidgets / QtGui"]:::framework
    end

    subgraph "OS & Platform Plugins"
        OS_EXE["manosimulator.exe"]:::os
        OS_Platforms["platforms"]:::os
        OS_PluginInput["platforminputcontexts"]:::os
        OS_Styles["styles"]:::os
        OS_Scene["scenegraph"]:::os
        OS_ImageFmt["imageformats"]:::os
        OS_IconEngines["iconengines"]:::os
        OS_Translations["translations/*.qm"]:::os
        OS_QML["qmltooling"]:::os
        OS_VK["virtualkeyboard"]:::os
    end

    User -->|"mouse/keyboard events"| UI_MainUI
    UI_MainUI -->|"invoke loadProgram()/step()"| SIM_Engine
    SIM_Engine -->|"updateUI() signals"| UI_MainUI
    UI_MainCPP -->|"UI logic calls"| SIM_Engine
    APP_MainCPP -->|"initialize QApplication, MainWindow"| UI_MainUI
    SIM_Engine -->|"loadIcon()"| RES_QRC
    UI_MainUI -->|"loadIcon()"| RES_QRC
    SIM_Engine -->|"uses Qt APIs"| FW_QT
    UI_MainUI -->|"uses Qt APIs"| FW_QT
    FW_QT -->|"calls OS API"| OS_EXE
    OS_EXE --> OS_Platforms
    OS_EXE --> OS_PluginInput
    OS_EXE --> OS_Styles
    OS_EXE --> OS_Scene
    OS_EXE --> OS_ImageFmt
    OS_EXE --> OS_IconEngines
    OS_EXE --> OS_Translations
    OS_EXE --> OS_QML
    OS_EXE --> OS_VK

    click UI_MainUI "https://github.com/arsalanyavari/mano-simulator/blob/main/sources&icons/mainwindow.ui"
    click UI_MainCPP "https://github.com/arsalanyavari/mano-simulator/blob/main/sources&icons/mainwindow.cpp"
    click UI_MainCPP "https://github.com/arsalanyavari/mano-simulator/blob/main/sources&icons/mainwindow.h"
    click APP_MainCPP "https://github.com/arsalanyavari/mano-simulator/blob/main/sources&icons/main.cpp"
    click RES_QRC "https://github.com/arsalanyavari/mano-simulator/blob/main/sources&icons/pic.qrc"
    click FW_PRO "https://github.com/arsalanyavari/mano-simulator/blob/main/sources&icons/manosimulator.pro"
    click OS_EXE "https://github.com/arsalanyavari/mano-simulator/blob/main/windows portable exe/manosimulator.exe"
    click OS_Platforms "https://github.com/arsalanyavari/mano-simulator/tree/main/windows portable exe/platforms"
    click OS_PluginInput "https://github.com/arsalanyavari/mano-simulator/tree/main/windows portable exe/platforminputcontexts"
    click OS_Styles "https://github.com/arsalanyavari/mano-simulator/tree/main/windows portable exe/styles"
    click OS_Scene "https://github.com/arsalanyavari/mano-simulator/tree/main/windows portable exe/scenegraph"
    click OS_ImageFmt "https://github.com/arsalanyavari/mano-simulator/tree/main/windows portable exe/imageformats"
    click OS_IconEngines "https://github.com/arsalanyavari/mano-simulator/tree/main/windows portable exe/iconengines"
    click OS_Translations "https://github.com/arsalanyavari/mano-simulator/blob/main/windows portable exe/translations/*.qm"
    click OS_QML "https://github.com/arsalanyavari/mano-simulator/tree/main/windows portable exe/qmltooling"
    click OS_VK "https://github.com/arsalanyavari/mano-simulator/tree/main/windows portable exe/virtualkeyboard"

    classDef ui fill:#D0E1FF,stroke:#034694
    classDef simulation fill:#D4EDDA,stroke:#1E7E34
    classDef resource fill:#D1ECF1,stroke:#0C5460
    classDef framework fill:#FFE5B4,stroke:#E69500
    classDef os fill:#E2E3E5,stroke:#6C757D
    classDef external fill:#FFFFFF,stroke:#000000,stroke-dasharray: 5 5
```
