Colaborando/doc/walkthrough.md

Resumen de Cambios: Mantenimiento y Penalización de Proyectos Activos (Actualizado)

Se ha implementado la funcionalidad solicitada para gestionar proyectos activos al final del trimestre (quincenas 6, 12, 18, 24).

Cambios Realizados

1. Pantalla de Resumen (resumen.php)

• Botones Dinámicos en Tarjetas: Las tarjetas de proyectos activos (En proceso) muestran los botones Pagar Manto y Penalizar (antes Desechar) si y solo si la quincena actual es un fin de trimestre (quincena % 6 === 0), excluyendo los proyectos con mantenimiento 'N/A' y las Incidencias.
• Persistencia de Proyectos: El botón "Penalizar" ya no descarta el proyecto (no cambia su estatus a descartado). El proyecto permanece activo (En proceso).
• Estado Deshabilitado: Una vez que se paga el mantenimiento o se paga la penalización, la tarjeta del proyecto se tiñe de color gris en la pantalla de resumen, y los botones Pagar Manto y Penalizar quedan deshabilitados (disabled), indicando visualmente que ya se resolvió la situación del proyecto para el trimestre actual (los proyectos exentos o Incidencias permanecen activos y con su color blanco normal).
• Descuentos por Habilidades: Al realizar el pago de mantenimiento de forma normal, se aplican los descuentos de recursos (Tiempo, Personal, Capital) ganados mediante las habilidades compradas del departamento (habilidadTiempo, habilidadPersonal, habilidadCapital), restando del total del depto el costo neto descontado (mínimo de 0).
• Textos e Interfaz: Se ajustó la confirmación de penalización a: "¿Estás seguro de que quieres pagar la penalización del proyecto...". Se detalla el costo original y costo neto final con descuento en el confirm del pago de mantenimiento.
• Habilidad Especial de Operaciones: Permite aplicar la penalización del proyecto sin costo utilizando la habilidad especial (actualizando su cooldown).

2. Tablero de Juego (jsCode.js)

• Visibilidad Permanente: Se eliminaron los filtros que ocultaban el proyecto del tablero chico o grande cuando el mantenimiento ya había sido resuelto. El proyecto permanece visible tanto en el tablero como en el resumen durante la quincena actual, permitiendo seguir trabajando en él.

Cómo Realizar las Pruebas (Verificación)

1. Escenario de Pago de Mantenimiento / Penalización:
   • Asegúrate de estar en una quincena fin de trimestre (ej. Q6 del Trimestre 1).
   • Ve a la pantalla de resumen. Verás los botones Pagar Manto y Penalizar en los proyectos en proceso.
   • Realiza cualquiera de las dos acciones:
     • Pagar Manto: Selecciona un departamento con recursos suficientes y pulsa el botón.
     • Penalizar: Pulsa el botón; confirmará que tengas acumulado financiero suficiente y aplicará la deducción.
   • En ambos casos:
     • La tarjeta del proyecto en el resumen cambiará inmediatamente a un fondo gris y los botones de acción se deshabilitarán de forma definitiva en la quincena actual.
     • Ve al Tablero (colaborando2.php) en la misma quincena (Q6) y verifica que el proyecto sigue estando visible en el tablero chico y en el slot de proyecto grande.
   • Avanza la quincena a Q7 (Trimestre 2). Vuelve a la pantalla de resumen y verifica que el proyecto recupera su color blanco y los botones ya no aparecen (pues no es fin de trimestre), y que en el tablero continúa disponible con total normalidad.