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 de acción en fin de trimestre (quincena % 6 === 0): el botón Pagar Manto aparece en proyectos que requieren mantenimiento (excluyendo Incidencias y mantenimiento 'N/A'), mientras que el botón Penalizar aparece en todos los proyectos e Incidencias activas.
• 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 sus botones quedan deshabilitados (disabled), indicando visualmente que ya se resolvió la situación del proyecto para el trimestre actual.
• 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).
• Redistribución de Layout (5 Columnas Superiores + Fila Inferior 20/40/40%): Se reorganizó la vista de resumen en 2 filas. La fila superior (top-row) distribuye los 5 bloques de control/información horizontalmente en 5 columnas de igual proporción. La fila inferior (main-container) ubica Departamentos a la izquierda (20%), Proyectos Terminados al centro (40%) y Proyectos Activos a la derecha (40%).
• Gráfica Mixta de Progresión (Barras + Líneas) con Zoom Flotante 2.5X y Persistencia: En la parte inferior del Bloque 3 (Progresión), se integró una gráfica Canvas HTML5 que representa los Objetivos del Trimestre (almacenados en la sesión como arregloGeneral.objetivoT1..T4, por defecto $100,000) en barras azules y los Ingresos Reales por Trimestre (T1..T4) en una línea roja con nodos y valores. Al colocar el cursor sobre la gráfica (mouseenter), se despliega un panel emergente flotante alineado sobre la tarjeta del bloque con la gráfica en tamaño 2.5X ampliado con posicionamiento dinámico anti-recorte y leyenda ajustada a la izquierda (textAlign = 'left') para evitar cualquier solapamiento con los iconos. Se oculta al retirar el cursor (mouseleave).

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.
• Corrección de Proyectos Descartados (continuamos()): Se actualizó la carga inicial del tablero para verificar estrictamente que el proyecto asignado a TablaProyectoGde tenga estatus 'En proceso'. Si un proyecto fue descartado desde el resumen o mediante habilidad especial, al retornar al tablero ya no se cargará en TablaProyectoGde y desaparecerá de inmediato sin necesidad de refrescar la página.
• Persistencia de Botones de Acción (bAccion1 y bAccion2): Se guardan los estados de selección (activado/desactivado) de las acciones 1 y 2 en arregloGeneral.bAccion1 y arregloGeneral.bAccion2 al pulsar toggleColor() y al finalizar el timer. Al navegar entre el tablero y el resumen y regresar, las acciones permanecen seleccionadas tal como las dejó el usuario.

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.

2. Escenario de Descarte de Proyecto Seleccionado:

   • Selecciona un proyecto en TablaProyectoGde en el tablero.
   • Ve al resumen (o usa la Habilidad Especial de Operaciones para "Descartar un proyecto").
   • Descarta el proyecto que estaba seleccionado en TablaProyectoGde.
   • Pulsa "Ir al Tablero".
   • Verifica que el proyecto descartado ya no aparece en TablaProyectoGde ni en el tablero chico sin necesidad de refrescar la página.

3. Escenario de Persistencia de Acciones 1 y 2:

   • En el tablero, activa los botones de acción 1 (bAccion1) o 2 (bAccion2).
   • Navega al Resumen haciendo clic en "Ir al Resumen".
   • Regresa al Tablero haciendo clic en "Ir al Tablero".
   • Verifica que las acciones seleccionadas se mantienen activas (color azul y texto blanco).