# pancoded/sistematableros architecture

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

- Interactive diagram: https://gitdiagram.com/pancoded/sistematableros
- Repository: https://github.com/pancoded/sistematableros

## Overview

##### Project type and purpose
- This is a standalone Java Swing desktop application (“Sistema de prestación de tableros en Java”).
- It implements a classic 3-tier architecture (UI, business logic, persistence) and uses JPA for database interactions.

##### File structure
- Top-level files:
- README.md – project description
- pom.xml – Maven build and dependency management
- Package breakdown under src/main/java/ar/edu/ottokrause/sistemaTableros:
- gui – Swing forms and frames (Principal, Registro, Pedidos)
- logica – core domain model (Tablero, Usuario, Prestamo, EstadoTablero, EstadoPrestamo, TipoUsuario) and Controladora
- persistencia – JPA controllers (UsuarioJpaController, TableroJpaController, PrestamoJpaController) and persistence unit (persistence.xml)
- src/main/resources/META-INF/persistence.xml – JPA configuration

##### README for additional insights
- Confirms project goal: manage lending (“prestación”) of boards.
- No explicit architecture section, but persistence.xml implies a relational database managed by JPA.

##### Details to capture
- Persistence unit (name, DB connection settings in persistence.xml)
- Entity classes (Tablero, Usuario, Prestamo) inside Persistence or Domain layer
- Exception hierarchy (NonexistentEntityException, PreexistingEntityException) as part of DAO error handling
- Maven as the build orchestrator (pom.xml)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% UI Layer
    subgraph "UI Layer"
        PrincipalJava["Principal.java"]:::ui
        PrincipalForm["Principal.form"]:::ui
        RegistroJava["Registro.java"]:::ui
        RegistroForm["Registro.form"]:::ui
        PedidosJava["Pedidos.java"]:::ui
        PedidosForm["Pedidos.form"]:::ui
        SistemaTableros["SistemaTableros.java"]:::ui
    end

    %% Business Logic Layer
    subgraph "Business Logic Layer"
        Controladora["Controladora.java"]:::bl
        UsuarioBL["Usuario.java"]:::bl
        TableroBL["Tablero.java"]:::bl
        PrestamoBL["Prestamo.java"]:::bl
        EstadoTableroBL["EstadoTablero.java"]:::bl
        EstadoPrestamoBL["EstadoPrestamo.java"]:::bl
        TipoUsuarioBL["TipoUsuario.java"]:::bl
    end

    %% Persistence Layer
    subgraph "Persistence Layer"
        ControladoraPersistencia["ControladoraPersistencia.java"]:::ps
        UsuarioJpa["UsuarioJpaController.java"]:::ps
        TableroJpa["TableroJpaController.java"]:::ps
        PrestamoJpa["PrestamoJpaController.java"]:::ps
        PreexistingEntity["PreexistingEntityException.java"]:::ps
        NonexistentEntity["NonexistentEntityException.java"]:::ps
        IllegalOrphan["IllegalOrphanException.java"]:::ps
        PersistenceConfig["persistence.xml"]:::ps
    end

    %% Database
    Database[(Database)]:::db

    %% Build & Metadata
    pom["pom.xml"]:::meta
    readme["README.md"]:::meta

    %% Connections
    PrincipalJava -->|uses| Controladora
    PrincipalForm -->|uses| Controladora
    RegistroJava -->|uses| Controladora
    RegistroForm -->|uses| Controladora
    PedidosJava -->|uses| Controladora
    PedidosForm -->|uses| Controladora
    SistemaTableros -->|launches| Controladora

    Controladora -->|delegates| ControladoraPersistencia
    ControladoraPersistencia -->|CRUD| UsuarioJpa
    ControladoraPersistencia -->|CRUD| TableroJpa
    ControladoraPersistencia -->|CRUD| PrestamoJpa

    UsuarioJpa -->|SQL| Database
    TableroJpa -->|SQL| Database
    PrestamoJpa -->|SQL| Database

    PersistenceConfig -.->|configures| UsuarioJpa
    PersistenceConfig -.->|configures| TableroJpa
    PersistenceConfig -.->|configures| PrestamoJpa

    pom -->|builds| Controladora
    readme -.->|documents| SistemaTableros

    %% Click Events for UI
    click PrincipalJava "https://github.com/pancoded/sistematableros/blob/main/src/main/java/ar/edu/ottokrause/sistemaTableros/gui/Principal.java"
    click PrincipalForm "https://github.com/pancoded/sistematableros/blob/main/src/main/java/ar/edu/ottokrause/sistemaTableros/gui/Principal.form"
    click RegistroJava "https://github.com/pancoded/sistematableros/blob/main/src/main/java/ar/edu/ottokrause/sistemaTableros/gui/Registro.java"
    click RegistroForm "https://github.com/pancoded/sistematableros/blob/main/src/main/java/ar/edu/ottokrause/sistemaTableros/gui/Registro.form"
    click PedidosJava "https://github.com/pancoded/sistematableros/blob/main/src/main/java/ar/edu/ottokrause/sistemaTableros/gui/Pedidos.java"
    click PedidosForm "https://github.com/pancoded/sistematableros/blob/main/src/main/java/ar/edu/ottokrause/sistemaTableros/gui/Pedidos.form"
    click SistemaTableros "https://github.com/pancoded/sistematableros/blob/main/src/main/java/ar/edu/ottokrause/sistemaTableros/SistemaTableros.java"

    %% Click Events for Business Logic
    click Controladora "https://github.com/pancoded/sistematableros/blob/main/src/main/java/ar/edu/ottokrause/sistemaTableros/logica/Controladora.java"
    click UsuarioBL "https://github.com/pancoded/sistematableros/blob/main/src/main/java/ar/edu/ottokrause/sistemaTableros/logica/Usuario.java"
    click TableroBL "https://github.com/pancoded/sistematableros/blob/main/src/main/java/ar/edu/ottokrause/sistemaTableros/logica/Tablero.java"
    click PrestamoBL "https://github.com/pancoded/sistematableros/blob/main/src/main/java/ar/edu/ottokrause/sistemaTableros/logica/Prestamo.java"
    click EstadoTableroBL "https://github.com/pancoded/sistematableros/blob/main/src/main/java/ar/edu/ottokrause/sistemaTableros/logica/EstadoTablero.java"
    click EstadoPrestamoBL "https://github.com/pancoded/sistematableros/blob/main/src/main/java/ar/edu/ottokrause/sistemaTableros/logica/EstadoPrestamo.java"
    click TipoUsuarioBL "https://github.com/pancoded/sistematableros/blob/main/src/main/java/ar/edu/ottokrause/sistemaTableros/logica/TipoUsuario.java"

    %% Click Events for Persistence
    click ControladoraPersistencia "https://github.com/pancoded/sistematableros/blob/main/src/main/java/ar/edu/ottokrause/sistemaTablerose/persistencia/ControladoraPersistencia.java"
    click UsuarioJpa "https://github.com/pancoded/sistematableros/blob/main/src/main/java/ar/edu/ottokrause/sistemaTablerose/persistencia/UsuarioJpaController.java"
    click TableroJpa "https://github.com/pancoded/sistematableros/blob/main/src/main/java/ar/edu/ottokrause/sistemaTablerose/persistencia/TableroJpaController.java"
    click PrestamoJpa "https://github.com/pancoded/sistematableros/blob/main/src/main/java/ar/edu/ottokrause/sistemaTablerose/persistencia/PrestamoJpaController.java"
    click PreexistingEntity "https://github.com/pancoded/sistematableros/blob/main/src/main/java/ar/edu/ottokrause/sistemaTablerose/persistencia/exceptions/PreexistingEntityException.java"
    click NonexistentEntity "https://github.com/pancoded/sistematableros/blob/main/src/main/java/ar/edu/ottokrause/sistemaTablerose/persistencia/exceptions/NonexistentEntityException.java"
    click IllegalOrphan "https://github.com/pancoded/sistematableros/blob/main/src/main/java/ar/edu/ottokrause/sistemaTablerose/persistencia/exceptions/IllegalOrphanException.java"
    click PersistenceConfig "https://github.com/pancoded/sistematableros/blob/main/src/main/resources/META-INF/persistence.xml"

    %% Click Events for Build & Metadata
    click pom "https://github.com/pancoded/sistematableros/blob/main/pom.xml"
    click readme "https://github.com/pancoded/sistematableros/blob/main/README.md"

    %% Styles
    classDef ui fill:#ADD8E6,stroke:#333;
    classDef bl fill:#90EE90,stroke:#333;
    classDef ps fill:#FFA500,stroke:#333;
    classDef db fill:#DDDDDD,stroke:#333,stroke-width:2px;
    classDef meta fill:#F0E68C,stroke:#333;
```
