# is-unina/canale_j_z-javaspritz architecture

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

- Interactive diagram: https://gitdiagram.com/is-unina/canale_j_z-javaspritz
- Repository: https://github.com/is-unina/canale_j_z-javaspritz

## Overview

##### Project type and purpose
- This is a Java-based, console-driven full-stack (three-tier) application for managing production and orders in a toy warehouse (JavaSpritz).
- It implements a clear separation of concerns: Boundary (I/O), Control (business logic), Database (DAO/connection), Entity (domain model), plus Exception handling.

##### File structure
- Top-level “JavaSpritz/src” holds five packages:
- boundary: user-facing interfaces (BoundaryMagazziniere, BoundaryRivenditore)
- control: business logic (GestioneProduzione)
- database: DBManager + DAOs for each entity
- entity: plain domain objects (EntityGiocattolo, EntityOrdine, etc.)
- exception: custom exceptions (DAOException, DBConnectionException, OperationException)
- A “mysql-connector-j-8.0.32.jar” sits in bin to support MySQL connectivity.
- No frontend frameworks—this is a CLI or simple Java UI.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Actors
    subgraph "Actors"
        A1([Magazziniere]):::actor
        A2([Rivenditore]):::actor
    end

    %% Boundary Layer
    subgraph "Boundary Layer"
        BM["BoundaryMagazziniere"]:::boundary
        BR["BoundaryRivenditore"]:::boundary
    end

    %% Control Layer
    subgraph "Control Layer"
        GP["GestioneProduzione"]:::control
    end

    %% Data Access Layer
    subgraph "Data Access Layer"
        subgraph "DAOs"
            GDAO["GiocattoloDAO"]:::dao
            MzDAO["MagazziniereDAO"]:::dao
            MDAO["MagazzinoDAO"]:::dao
            ODAO["OrdineDAO"]:::dao
            RDAO["RivenditoreDAO"]:::dao
        end
        DBM["DBManager"]:::dao
    end

    %% Domain Model
    subgraph "Domain Model"
        E1["EntityGiocattolo"]:::entity
        E2["EntityMagazziniere"]:::entity
        E3["EntityMagazzino"]:::entity
        E4["EntityOrdine"]:::entity
        E5["EntityRivenditore"]:::entity
    end

    %% External Systems
    subgraph "External Systems"
        MySQL[(MySQL Database)]:::db
        JDBC[(mysql-connector-j-8.0.32.jar)]:::external
    end

    %% Connections
    A1 --> BM
    A2 --> BR
    BM --> GP
    BR --> GP

    GP -->|"uses"| DBM
    DBM -->|"manages connection"| GDAO
    DBM -->|"manages connection"| MzDAO
    DBM -->|"manages connection"| MDAO
    DBM -->|"manages connection"| ODAO
    DBM -->|"manages connection"| RDAO

    GDAO --> E1
    MzDAO --> E2
    MDAO --> E3
    ODAO --> E4
    RDAO --> E5

    DBM --> MySQL
    DBM --> JDBC

    %% Exception Flows
    DBM -.->|throws DBConnectionException| GP
    GDAO -.->|throws DAOException| GP
    GP -.->|throws OperationException| BM
    GP -.->|throws OperationException| BR

    %% Click Events
    click BM "https://github.com/is-unina/canale_j_z-javaspritz/blob/main/JavaSpritz/src/boundary/BoundaryMagazziniere.java"
    click BR "https://github.com/is-unina/canale_j_z-javaspritz/blob/main/JavaSpritz/src/boundary/BoundaryRivenditore.java"
    click GP "https://github.com/is-unina/canale_j_z-javaspritz/blob/main/JavaSpritz/src/control/GestioneProduzione.java"
    click DBM "https://github.com/is-unina/canale_j_z-javaspritz/blob/main/JavaSpritz/src/database/DBManager.java"
    click GDAO "https://github.com/is-unina/canale_j_z-javaspritz/blob/main/JavaSpritz/src/database/GiocattoloDAO.java"
    click MzDAO "https://github.com/is-unina/canale_j_z-javaspritz/blob/main/JavaSpritz/src/database/MagazziniereDAO.java"
    click MDAO "https://github.com/is-unina/canale_j_z-javaspritz/blob/main/JavaSpritz/src/database/MagazzinoDAO.java"
    click ODAO "https://github.com/is-unina/canale_j_z-javaspritz/blob/main/JavaSpritz/src/database/OrdineDAO.java"
    click RDAO "https://github.com/is-unina/canale_j_z-javaspritz/blob/main/JavaSpritz/src/database/RivenditoreDAO.java"
    click E1 "https://github.com/is-unina/canale_j_z-javaspritz/blob/main/JavaSpritz/src/entity/EntityGiocattolo.java"
    click E2 "https://github.com/is-unina/canale_j_z-javaspritz/blob/main/JavaSpritz/src/entity/EntityMagazziniere.java"
    click E3 "https://github.com/is-unina/canale_j_z-javaspritz/blob/main/JavaSpritz/src/entity/EntityMagazzino.java"
    click E4 "https://github.com/is-unina/canale_j_z-javaspritz/blob/main/JavaSpritz/src/entity/EntityOrdine.java"
    click E5 "https://github.com/is-unina/canale_j_z-javaspritz/blob/main/JavaSpritz/src/entity/EntityRivenditore.java"
    click exception1 "https://github.com/is-unina/canale_j_z-javaspritz/blob/main/JavaSpritz/src/exception/DAOException.java"
    click exception2 "https://github.com/is-unina/canale_j_z-javaspritz/blob/main/JavaSpritz/src/exception/DBConnectionException.java"
    click exception3 "https://github.com/is-unina/canale_j_z-javaspritz/blob/main/JavaSpritz/src/exception/OperationException.java"

    %% Styles
    classDef actor fill:#D5D8DC,stroke:#2E86C1,color:#1B2631;
    classDef boundary fill:#AED6F1,stroke:#21618C,color:#1B2631;
    classDef control fill:#A9DFBF,stroke:#196F3D,color:#1B2631;
    classDef dao fill:#F5B041,stroke:#B9770E,color:#1B2631;
    classDef entity fill:#FADBD8,stroke:#C0392B,color:#1B2631;
    classDef db fill:#D5D8DC,stroke:#5D6D7E,color:#1B2631;
    classDef external fill:#EBEDEF,stroke:#7B7D7D,color:#1B2631;
```
