[Proyecto I] Gestor de Eventos para Naves Mineras 🪐

[cubangnocchi]

Nombre: Marco Raymat Cateura
Grupo: C122
Repositorio: https://github.com/cubangnocchi/ProgProject01-c25-26

Descripción

Inspirado en el universo de sci-fi de The Expanse, el proyecto tiene lugar en una nave minera de hielo y, como la radiación del espacio 🛰️ se lleva mal con la microelectrónica, he diseñado una sencilla aplicación de consola que permita la gestión de eventos e inventario que se puede ejecutar en hardware antiguo y robusto.

ℹ️ Más información en la documentación.

[cubangnocchi]

/revisar

[github-actions]

Verificación Automática — Proyecto I 🤖

Repositorio analizado: https://github.com/cubangnocchi/ProgProject01-c25-26

1. Repositorio

✅ El repositorio es accesible y fue clonado correctamente.

2. Informe (report.md)

⚠️ report.md encontrado pero con solo 748 palabras (mínimo: 2,000).

3. Proyecto Python

⚠️ Sin pyproject.toml.
⚠️ Sin requirements.txt.

Archivos Python (24, 1,972 líneas en total):

• __init__.py
• tester.py
• main.py
• src/__init__.py
• src/data_base/__init__.py
• src/data_base/data_management.py
• src/manager/manager.py
• src/manager/__init__.py
• src/manager/data_search.py
• src/manager/restrictions_data.py
• src/manager/restrictions.py
• src/calendar/__init__.py
• src/calendar/calendar.py
• src/visual_interface/__init__.py
• src/visual_interface/selection_menue.py
• (y 9 más)

4. Punto de Entrada

✅ Punto de entrada detectado: main.py

5. Ejecución

✅ El proyecto se ejecuta.

---[MAIN MENUE]---
[1] - list events
[2] - list items 
[3] - list crew
[4] - add item to inventoory
[5] - create event
[6] - add crew member
[x] - exit
press a [key] + [Enter↲] to select one of the options:
ERROR: option not available, try again:

---[MAIN MENUE]---
[1] - list events
[2] - list items 
[3] - list crew
[4] - add item to inventoory
[5] - create event
[6] - add crew member
[x] - exit

Resumen

• ✅ Repositorio accesible
• ❌ report.md con ≥2000 palabras
• ✅ Archivos Python
• ❌ Configuración de dependencias
• ✅ Punto de entrada
• ✅ Ejecución

4/6 verificaciones pasadas.

---

Verificación automática — los resultados son orientativos. El profesor revisará en detalle.

[cubangnocchi]

/help

[apiad]

🔍 Revisión de Código — Claude Code

Repositorio: https://github.com/cubangnocchi/ProgProject01-c25-26

Qué hace tu proyecto

Construiste un gestor de eventos e inventario para una nave minera al estilo de The Expanse: una app de consola donde llevas un calendario, un inventario de objetos, una tripulación y unas ubicaciones, y donde puedes crear eventos que solo se guardan si cumplen un conjunto de restricciones (que un evento de reparación necesita una herramienta y un especialista, que el Reactor Nuclear exige protección contra radiación, etc.). Lo más valioso es que ese motor de reglas está dirigido por datos y que la arquitectura del proyecto está muy bien separada en paquetes — un nivel de diseño poco común en primer año.

Ejecución

Lo corrí de verdad con Python 3.12 (sin dependencias, solo biblioteca estándar) alimentando el menú por tubería. Listar eventos y items funciona; crear un evento inválido (reparación en el Reactor sin nada asignado) produjo correctamente los 5 mensajes de restricción esperados; crear un evento válido lo guardó y lo insertó en orden en el calendario (verificado en el JSON). Añadir tripulante persiste bien. Probé entradas basura (abc como día, mes 99, día 45) y todas se atrapan sin Traceback. La lógica directa (cálculo de edades, solapamiento de intervalos) también da resultados correctos.

Lo que está bien

• La arquitectura. Paquetes calendar/, inventory/, data_base/, manager/, visual_interface/ con responsabilidades claras. La capa de presentación está de verdad separada de la lógica.
• SelectionMenue es un acierto: encapsulaste el patrón de menú una vez y lo reutilizas en todos lados con validación incluida.
• El motor de restricciones funciona en su primera categoría (dependencias): verifiqué 5 restricciones correctas en ejecución real. Que sea dirigido por datos (restrictions_data.py) es lo difícil y lo hiciste bien.
• Persistencia sólida: serialización objeto↔JSON simétrica en cada clase, referencias por clave en vez de por copia, e inserción ordenada con búsqueda binaria (calendar.py:80).
• Manejo de fechas con datetime y validación con try/except.

Qué mejorar

• La opción [3] "list crew" no hace nada: está en el menú (menues.py:19) pero falta la rama if(option_selected == "3") en main_bucle (manager.py:34-53). Se prometía una opción que no está cableada.
• El motor de restricciones quedó a medias. check_event solo llama a dependency_check; exclusion_check, resources_n_crew_concistency y las demás son stubs que devuelven [] (tu propio #! te quedaste por aquí en restrictions.py:89 lo dice). Ya tienes los datos de exclusión y consistencia en restrictions_data.py — solo falta usarlos. Además is_it_overlaping funciona perfecto pero nunca lo llamas, así que los choques de horario no se comprueban.
• Bucle infinito ante fin de entrada: en console_in_out.py:19 capturas except Exception, que atrapa también el EOFError. Acótalo a except ValueError — así el reintento solo ocurre por texto no numérico, no por fin de la entrada. Un except demasiado ancho esconde errores que sí querrías ver.
• Pequeño bug latente: en restrictions.py:87 construyes el mensaje de error de estatus-por-lugar pero se te olvidó el error_list.append(...). Hoy no se dispara (esas listas están vacías) pero conviene arreglarlo.
• Detalles idiomáticos menores: if x is None en vez de if x == None; str(x) en vez de x.__str__().

Sobre el informe

Honesto y preciso: describe la arquitectura real con enlaces archivo:línea que coinciden con el código, y no exagera — no afirma que "prueba" ni "demuestra" nada que no haga. El punto débil es que quedó sin terminar: las secciones "Ejemplo de uso", "Flujo de ejecución" e "Historia y experiencia" solo dicen "texto", y quedó un borrador_readme.docx suelto en la raíz. Termínalo y quedará a la altura del código.

Es un proyecto ambicioso y bien pensado; lo que le falta es rematar lo empezado, no rehacer nada. Buen trabajo con la arquitectura. 🚀