# abdulrahmanalkhawwam/dsa-2-project architecture

> Architecture diagram of the GitHub repository abdulrahmanalkhawwam/dsa-2-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/abdulrahmanalkhawwam/dsa-2-project
- Repository: https://github.com/abdulrahmanalkhawwam/dsa-2-project

## Overview

##### Project type and purpose
- This is a monolithic, desktop‐based Java application (no web or microservices), organized as a set of algorithmic exercises (“First_Question”, “Second_Question”, “Form3”, “Form4and5”, “Form6”) that provide:
- GUI screens for user input and visualization (Swing-style classes under each “screens” or “inoutputRec” folder)
- Core algorithm implementations (under each “algorithm” folder)
- File I/O modules to import/export data (under each “files” or “inoutputRec” folder)
- There are multiple entry points (Main.java in root, First_Question, Second_Question, Form3, Form4and5 packages).

##### File structure
- Top-level packages under src:
- First_Question – question 1 logic
- Second_Question – question 2 logic
- Form3, Form4and5, Form6 – standalone exercise modules
- algo – shared model classes (Rectangle, TreeNode)
- Each question folder contains three logical subpackages: algorithm (business logic), files (data access), screens (presentation layer).
- There are Java Main classes at different levels serving as application entry points.
- No external config or build scripts are present, implying an IDE-centric build (e.g., IntelliJ).

##### Available documentation
- The README is empty; rely on naming conventions and package structure to infer layering (UI → Logic → Data).

