[Proyecto I]

[tgnd254]

Nombre: Estefanía Delgado Marqués
Grupo: C122
Repositorio: https://github.com/tgnd254/HappyPaws

Descripción

Planificador de Eventos en un Refugio de Animales llamado HappyPaws

[github-actions]

Verificación Automática — Proyecto I 🤖

Repositorio analizado: https://github.com/tgnd254/HappyPaws

1. Repositorio

✅ El repositorio es accesible y fue clonado correctamente.

2. Informe (report.md)

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

3. Proyecto Python

⚠️ Sin pyproject.toml.
✅ requirements.txt encontrado.
Dependencias declaradas: ��k�i�v�y�, �k�i�v�y�m�d�, �p�i�l�l�o�w�

Archivos Python (9, 1,686 líneas en total):

• widgets.py
• utils.py
• main.py
• screens/__init__.py
• screens/resources.py
• screens/events.py
• screens/recurrence.py
• screens/date.py
• screens/place.py

4. Punto de Entrada

✅ Punto de entrada detectado: main.py

5. Ejecución

✅ El proyecto se ejecuta.

Kivy Usage: main.py [KIVY OPTION...] [-- PROGRAM OPTIONS]::

            Options placed after a '-- ' separator, will not be touched by kivy,
            and instead passed to your program.

            Set KIVY_NO_ARGS=1 in your environment or before you import Kivy to
            disable Kivy's argument parser.

        -h, --help
            Prints this help message.
        -d, --debug

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/tgnd254/HappyPaws

Qué hace tu proyecto

Construiste un planificador de eventos para un refugio animal con una interfaz gráfica completa en Kivy + KivyMD: eliges lugar, seleccionas recursos (con imágenes, descripciones y hasta sonidos por especie), fijas fecha y hora con calendario y reloj, y el sistema decide si el evento cabe según la disponibilidad real de cada recurso. Lo más valioso es el motor detrás: un algoritmo de barrido temporal (sweep line) que respeta cantidades múltiples, co-requisitos y exclusiones, y que cuando hay choque te sugiere automáticamente el siguiente hueco libre. También manejas eventos recurrentes con detección de conflictos entre las propias ocurrencias de la serie. Es un proyecto ambicioso y bien pensado.

Ejecución

Lo ejecuté de verdad. Como es una app gráfica y no de consola, ataqué la lógica de negocio directamente (importando utils.py y corriéndola con tus datos reales de data/) y además arranqué la GUI completa en un framebuffer virtual.

• Los 8 módulos compilan sin errores.
• Probé el motor de conflictos con muchos escenarios reales: hueco libre, agotar un recurso de cantidad 1, agotar uno de cantidad 2, solapamientos parciales, exclusiones, co-requisitos y conflictos internos de una serie recurrente. Funcionó correctamente en todos. Por ejemplo, al pedir un evento que solapa con "Adopción de Stuart Little" usando Voluntario de Adopciones (del que solo hay 1), me sugirió exactamente las 13:00, justo cuando se libera.
• Creé un evento, lo guardé y lo recargué: la persistencia en JSON funciona y conserva los acentos.
• La GUI: al arrancarla, apareció un FileNotFoundError: label.kv. Esto no es culpa de tu código — es un bug conocido de empaquetado de kivymd==1.2.0 cuando se instala por pip (la rueda no trae los archivos .kv). Lo sorteé restaurando esos archivos desde el código oficial de KivyMD, y con eso las seis pantallas de tu app renderizan enteras, cargando imágenes, fuentes y datos, sin una sola excepción.

Lo que está bien

• Separaste de verdad la lógica de la interfaz. Toda la lógica pura vive en utils.py sin depender de Kivy. Gracias a eso pude testear tu motor sin pantalla. Esta es una decisión de diseño madura que muchos proyectos no logran.
• El algoritmo de conflictos es correcto y no es trivial. Maneja bien las cantidades múltiples (dejar 1 veterinario libre de 2), los solapamientos parciales y el cálculo del siguiente hueco. Lo verifiqué caso por caso.
• Datos externos, no hardcodeados. Tus 44 recursos con sus reglas viven en resources.json; cambiar de refugio no toca código. Muy bien.
• Validaciones de usuario cuidadas: cada entrada inválida (título vacío, fecha pasada, fin antes que inicio, duración > 24h) muestra un mensaje y no revienta. Exactamente lo que se espera.
• El series_id (UUID) para agrupar y borrar series recurrentes está bien resuelto.

Qué mejorar

• Un caso borde en la sugerencia de horario. En utils.py (líneas 110-111), cuando no existe ningún hueco futuro que libere el recurso, la función devuelve (None, None, ...). Entonces el mensaje en date.py:196-197 mostraría literalmente "de None a None". Es un camino estrecho (casi siempre encuentra una fecha concreta), pero conviene detectar ese None y mostrar algo como "No hay disponibilidad en el rango; prueba otra fecha".
• Limpia los residuos de desarrollo. Hay un print(animal) de depuración en resources.py:102, un load_events() suelto sin usar en events.py:18, e imports que no se usan en varios screens/*.py. Quitarlos deja el código más profesional.
• El except: desnudo en recurrence.py:131 mejor como except ValueError: — así no atrapas errores inesperados que preferirías ver.
• Detalle en resources.json: hay líneas en blanco entre bloques (no rompen nada porque JSON las ignora, pero un JSON "limpio" no las lleva).

Sobre el informe

Tu report.md es de los más rigurosos que he revisado: la explicación del algoritmo de barrido temporal coincide con precisión con lo que hace utils.py, y lo confirmé ejecutándolo. El modelo de datos, las siete validaciones de fecha y la lógica de recurrencia que describes están todas en el código. No exageras funciones. Solo dos detalles menores: el árbol de directorios escribe Screens/ con mayúscula pero la carpeta real es screens/ en minúscula, y no mencionas el caso borde del "None a None". Nada de esto resta valor: es un informe honesto y bien alineado con el código.

Enhorabuena, Estefanía — es un trabajo ambicioso, bien organizado y funcionalmente sólido. Con un par de limpiezas queda redondo. 🐾