# Aviso de impresión de planilla y acta de compromiso en el correo y en el paso final

- **Código:** EDT-003
- **Tipo:** edit
- **Estado:** completado
- **Fecha:** 2026-11-05
- **Autor:** Agente (opencode)

## Objetivo
Indicar en el correo de inscripción culminada y en la pantalla final de inscripción (`/finalizado`) que el aspirante debe llevar impresas su planilla de inscripción y su acta de compromiso firmada a la entrega presencial de los recaudos. Aplica a todas las postulaciones aprobadas, sin importar sede ni método de pago.

## Motivación
El correo actual adjunta los PDFs del recibo, la planilla y el acta, e invita a revisar los documentos pendientes para entrega presencial. La pantalla final permite descargar la planilla y el acta, pero tampoco indica que deben imprimirse ni que el acta debe firmarse. Esto puede provocar que el aspirante llegue a la sede sin esos documentos impresos o con el acta sin firmar, retrasando la apertura de su expediente.

## Estado actual
- La plantilla `app/Views/emails/nuevo_ingreso_inscripcion_culminada.php` (línea 35) dice: "Tu pago fue aprobado y tu inscripción ha culminado. Adjuntamos tu recibo, tu planilla y tu acta de compromiso en formato PDF.".
- El bloque condicional "Documentos pendientes para entrega presencial" (líneas 38-65) lista los recaudos configurados por carrera, pero solo se muestra si `$documentos` no está vacío. No menciona impresión ni firma.
- El aviso "Información importante" (líneas 76-80) solo explica cómo acceder al Paso 4 si no hay sesión iniciada.
- El texto alternativo del correo, en `NuevoIngresoAprobacionNotificacionService::ALT_BODY` (línea 32), dice: "Tu pago fue aprobado y tu inscripción ha culminado. Adjuntamos tu recibo, tu planilla y tu acta de compromiso. Revisa los documentos pendientes para entrega presencial.".
- La pantalla final se renderiza con `Paso4::index()` en la ruta `GET /finalizado` (`app/Config/Routes.php`, línea 181) y la vista `app/Views/inscripciones/nuevo_ingreso/paso4/index.php`.
- En esa vista, el encabezado muestra los botones "Descargar planilla de inscripción" (líneas 55-63) y "Descargar acta de compromiso" (líneas 64-72) cuando `$planillaUrl` y `$actaUrl` tienen valor. No existe ningún aviso de impresión o firma.
- La ruta `/paso-4` es el resumen de pago (`Paso3::index`) y no muestra los botones de descarga; no se modifica.
- No existe ninguna mención a "imprimir", "impresa" ni "firmada" en la plantilla del correo, el texto alternativo ni la pantalla final.

## Cambios propuestos