##### Elements
- UI → Logic (invoke compute methods)
- Logic → Models (instantiate Rectangle, TreeNode)
- UI/Logic → Data (read/write calls)
- EntryPoint → UI (application start)
- Yellow for Shared Models
- Orange for File I/O
- Diamonds or circles for Entry Points

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% First Question Module
    subgraph "First_Question Module"
        direction TB
        FQ_EP(["Main"]):::entry
        subgraph "UI Layer"
            direction TB
            FQ_UI1["MessageDisplayGUI"]:::ui
            FQ_UI2["NodesInput"]:::ui
            FQ_UI3["RectangleDraw"]:::ui
            FQ_UI4["StringInputFrame"]:::ui
            FQ_UI5["TreeVisualization"]:::ui
            FQ_UI6["BinaryTreeDrawer"]:::ui
        end
        subgraph "Business Logic"
            direction TB
            FQ_L1["BinaryTree"]:::logic
            FQ_L2["MergeRectangle"]:::logic
            FQ_L3["Node"]:::logic
            FQ_L4["converter"]:::logic
            FQ_L5["form4_5"]:::logic
            subgraph "order6"
                direction TB
                FQ_L6["RectangleChar"]:::logic
                FQ_L7["RectangleString"]:::logic
            end
        end
        subgraph "Data Access"
            direction TB
            FQ_D1["readFile"]:::data
            FQ_D2["writeFile"]:::data
            subgraph "order2"
                direction TB
                FQ_D3["order2"]:::data
            end
            subgraph "order3"
                direction TB
                FQ_D4["export_3"]:::data
                FQ_D5["import_3"]:::data
                FQ_D6["form"]:::data
            end
            subgraph "order4"
                direction TB
                FQ_D7["export_4"]:::data
            end
        end
    end

    %% Second Question Module
    subgraph "Second_Question Module"
        direction TB
        SQ_EP(["Main"]):::entry
        subgraph "UI Layer"
            direction TB
            SQ_UI1["BinaryTreePanel"]:::ui
            SQ_UI2["FrameGUI"]:::ui
            SQ_UI3["TreeGUI"]:::ui
        end
        subgraph "Business Logic"
            direction TB
            SQ_L1["BinaryTree"]:::logic
            SQ_L2["BinaryTreeNode"]:::logic
            SQ_L3["GeneralTree"]:::logic
            SQ_L4["GeneralTreeNode"]:::logic
        end
        subgraph "Data Access"
            direction TB
            SQ_D1["GeneEX"]:::data
            SQ_D2["GeneralTree"]:::data
            SQ_D3["test"]:::data
        end
    end

    %% Form3 Module
    subgraph "Form3 Module"
        direction TB
        F3_EP1["Form3Exp"]:::entry
        F3_EP2["Form3Imp"]:::entry
        subgraph "UI & Data"
            direction TB
            F3_UD1["DrwoRectangleForm3"]:::ui
            F3_UD2["ReadRectangleForm3"]:::data
        end
    end

    %% Form4and5 Module
    subgraph "Form4and5 Module"
        direction TB
        F45_EP["Form45"]:::entry
        subgraph "UI Layer"
            direction TB
            F45_UI["DrawRecForm4"]:::ui
        end
        subgraph "Business Logic"
            direction TB
            F45_L["MergeRectangle"]:::logic
        end
    end

    %% Form6 Module
    subgraph "Form6 Module"
        direction TB
        F6_L1["RectangleChar"]:::logic
        F6_L2["RectangleString"]:::logic
    end

    %% Shared Models
    subgraph "Shared Models (algo)"
        direction TB
        SM1["Rectangle"]:::model
        SM2["TreeNode"]:::model
    end

    %% Global Entry Point
    GE["Main"]:::entry

    %% Relationships
    FQ_EP -->|starts| FQ_UI1
    FQ_UI1 -->|invoke| FQ_L1
    FQ_UI2 -->|invoke| FQ_L1
    FQ_UI3 -->|invoke| FQ_L2
    FQ_UI4 -->|invoke| FQ_L4
    FQ_UI5 -->|invoke| FQ_L1
    FQ_UI6 -->|invoke| FQ_L1
    FQ_L1 -->|uses| SM2
    FQ_L2 -->|uses| SM1
    FQ_UI1 -->|read/write| FQ_D1
    FQ_L4 -->|read/write| FQ_D2

    SQ_EP -->|starts| SQ_UI1
    SQ_UI1 -->|invoke| SQ_L1
    SQ_UI2 -->|invoke| SQ_L3
    SQ_UI3 -->|invoke| SQ_L3
    SQ_L1 -->|uses| SM2
    SQ_L3 -->|uses| SM2
    SQ_UI1 -->|read/write| SQ_D1

    F3_EP1 -->|starts| F3_UD1
    F3_UD1 -->|uses| F3_UD2
    F3_EP2 -->|starts| F3_UD2

    F45_EP -->|starts| F45_UI
    F45_UI -->|invoke| F45_L
    F45_L -->|uses| SM1

    GE -->|launches| FQ_EP
    GE -->|launches| SQ_EP
    GE -->|launches| F3_EP1
    GE -->|launches| F3_EP2
    GE -->|launches| F45_EP

    %% Click Events
    click FQ_UI1 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/First_Question/screens/first_Question/MessageDisplayGUI.java"
    click FQ_UI2 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/First_Question/screens/first_Question/NodesInput.java"
    click FQ_UI3 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/First_Question/screens/first_Question/RectangleDraw.java"
    click FQ_UI4 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/First_Question/screens/first_Question/StringInputFrame.java"
    click FQ_UI5 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/First_Question/screens/first_Question/TreeVisualization.java"
    click FQ_UI6 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/First_Question/screens/BinaryTreeDrawer.java"
    click FQ_L1 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/First_Question/algorithm/BinaryTree.java"
    click FQ_L2 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/First_Question/algorithm/MergeRectangle.java"
    click FQ_L3 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/First_Question/algorithm/Node.java"
    click FQ_L4 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/First_Question/algorithm/converter.java"
    click FQ_L5 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/First_Question/algorithm/form4_5.java"
    click FQ_L6 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/First_Question/algorithm/order6/RectangleChar.java"
    click FQ_L7 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/First_Question/algorithm/order6/RectangleString.java"
    click FQ_D1 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/First_Question/files/readFile.java"
    click FQ_D2 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/First_Question/files/writeFile.java"
    click FQ_D3 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/tree/main/src/First_Question/files/order2/order2"
    click FQ_D4 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/tree/main/src/First_Question/files/order3/export_3"
    click FQ_D5 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/tree/main/src/First_Question/files/order3/import_3"
    click FQ_D6 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/tree/main/src/First_Question/files/order3/form"
    click FQ_D7 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/tree/main/src/First_Question/files/order4/export_4"
    click FQ_EP "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/First_Question/Main.java"
    click SQ_UI1 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/Second_Question/screens/BinaryTreePanel.java"
    click SQ_UI2 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/Second_Question/screens/FrameGUI.java"
    click SQ_UI3 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/Second_Question/screens/TreeGUI.java"
    click SQ_L1 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/Second_Question/algorithm/BinaryTree.java"
    click SQ_L2 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/Second_Question/algorithm/BinaryTreeNode.java"
    click SQ_L3 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/Second_Question/algorithm/GeneralTree.java"
    click SQ_L4 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/Second_Question/algorithm/GeneralTreeNode.java"
    click SQ_D1 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/tree/main/src/Second_Question/files/GeneEX"
    click SQ_D2 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/tree/main/src/Second_Question/files/GeneralTree"
    click SQ_D3 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/tree/main/src/Second_Question/files/test"
    click SQ_EP "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/Second_Question/Main.java"
    click F3_EP1 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/Form3/Form3Exp.java"
    click F3_EP2 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/Form3/Form3Imp.java"
    click F3_UD1 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/Form3/inoutputRec/DrwoRectangleForm3.java"
    click F3_UD2 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/Form3/inoutputRec/ReadRectangleForm3.java"
    click F45_EP "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/Form4and5/Form45.java"
    click F45_UI "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/Form4and5/DrawRecForm4.java"
    click F45_L "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/Form4and5/MergeRectangle.java"
    click F6_L1 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/Form6/RectangleChar.java"
    click F6_L2 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/Form6/RectangleString.java"
    click SM1 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/algo/Rectangle.java"
    click SM2 "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/algo/TreeNode.java"
    click GE "https://github.com/abdulrahmanalkhawwam/dsa-2-project/blob/main/src/Main.java"

    %% Styles
    classDef ui fill:#ADD8E6,stroke:#333,stroke-width:1px;
    classDef logic fill:#90EE90,stroke:#333,stroke-width:1px;
    classDef data fill:#FFA500,stroke:#333,stroke-width:1px;
    classDef model fill:#FFFF99,stroke:#333,stroke-width:1px;
    classDef entry fill:#D3D3D3,stroke:#333,stroke-width:1px;
```
