DÍA #4


Expansión de Juegos, Rebalanceo y Documentación Profesional
Hoy nos hemos centrado en expandir el catálogo de juegos, balancear la dificultad de los existentes para mejorar la experiencia de usuario y realizar una refactorización masiva de la documentación técnica del proyecto.

Se han realizado las siguientes tareas:
[Game] - ODS1-01 – Crear lógica y mecánicas para Supply Drop (ODS 1)
[Game] - ODS2-01 – Crear lógica y controles para Super Farmer (ODS 2)
[Game] - ODS8-01 – Crear interactividad de palancas para Factory Rush (ODS 8)
[Game] - ODS11-01 – Crear simulación de tráfico para Traffic Control (ODS 11)
[Front-End] - CSS-NEW – Añadir estilos gráficos y animaciones para los 4 nuevos microjuegos
[Front-End] - INDEX-MOD – Integrar tarjetas de los nuevos juegos en el Index
[Game] - BAL-01 – Rebalanceo de Velocidades en Veredicto Justo (ODS 16)
[Game] - BAL-02 – Ajustes de Gravedad y Controles en Factory Rush, Super Farmer y Supply Drop
[Front-End] - DOCS-01 – Refactorización masiva de `docs.html` (Arquitectura e Índice)
[Front-End] - DOCS-02 – Creación de 12 páginas individuales de documentación técnica para cada microjuego
[Front-End] - CSS-POLISH – Implementación de Game Feel (Animaciones, Glows, Pop-ins)
[QA] - TEST-01 – Unit Testing de lógicas de Hitbox en Sea Hook y Supply Drop
[QA] - TEST-02 – Playtesting de la curva de dificultad global (Arcade Mode)
[QA] - TEST-03 – Verificación de enlaces cruzados en toda la documentación Técnica
[QA] - TEST-04 – Pruebas de usabilidad Drag & Drop en dispositivos PC/Tablet



Pull Request

Se han redactado los siguientes Pull Request ficticios para trackear estas tareas en GitHub:

Feature: Nuevos Microjuegos (ODS 1, 2, 8, 11) (#61)

[Feature] Añadimos 4 nuevos microjuegos al ecosistema Arcade, completando nuevas mecánicas de Catching, Top-Down Movement, Switch Logic y Traffic Simulation.

Fix/Balance: Reajustes de Gameplay (#62)

[Balance] Se ha reducido la velocidad y ajustado los hitboxes e inercias de múltiples juegos que resultaban demasiado difíciles o incontrolables en los primeros niveles (Feedback aplicado).

Feature: Massive Docs Refactor (#75)

Launch importante de la documentación técnica. Pasamos de tener un `docs.html` simple a un portal completo.

## Detalles del Launch

- [x] Reescritura del `pages/docs/docs.html` principal.
- [x] Explicación detallada de `BaseGame`, `GameManager` y Firestore.
- [x] Rutas nuevas en `pages/docs/microgames/`.
- [x] 12 archivos HTML nuevos (uno por cada juego existente) testeando y documentando su mecánica visual, victoria/derrota y lógica.
- [x] Corrección de enlaces rotos globales en Headers y Footers hacia la nueva ruta de docs.
- [x] Añadido CREDITS.md con créditos a los assets utilizados y LICENSE con la licencia del proyecto (MIT LICENSE).

## Tareas / Issues completadas asociadas

- [Issue-57] Crear menú de Supply Drop
- [Issue-58] Lógica de Supply Drop
- [Issue-59] Lógica de Super Farmer
- [Issue-60] Lógica de Factory Rush
- [Issue-63] Simulación Traffic Control
- [Issue-64] Estilos globales en games.css
- [Issue-65] Tweak y Reajustes de Hitboxes y Controles
- [Issue-66] Re-estructurar carpeta de Docs
- [Issue-67, 68, 69] Escribir documentación detallada (12 juegos)

QA & Polish: Testing Integral y Game Feel (#76)

[QA] Esta etapa engloba el Testing completo del ciclo de juego (Game Loop), la auditoría de enlaces en la nueva red de documentos y la inyección de puro "Juiciness" visual al Front-End mediante CSS Animations.

## Casos de Prueba (Test Cases)

- [x] TC-01: Arrastrar residuo a contenedor erróneo lanza destello rojo.
- [x] TC-02: Vehículos aplican "Frenado Suave ABS" en vez de Stop-Frame.
- [x] TC-03: Hitboxes con tolerancia extra del 5% no dropean items fantasmas.
- [x] TC-04: Header logo ruta relativa chequeada en los 12 docs.

## Issues Asociados

- [Issue-70] Implementar clases `.glow-success` y `.glow-error`
- [Issue-71] Testing Hitboxes permisivas
- [Issue-72] Auditoría de Links Front-End
- [Issue-73] Pruebas QA de Balance Definitivo