# Prototipo de ejecución — BUG-005 Botón "Descargar recibo" invisible en el Paso 4 de nuevo ingreso

- **Rama:** p-bugfix/boton-descargar-recibo-invisible
- **Rama base:** feature/desacoplar-contructor-pagos
- **Plan:** docs/bugfix/005-boton-descargar-recibo-invisible/plan.md
- **Fecha:** 2026-10-28
- **Estado:** consolidado

## Resumen

Se aplicó el mapa de reemplazo del plan en `estado.php`: las 15 clases de Tailwind ausentes en los CSS compilados se sustituyeron por equivalentes ya presentes. Se verificó por script que todas las clases de la vista (salvo `material-icons`) existen en `tailwind.css` + `tailwind-v4.css`. Las pruebas `Paso4NuevoIngresoTest` y `Paso4ReciboTest` siguen en verde. Queda pendiente la verificación visual manual en navegador (temas claro/oscuro y todos los estados).

## Tareas realizadas

- [x] Reemplazar `bg-emerald-600` / `hover:bg-emerald-700` del botón "Descargar recibo" por `bg-green-600` / `hover:bg-green-700`.
- [x] Reemplazar las variantes `dark:` ausentes del panel aprobado (`dark:bg-emerald-900/40`, `dark:border-green-800/40`, `dark:text-emerald-300`).
- [x] Reemplazar las clases ausentes del estado pendiente (`dark:bg-amber-900/30`, `dark:border-amber-700/50`, `text-amber-800`, `dark:text-amber-300`).
- [x] Reemplazar las variantes `dark:` ausentes de los enlaces "Ver intentos de pago" (`dark:text-amber-300`).
- [x] Reemplazar las variantes `dark:` ausentes de los paneles creado/pagando (`dark:border-blue-900/30`, `dark:text-blue-300`).
- [x] Reemplazar las clases ausentes de los botones "Cancelar pago" (`dark:border-red-900/30`, `hover:bg-gray-50`, `dark:hover:bg-slate-700/50`).
- [x] Verificar con script que las 14 clases destino existen en los CSS cargados: todas `True`.
- [x] Verificar que no quedan clases ausentes en `estado.php` (excluyendo `material-icons`): todas presentes.
- [x] Ejecutar `Paso4NuevoIngresoTest` y `Paso4ReciboTest`: ambos en verde.
- [ ] Verificación visual manual en navegador de todos los estados y ambos temas — Motivo: requiere entorno de desarrollo con una postulación aprobada (`estados_id` 3 u 8) y navegador; no ejecutable desde este agente.

## Archivos creados

| Archivo | Motivo |
| --- | --- |
| docs/bugfix/005-boton-descargar-recibo-invisible/prototipo.md | Registro de ejecución de este bugfix. |

## Archivos modificados

| Archivo | Cambio realizado |
| --- | --- |
| app/Views/inscripciones/nuevo_ingreso/paso3/estado.php | Sustituidas 15 clases de Tailwind ausentes por equivalentes compilados, sin cambios en textos, URLs, condiciones ni atributos de comportamiento. |
| docs/bugfix/005-boton-descargar-recibo-invisible/plan.md | Estado actualizado de `pendiente` a `en curso`. |

## Comandos ejecutados

| Comando | Resultado |
| --- | --- |
| `git switch -c p-bugfix/boton-descargar-recibo-invisible` | Éxito; rama local creada desde `feature/desacoplar-contructor-pagos`. |
| Script PowerShell de soporte de clases (14 clases destino) | Éxito; todas las clases `Presente = True`. |
| Script PowerShell de barrido de clases de `estado.php` | Éxito; todas las clases presentes (excepto `material-icons`, provisto por otra hoja). |
| `vendor\bin\phpunit.bat tests\app\Integration\Paso4NuevoIngresoTest.php --no-coverage` | OK (27 tests, 129 assertions). |
| `vendor\bin\phpunit.bat tests\app\Integration\Paso4ReciboTest.php --no-coverage` | OK (7 tests, 17 assertions). |

## Verificación

- **Prueba manual:** no ejecutada. Requiere navegador y una postulación de desarrollo con intención aprobada. Queda como pendiente para el usuario.
- **Pruebas automatizadas:** `Paso4NuevoIngresoTest` (27 tests, 129 assertions) y `Paso4ReciboTest` (7 tests, 17 assertions), ambas en verde.
- **Criterios del plan:**
  - [x] No quedan clases de Tailwind ausentes en `estado.php` (salvo `material-icons`).
  - [x] `Paso4NuevoIngresoTest` y `Paso4ReciboTest` siguen en verde.
  - [x] No se modificaron rutas, filtros, controladores, pagos, PDFs, `tailwind.css` ni `tailwind-v4.css`.
  - [ ] Botón visible con fondo verde, texto e icono blancos en tema claro — verificación visual pendiente.
  - [ ] Botón legible en tema oscuro junto al panel "Pago aprobado" — verificación visual pendiente.
  - [ ] Hover perceptible — verificación visual pendiente.
  - [ ] Clic sigue abriendo `/inscripciones/nuevo-ingreso/paso-4/recibo/{id}` — cubierto por pruebas; confirmación manual pendiente.
  - [ ] Estados pendiente, creado, pagando, reintento y cancelado legibles en ambos temas — verificación visual pendiente.

## Desviaciones del plan

- Ninguna en el código. La única desviación es que la verificación visual manual no se ejecutó por falta de entorno/navegador; se sustituyó parcialmente por un barrido estático de clases contra los CSS compilados.

## Riesgos y pendientes

- Confirmar visualmente el resultado en desarrollo (temas claro y oscuro y los seis estados) antes de cerrar el bugfix.
- El CSS compilado sigue desactualizado: cualquier clase nueva volverá a quedar sin efecto hasta un `chore` con `npm run build`.
- Los reemplazos son aproximaciones visuales: el hover de "Cancelar pago" pasa de rojo claro a gris claro y el borde oscuro del panel aprobado cambia de emerald a green.
- Otras vistas (`index.php`, `metodos.php`, `formas_pago.php`) conservan clases ausentes; quedan fuera de este alcance como deuda separada.

## Consolidación

- **Fecha:** 2026-10-28
- **Rama destino:** feature/desacoplar-contructor-pagos
- **Estrategia:** merge `--no-ff`
- **Commits integrados:** `1eb9f32` (fix) y `a5be455` (docs)
- **Commit de merge:** `207a9e0`
- **Verificación:** la rama prototipo quedó como ancestro, sin commits pendientes ni diferencias de archivos.
- **Rama prototipo:** `p-bugfix/boton-descargar-recibo-invisible` eliminada con `git branch -d` después de verificar el traslado completo.
- **Pendiente:** verificación visual manual en navegador (temas claro/oscuro y todos los estados) antes de cerrar el bugfix.
