# ravarage/chainmanagement architecture

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

- Interactive diagram: https://gitdiagram.com/ravarage/chainmanagement
- Repository: https://github.com/ravarage/chainmanagement

## Overview

##### Project Type and Purpose
- Desktop GUI application written in Java (Swing/AWT)
- CRUD tool for managing places, employees, products, and shipments
- Local MySQL database backend

##### File Structure
- UI Layer
– CenteFrame.java, MainInterface.java, MainMenu.java, MenuBar.java
– LoginPanel.java, AddEmployee.java, AddPlace.java, AddProduct.java, AddShipment.java
– SQLScreen.java, RightClickWestPanel.java, TextPrompt.java
- Data Access Layer
– DBConnection.java, DBConnector.java
- Utility / Helper Classes
– Password.java (hashing), XMLFile.java (export/import)
- README + SQL scripts (database schema)

##### Key Components
a. Client Application (Java Swing)
- UI Modules (Frames, Panels, Menus)
- Business Logic Modules (CRUD handlers in each “Add*.java” class)
- Utility Modules
b. Database
- MySQL Server
- Tables: login, place, employee, product, shipment
c. External Integrations
- Optionally, XML import/export (XMLFile.java)

##### Relationships & Data Flows
- UI → Business Logic → Data Access → MySQL → Data Access → UI
- LoginPanel calls Password.java to hash credentials, passes to DBConnector
- AddEmployee/AddPlace/AddProduct/AddShipment panels invoke DBConnector methods
- DBConnector & DBConnection manage JDBC connections, execute SQL
- XMLFile can read/write data from these tables

##### Architectural Patterns & Principles
- Layered Architecture (Presentation → Business Logic → Data Access → Database)
- Single Responsibility per class (each panel or frame handles one use case)
- Utility classes separated for cross-cutting concerns (security, file I/O)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        CF["CenteFrame.java"]:::ui
        MI["MainInterface.java"]:::ui
        MM["MainMenu.java"]:::ui
        MB["MenuBar.java"]:::ui
        LP["LoginPanel.java"]:::ui
        AE["AddEmployee.java"]:::ui
        AP["AddPlace.java"]:::ui
        APr["AddProduct.java"]:::ui
        AS["AddShipment.java"]:::ui
        SS["SQLScreen.java"]:::ui
        RC["RightClickWestPanel.java"]:::ui
        TP["TextPrompt.java"]:::ui
    end

    %% Business Logic Layer
    subgraph "Business Logic Layer"
        direction TB
        BLE["AddEmployee.java"]:::logic
        BLP["AddPlace.java"]:::logic
        BLPd["AddProduct.java"]:::logic
        BLS["AddShipment.java"]:::logic
        BSQ["SQLScreen.java"]:::logic
    end

    %% Data Access Layer
    subgraph "Data Access Layer"
        direction TB
        DBC["DBConnector.java"]:::data
        DBCo["DBConnection.java"]:::data
    end

    %% Utility Layer
    subgraph "Utility / Helper"
        direction TB
        PW["Password.java"]:::utility
        XML["XMLFile.java"]:::utility
    end

    %% Persistence Layer
    subgraph "Persistence Layer"
        direction TB
        DB[(MySQL Database)]:::db
    end

    %% Connections
    LP -->|"hashPassword()"| PW
    LP -->|login query| DBC

    AE -->|INSERT Employee| DBC
    AP -->|INSERT Place| DBC
    APr -->|INSERT Product| DBC
    AS -->|INSERT Shipment| DBC
    SS -->|generic SQL ops| DBC

    BLE -->|uses| DBC
    BLP -->|uses| DBC
    BLPd -->|uses| DBC
    BLS -->|uses| DBC
    BSQ -->|uses| DBC

    DBC -->|connect/disconnect| DBCo
    DBCo -->|JDBC| DB

    XML -->|import/export| DBC

    %% Click Events
    click CF "https://github.com/ravarage/chainmanagement/blob/main/CenteFrame.java"
    click MI "https://github.com/ravarage/chainmanagement/blob/main/MainInterface.java"
    click MM "https://github.com/ravarage/chainmanagement/blob/main/MainMenu.java"
    click MB "https://github.com/ravarage/chainmanagement/blob/main/MenuBar.java"
    click LP "https://github.com/ravarage/chainmanagement/blob/main/LoginPanel.java"
    click AE "https://github.com/ravarage/chainmanagement/blob/main/AddEmployee.java"
    click AP "https://github.com/ravarage/chainmanagement/blob/main/AddPlace.java"
    click APr "https://github.com/ravarage/chainmanagement/blob/main/AddProduct.java"
    click AS "https://github.com/ravarage/chainmanagement/blob/main/AddShipment.java"
    click SS "https://github.com/ravarage/chainmanagement/blob/main/SQLScreen.java"
    click RC "https://github.com/ravarage/chainmanagement/blob/main/RightClickWestPanel.java"
    click TP "https://github.com/ravarage/chainmanagement/blob/main/TextPrompt.java"
    click BLE "https://github.com/ravarage/chainmanagement/blob/main/AddEmployee.java"
    click BLP "https://github.com/ravarage/chainmanagement/blob/main/AddPlace.java"
    click BLPd "https://github.com/ravarage/chainmanagement/blob/main/AddProduct.java"
    click BLS "https://github.com/ravarage/chainmanagement/blob/main/AddShipment.java"
    click BSQ "https://github.com/ravarage/chainmanagement/blob/main/SQLScreen.java"
    click DBC "https://github.com/ravarage/chainmanagement/blob/main/DBConnector.java"
    click DBCo "https://github.com/ravarage/chainmanagement/blob/main/DBConnection.java"
    click PW "https://github.com/ravarage/chainmanagement/blob/main/Password.java"
    click XML "https://github.com/ravarage/chainmanagement/blob/main/XMLFile.java"

    %% Styles
    classDef ui fill:#AED6F1,stroke:#3498DB,color:#0B3C5D;
    classDef logic fill:#ABEBC6,stroke:#27AE60,color:#145A32;
    classDef data fill:#FAD7A0,stroke:#E67E22,color:#6E2C00;
    classDef utility fill:#D2B4DE,stroke:#8E44AD,color:#512E5F;
    classDef db fill:#E5E7E9,stroke:#7F8C8D,color:#2C3E50;
```