| # | Archivo / ubicación | Antes | Después | Motivo |
| --- | --- | --- | --- | --- |
| 1 | `app/Views/emails/nuevo_ingreso_inscripcion_culminada.php`, después del párrafo de la línea 33-36 | El párrafo de bienvenida termina en "…tu acta de compromiso en formato PDF." y pasa al bloque condicional de documentos. | Agregar un párrafo propio, siempre visible, con el texto: "Debes llevar impresas tu planilla de inscripción y tu acta de compromiso firmada para la entrega presencial de los recaudos." con el mismo estilo del párrafo anterior (`margin: 0 0 14px 0; font-size: 12px; line-height: 1.5;`). | Dejar el requisito explícito en el correo, visible aunque no haya documentos presenciales configurados. |
| 2 | `app/Views/inscripciones/nuevo_ingreso/paso4/index.php`, dentro del encabezado, después del contenedor de botones (líneas 53-74) | Solo se muestran los botones de descarga de planilla y acta. | Agregar un aviso visible cuando el pago esté aprobado y exista `$planillaUrl`, con el mismo texto acordado y un icono `print`. Se coloca debajo de los botones, dentro de la tarjeta de felicitación. | Que el aspirante vea el requisito justo donde descarga la planilla. |
| 3 | `app/Libraries/Inscripciones/NuevoIngreso/Notificacion/NuevoIngresoAprobacionNotificacionService.php`, constante `ALT_BODY` (línea 32) | `'Tu pago fue aprobado y tu inscripción ha culminado. Adjuntamos tu recibo, tu planilla y tu acta de compromiso. Revisa los documentos pendientes para entrega presencial.'` | `'Tu pago fue aprobado y tu inscripción ha culminado. Adjuntamos tu recibo, tu planilla y tu acta de compromiso. Revisa los documentos pendientes. Debes llevar impresas tu planilla de inscripción y tu acta de compromiso firmada para la entrega presencial de los recaudos.'` | Mantener el mismo mensaje en la versión sin HTML, sin repetir "para entrega presencial" en dos frases seguidas. |
| 4 | `tests/app/Libraries/Inscripciones/NuevoIngreso/Notificacion/NuevoIngresoAprobacionNotificacionServiceTest.php`, `testNotificarEnviaUnaSolaVezConAdjuntosYDocumentos()` (después de las aserciones de la línea 316-318) | Solo se valida que el HTML y el texto alternativo contengan "acta de compromiso". | Agregar aserciones de que el HTML y el `alt` contienen el texto exacto "Debes llevar impresas tu planilla de inscripción y tu acta de compromiso firmada para la entrega presencial de los recaudos.". | Proteger el contenido nuevo ante futuras ediciones de la plantilla o del `ALT_BODY`. |
| 5 | `tests/app/Integration/Paso4FinalizadoDocumentosTest.php`, casos `testFinalizadoConservaMensajeDocumentosYFecha()` y `testFinalizadoOcultaDocumentosSinCatalogoAplicableYConservaMensaje()` | No se valida el aviso de impresión. | Agregar la aserción de que el HTML contiene el texto exacto del aviso. | Confirmar que el mensaje aparece con pago aprobado, con o sin documentos presenciales configurados. |
| 6 | `tests/app/Integration/Paso4FinalizadoDocumentosTest.php`, casos `testFinalizadoSinIntencionNoMuestraEnlaceDePlanilla()` y `testFinalizadoConPagoNoAprobadoNoMuestraBotonDeActa()` | No se valida la ausencia del aviso. | Agregar la aserción de que el HTML no contiene el texto del aviso. | Confirmar que el mensaje no aparece sin intención ni con pago no aprobado, porque en esos casos el acta aún no está disponible. |

### Texto HTML propuesto para el correo (insertar como párrafo propio)

```html
<p style="margin: 0 0 14px 0; font-size: 12px; color: #191c1e; line-height: 1.5;">
    Debes llevar impresas tu planilla de inscripción y tu acta de compromiso firmada para la entrega presencial de los recaudos.
</p>
```

> El texto es estático y no depende de datos del aspirante, por lo que no requiere `esc()`. Se mantiene el estilo del párrafo existente y no se modifica el diseño del correo.

### Bloque propuesto para la pantalla final

Insertar después del `</div>` que cierra el contenedor de botones y antes del `<?php endif; ?>` de las líneas 53-74:

```php
<?php if (! empty($pagoAprobado) && $planillaUrl !== ''): ?>
    <div class="mt-4 p-3 sm:p-3.5 rounded-xl bg-primary/5 border border-slate-200 dark:border-slate-700 text-xs sm:text-sm text-slate-700 dark:text-slate-300 flex items-start gap-2 text-left">
        <span class="material-icons text-primary dark:text-blue-400 text-base mt-0.5">print</span>
        <span>Debes llevar impresas tu planilla de inscripción y tu acta de compromiso firmada para la entrega presencial de los recaudos.</span>
    </div>
<?php endif; ?>
```

> La condición exige pago aprobado porque el acta solo se puede descargar en ese estado. Si no hay intención de pago, tampoco se muestra. El aviso queda dentro de la tarjeta de felicitación, debajo de los botones de descarga.

