# alex6036/ejercicios-tema-3 architecture

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

- Interactive diagram: https://gitdiagram.com/alex6036/ejercicios-tema-3
- Repository: https://github.com/alex6036/ejercicios-tema-3

## Overview

Este proyecto se centra en la implementación de varios ejercicios de estructuras de datos y algoritmos en Python, donde cada ejercicio se encuentra en su propio directorio y aborda un problema específico: Torre de Hanói, cálculo de determinantes, gestión de naves espaciales y operaciones con polinomios.

Para diseñar el mejor y más preciso diagrama de la arquitectura/sistema para este proyecto, sigue estas pautas detalladas:

##### Identifica los componentes principales
- Cada “Ejercicio” (Ejercicio 1 a Ejercicio 4) es un módulo/component independiente.
- Dentro de cada directorio, reconoce dos archivos clave: la lógica principal (por ejemplo, hanoi.py, matriz.py, nave.py, polinomio.py) y el script de entrada o prueba (main.py) que orquesta la ejecución.
- Considera que, si se quisiera integrar este repositorio dentro de un sistema mayor, cada ejercicio actuaría como un servicio o componente independiente dedicado a resolver un algoritmo o problema particular.

##### Relaciones e interacciones
- Dado que cada ejercicio es independiente, no hay interacciones directas entre ellos. El diagrama debe reflejar esta independencia mostrando cada uno como un bloque separado.
- Si se necesitara evidenciar el “cliente” o “driver”, incluye un ícono o bloque para representar el rol que ejecuta main.py en cada módulo para iniciar y probar la solución.

##### Patrones y principios de diseño
- En cuanto a diseño arquitectónico, el proyecto respeta el principio de separación de responsabilidades: cada ejercicio encapsula su lógica y sus operaciones.
- No se observa una arquitectura de microservicios ni un patrón MVC completo dado que el proyecto se centra en problemas algorítmicos; sin embargo, la clara separación entre “modelo” (lógica en hanoi.py, matriz.py, etc.) y “control” (main.py) es evidente.

##### Tecnologías y herramientas involucradas
- Lenguaje Python es la tecnología central.
- Uso de __init__.py en cada directorio sugiere que cada “Ejercicio” está pensado como un paquete, lo cual podría facilitar su integración o reutilización en proyectos mayores.
- Gestión de dependencias es mínima, y la ejecución es a través de scripts de línea de comandos.

##### Directrices para visualizar el diagrama
a. Dibuja bloques separados para cada módulo: Ejercicio 1, Ejercicio 2, Ejercicio 3 y Ejercicio 4.
- Dentro de cada bloque, divide el componente en dos sub-componentes: el “Motor/Algoritmo” (por ejemplo, TorreHanoi, Matriz, NaveEspacial, Polinomio) y el “Punto de entrada” (main.py).
b. Usa flechas direccionales para señalar que main.py invoca métodos y procesos de la clase principal dentro de cada archivo.
c. Emplea formas o colores distintos para diferenciar:
d. Asegúrate de etiquetar cada bloque claramente (por ejemplo: "Ejercicio 1: Torre de Hanói", "Ejercicio 2: Cálculo de Determinantes", etc.).
e. Dado que los ejercicios son independientes, no dibujes conexiones entre ellos; sin embargo, podrías incluir un bloque central o un encabezado que delimite "Repositorio Ejercicios-Tema-3" para contextualizar que todos son parte del mismo proyecto.

##### Consideraciones adicionales
- Para un ingeniero principal, es importante mostrar no solo la estructura física del proyecto, sino también el flujo de datos o la llamada a funciones (por ejemplo, desde main.py hacia la lógica algorítmica).
- Aunque no se trata de una aplicación full-stack ni de un compilador, enfatiza la modularidad y la separación de cada problema algorítmico, lo que facilita pruebas, mantenimiento y posibles integraciones.

En resumen, tu diagrama debe capturar la arquitectura del proyecto dividiéndolo en componentes lógicos (cada ejercicio), detallando sus archivos clave y mostrando de manera clara el flujo de ejecución y la independencia de cada módulo. Utiliza etiquetas claras, flechas para mostrar la dirección del flujo de ejecución y utiliza diferentes colores o formas para destacar la funcionalidad de cada componente.

## Diagram (Mermaid)

```mermaid
graph TB
    A["Repositorio Ejercicios-Tema-3"]:::header

    subgraph "Ejercicio 1: Torre de Hanói"
        ex1_main["main.py"]:::entry
        ex1_logic["TorreHanoi (hanoi.py)"]:::logic
        ex1_main -->|"invoca"| ex1_logic
    end

    subgraph "Ejercicio 2: Cálculo de Determinantes"
        ex2_main["main.py"]:::entry
        ex2_logic["Algoritmo (matriz.py)"]:::logic
        ex2_main -->|"invoca"| ex2_logic
    end

    subgraph "Ejercicio 3: Gestión de Naves Espaciales"
        ex3_main["main.py"]:::entry
        ex3_logic["NaveEspacial (nave.py)"]:::logic
        ex3_main -->|"invoca"| ex3_logic
    end

    subgraph "Ejercicio 4: Operaciones con Polinomios"
        ex4_main["main.py"]:::entry
        ex4_logic["Polinomio (polinomio.py)"]:::logic
        ex4_main -->|"invoca"| ex4_logic
    end

    A --> ex1_main
    A --> ex2_main
    A --> ex3_main
    A --> ex4_main

    click ex1_logic "https://github.com/alex6036/ejercicios-tema-3/blob/main/Ejercicio1/hanoi.py"
    click ex1_main "https://github.com/alex6036/ejercicios-tema-3/blob/main/Ejercicio1/main.py"
    click ex2_logic "https://github.com/alex6036/ejercicios-tema-3/blob/main/Ejercicio 2/matriz.py"
    click ex2_main "https://github.com/alex6036/ejercicios-tema-3/blob/main/Ejercicio 2/main.py"
    click ex3_logic "https://github.com/alex6036/ejercicios-tema-3/blob/main/Ejercicio 3/nave.py"
    click ex3_main "https://github.com/alex6036/ejercicios-tema-3/blob/main/Ejercicio 3/main.py"
    click ex4_logic "https://github.com/alex6036/ejercicios-tema-3/blob/main/Ejercicio 4/polinomio.py"
    click ex4_main "https://github.com/alex6036/ejercicios-tema-3/blob/main/Ejercicio 4/main.py"

    classDef header fill:#f9d5e5,stroke:#333,stroke-width:2px;
    classDef entry fill:#90ee90,stroke:#000,stroke-width:2px;
    classDef logic fill:#add8e6,stroke:#000,stroke-width:2px;
```
