# Prototipo de ejecución — FEAT-021 Quitar documentos presenciales y descarga de planilla del paso de pago

- **Rama:** p-feature/simplificar-paso-pago-sin-documentos-ni-planilla
- **Rama base:** feature/desacoplar-contructor-pagos
- **Plan:** docs/features/021-simplificar-paso-pago-sin-documentos-ni-planilla/plan.md
- **Fecha:** 2026-11-04
- **Estado:** consolidado

## Resumen

Se simplificó la pantalla de pago de nuevo ingreso (`/inscripciones/nuevo-ingreso/paso-4`, controlador `Paso3` y vista `paso3/estado.php`) retirando la lista de documentos presenciales, la fecha límite, la insignia "Plazo vencido" y el botón "Descargar planilla de inscripción". El bloque aprobado conserva el mensaje, el monto, la referencia, "Ver intentos de pago", "Descargar recibo" y "Finalizar". La pantalla final (`/finalizado`, controlador `Paso4`) conserva su mensaje, sus documentos y su fecha límite, y ahora muestra el enlace "Descargar planilla de inscripción". El servicio y la ruta de planilla quedaron intactos. Se actualizaron las pruebas de `/paso-4` y se agregó cobertura para `/finalizado`.

## Tareas realizadas

- [x] Retirar de `paso3/estado.php` la sección "Documentos pendientes para entrega presencial" (título, subtítulo, lista, fecha límite e insignia "Plazo vencido").
- [x] Retirar de `paso3/estado.php` el botón "Descargar planilla de inscripción" y su enlace a `paso-4/planilla/{id}`.
- [x] Ajustar el texto del bloque aprobado a "Tu pago fue registrado y confirmado correctamente. Ya puedes descargar tu recibo."
- [x] Conservar en `/paso-4` con pago aprobado: "Pago aprobado con éxito", monto, referencia, "Ver intentos de pago", "Descargar recibo" y "Finalizar".
- [x] Dejar de consultar documentos y plazo en `Paso3::index()` y de reenviar `documentos_presenciales` y `plazo_entrega` desde `paso3/index.php`.
- [x] Conservar sin cambios el mensaje, el encabezado, el resumen, la lista de documentos y la fecha límite de `/finalizado`.
- [x] Agregar en `/finalizado`, dentro del bloque de éxito, el enlace "Descargar planilla de inscripción" hacia `paso-4/planilla/{id}` cuando exista una intención.
- [x] Conservar `NiDocumentoPresencialModel`, `CalculadoraPlazoEntrega`, el seeder, las migraciones, la ruta `paso-4/planilla/(:num)`, `Paso3::planilla()` y `NuevoIngresoPlanillaService`.
- [x] Actualizar `Paso4NuevoIngresoTest.php` y `Paso4DocumentosPresencialesTest.php` al nuevo comportamiento.
- [x] Crear `Paso4FinalizadoDocumentosTest.php` con cobertura de la lista y la fecha límite en `/finalizado`.
- [ ] Smoke test manual en navegador con una intención aprobada — Motivo: no hay entorno web/base de datos de ejecución disponible en esta sesión; el render se cubrió con pruebas de integración.

## Criterios de aceptación