## Alcance
- Incluye:
  - Agregar el aviso en el cuerpo HTML del correo, como párrafo propio y siempre visible.
  - Replicar el aviso en el texto alternativo del correo.
  - Agregar el aviso en la pantalla final `/finalizado`, debajo de los botones de descarga y solo con pago aprobado.
  - Añadir aserciones a los tests existentes del notificador y de la pantalla final.
- No incluye:
  - Cambiar el asunto del correo (`Tu inscripción en UNIR ha culminado`).
  - Cambiar los adjuntos (recibo, planilla y acta) ni la regla "todo o nada".
  - Modificar el aviso Zelle de "Pago verificado".
  - Modificar la pantalla `/paso-4` (resumen de pago), los PDFs de la planilla o del acta, ni las rutas de descarga.
  - Cambiar flujos de pago, rutas, filtros, base de datos, CSRF ni permisos.
  - Agregar dependencias o tocar `vendor/`, `public/vendor/`, `system/` o `app/ThirdParty/`.

## Archivos afectados
| Acción | Archivo | Motivo |
| --- | --- | --- |
| Modificar | `app/Views/emails/nuevo_ingreso_inscripcion_culminada.php` | Agregar el párrafo con el aviso de impresión y firma. |
| Modificar | `app/Views/inscripciones/nuevo_ingreso/paso4/index.php` | Agregar el aviso debajo de los botones de descarga de la pantalla final. |
| Modificar | `app/Libraries/Inscripciones/NuevoIngreso/Notificacion/NuevoIngresoAprobacionNotificacionService.php` | Actualizar `ALT_BODY` con el mismo aviso. |
| Modificar | `tests/app/Libraries/Inscripciones/NuevoIngreso/Notificacion/NuevoIngresoAprobacionNotificacionServiceTest.php` | Añadir aserciones del texto nuevo en HTML y texto alternativo. |
| Modificar | `tests/app/Integration/Paso4FinalizadoDocumentosTest.php` | Añadir aserciones de presencia y ausencia del aviso en la pantalla final. |
| Agregar | `docs/edit/003-aviso-impresion-planilla-acta-correo-paso-final/plan.md` | Documento de esta edición. |

No se crean archivos de código nuevos. No se tocan controladores, modelos, migraciones ni dependencias.

## Verificación

### Prueba manual (flujo normal)
1. Levantar el servidor: `php spark serve --port 8080`.
2. Completar una postulación de nuevo ingreso y aprobar el pago (pasarela no Zelle) o verificar un pago Zelle en un entorno de pruebas.
3. Abrir el correo enviado al correo registrado en la postulación.
4. Confirmar que, después de la frase "Adjuntamos tu recibo, tu planilla y tu acta de compromiso en formato PDF.", aparece un párrafo propio con el texto: "Debes llevar impresas tu planilla de inscripción y tu acta de compromiso firmada para la entrega presencial de los recaudos.".
5. Repetir con una postulación cuya carrera no tenga documentos presenciales configurados: el aviso del correo debe seguir visible.
6. Abrir la versión de texto plano del correo (si el cliente la muestra) y confirmar que incluye la misma indicación.
7. Entrar a `/finalizado` con el pago aprobado: debajo de los botones "Descargar planilla de inscripción" y "Descargar acta de compromiso" debe verse el mismo aviso, con el icono de impresión.
8. Confirmar que en `/finalizado` el aviso se ve en modo claro y oscuro sin romper el diseño en móvil.
9. Entrar a `/finalizado` sin intención de pago o con pago no aprobado: el aviso no debe mostrarse.
10. Confirmar que `/paso-4`, el asunto del correo, los tres adjuntos y los botones de descarga no cambiaron.

