# gabriel28112005/gapt_clasicos_algoritmia architecture

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

- Interactive diagram: https://gitdiagram.com/gabriel28112005/gapt_clasicos_algoritmia
- Repository: https://github.com/gabriel28112005/gapt_clasicos_algoritmia

## Overview

Based on our analysis of the file tree and README, this project—“Clásicos de la algoritmia”—is a Java application built with Maven (as indicated by the pom.xml) that demonstrates three classic algorithmic puzzles: the Tower of Hanoi, the n-Reinas (n Queens) problem, and the Knight’s Tour (problema del caballo). The project is structured following an MVC (Model-View-Controller) pattern for each game, and uses separate main classes (located in the main_juegos package) to launch each game individually.

##### Relationships and Interactions
- How the main entry point (or game selector interface) directs control to one of the three game modules based on user selection.
- The Controller invokes methods from the Model (game logic) to compute moves/solutions.
- The Controller updates the View to display results, moves, or state changes.

##### Architectural Patterns
- MVC design pattern common to each puzzle:
- That the separation of concerns (algorithm processing in the Model, UI handling in the View, and orchestration in the Controller) is a vital principle here.
- Supporting libraries or frameworks if applicable (in this case, Maven is used for build configuration, so a note on project management/configuration can be included).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Global Entities
    MainApp["Main.java (Application Entry Point)"]:::main
    Maven["pom.xml (Maven Config)"]:::maven
    Selector["Game Selector"]:::selector

    %% High-level flow
    MainApp -->|"launches"| Selector
    Maven -->|"builds"| MainApp

    %% Tower of Hanoi Module
    subgraph "Tower of Hanoi Module"
        MHanoi["Main_Hanoi.java"]:::driver
        CHanoi["Controlador_Hanoi.java"]:::controller
        ModHanoi["Modelo_Hanoi.java"]:::model
        VisHanoi["Vista_Hanoi.java"]:::view
    end

    %% n-Reinas Module
    subgraph "n-Reinas Module"
        MReina["Main_Reina.java"]:::driver
        CReina["Controlador_Reina.java"]:::controller
        ModReina["Modelo_Reina.java"]:::model
        VisReina["Vista_Reina.java"]:::view
    end

    %% Knight's Tour Module
    subgraph "Knight's Tour Module"
        MCaballo["Main_Caballo.java"]:::driver
        CCaballo["Controlador_Caballo.java"]:::controller
        ModCaballo["Modelo_Caballo.java"]:::model
        VisCaballo["Vista_Caballo.java"]:::view
    end

    %% Shared Domain & Utilities
    subgraph "Shared Domain & Utilities"
        Caballo["Caballo.java"]:::shared
        Disco["Disco.java"]:::shared
        Figura["Figura.java"]:::shared
        Matriz["Matriz.java"]:::shared
        Reina["Reina.java"]:::shared
    end

    %% Relationships from Game Selector to Modules
    Selector -->|"Selects: TowerHanoi"| MHanoi
    Selector -->|"Selects: nReinas"| MReina
    Selector -->|"Selects: KnightsTour"| MCaballo

    %% Tower of Hanoi MVC flow
    MHanoi -->|"initiates"| CHanoi
    CHanoi -->|"executes"| ModHanoi
    CHanoi -->|"updates"| VisHanoi
    ModHanoi -- "uses" --> Disco

    %% n-Reinas MVC flow
    MReina -->|"initiates"| CReina
    CReina -->|"executes"| ModReina
    CReina -->|"updates"| VisReina
    ModReina -- "uses" --> Reina

    %% Knight's Tour MVC flow
    MCaballo -->|"initiates"| CCaballo
    CCaballo -->|"executes"| ModCaballo
    CCaballo -->|"updates"| VisCaballo
    ModCaballo -- "uses" --> Caballo
    ModCaballo -- "uses" --> Matriz

    %% Optional: Shared dependency for common utilities
    ModHanoi --- Figura
    ModReina --- Figura
    ModCaballo --- Figura

    %% Click Events
    click MainApp "https://github.com/gabriel28112005/gapt_clasicos_algoritmia/blob/master/src/main/java/juegos/Main.java"
    click Maven "https://github.com/gabriel28112005/gapt_clasicos_algoritmia/blob/master/pom.xml"
    click MHanoi "https://github.com/gabriel28112005/gapt_clasicos_algoritmia/blob/master/src/main/java/juegos/main_juegos/Main_Hanoi.java"
    click CHanoi "https://github.com/gabriel28112005/gapt_clasicos_algoritmia/blob/master/src/main/java/juegos/controlador/Controlador_Hanoi.java"
    click ModHanoi "https://github.com/gabriel28112005/gapt_clasicos_algoritmia/blob/master/src/main/java/juegos/modelos/Modelo_Hanoi.java"
    click VisHanoi "https://github.com/gabriel28112005/gapt_clasicos_algoritmia/blob/master/src/main/java/juegos/vistas/Vista_Hanoi.java"
    
    click MReina "https://github.com/gabriel28112005/gapt_clasicos_algoritmia/blob/master/src/main/java/juegos/main_juegos/Main_Reina.java"
    click CReina "https://github.com/gabriel28112005/gapt_clasicos_algoritmia/blob/master/src/main/java/juegos/controlador/Controlador_Reina.java"
    click ModReina "https://github.com/gabriel28112005/gapt_clasicos_algoritmia/blob/master/src/main/java/juegos/modelos/Modelo_Reina.java"
    click VisReina "https://github.com/gabriel28112005/gapt_clasicos_algoritmia/blob/master/src/main/java/juegos/vistas/Vista_Reina.java"
    
    click MCaballo "https://github.com/gabriel28112005/gapt_clasicos_algoritmia/blob/master/src/main/java/juegos/main_juegos/Main_Caballo.java"
    click CCaballo "https://github.com/gabriel28112005/gapt_clasicos_algoritmia/blob/master/src/main/java/juegos/controlador/Controlador_Caballo.java"
    click ModCaballo "https://github.com/gabriel28112005/gapt_clasicos_algoritmia/blob/master/src/main/java/juegos/modelos/Modelo_Caballo.java"
    click VisCaballo "https://github.com/gabriel28112005/gapt_clasicos_algoritmia/blob/master/src/main/java/juegos/vistas/Vista_Caballo.java"
    
    click Caballo "https://github.com/gabriel28112005/gapt_clasicos_algoritmia/blob/master/src/main/java/juegos/clases/Caballo.java"
    click Disco "https://github.com/gabriel28112005/gapt_clasicos_algoritmia/blob/master/src/main/java/juegos/clases/Disco.java"
    click Figura "https://github.com/gabriel28112005/gapt_clasicos_algoritmia/blob/master/src/main/java/juegos/clases/Figura.java"
    click Matriz "https://github.com/gabriel28112005/gapt_clasicos_algoritmia/blob/master/src/main/java/juegos/clases/Matriz.java"
    click Reina "https://github.com/gabriel28112005/gapt_clasicos_algoritmia/blob/master/src/main/java/juegos/clases/Reina.java"

    %% Class Definitions for Colors and Styling
    classDef main fill:#bbdefb,stroke:#1565c0,stroke-width:2px,font-weight:bold;
    classDef maven fill:#f8bbd0,stroke:#ad1457,stroke-width:2px,font-weight:bold;
    classDef selector fill:#fff9c4,stroke:#f9a825,stroke-width:2px,font-weight:bold;
    classDef driver fill:#d1c4e9,stroke:#673ab7,stroke-width:2px;
    classDef controller fill:#ffcdd2,stroke:#c62828,stroke-width:2px;
    classDef model fill:#c8e6c9,stroke:#2e7d32,stroke-width:2px;
    classDef view fill:#bbdefb,stroke:#1565c0,stroke-width:2px;
    classDef shared fill:#ffe0b2,stroke:#ef6c00,stroke-width:2px;
```
