[Proyecto I] WRB - Planificador de Combates

[laxxuzxlr8]

Nombre: Adrian Yunior Muñoz Obregón
Grupo: C-111
Repositorio: https://github.com/laxxuzxlr8/WRB-GitHub.git

Descripción

¡El Deporte más famoso del Futuro ya está aquí! El combate entre Robots siempre ha sido uno de los deseos más ambiciosos del ser humano: Metal vs Metal, un hito inalcanzable decían algunos excéntricos de los últimos tiempos. Pero gracias a @laxxuzxlr8 y a su Proyecto estrella: La World Robot Boxing(WRB), ahora es posible organizar estos asaltos legendarios entre Gigantes de Acero. Con una amplia gama de Robots, Armas, Arenas y Restricciones, esta aplicación Web te permitirá organizar Combates inolvidables a tú manera, almacenándolos en nuestro Sistema de Almacenamiento Json para que no te pierdas ninguna presentación de tu Combatiente favorito.

[github-actions]

Verificación Automática — Proyecto I 🤖

Repositorio analizado: https://github.com/laxxuzxlr8/WRB-GitHub.git

1. Repositorio

✅ El repositorio es accesible y fue clonado correctamente.

2. Informe (report.md)

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

3. Proyecto Python

⚠️ Sin pyproject.toml.
✅ requirements.txt encontrado.
Dependencias declaradas: streamlit, pandas

Archivos Python (18, 1,779 líneas en total):

• core.py
• __init__.py
• main.py
• images/__init__.py
• pages/__init__.py
• pages/acerca_de.py
• pages/armas.py
• pages/robots.py
• pages/combates_programados.py
• pages/organizar_combate.py
• data/__init__.py
• images/Robots/__init__.py
• images/Gestionar Combate/__init__.py
• images/Armas/__init__.py
• images/Armas/Ofensivas/__init__.py
• (y 3 más)

4. Punto de Entrada

✅ Punto de entrada detectado: main.py

5. Ejecución

✅ El proyecto se ejecuta.

2026-06-25 23:49:50.548 WARNING streamlit.runtime.scriptrunner_utils.script_run_context: Thread 'MainThread': missing ScriptRunContext! This warning can be ignored when running in bare mode.
2026-06-25 23:49:50.591 
  �[33m�[1mWarning:�[0m to view this Streamlit app on a browser, run it with the following
  command:

    streamlit run main.py [ARGUMENTS]
2026-06-25 23:49:50.591 Thread 'MainThread'

Resumen

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

5/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/laxxuzxlr8/WRB-GitHub.git

Qué hace tu proyecto

Construiste una aplicación web multipágina en Streamlit para planificar combates de la WRB: eliges fecha, arena, modo (1vs1 o 3vs3), armas los robots de cada equipo, tipo de control y patrocinador, y todo se guarda en JSON. Lo más valioso —y lo que más me gustó— es tu sistema de gestión de recursos por fecha: al fijar un día, tu código descuenta las arenas, robots, armas y células de energía que ya están comprometidos por otros combates de ese mismo día, evitando colisiones. Eso es una idea de diseño muy buena para primer año.

Ejecución

No es una app de consola, así que no la corrí con printf. La ejecuté de tres formas:

1. Compilé los 7 módulos con py_compile → todo compila.
2. Ejecuté tu lógica de negocio real (todo core.py y tus funciones validar_robot, validar_patrocinador, validar_combate, recomendar_fecha) con los datos reales de data/, probando casos válidos e inválidos.
3. Levanté la app de verdad con streamlit run main.py en modo headless → responde HTTP 200 y su health-check, sin ningún Traceback.

Todas tus validaciones respondieron correctamente: campos vacíos, arma repetida en ambos brazos, combinación incompatible (Lanzallamas + Sensores ópticos → la rechaza con la razón exacta), equipo lleno, patrocinador con números o repetido, y células requeridas por encima de las disponibles. También verifiqué que recomendar_fecha salta al día siguiente cuando ambas arenas están ocupadas. Todo funciona.

Lo que está bien

• Separaste la capa de datos en core.py (guardar_combates, cargar_combates, cargar_inventario). Es exactamente lo correcto, y lo reutilizas desde varias páginas.
• Tu modelo de datos JSON está muy bien pensado: robots→C/E, armas→tipo, incompatibilidades con su razón, y un tope global de células. Soporta directamente todas tus validaciones.
• Las funciones de validación están separadas de la UI y cada una hace una sola cosa. Verificadas: todas correctas.
• Detalle fino que aprecié: al abrir la web, limpias automáticamente los combates con fecha ya pasada (acerca_de.py:13-27).

Qué mejorar

• Bug de portabilidad (el más importante): en pages/robots.py llamas a las imágenes como images/robots/... (minúscula), pero la carpeta en disco es images/Robots/ (R mayúscula). En Windows/Mac funciona porque no distinguen mayúsculas, pero en Linux sí distingue, así que al correrlo ahí las 25 imágenes del catálogo de robots no cargan. Arréglalo cambiando las 25 rutas a images/Robots/. Fíjate que en armas.py y en organizar_combate.py ya usas la capitalización correcta; solo robots.py quedó descuadrado.
• Duplicación Equipo A / Equipo B: los bloques de gestión del Equipo A y del Equipo B son casi idénticos (lo mismo pasa dentro de validar_robot con las ramas "a" y "b"). Podrías escribir una sola función render_equipo(equipo) y llamarla dos veces. Menos código = menos sitios donde equivocarse al hacer un cambio.
• El badge dice "Python 3.8+" pero en realidad necesitas 3.12. Usas f-strings con comillas anidadas del mismo tipo (por ejemplo f"{st.session_state.inventario["robots"][robot]}"), y esa sintaxis solo existe desde Python 3.12. Corrige el badge para no confundir a quien lo instale.
• Detalles cosméticos: "Maza electromagnática" en el panel de ayuda vs. "electromagnética" en el inventario, y "a sido cancelado" → "ha sido cancelado".

Sobre el informe

Tu report.md es honesto y fiel al código: describe el flujo real (todo guiado por la fecha), la gestión de recursos por día, tus funciones de validación y la persistencia, con fragmentos que efectivamente coinciden con lo implementado. No exageras ni afirmas validaciones que no existan — lo comprobé ejecutando. Con el conteo actual ronda las 2100 palabras, así que supera el mínimo. Buen trabajo documentando.

Enhorabuena por un proyecto ambicioso y bien construido. Corrige lo de las rutas de imágenes y quedará redondo. 💪