# eriquito00/proyectoaplicacionescalada architecture

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

- Interactive diagram: https://gitdiagram.com/eriquito00/proyectoaplicacionescalada
- Repository: https://github.com/eriquito00/proyectoaplicacionescalada

## Overview

##### Project Type and Purpose
- This is a Java-based, console (CLI) application for managing climbing schools, routes, and users using a MySQL database.
- It follows a three-tier (MVC-style) architecture with a DAO layer for database access and uses Docker to provision the MySQL instance.

##### Main Components
a. User Interface (View)
- `src/view/View.java`
- Presents menus, reads user input, displays results.
b. Controller Layer
- Entry point: `src/controller/Main.java`
- Menu classes: `src/controller/menus/MenuClasses.java`, `MenuAvanzados.java`
- CRUD handlers in `src/controller/classes/{create, read, update, delete}`
- Routes user commands to the DAO layer.
c. Model Layer
- Domain classes: `src/model/classes/{Escalador, Escola, Sector, Via}`
- Connection manager: `src/model/connection/MySQLConnection.java` (JDBC setup)
- DAO interfaces: `src/model/dao/interfaces/*.java`
- DAO implementations: `src/model/dao/MySQLDAO/MySQLEscaladorDAO.java`, etc.
d. Database
- MySQL container defined in `docker-compose.yml`
- Initialization scripts in `docker/{bd-inicial.sql, data-inicial.sql, advanced-query.sql}`
e. Build & Runtime
- Maven (`pom.xml`) for dependencies and build lifecycle
- Docker for database provisioning

##### Relationships and Data Flow
- User → View: types command in console
- View → Controller: relays menu selection and parameters
- Controller → DAO interface: invokes `create()`, `read()`, `update()`, `delete()` or advanced queries
- DAO impl → MySQLConnection: obtains JDBC `Connection`
- Connection → MySQL container: executes SQL, returns `ResultSet`
- Results propagate back up: DAO → Controller → View → User

##### Architectural Patterns & Principles
- Layered (Separation of Concerns): View / Controller / Model / DAO
- DAO Pattern: isolates SQL logic behind interfaces
- JDBC Connection Pooling or single‐connection abstraction in `MySQLConnection`
- Containerization: database as disposable service

