# enekgonztolosaldea/alaiktomugi architecture

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

- Interactive diagram: https://gitdiagram.com/enekgonztolosaldea/alaiktomugi
- Repository: https://github.com/enekgonztolosaldea/alaiktomugi

## Overview

##### Project type and purpose
- This is a Java desktop (Swing/GForms) application (“praktikak”/“alaiktoMugi”) that manages users (“Erabiltzaileak”) and drivers (“Gidariak”) data in a MySQL database. It uses the Java module system, JGoodies Forms for UI layout, and JDBC (mysql-connector) for data access.

##### File structure
- Top-level folders:
- praktikak/src – Java source
– datubasea – data-access layer (DBGestorea, DB_Erabiltzaileak, DB_Gidariak)
– praktikak – UI package (MenuNagusia, ErabiltzaileLehioa, GidariLehioa, HistorialErabiltzaileLehioa)
– module-info.java – Java 9+ module descriptor
- praktikak/lib – external JARs (MySQL connector)
- praktikak/com.jgoodies.*.jar – JGoodies libraries
- praktikak/config/config.properties – DB connection settings
- praktikak/bin – compiled classes

##### (minimal) README
- It only lists the project name (“alaiktoMugi”), confirming this is a small standalone client.

##### Main components & their relationships
a. Presentation/UI layer
- MenuNagusia (main menu)
- ErabiltzaileLehioa (user window)
- GidariLehioa (driver window)
- HistorialErabiltzaileLehioa (user-history window)
– Uses JGoodies Forms for layout
b. Business/Data-access layer
- DBGestorea (central DB manager)
- DB_Erabiltzaileak (user DAO)
- DB_Gidariak (driver DAO)
– Loads config.properties for connection params
c. External service
- MySQL database server
– Accessed via mysql-connector-j JDBC driver
d. Libraries/frameworks
– JGoodies (UI)
– JDBC (mysql-connector)

##### Architectural patterns/design principles
- 2-tier architecture: desktop client ↔ database
- Layered separation:
– UI layer calls business/Data-Access layer
– Data-Access layer interacts with DB via JDBC
– Configuration externalized in properties file
- Modularization via module-info.java

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "UI Layer"
        MN["MenuNagusia"]:::ui
        EL["ErabiltzaileLehioa"]:::ui
        GL["GidariLehioa"]:::ui
        HL["HistorialErabiltzaileLehioa"]:::ui
    end

    subgraph "Business/Data-Access Layer"
        DBG["DBGestorea"]:::data
        DUE["DB_Erabiltzaileak"]:::data
        DUG["DB_Gidariak"]:::data
        MOD["module-info.java"]:::data
    end

    subgraph "Configuration Store"
        CFG["config.properties"]:::config
    end

    subgraph "External Systems"
        MYDB["MySQL Database"]:::external
    end

    subgraph "External Libraries"
        JGF["JGoodies Forms"]:::lib
        JGC["JGoodies Common"]:::lib
        JDBC["MySQL JDBC Driver"]:::lib
    end

    MN -->|"renders UI; calls DAO"| DUE
    EL -->|"renders UI; calls DAO"| DUE
    GL -->|"renders UI; calls DAO"| DUG
    HL -->|"renders UI; calls DAO"| DUE

    DUE -->|"JDBC call"| MYDB
    DUG -->|"JDBC call"| MYDB

    DUE -->|"uses DBGestorea"| DBG
    DUG -->|"uses DBGestorea"| DBG
    DBG -->|"loads config"| CFG

    MOD -->|"module boundary"| MN
    MOD -->|"module boundary"| DBG

    JGF -->|"layout library"| MN
    JGC -->|"layout library"| MN
    JDBC -->|"JDBC driver"| MYDB

    click MN "https://github.com/enekgonztolosaldea/alaiktomugi/blob/main/praktikak/src/praktikak/MenuNagusia.java"
    click EL "https://github.com/enekgonztolosaldea/alaiktomugi/blob/main/praktikak/src/praktikak/ErabiltzaileLehioa.java"
    click GL "https://github.com/enekgonztolosaldea/alaiktomugi/blob/main/praktikak/src/praktikak/GidariLehioa.java"
    click HL "https://github.com/enekgonztolosaldea/alaiktomugi/blob/main/praktikak/src/praktikak/HistorialErabiltzaileLehioa.java"
    click DBG "https://github.com/enekgonztolosaldea/alaiktomugi/blob/main/praktikak/src/datubasea/DBGestorea.java"
    click DUE "https://github.com/enekgonztolosaldea/alaiktomugi/blob/main/praktikak/src/datubasea/DB_Erabiltzaileak.java"
    click DUG "https://github.com/enekgonztolosaldea/alaiktomugi/blob/main/praktikak/src/datubasea/DB_Gidariak.java"
    click CFG "https://github.com/enekgonztolosaldea/alaiktomugi/blob/main/praktikak/config/config.propertiers"
    click MOD "https://github.com/enekgonztolosaldea/alaiktomugi/blob/main/praktikak/src/module-info.java"
    click JGF "https://github.com/enekgonztolosaldea/alaiktomugi/blob/main/praktikak/com.jgoodies.forms_1.9.0.v20240327-0800.jar"
    click JGC "https://github.com/enekgonztolosaldea/alaiktomugi/blob/main/praktikak/com.jgoodies.common_1.8.1.v20240327-0800.jar"
    click JDBC "https://github.com/enekgonztolosaldea/alaiktomugi/blob/main/praktikak/lib/mysql-connector-j-9.2.0.jar"

    classDef ui fill:#cce5ff,stroke:#333,stroke-width:1px
    classDef data fill:#d4edda,stroke:#333,stroke-width:1px
    classDef config fill:#fff3cd,stroke:#333,stroke-width:1px
    classDef external fill:#f8d7da,stroke:#333,stroke-width:1px
    classDef lib fill:#e2e3e5,stroke:#333,stroke-width:1px
```