| Criterio | Cómo se verificó | Resultado |
| --- | --- | --- |
| `/paso-4` aprobado no contiene "Documentos pendientes para entrega presencial" | `Paso4DocumentosPresencialesTest` estados 3 y 8 | ok |
| `/paso-4` aprobado no contiene nombres de documentos, "Fecha límite de entrega:" ni "Plazo vencido" | `Paso4DocumentosPresencialesTest` | ok |
| `/paso-4` aprobado no contiene "Descargar planilla de inscripción" ni enlace a `paso-4/planilla/` | `Paso4DocumentosPresencialesTest` y `Paso4NuevoIngresoTest` | ok |
| `/paso-4` aprobado conserva "Pago aprobado con éxito", monto, referencia, "Ver intentos de pago", "Descargar recibo" y "Finalizar" | `Paso4DocumentosPresencialesTest` y `Paso4NuevoIngresoTest` | ok |
| El mensaje de éxito menciona solo el recibo y no la planilla | `Paso4DocumentosPresencialesTest` (`Ya puedes descargar tu recibo.`) | ok |
| `Paso3::index()` ya no instancia `NiDocumentoPresencialModel` ni `CalculadoraPlazoEntrega` ni pasa variables de documentos/plazo | Revisión de `Paso3.php` y prueba con tablas de documentos eliminadas (`testNoRompeElPaso4SiFaltanLasTablasDeDocumentos`) | ok |
| `paso3/index.php` ya no declara ni reenvía `documentos_presenciales` ni `plazo_entrega` | Revisión del archivo | ok |
| `paso3/estado.php` ya no declara variables de documentos, plazo, fecha límite ni plazo vencido | Revisión del archivo | ok |
| Los estados no aprobados conservan su comportamiento | `Paso4DocumentosPresencialesTest::testEstadosNoAprobadosConservanSuBloqueSinDocumentos` | ok |
| `/finalizado` sigue mostrando el mensaje de confirmación | `Paso4FinalizadoDocumentosTest` | ok |
| `/finalizado` sigue mostrando la lista de documentos aplicables y la fecha límite | `Paso4FinalizadoDocumentosTest` (`18/11/2026`) | ok |
| `/finalizado` muestra el enlace "Descargar planilla de inscripción" con el id de la intención | `Paso4FinalizadoDocumentosTest::testFinalizadoConservaMensajeDocumentosYFecha` | ok |
| `/finalizado` no muestra el enlace de planilla si no hay intención | `Paso4FinalizadoDocumentosTest::testFinalizadoSinIntencionNoMuestraEnlaceDePlanilla` | ok |
| La ruta de planilla, `Paso3::planilla()`, `NuevoIngresoPlanillaService` y la plantilla siguen existiendo y funcionando | `Paso4PlanillaTest` (8 pruebas) y `NuevoIngresoPlanillaServiceTest` (14 pruebas) | ok |
| La descarga directa de planilla responde PDF y conserva 405/422 | `Paso4PlanillaTest` | ok |
| "Descargar recibo" conserva comportamiento y ruta | `Paso4ReciboTest` (7 pruebas) y `Paso4DocumentosPresencialesTest` | ok |
| "Finalizar" conserva su flujo hacia `/finalizado` | `Paso4PagoTest` (21 pruebas) y revisión de `Paso3::continuar()` | ok |
| Se actualizan y pasan `Paso4NuevoIngresoTest` y `Paso4DocumentosPresencialesTest` | Ejecución individual de ambas suites | ok |
| Existe cobertura de la lista de documentos en `/finalizado` | `Paso4FinalizadoDocumentosTest` (3 pruebas) | ok |
| Siguen pasando recibo, pago, planilla, Zelle, modelo de documentos, calculadora y correo FEAT-011 | Ejecución individual de las suites listadas | ok |
| `php -l` sin errores en los PHP modificados | `php -l` sobre 6 archivos | ok |
| Smoke test manual de `/paso-4` y `/finalizado` con intención aprobada | No ejecutado | pendiente |
| `graphify update .` después de los cambios | Ejecutado | ok |
| No se modificaron rutas, filtros, sesión, migraciones, seeds, `vendor/`, `system/`, `public/vendor/` ni `app/ThirdParty/` | `git status` y revisión del diff | ok |

## Flujos cubiertos

- **Flujo normal:** intención en estado 3 (aprobado) → `/paso-4` muestra éxito, monto, referencia, intentos, recibo y Finalizar, sin documentos ni planilla. Verificado por pruebas de integración sobre la vista real.
- **Flujos alternativos:** estado 8 (verificado) se comporta igual que el 3; estados no aprobados (2, 7) conservan su bloque y tampoco muestran documentos; `/finalizado` conserva documentos y fecha; sin documentos aplicables en `/finalizado` se oculta la sección y se mantiene el mensaje.
- **Control de errores:** `/paso-4` no falla si faltan las tablas de documentos porque ya no las consulta; `/finalizado` conserva su `try/catch` y oculta la sección registrando advertencia. La planilla directa conserva sus códigos 405/422 y el PDF válido.

## Archivos creados