a. Layout
- Layers vertically or horizontally:
[CLI View] → [Controller Package] → [DAO Layer (Interfaces + Impl)] → [MySQLConnection] → [MySQL DB Container]
- Rectangles for Java components (View, Controller, DAO)
- Blue = Application code
- Green = Database services
- Orange = Build & deployment tools
d. Annotations
- Next to the DB container, list initialization scripts (`bd-inicial.sql`, etc.)
- Near the DAO layer, note “Implements EscaladorDAO, EscolaDAO, …”
- By the Controller, note “Menus & CRUD handlers”

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Actors
    User["User"]:::external

    %% CLI View Layer
    subgraph "CLI View Layer"
        View["View"]:::app
    end

    %% Controller Layer
    subgraph "Controller Layer"
        Main["Main (Entry)"]:::app
        MenuClasses["MenuClasses"]:::app
        MenuAvanzados["MenuAvanzados"]:::app
        subgraph "CRUD Handlers"
            creaEscalador["creaEscalador"]:::app
            creaEscola["creaEscola"]:::app
            creaSector["creaSector"]:::app
            creaVia["creaVia"]:::app
            mostrarTodo["mostrarTodo"]:::app
            mostrarUno["mostrarUno"]:::app
            actualizarEscalador["actualizarEscalador"]:::app
            actualizarEscola["actualizarEscola"]:::app
            actualizarSector["actualizarSector"]:::app
            actualizarVia["actualizarVia"]:::app
            borrarObjeto["borrarObjeto"]:::app
        end
    end

    %% Model Layer
    subgraph "Model Layer"
        subgraph "Domain Classes"
            Escalador["Escalador"]:::app
            Escola["Escola"]:::app
            Sector["Sector"]:::app
            Via["Via"]:::app
        end
        MySQLConnection["MySQLConnection"]:::app
        subgraph "DAO Interfaces"
            EscaladorDAO["EscaladorDAO"]:::app
            EscolaDAO["EscolaDAO"]:::app
            SectorDAO["SectorDAO"]:::app
            ViaDAO["ViaDAO"]:::app
        end
        subgraph "DAO Implementations"
            MySQLEscaladorDAO["MySQLEscaladorDAO"]:::app
            MySQLEscolaDAO["MySQLEscolaDAO"]:::app
            MySQLSectorDAO["MySQLSectorDAO"]:::app
            MySQLViaDAO["MySQLViaDAO"]:::app
            MySQLAncoratgeDAO["MySQLAncoratgeDAO"]:::app
            MySQLDificultatDAO["MySQLDificultatDAO"]:::app
            MySQLPoblacionsDAO["MySQLPoblacionsDAO"]:::app
            MySQLTipusDAO["MySQLTipusDAO"]:::app
            MySQLTipusRocaDAO["MySQLTipusRocaDAO"]:::app
        end
    end

    %% Infrastructure Layer
    subgraph "Infrastructure"
        DB["MySQL DB Container"]:::db
        Docker["Docker\n(docker-compose)"]:::tool
        Maven["Maven\n(pom.xml)"]:::tool
    end

    %% Data Flow
    User -->|"types command"| View
    View -->|"menuSelection"| Main
    Main --> MenuClasses
    Main --> MenuAvanzados

    MenuClasses --> creaEscalador
    MenuClasses --> creaEscola
    MenuClasses --> creaSector
    MenuClasses --> creaVia
    MenuAvanzados --> mostrarTodo
    MenuAvanzados --> mostrarUno
    MenuClasses --> actualizarEscalador
    MenuClasses --> actualizarEscola
    MenuClasses --> actualizarSector
    MenuClasses --> actualizarVia
    MenuClasses --> borrarObjeto

    creaEscalador -->|"create()"| EscaladorDAO
    creaEscola -->|"create()"| EscolaDAO
    creaSector -->|"create()"| SectorDAO
    creaVia -->|"create()"| ViaDAO

    mostrarTodo -->|"read()"| EscaladorDAO
    mostrarUno -->|"read()"| EscaladorDAO
    actualizarEscalador -->|"update()"| EscaladorDAO
    actualizarEscola -->|"update()"| EscolaDAO
    actualizarSector -->|"update()"| SectorDAO
    actualizarVia -->|"update()"| ViaDAO
    borrarObjeto -->|"delete()"| EscaladorDAO

    %% Interfaces to implementations
    EscaladorDAO --> MySQLEscaladorDAO
    EscolaDAO --> MySQLEscolaDAO
    SectorDAO --> MySQLSectorDAO
    ViaDAO --> MySQLViaDAO
    EscaladorDAO -.-> MySQLAncoratgeDAO
    EscaladorDAO -.-> MySQLDificultatDAO
    EscaladorDAO -.-> MySQLPoblacionsDAO
    EscaladorDAO -.-> MySQLTipusDAO
    EscaladorDAO -.-> MySQLTipusRocaDAO

    %% DB Access
    MySQLEscaladorDAO -->|"getConnection()"| MySQLConnection
    MySQLEscolaDAO --> MySQLConnection
    MySQLSectorDAO --> MySQLConnection
    MySQLViaDAO --> MySQLConnection
    MySQLAncoratgeDAO --> MySQLConnection
    MySQLDificultatDAO --> MySQLConnection
    MySQLPoblacionsDAO --> MySQLConnection
    MySQLTipusDAO --> MySQLConnection
    MySQLTipusRocaDAO --> MySQLConnection

    MySQLConnection -->|"execute SQL"| DB
    DB -->|"ResultSet"| MySQLConnection
    MySQLConnection --> MySQLEscaladorDAO

    %% Tools
    Maven -.-> View
    Docker -.-> DB

    %% Click Events
    click View "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/view/View.java"
    click Main "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/controller/Main.java"
    click MenuClasses "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/controller/menus/MenuClasses.java"
    click MenuAvanzados "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/controller/menus/MenuAvanzados.java"
    click creaEscalador "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/controller/classes/create/creaEscalador.java"
    click creaEscola "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/controller/classes/create/creaEscola.java"
    click creaSector "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/controller/classes/create/creaSector.java"
    click creaVia "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/controller/classes/create/creaVia.java"
    click mostrarTodo "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/controller/classes/read/mostrarTodo.java"
    click mostrarUno "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/controller/classes/read/mostrarUno.java"
    click actualizarEscalador "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/controller/classes/update/actualizarEscalador.java"
    click actualizarEscola "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/controller/classes/update/actualizarEscola.java"
    click actualizarSector "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/controller/classes/update/actualizarSector.java"
    click actualizarVia "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/controller/classes/update/actualizarVia.java"
    click borrarObjeto "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/controller/classes/delete/borrarObjeto.java"
    click Escalador "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/model/classes/Escalador.java"
    click Escola "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/model/classes/Escola.java"
    click Sector "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/model/classes/Sector.java"
    click Via "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/model/classes/Via.java"
    click MySQLConnection "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/model/connection/MySQLConnection.java"
    click EscaladorDAO "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/model/dao/interfaces/EscaladorDAO.java"
    click EscolaDAO "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/model/dao/interfaces/EscolaDAO.java"
    click SectorDAO "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/model/dao/interfaces/SectorDAO.java"
    click ViaDAO "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/model/dao/interfaces/ViaDAO.java"
    click MySQLEscaladorDAO "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/model/dao/MySQLDAO/MySQLEscaladorDAO.java"
    click MySQLEscolaDAO "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/model/dao/MySQLDAO/MySQLEscolaDAO.java"
    click MySQLSectorDAO "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/model/dao/MySQLDAO/MySQLSectorDAO.java"
    click MySQLViaDAO "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/src/model/dao/MySQLDAO/MySQLViaDAO.java"
    click Docker "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/docker-compose.yml"
    click Docker "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/docker/bd-inicial.sql"
    click Docker "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/docker/data-inicial.sql"
    click Docker "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/docker/advanced-query.sql"
    click Maven "https://github.com/eriquito00/proyectoaplicacionescalada/blob/main/pom.xml"

    %% Styles
    classDef app fill:#E0F7FA,stroke:#006064,color:#000
    classDef db fill:#E8F5E9,stroke:#1B5E20,color:#000
    classDef tool fill:#FFF3E0,stroke:#E65100,color:#000
    classDef external fill:#ECEFF1,stroke:#607D8B,color:#000
```
