# javprog24/biblioteca architecture

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

- Interactive diagram: https://gitdiagram.com/javprog24/biblioteca
- Repository: https://github.com/javprog24/biblioteca

## Overview

##### Project type and purpose
- This is a standalone Java SE desktop application for library management (monolithic, MVC-style).
- Purpose: allow registration of users, books, and the management of book loans via a local or remote relational database, using stored procedures.

##### File structure
- Top-level:
- src/main/java – application code
- src/SQL – database schema and stored-procedure scripts
- Within src/main/java:
- Views – all Swing/Java‐UI forms (presentation layer)
- Controllers – divided into “Datos” (data access) and “Operadores” (business logic)
- Models – POJOs representing domain entities (Usuario, Libro, Prestamo, etc.)
- Main.java – application entry point
- Configuration: .gitignore, IDE configs, README

##### README
- Confirms Java SE tech stack, basic features, and SQL as the persistence mechanism

##### Detailed elements
- Presentation: Views (FrmUsuario, FrmLibro, FrmPrestamo, LoginPrincipal, BibliotecaPrincipal) + Shared Components
- Business Logic: ControladorUsuario, ControladorLibro, ControladorPrestamo, etc.
- SP Builders: CadenaSPCreator, PropiedadesCreator
- DAO Interfaces: Acceso_DB, ExecuteSP
- DAO Impl: ConexionDB, ExecuteQuery
- Models: Usuario, Libro, Prestamo, Ejemplar, Bibliotecario
- Database: scripts under src/SQL, stored procedures

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Entry Point
    Main["Main.java"]:::entry
    click Main "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Main.java"

    %% Presentation Layer
    subgraph "Presentation Layer" 
        direction TB
        Views["Java Swing Forms"]:::presentation
        click Views "https://github.com/javprog24/biblioteca/tree/master/src/main/java/Views"
        BP["BibliotecaPrincipal"]:::presentation
        click BP "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Views/BibliotecaPrincipal.java"
        LP["LoginPrincipal"]:::presentation
        click LP "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Views/LoginPrincipal.java"
        subgraph "Usuario Forms"
            direction TB
            FU["FrmUsuario"]:::presentation
            click FU "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Views/Usuario/FrmUsuario.java"
            FUF["FrmUsuarioForm"]:::presentation
            click FUF "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Views/Usuario/FrmUsuarioForm.java"
        end
        subgraph "Libro Forms"
            direction TB
            FL["FrmLibro"]:::presentation
            click FL "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Views/Libro/FrmLibro.java"
            FLF["FrmLibroForm"]:::presentation
            click FLF "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Views/Libro/FrmLibroForm.java"
        end
        subgraph "Prestamo Forms"
            direction TB
            FP["FrmPrestamo"]:::presentation
            click FP "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Views/Prestamo/FrmPrestamo.java"
            FPF["FrmPrestamoForm"]:::presentation
            click FPF "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Views/Prestamo/FrmPrestamoForm.java"
        end
        subgraph "Shared UI Assets" 
            direction TB
            CC["ColorComponent"]:::shared
            click CC "https://github.com/javprog24/biblioteca/blob/master/src/main/Resources/Shared/ColorComponent.java"
            DC["DialogComponent"]:::shared
            click DC "https://github.com/javprog24/biblioteca/blob/master/src/main/Resources/Shared/DialogComponent.java"
            DFC["DialogFormComponent"]:::shared
            click DFC "https://github.com/javprog24/biblioteca/blob/master/src/main/Resources/Shared/DialogFormComponent.java"
            NC["NotificationComponent"]:::shared
            click NC "https://github.com/javprog24/biblioteca/blob/master/src/main/Resources/Shared/NotificationComponent.java"
            TC["TableComponent"]:::shared
            click TC "https://github.com/javprog24/biblioteca/blob/master/src/main/Resources/Shared/TableComponent.java"
        end
    end

    %% Business Logic Layer
    subgraph "Business Logic Layer"
        direction TB
        Controllers["Controller Methods"]:::logic
        subgraph "Operadores.Metodos"
            direction TB
            CU["ControladorUsuario"]:::logic
            click CU "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Controllers/Operadores/Metodos/ControladorUsuario.java"
            CL["ControladorLibro"]:::logic
            click CL "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Controllers/Operadores/Metodos/ControladorLibro.java"
            CP["ControladorPrestamo"]:::logic
            click CP "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Controllers/Operadores/Metodos/ControladorPrestamo.java"
            CE["ControladorEjemplar"]:::logic
            click CE "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Controllers/Operadores/Metodos/ControladorEjemplar.java"
            CB["ControladorBiblioteca"]:::logic
            click CB "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Controllers/Operadores/Metodos/ControladorBiblioteca.java"
            CG["ControladorGeneral"]:::logic
            click CG "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Controllers/Operadores/Metodos/ControladorGeneral.java"
        end
        subgraph "SP Builders"
            direction TB
            CSP["CadenaSPCreator"]:::logic
            click CSP "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Controllers/Operadores/Creators/CadenaSPCreator.java"
            PCP["PropiedadesCreator"]:::logic
            click PCP "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Controllers/Operadores/Creators/PropiedadesCreator.java"
        end
        subgraph "Enums"
            direction TB
            EC["E_CODIGO_SP"]:::logic
            click EC "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Controllers/Operadores/Enums/E_CODIGO_SP.java"
            EP["E_PARAMETRO"]:::logic
            click EP "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Controllers/Operadores/Enums/E_PARAMETRO.java"
            ER["E_ROL"]:::logic
            click ER "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Controllers/Operadores/Enums/E_ROL.java"
        end
    end

    %% Data Access Layer
    subgraph "Data Access Layer"
        direction TB
        Interfaces["DAO Interfaces"]:::data
        subgraph "Interfaces"
            direction TB
            AD["Acceso_DB"]:::data
            click AD "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Controllers/Datos/Interface/Acceso_DB.java"
            ES["ExecuteSP"]:::data
            click ES "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Controllers/Datos/Interface/ExecuteSP.java"
        end
        subgraph "JDBC Implementations"
            direction TB
            CDB["ConexionDB"]:::data
            click CDB "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Controllers/Datos/DbOperaciones/ConexionDB.java"
            EQ["ExecuteQuery"]:::data
            click EQ "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Controllers/Datos/DbOperaciones/ExecuteQuery.java"
        end
    end

    %% Model Layer
    subgraph "Model Layer"
        direction TB
        MU["Usuario"]:::model
        click MU "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Models/Usuario.java"
        ML["Libro"]:::model
        click ML "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Models/Libro.java"
        MP["Prestamo"]:::model
        click MP "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Models/Prestamo.java"
        ME["Ejemplar"]:::model
        click ME "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Models/Ejemplar.java"
        MB["Bibliotecario"]:::model
        click MB "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Models/Bibliotecario.java"
        MEN["Entidad"]:::model
        click MEN "https://github.com/javprog24/biblioteca/blob/master/src/main/java/Models/Entidad.java"
    end

    %% Database
    DB[(Relational Database)]:::database
    click DB "https://github.com/javprog24/biblioteca/tree/master/src/SQL"

    %% Data Flows
    Main --> Views
    Views --> CU
    Views --> CL
    Views --> CP
    Views --> CE
    Views --> CB
    Controllers --> Interfaces
    CU --> CSP
    CU --> AD
    CL --> CSP
    CL --> AD
    CP --> CSP
    CP --> AD
    AD --> CDB
    ES --> EQ
    CDB --> DB
    EQ --> DB
    DB --> EQ
    EQ --> CU
    CU --> Views

    %% Styles
    classDef entry fill:#d3d3d3,stroke:#333,stroke-width:1px
    classDef presentation fill:#add8e6,stroke:#1f4e79,stroke-width:1px
    classDef shared fill:#87cefa,stroke:#1f4e79,stroke-width:1px
    classDef logic fill:#90ee90,stroke:#2e7d32,stroke-width:1px
    classDef data fill:#ffa500,stroke:#bf360c,stroke-width:1px
    classDef model fill:#ffffe0,stroke:#a1887f,stroke-width:1px
    classDef database fill:#b0c4de,stroke:#37474f,stroke-width:2px,stroke-dasharray: 5 5
```