| Archivo | Motivo |
| --- | --- |
| `tests/app/Integration/Paso4FinalizadoDocumentosTest.php` | Cubrir que `/finalizado` conserva mensaje, documentos y fecha límite, que muestra el enlace a la planilla y que no se rompe sin tablas. |
| `docs/features/021-simplificar-paso-pago-sin-documentos-ni-planilla/prototipo.md` | Registro de ejecución de la feature. |

## Archivos modificados

| Archivo | Cambio realizado |
| --- | --- |
| `app/Controllers/Inscripciones/NuevoIngreso/Paso3.php` | Se quitaron los imports y la consulta de documentos/plazo; ya no se envían `documentos_presenciales` ni `plazo_entrega`. |
| `app/Views/inscripciones/nuevo_ingreso/paso3/index.php` | Se quitaron las variables de documentos/plazo y su reenvío a `estado.php`. |
| `app/Views/inscripciones/nuevo_ingreso/paso3/estado.php` | Se retiró la sección de documentos, la fecha límite, "Plazo vencido" y el botón de planilla; se ajustó el texto de éxito. |
| `app/Views/inscripciones/nuevo_ingreso/paso4/index.php` | Se agregó el enlace "Descargar planilla de inscripción" dentro del bloque de éxito de `/finalizado`. |
| `tests/app/Integration/Paso4NuevoIngresoTest.php` | Se invirtió la expectativa del botón de planilla y se agregó la verificación del nuevo mensaje. |
| `tests/app/Integration/Paso4DocumentosPresencialesTest.php` | Se redefinió su alcance para probar la ausencia de documentos y planilla en `/paso-4`; se corrigió la sesión de prueba a `paso_actual = 3`. |
| `docs/features/021-simplificar-paso-pago-sin-documentos-ni-planilla/plan.md` | Actualización de estado y criterios verificados. |

## Rutas, permisos y datos

- **Rutas/endpoints nuevos o modificados:** ninguno. Se conserva `GET inscripciones/nuevo-ingreso/paso-4/planilla/(:num)` con filtro `nuevoIngresoAuth:3`; solo se retiró su enlace visible.
- **Permisos y validaciones:** sin cambios. `Paso3::planilla()` conserva sus validaciones de método, sesión, id, propiedad y estado 3/8. No se relajó ningún filtro.
- **Migraciones/seeds:** no aplica; no se crearon ni modificaron.
- **Compatibilidad:** el contrato de la planilla sigue disponible por URL directa. El correo de FEAT-011 no se modificó. No hay cambios de datos ni de esquema.

## Comandos ejecutados

| Comando | Resultado |
| --- | --- |
| `vendor\bin\phpunit.bat tests/app/Integration/Paso4NuevoIngresoTest.php` | Éxito: 30 pruebas, 151 aserciones. |
| `vendor\bin\phpunit.bat tests/app/Integration/Paso4DocumentosPresencialesTest.php` | Éxito: 6 pruebas, 48 aserciones. |
| `vendor\bin\phpunit.bat tests/app/Integration/Paso4FinalizadoDocumentosTest.php` | Éxito: 4 pruebas, 23 aserciones. |
| `vendor\bin\phpunit.bat tests/app/Integration/Paso4ReciboTest.php` | Éxito: 7 pruebas, 17 aserciones. |
| `vendor\bin\phpunit.bat tests/app/Integration/Paso4PlanillaTest.php` | Éxito: 8 pruebas, 19 aserciones. |
| `vendor\bin\phpunit.bat tests/app/Integration/Paso4PagoTest.php` | Éxito: 21 pruebas, 79 aserciones. |
| `vendor\bin\phpunit.bat tests/app/Integration/ZelleNuevoIngresoTest.php` | Éxito: 10 pruebas, 74 aserciones. |
| `vendor\bin\phpunit.bat tests/app/Models/Inscripciones/NiDocumentoPresencialModelTest.php` | Éxito: 6 pruebas, 8 aserciones. |
| `vendor\bin\phpunit.bat tests/app/Libraries/Inscripciones/NuevoIngreso/Documentos/CalculadoraPlazoEntregaTest.php` | Éxito: 9 pruebas, 15 aserciones. |
| `vendor\bin\phpunit.bat tests/app/Libraries/Inscripciones/NuevoIngreso/Planilla/NuevoIngresoPlanillaServiceTest.php` | Éxito: 14 pruebas, 74 aserciones. |
| `vendor\bin\phpunit.bat tests/app/Libraries/Inscripciones/NuevoIngreso/Notificacion/NuevoIngresoAprobacionNotificacionServiceTest.php` | Éxito: 15 pruebas, 87 aserciones. |
| `vendor\bin\phpunit.bat tests/app/Database/Migrations/CorreoAprobacionNiInscripcionesMigrationTest.php` | Éxito: 4 pruebas, 15 aserciones. |
| `vendor\bin\phpunit.bat tests/app/Commands/NiReenviarCorreoAprobacionTest.php` | Éxito: 9 pruebas, 36 aserciones. |
| `php -l` en `Paso3.php`, `paso3/index.php`, `paso3/estado.php`, `paso4/index.php` y las 3 pruebas | Sin errores de sintaxis. |
| `graphify update .` | Grafo actualizado (15339 nodos, 923 comunidades); advertencia por `tree_sitter_sql` ausente y 3 archivos con errores de sintaxis preexistentes ajenos al cambio. |

