# lutzroeder/beamax architecture

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

- Interactive diagram: https://gitdiagram.com/lutzroeder/beamax
- Repository: https://github.com/lutzroeder/beamax

## Overview

##### Project Type and Purpose
- Beamax is a desktop application (likely built in C++ using Microsoft Visual Studio) designed for visually editing and analyzing continuous beam structures.
- The application uses a graphical interface with document–view concepts, combined with an analysis engine to compute beam properties.

##### Analyzing the File Structure
- Top-level directories and files include:
- The .github directory (contains workflow and community files).
- Sample files in the Samples directory (provided for usage/examples).
- The Source directory, which holds all key source code components including headers, implementations, and Visual Studio project/solution files.
- Within Source, notice:
- “Application.cpp/h” – likely the main application entry point and setup.
- “Dialog”, “View”, and “Document” – these files suggest a Document/View architecture, typical of many GUI applications, possibly using MFC.
- “Analysis.cpp/h” – indicates a module designated for beam structure analysis.
- Resource files (Application.rc, ToolBar.bmp) – assets for GUI elements.
- “Object.cpp/h” – could be a base class used in the modeling of the beam components.

##### Key Components
a. Main Application Module:
- “Application” as the entry point that initializes the application, carries out startup routines and orchestrates other components.
b. Graphical User Interface (GUI) / Presentation Layer:
- Components like “Dialog”, “View”, and “ToolBar.bmp” as parts of a windowed interface.
- Document area (“Document.cpp/h”) that is central to the editing/manipulation of beam data.
c. Beam Analysis Module:
- “Analysis” component as the engine/methodology for performing calculations on continuous beam structures.
d. Data / Model Components:
- “Object” classes and potential support modules that represent the beam’s properties and underlying data structure.
e. Supporting Resources:
- Resource files (e.g., Application.rc) which are used to configure the GUI and possibly handle localization, UI definitions, etc.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Main Application Node
    App["Beamax Application"]:::controller

    %% GUI / Presentation Layer Subgraph
    subgraph "GUI/Presentation Layer"
        direction TB
        D["Dialog"]:::presentation
        V["View"]:::presentation
        Doc["Document"]:::presentation
    end

    %% Other Core Components
    An["Analysis Module"]:::controller
    DM["Object/Data Models"]:::data
    Res["Resources"]:::resource
    Samp["Samples/Examples"]:::external

    %% Connections from Main Application
    App -->|"init"| D
    App -->|"init"| V
    App -->|"init"| Doc
    App -->|"triggers"| An
    App -->|"loads"| Res
    App -->|"provides"| Samp

    %% GUI Interactions and Data Flow
    D -->|"userInput"| Doc
    Doc -->|"analyze"| An
    An -->|"updateView"| V
    Doc -->|"binds"| DM

    %% Click Events for Component Mapping
    click App "https://github.com/lutzroeder/beamax/blob/main/Source/Application.cpp"
    click App "https://github.com/lutzroeder/beamax/blob/main/Source/Application.h"
    
    click D "https://github.com/lutzroeder/beamax/blob/main/Source/Dialog.cpp"
    click D "https://github.com/lutzroeder/beamax/blob/main/Source/Dialog.h"
    
    click V "https://github.com/lutzroeder/beamax/blob/main/Source/View.cpp"
    click V "https://github.com/lutzroeder/beamax/blob/main/Source/View.h"
    
    click Doc "https://github.com/lutzroeder/beamax/blob/main/Source/Document.cpp"
    click Doc "https://github.com/lutzroeder/beamax/blob/main/Source/Document.h"
    
    click An "https://github.com/lutzroeder/beamax/blob/main/Source/Analysis.cpp"
    click An "https://github.com/lutzroeder/beamax/blob/main/Source/Analysis.h"
    
    click DM "https://github.com/lutzroeder/beamax/blob/main/Source/Object.cpp"
    click DM "https://github.com/lutzroeder/beamax/blob/main/Source/Object.h"
    
    click Res "https://github.com/lutzroeder/beamax/blob/main/Source/Application.rc"
    click Res "https://github.com/lutzroeder/beamax/blob/main/Source/ToolBar.bmp"
    click Res "https://github.com/lutzroeder/beamax/blob/main/Source/Resource.h"
    
    click Samp "https://github.com/lutzroeder/beamax/blob/main/Samples/Example.bcb"

    %% Style Definitions
    classDef controller fill:#ADD8E6,stroke:#000,stroke-width:2px;
    classDef presentation fill:#90EE90,stroke:#000,stroke-width:2px;
    classDef data fill:#FFFF99,stroke:#000,stroke-width:2px;
    classDef resource fill:#FFA500,stroke:#000,stroke-width:2px;
    classDef external fill:#D3D3D3,stroke:#000,stroke-width:2px;
```