### Lint / build / prueba automatizada
- `php -l app/Views/emails/nuevo_ingreso_inscripcion_culminada.php` para validar la sintaxis de la plantilla del correo.
- `php -l app/Views/inscripciones/nuevo_ingreso/paso4/index.php` para validar la sintaxis de la vista final.
- `php -l app/Libraries/Inscripciones/NuevoIngreso/Notificacion/NuevoIngresoAprobacionNotificacionService.php` para validar el servicio.
- `vendor\bin\phpunit.bat tests/app/Libraries/Inscripciones/NuevoIngreso/Notificacion/NuevoIngresoAprobacionNotificacionServiceTest.php` (o `php vendor\phpunit\phpunit\phpunit ...` si el proxy no está disponible) para validar el envío, los adjuntos y el texto nuevo.
- `vendor\bin\phpunit.bat tests/app/Integration/Paso4FinalizadoDocumentosTest.php` para validar el aviso en la pantalla final.
- No aplica build de Tailwind: el correo usa estilos inline y la vista final usa clases ya presentes en `public/css/tailwind-v4.css` (`bg-primary/5`, `border-slate-200`, `dark:border-slate-700`, `text-slate-700`, `dark:text-slate-300`, `text-primary`, `dark:text-blue-400`).

## Riesgos y efectos secundarios
- **Redundancia con "Documentos pendientes":** el bloque condicional ya habla de entrega presencial. El aviso se mantiene como párrafo separado para que no dependa de la configuración de documentos por carrera. Si se prefiere evitar la repetición, se puede acortar el bloque condicional en una edición futura.
- **Visibilidad condicionada en la pantalla final:** el aviso solo aparece con pago aprobado e intención válida, porque en ese momento el acta está disponible. Si el negocio quiere mostrarlo antes, requiere otra edición.
- **Clases Tailwind:** el bloque usa clases ya presentes en `public/css/tailwind-v4.css`, por lo que no requiere compilar estilos.
- **Clientes de correo:** las etiquetas y estilos del correo son los mismos que ya usa la plantilla; no se introducen tablas ni estilos nuevos que puedan romper la renderización.
- **Texto fijo:** el aviso no está condicionado al tipo de pago ni a la sede, por decisión de la entrevista. Si el negocio exige excepciones, requiere otra edición.
- **Sin impacto técnico:** no se modifican datos, pagos, rutas, permisos ni adjuntos.

## Criterios de finalización
- [ ] El párrafo con el texto acordado existe en la plantilla HTML del correo, después de la frase de adjuntos.
- [ ] El aviso del correo se muestra aunque la carrera no tenga documentos presenciales configurados.
- [ ] El texto alternativo incluye la misma indicación.
- [ ] La pantalla `/finalizado` muestra el aviso debajo de los botones cuando el pago está aprobado.
- [ ] La pantalla `/finalizado` no muestra el aviso sin intención o con pago no aprobado.
- [ ] El test del notificador y el test de la pantalla final validan el texto y pasan sin errores.
- [ ] `php -l` sobre las dos vistas y el servicio pasa sin errores.
- [ ] El asunto, los adjuntos, el aviso Zelle y la pantalla `/paso-4` no cambiaron.
- [ ] No se modificó nada fuera del alcance.

## Notas del programador
- Texto confirmado por el usuario en la entrevista: "Debes llevar impresas tu planilla de inscripción y tu acta de compromiso firmada para la entrega presencial de los recaudos.".
- Se confirmó que el acta debe indicarse como impresa y firmada.
- Se confirmó que el aviso va en un párrafo propio después de la frase de adjuntos en el correo y debajo de los botones en la pantalla final.
- Se confirmó que aplica a todas las postulaciones aprobadas, sin importar sede ni método de pago.
- La pantalla final se identificó como `GET /finalizado` (`Paso4::index`), no `/paso-4` (resumen de pago de `Paso3::index`).
- El test existente del notificador solo comprueba la subcadena "acta de compromiso"; las nuevas aserciones deben ser por el texto completo para evitar falsos positivos.
- El aviso de la pantalla final se condiciona a pago aprobado para no mencionar el acta cuando todavía no se puede descargar.