## Verificación

- **Línea base (antes):** `Paso4NuevoIngresoTest` 30/30, `Paso4ReciboTest` 7/7, `Paso4PlanillaTest` 8/8 y `Paso4PagoTest` 21/21 en verde. `Paso4DocumentosPresencialesTest` tenía 8 fallos preexistentes (302 vs 200) porque su sesión usaba `paso_actual = 4`; se corrigió dentro del alcance al redefinir el test. Nota: PHPUnit 8 solo procesa el primer argumento de archivo, por lo que la línea base se reejecutó archivo por archivo.
- **Prueba manual (flujo normal):** no ejecutada en navegador; cubierta por `Paso4DocumentosPresencialesTest` y `Paso4FinalizadoDocumentosTest` sobre las vistas reales.
- **Flujos alternativos y errores:** cubiertos por estados 2, 7 y 8, ausencia de tablas de documentos y ausencia de catálogo aplicable.
- **Pruebas automatizadas:** suites de integración, modelo, calculadora, servicio de planilla, notificación y comando de reenvío, todas en verde.
- **Criterios del plan:** todos cumplidos salvo el smoke test manual. El enlace a la planilla en `/finalizado` quedó cubierto por pruebas de integración.

## Desviaciones del plan

- Se conservó el nombre de archivo `Paso4DocumentosPresencialesTest.php`, pero se redefinió su alcance y docblock para probar la ausencia de documentos en `/paso-4`, en lugar de renombrarlo. El plan permitía ajustar nombre o alcance.
- Se corrigió en el mismo test la sesión `paso_actual` de `4` a `3`; sin ese ajuste el controlador redirigía a `/finalizado` y la suite fallaba antes del cambio.
- Ajuste posterior solicitado por el usuario: se agregó el enlace "Descargar planilla de inscripción" en el bloque de éxito de `/finalizado` (`paso4/index.php`). Se actualizaron el plan y la prueba de `/finalizado` para cubrir el nuevo requisito.

## Riesgos y pendientes

- **Smoke test manual pendiente:** validar en un entorno con base de datos real que `/paso-4` y `/finalizado` renderizan como se espera.
- **Planilla accesible por URL directa:** decisión intencional del plan; ahora también tiene un enlace visible en `/finalizado`. Si negocio quiere ocultarla por completo, requiere una feature posterior.
- **Correo FEAT-011:** sigue adjuntando planilla y listando documentos; no se modificó.
- **Clave `planilla` en `Paso3::urls()`:** se conserva aunque la vista ya no la use, para no alterar el contrato interno ni pruebas existentes.

## Consolidación

- **Estado:** consolidado
- **Fecha:** 2026-11-04
- **Rama destino:** feature/desacoplar-contructor-pagos
- **Estrategia:** merge --no-ff (commits `9bdd0e7` y `24c785f`, merge `687c606`)
- **Rama prototipo:** p-feature/simplificar-paso-pago-sin-documentos-ni-planilla (eliminada con `git branch -d`)
- **Verificación:** rama prototipo ancestro de la de origen, sin commits ni diferencias pendientes; pruebas de integración, regresión y `php -l` en verde. El smoke test manual sigue pendiente y se aceptó la cobertura automatizada como respaldo.
