[Proyecto I] Alvaro Vladimir Besada Ferrer

[AlvaroBesadaFerrer]

Nombre: Alvaro Vladimir Besada Ferrer
Grupo: C111
Repositorio: https://github.com/AlvaroBesadaFerrer/Event_manager

Descripción

Planificador de eventos para un taller mecánico, con adición de eventos automáticos y con IA

[apiad]

🔧 Título corregido al formato [Proyecto I] para disparar la verificación automática.

/revisar

[github-actions]

Verificación Automática — Proyecto I 🤖

Repositorio analizado: https://github.com/AlvaroBesadaFerrer/Event_manager

1. Repositorio

✅ El repositorio es accesible y fue clonado correctamente.

2. Informe (report.md)

✅ report.md — 3,545 palabras (mínimo: 2,000).

3. Proyecto Python

✅ pyproject.toml — proyecto estructurado correctamente.
✅ requirements.txt encontrado.
Dependencias declaradas: dotenv, google-genai, streamlit, streamlit-vis-timeline

Archivos Python (27, 1,508 líneas en total):

• main.py
• domain/__init__.py
• domain/resources_data.py
• domain/event.py
• domain/resource.py
• domain/restrictions_config.py
• domain/restrictions_data.py
• domain/restrictions.py
• utils/__init__.py
• utils/color_utils.py
• utils/filter_utils.py
• utils/format_utils.py
• utils/time_utils.py
• utils/save_load_utils.py
• schedule_events/__init__.py
• (y 12 más)

4. Punto de Entrada

✅ Punto de entrada detectado: main.py

5. Ejecución

✅ El proyecto se ejecuta.

2026-07-06 14:42:19.000 Thread 'MainThread': missing ScriptRunContext! This warning can be ignored when running in bare mode.
2026-07-06 14:42:19.001 No runtime found, using MemoryCacheStorageManager
2026-07-06 14:42:19.006 Thread 'MainThread': missing ScriptRunContext! This warning can be ignored when running in bare mode.
2026-07-06 14:42:19.015 
  �[33m�[1mWarning:�[0m to view this Streamlit ap

Resumen

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

6/6 verificaciones pasadas.

---

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

[apiad]

🔍 Revisión de Código — Claude Code

Repositorio: https://github.com/AlvaroBesadaFerrer/Event_manager

Qué hace tu proyecto

Construiste un planificador de eventos para un taller mecánico. El programa modela cuatro tipos de recurso (áreas de trabajo, tipos de evento, trabajadores y herramientas) y permite crear eventos que los consumen durante un intervalo de tiempo, garantizando que no haya colisiones: dos eventos no pueden usar el mismo recurso a la misma hora. Además aplica restricciones configurables de co-requisito (un recurso exige otro) y de exclusión mutua (dos recursos no pueden convivir en un evento). La interfaz es una app web con Streamlit dividida en páginas: ver la línea de tiempo, agregar eventos (manual o auto-agendado), verlos por recurso y crearlos con lenguaje natural mediante IA (Gemini). Todo persiste en un archivo JSON.

Ejecución

Levanté la app con streamlit run main.py en un entorno aislado y arrancó sin errores. La página principal renderiza la línea de tiempo con los eventos de ejemplo, y las páginas de agregar evento y ver detalles por recurso cargan bien. Probé la lógica de planificación directamente con ocho escenarios (evento válido, restricción co-requisito, exclusión mutua, fuera de horario, sin trabajadores, fin antes que inicio, solapamiento de recursos y auto-agendado): todos se comportaron correctamente y con los mensajes de error esperados. No pude probar el flujo de IA de extremo a extremo porque requiere una clave de Gemini que no tengo.

Lo que está bien

• Arquitectura por capas limpia: separaste dominio, validación/planificación, persistencia, utilidades e interfaz. Nada de un main.py gigante. Excelente para un primer proyecto.
• Uso correcto de POO: clases Event, Resource y una jerarquía de restricciones, más un Enum para los tipos de recurso.
• Motor de conflictos sólido: la detección de solapamientos por intervalos y las restricciones funcionan de verdad, no solo sobre el papel.
• Restricciones declarativas: definirlas en un diccionario de configuración es un patrón muy elegante que permite cambiar reglas sin tocar la lógica.
• Informe honesto y completo: describe con precisión lo que hace el código, sin exagerar.

Qué mejorar

• Dependencias reproducibles: en una instalación limpia reciente, la línea de tiempo puede romperse con ModuleNotFoundError: pkg_resources (lo lanza el componente del calendario). Se soluciona añadiendo setuptools<81 a requirements.txt.
• Revisa el flujo de IA con hora específica: leyendo el código, cuando la IA devuelve inicio y fin concretos, esos valores llegan como objetos datetime a una función que espera texto, y probablemente muestre "Error interno" en lugar de crear el evento. Vale la pena verificarlo con una clave de Gemini.
• Estado global: cargar los eventos y las restricciones al importar el módulo funciona en Streamlit, pero conviene pasarlos como parámetros para evitar estado obsoleto en otros contextos.
• Limpieza menor: quedan comentarios "TODO" al final de la página de agregar evento; elimínalos al terminar.

Sobre el informe

El informe es extenso, claro y coincide con el código: dominio, diseño por capas, ambos tipos de restricción, validaciones y guía de uso están bien documentados. No detecté que sobreestime funciones; describe fielmente lo implementado.

Valoración general

Es un trabajo excepcional para primer año: diseño modular, POO bien aplicada y un motor de planificación correcto y verificado en ejecución, con extras (GUI web, auto-planificador e IA) que van más allá de lo pedido. Tu principal fortaleza es la calidad del diseño y la corrección de la lógica; el área de mejora más concreta es fijar dependencias reproducibles y pulir el sub-camino de creación por IA con horario específico.

---

Revisión automática de código con Claude Code — orientativa. La nota final la pone el profesor.

📄 Reporte detallado (código, archivo y línea): ver análisis completo