How ardillachiki/ex_parcial_24_25 works
Identificación del tipo de proyecto y su propósito
• A partir de la estructura de archivos y del contenido del README, vemos que es un proyecto en Python compuesto por dos ejercicios (paquetes) y un script principal. No hay frontend ni base de datos; más bien es una aplicación de línea de comandos (CLI) o de lógica de negocio organizada en dos dominios: “libro” y “personas”.
Análisis de la estructura de archivos
• Raíz:
• main.py: punto de entrada que orquesta la ejecución.
• requirements.txt: lista de dependencias de Python.
• Paquetes:
• Ejercicio_4/
– __init__.py
– libro_model.py
• Ejercicio_5/
– __init__.py
– personas.py
• Carpetas __pycache__: compilados de Python, pueden omitirse en el diagrama.
Insights del README
• El README es genérico y menciona directorios (/src, /docs, etc.) que en realidad no existen.
• Presumiblemente cada “Ejercicio” implementa una parte de la lógica: modelado de libros y manejo de personas, y main.py los integra.
Cómo crear el diagrama de arquitectura
a. Componentes principales
• Módulo “CLI / Orquestador” (main.py)
• Componente “Libros” (Ejercicio_4.libro_model)
• Componente “Personas” (Ejercicio_5.personas)
• Dependencias externas (Python Runtime y librerías del requirements.txt)
b. Relaciones e interacciones
• main.py → importa y llama a funciones/objetos de Ejercicio_4 y Ejercicio_5
• Cada submódulo expone interfaces públicas (clases, funciones) que main.py utiliza
c. Patrones y principios
• Separación por dominio: cada paquete es responsable de un conjunto de entidades/lógica
• Modularidad: independencia entre módulos para facilitar pruebas y mantenimiento
d. Tecnologías y librerías clave
• Python 3.x
• Cualquier paquete listado en requirements.txt (p.ej., pytest si hay pruebas)
Guía de ajuste al proyecto
• Al tratarse de un “script + módulos”:
• Destaca el diagrama de paquetes y sus fronteras.
• Muestra el flujo de control: desde la invocación del script hasta cada método/clase en los paquetes.
• Si añadieras tests o configuración, inclúyelos como componentes separados (Tests, Configuración).
Elementos a incluir en el diagrama
• Cajas/rectángulos con etiquetas claras:
• “main.py”
• “Ejercicio_4 (libro_model)”
• “Ejercicio_5 (personas)”
• “Dependencias (requirements)”
• Flechas direccionales que indiquen:
• Invocaciones: main.py → Ejercicio_4
• main.py → Ejercicio_5
• Colores o formas diferentes para:
• Código de dominio (paquetes)
• Punto de entrada (CLI)
• Dependencias externas
Recomendaciones finales
• Sé detallado: muestra cada paquete y sus interfaces públicas.
• No subdividas en exceso; mantén los dos dominios y el orquestador como los componentes centrales.
• Añade notas si cada paquete tiene subcomponentes (p.ej., clases principales dentro de libro_model.py).
• Verifica que los nombres en el diagrama coincidan exactamente con los nombres de archivo y paquete.