# tomas-dorado/tema-3 architecture

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

- Interactive diagram: https://gitdiagram.com/tomas-dorado/tema-3
- Repository: https://github.com/tomas-dorado/tema-3

## Overview

##### Project Type and Purpose
- This is an educational CLI/Pygame‑based Python application consisting of four independent “exercises” (Ejercicio_1…4), each demonstrating different algorithmic concepts.
- A root menu (menu.py / main.py) lets the user pick and run any exercise.

##### File Structure
- Top‑level:
- menu.py / main.py: dispatch layer
- requeriment.txt: dependencies
- README.md
- Subdirectories Ejercicio_1…Ejercicio_4, each with:
- main.py (entry point for that exercise)
- Domain modules (classes or functions) implementing the core logic
- A launcher (Lanzador.py) in Ejercicio_3 & 4
- No external services or databases; purely in‑process modules.

##### README for Insights
- Each exercise is described with its main files and responsibilities.
- Dependencies: only pygame (for Ejercicio_1) and standard Python libs.

##### Main Components & Their Interactions
a. Root Layer:
- User (CLI) → menu.py / main.py
- menu.py presents options → invokes the chosen exercise’s entry point
b. Exercise 1 – “Torres de Hanói”:
- main.py
- HanoiGame (Game.py) – orchestrates solution
- Torre (Torre.py) – model for a peg
- Disco (Nodo.py) – represents a disk
- pygame UI renderer
c. Exercise 2 – “Determinante de Matrices”:
- main.py
- Iterativo.py – iterative determinant function
- Recursivo.py – recursive determinant function
d. Exercise 3 – “Gestión de Naves”:
- main.py
- Lanzador.py – parses input, calls filter/sort routines
- (potentially data model module if added)
e. Exercise 4 – “Polinomios Mágicos”:
- main.py
- Polinomio.py – PolinomioMagico class with arithmetic methods
- Lanzador.py – CLI wrapper for operations

##### Architectural Patterns & Principles
- Modular packaging: each exercise is a self‑contained package.
- Clear separation of concerns: presentation/launcher vs. domain logic.
- Single‐responsibility per module/class.

##### Final Checklist
- Clear labels on all four exercise components and the root menu.
- User → Root Menu → Exercise main → Domain modules.
- UI/launcher modules
- Algorithm/domain logic modules
- Optional: note dependencies (pygame for E1).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Actor and Root Menu
    User([User]):::actor
    subgraph "Root Menu"
        Menu["menu.py"]:::ui
        Dispatcher["main.py"]:::ui
    end
    User -->|starts| Menu
    Menu -->|dispatch| Dispatcher

    %% Exercise 1
    subgraph "Ejercicio 1 – Torres de Hanói"
        E1Main["main.py\n(UI Launcher – pygame)"]:::ui
        E1Game["Game.py\n(HanoiGame)"]:::domain
        E1Torre["Torre.py\n(Peg Model)"]:::domain
        E1Nodo["Nodo.py\n(Disk Model)"]:::domain
    end
    Dispatcher -->|choose E1| E1Main
    E1Main -->|orchestrates| E1Game
    E1Game -->|uses| E1Torre
    E1Game -->|uses| E1Nodo

    %% Exercise 2
    subgraph "Ejercicio 2 – Determinante de Matrices"
        E2Main["main.py\n(UI Launcher – CLI)"]:::ui
        Iterativo["Iterativo.py\n(iterative)"]:::domain
        Recursivo["Recursivo.py\n(recursive)"]:::domain
    end
    Dispatcher -->|choose E2| E2Main
    E2Main -->|invoke determinante_iterativo| Iterativo
    E2Main -->|invoke determinante_recursivo| Recursivo

    %% Exercise 3
    subgraph "Ejercicio 3 – Gestión de Naves"
        E3Main["main.py\n(UI Launcher – CLI)"]:::ui
        E3Lanzador["Lanzador.py\n(input parser)"]:::ui
    end
    Dispatcher -->|choose E3| E3Main
    E3Main -->|parse & dispatch| E3Lanzador

    %% Exercise 4
    subgraph "Ejercicio 4 – Polinomios Mágicos"
        E4Main["main.py\n(UI Launcher – CLI)"]:::ui
        Polinomio["Polinomio.py\n(PolinomioMagico)"]:::domain
        E4Lanzador["Lanzador.py\n(CLI wrapper)"]:::ui
    end
    Dispatcher -->|choose E4| E4Main
    E4Main -->|invoke operations| Polinomio
    E4Main -->|wrap commands| E4Lanzador

    %% Legend
    subgraph "Legend"
        UI["UI/Launcher Modules"]:::ui
        Domain["Domain Logic Modules"]:::domain
    end

    %% Click Events
    click Menu "https://github.com/tomas-dorado/tema-3/blob/main/menu.py"
    click Dispatcher "https://github.com/tomas-dorado/tema-3/blob/main/main.py"
    click E1Main "https://github.com/tomas-dorado/tema-3/blob/main/Ejercicio_1/main.py"
    click E1Game "https://github.com/tomas-dorado/tema-3/blob/main/Ejercicio_1/Game.py"
    click E1Torre "https://github.com/tomas-dorado/tema-3/blob/main/Ejercicio_1/Torre.py"
    click E1Nodo "https://github.com/tomas-dorado/tema-3/blob/main/Ejercicio_1/Nodo.py"
    click E2Main "https://github.com/tomas-dorado/tema-3/blob/main/Ejercicio_2/main.py"
    click Iterativo "https://github.com/tomas-dorado/tema-3/blob/main/Ejercicio_2/Iterativo.py"
    click Recursivo "https://github.com/tomas-dorado/tema-3/blob/main/Ejercicio_2/Recursivo.py"
    click E3Main "https://github.com/tomas-dorado/tema-3/blob/main/Ejercicio_3/main.py"
    click E3Lanzador "https://github.com/tomas-dorado/tema-3/blob/main/Ejercicio_3/Lanzador.py"
    click E4Main "https://github.com/tomas-dorado/tema-3/blob/main/Ejercicio_4/main.py"
    click Polinomio "https://github.com/tomas-dorado/tema-3/blob/main/Ejercicio_4/Polinomio.py"
    click E4Lanzador "https://github.com/tomas-dorado/tema-3/blob/main/Ejercicio_4/Lanzador.py"

    %% Styles
    classDef actor fill:#f9f,stroke:#333,stroke-width:1px;
    classDef ui fill:#bbdefb,stroke:#1e88e5,stroke-width:1px;
    classDef domain fill:#c8e6c9,stroke:#388e3c,stroke-width:1px;
```
