[Proyecto I]

[Carla-inix]

Nombre: Carla Argote Hernández
Grupo: C111
Repositorio: https://github.com/Carla-inix/Arcane-Gestor-de-Eventos.git

Descripción

Mi proyecto es un gestor de eventos de un local de videojuegos en el que puedes reservar salas y juegos

(Añadir una breve descripción de su proyecto).

[github-actions]

Verificación Automática — Proyecto I 🤖

Repositorio analizado: https://github.com/Carla-inix/Arcane-Gestor-de-Eventos.git

1. Repositorio

✅ El repositorio es accesible y fue clonado correctamente.

2. Informe (report.md)

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

3. Proyecto Python

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

Archivos Python (15, 1,551 líneas en total):

• main.py
• funciones/mis_reservas.py
• funciones/tienda_arcane.py
• funciones/suscripcion.py
• funciones/inputs.py
• funciones/juegos.py
• funciones/datos.py
• funciones/__init__.py
• funciones/menu.py
• funciones/horarios_r.py
• funciones/reservas.py
• funciones/estado.py
• funciones/ofertas.py
• funciones/recursos_r.py
• funciones/persistencia.py

4. Punto de Entrada

✅ Punto de entrada detectado: main.py

5. Ejecución

✅ El proyecto se ejecuta.

Archivo de estado corrupto o incompatible. Iniciando desde cero

Archivo de estado corrupto o incompatible. Iniciando desde cero

========================================
        Arcane Gaming Lounge
========================================
Horario: 9:00 AM - 11:00 PM
Contacto: arcane@gaming.com | Tel: +53 53529701
----------------------------------------

Fecha y hora: 04-06-2026 | 17:08
-------

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.

[apiad]

/revisar

[github-actions]

Verificación Automática — Proyecto I 🤖

Repositorio analizado: https://github.com/Carla-inix/Arcane-Gestor-de-Eventos.git

1. Repositorio

✅ El repositorio es accesible y fue clonado correctamente.

2. Informe (report.md)

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

3. Proyecto Python

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

Archivos Python (15, 1,551 líneas en total):

• main.py
• funciones/mis_reservas.py
• funciones/tienda_arcane.py
• funciones/suscripcion.py
• funciones/inputs.py
• funciones/juegos.py
• funciones/datos.py
• funciones/__init__.py
• funciones/menu.py
• funciones/horarios_r.py
• funciones/reservas.py
• funciones/estado.py
• funciones/ofertas.py
• funciones/recursos_r.py
• funciones/persistencia.py

4. Punto de Entrada

✅ Punto de entrada detectado: main.py

5. Ejecución

✅ El proyecto se ejecuta.

Archivo de estado corrupto o incompatible. Iniciando desde cero

Archivo de estado corrupto o incompatible. Iniciando desde cero

========================================
        Arcane Gaming Lounge
========================================
Horario: 9:00 AM - 11:00 PM
Contacto: arcane@gaming.com | Tel: +53 53529701
----------------------------------------

Fecha y hora: 06-06-2026 | 12:13
-------

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.

[apiad]

🔍 Revisión de Código — Claude Code

Repositorio: https://github.com/Carla-inix/Arcane-Gestor-de-Eventos

Qué hace tu proyecto

Tu proyecto es un gestor de reservas de consola para Arcane Gaming Lounge, un local de videojuegos con cuatro salas (Consolas I y II, PCs y Realidad Virtual). El usuario se suscribe con nombre y carnet, reserva una sala eligiendo personas, equipos (mandos, sillas o sofás, audífonos, visores y caminadoras RV), juegos y horario, con un costo de 1000$ por hora. Además puede ver y cancelar sus reservas, comprar juegos en la Tienda Arcane y desbloquear un cupón del 20% al acumular reservas. Todo el estado se guarda en un JSON y se recarga al reiniciar.

Ejecución

Lo ejecuté con python3 main.py (sin dependencias) y recorrí el menú completo: me suscribí, hice una reserva de sala PCs de principio a fin (Costo total: 2000$ → Reserva realizada con éxito), compré un juego en la tienda (350$), cargué el archivo de ejemplo y probé entradas inválidas. Todo funcionó sin un solo error lógico, y verifiqué que una reserva creada se guardaba y volvía a aparecer intacta tras reiniciar el programa. Los únicos "errores" que vi fueron al agotarse la entrada automática de mis pruebas, lo cual es normal.

Lo que está bien

• Organización ejemplar. En vez de un main.py gigante, dividiste el código en un paquete funciones/ con módulos de responsabilidad única (reservas, horarios, recursos, tienda, persistencia…). Esto está por encima de lo esperado en primer año.
• Lógica de negocio real y compleja. Manejas pools de recursos compartidos entre salas, conflictos de horario, restricciones de co-requisito (mando RV ↔ caminadora) y de exclusión mutua (sillas o sofás). No es lógica artificial: se sostiene sola.
• Validación de entradas sólida. Tu función reutilizable para pedir números rechaza vacíos, letras, ceros a la izquierda y valores fuera de rango, y el carnet valida longitud exacta y unicidad.
• Persistencia correcta. Resolviste bien el reto de serializar fechas (datetime) a JSON y reconstruirlas al cargar, con manejo elegante del caso de archivo corrupto.

Qué mejorar

• El archivo estado_app.json está versionado con contenido {}. Esto hace que, al primer arranque, aparezca dos veces el mensaje "Archivo de estado corrupto". No es un error real (el programa arranca bien), pero da mala impresión. Sugerencia: quítalo del repositorio con git rm --cached datos/estado_app.json y trata el JSON vacío como "no hay estado" en lugar de "corrupto".
• cargar_estado() se llama dos veces (en main.py y al entrar al menú). Con una sola llamada basta y desaparece el mensaje duplicado.
• Estado global. Usas bastantes variables globales. A tu nivel es totalmente aceptable, pero a futuro agrupar ese estado en una clase reduciría el acoplamiento.

Sobre el informe

El informe es excelente y describe fielmente casi todo lo que el código hace. Dos detalles: menciona un "Modo de prueba" (opción 7) como accesible, pero en el código está desactivado (MODO_DEBUG = False), así que no aparece en el menú; y dice que estado_app.json está ignorado por Git cuando en realidad sigue versionado. Vale la pena alinear ambos puntos.

Valoración general

Trabajo sobresaliente para un primer proyecto de primer año: arquitectura limpia, lógica genuinamente compleja y una ejecución sin fallos de punta a punta. Tu principal fortaleza es la organización y profundidad del diseño; la principal área de mejora es pulir el arranque (la persistencia versionada) y alinear pequeños detalles del informe con lo que realmente se puede usar.

---

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