# Prototipo de ejecución — EDT-001 Agregar los campos del aspirante a la planilla de inscripción de nuevo ingreso

- **Rama:** p-edit/agregar-campos-planilla-inscripcion-nuevo-ingreso
- **Rama base:** feature/desacoplar-contructor-pagos
- **Plan:** docs/edit/001-agregar-campos-planilla-inscripcion-nuevo-ingreso/plan.md
- **Fecha:** 2026-11-03
- **Estado:** consolidado (edición parcial; verificación manual pendiente)
- **Rama destino:** feature/desacoplar-contructor-pagos
- **Fecha de consolidación:** 2026-11-03
- **Estrategia de consolidación:** merge --no-ff (commit `eb24e2d`)

## Resumen

Se amplió el servicio de la planilla de nuevo ingreso para construir y traducir los campos de fecha de nacimiento, sexo, representante, salud, plantel y trabajo. La vista PDF se reorganizó en cinco secciones (personal, representante condicional, salud, académica y laboral) conservando carrera, sede, turno y modalidad. Se ampliaron las pruebas del servicio (esquema SQLite, datos de ejemplo y aserciones). Las pruebas automatizadas indicadas en el plan pasan; la verificación manual en una postulación real quedó pendiente.

## Cambios aplicados

| # | Archivo / ubicación | Antes | Después | Estado |
| --- | --- | --- | --- | --- |
| 1 | `NuevoIngresoPlanillaService::datosPlanilla()` | No devolvía fecha de nacimiento ni sexo. | Devuelve `fecha_nacimiento` (`dd/mm/aaaa`) y `sexo` (`Masculino`/`Femenino`); inválidos o vacíos → `No disponible`. | aplicado |
| 2 | `NuevoIngresoPlanillaService::datosPlanilla()` | No devolvía datos del representante. | Devuelve `tiene_representante`, `rep_nombres`, `rep_apellidos`, `rep_parentesco`, `rep_telefono`, `rep_pais`, `rep_provincia`, `rep_ciudad` y `rep_direccion`; país/provincia se resuelven desde `rep_pais_provincia_id`. | aplicado |
| 3 | `NuevoIngresoPlanillaService::datosPlanilla()` | No devolvía discapacidad ni alergia. | Devuelve `Sí: {texto}` con valor y `No` cuando el campo está vacío. | aplicado |
| 4 | `NuevoIngresoPlanillaService::datosPlanilla()` | No devolvía antecedentes del plantel. | Devuelve `plantel_egreso`, `plantel_ano_egreso`, `plantel_tipo` y `plantel_mencion` traducidos. | aplicado |
| 5 | `NuevoIngresoPlanillaService::datosPlanilla()` | No devolvía información laboral. | Devuelve `trabaja`, `trabajo_empresa` y horarios normalizados a `HH:MM`. | aplicado |
| 6 | `NuevoIngresoPlanillaService` (métodos privados) | Solo existían `identificacion()` y `modalidad()`. | Se agregaron `fecha()`, `hora()`, `sexo()`, `parentesco()`, `tipoPlantel()`, `mencion()`, `tieneRepresentante()`, `condicionLaboral()` y `detalleSalud()`. | aplicado |
| 7 | `app/Views/.../paso3/planilla.php` - Información personal | Filas: Apellidos/Nombres; Cédula/Correo; Teléfono/País/Provincia; Ciudad/Dirección. | Se agregó la fila Fecha de Nacimiento / Sexo después de Apellidos/Nombres. | aplicado |
| 8 | `app/Views/.../paso3/planilla.php` - Representante | No existía la sección. | Se agregó `INFORMACIÓN DEL REPRESENTANTE`, visible solo si `tiene_representante` es verdadero, con Nombres, Apellidos, Parentesco, Teléfono Móvil, País, Estado/Provincia, Ciudad y Dirección de Habitación. | aplicado |
| 9 | `app/Views/.../paso3/planilla.php` - Salud | No existía la sección. | Se agregó `INFORMACIÓN DE SALUD` con Discapacidad y Es alérgico a algún Medicamento. | aplicado |
| 10 | `app/Views/.../paso3/planilla.php` - Información académica | Solo Carrera/Sede y Turno/Modalidad. | Se conservaron esas filas y se agregaron Nombre del Plantel donde Egresó, Año de Egreso, Plantel y Mención. | aplicado |
| 11 | `app/Views/.../paso3/planilla.php` - Laboral | No existía la sección. | Se agregó `INFORMACIÓN LABORAL` con ¿Trabajas?; Empresa y horarios solo cuando la respuesta es `Sí`. | aplicado |
| 12 | `NuevoIngresoPlanillaServiceTest.php` - esquema SQLite | `ni_inscripciones` no tenía las columnas nuevas. | Se agregaron las columnas de fecha, sexo, representante, salud, plantel y trabajo. | aplicado |
| 13 | `NuevoIngresoPlanillaServiceTest.php` - datos de prueba | La postulación sembrada solo tenía datos básicos. | Se agregaron valores de ejemplo para todos los campos nuevos y una segunda provincia (`Carabobo`, id 2) para el representante. | aplicado |
| 14 | `NuevoIngresoPlanillaServiceTest.php` - aserciones | Solo se comprobaban los datos actuales. | Se agregaron aserciones de valores/etiquetas nuevos, ausencia de la sección del representante y casos `No` de salud y trabajo. | aplicado |

## Tareas realizadas

- [x] Ampliar `datosPlanilla()` con los campos nuevos y resolver país/provincia del representante.
- [x] Agregar métodos privados de formato y traducción (fecha, hora, sexo, parentesco, plantel, mención, representante, trabajo y salud).
- [x] Reorganizar la vista PDF en cinco secciones con el orden solicitado.
- [x] Condicionar la sección del representante a `tiene_representante`.
- [x] Mostrar salud y trabajo como `No` sin detalle cuando no hay datos.
- [x] Ampliar el esquema SQLite, los datos sembrados y las aserciones de la prueba del servicio.
- [x] Ejecutar `php -l` y las pruebas indicadas en el plan.
- [ ] Verificación manual en una postulación real con sesión y pago aprobado — Motivo: requiere datos y sesión de nuevo ingreso disponibles fuera del entorno de pruebas.

## Archivos creados

| Archivo | Motivo |
| --- | --- |
| `docs/edit/001-agregar-campos-planilla-inscripcion-nuevo-ingreso/prototipo.md` | Registrar la ejecución, verificación y pendientes de la edición. |

## Archivos modificados

| Archivo | Cambio realizado |
| --- | --- |
| `app/Libraries/Inscripciones/NuevoIngreso/Planilla/NuevoIngresoPlanillaService.php` | Nuevas claves en `datosPlanilla()`, resolución de país/provincia del representante y métodos privados de formato/traducción. |
| `app/Views/inscripciones/nuevo_ingreso/paso3/planilla.php` | Fila de fecha/sexo, secciones de representante, salud y laboral, y filas del plantel en la sección académica. |
| `tests/app/Libraries/Inscripciones/NuevoIngreso/Planilla/NuevoIngresoPlanillaServiceTest.php` | Columnas nuevas en SQLite, datos de ejemplo, segunda provincia y tres pruebas adicionales con sus aserciones. |

## Comandos ejecutados

| Comando | Resultado |
| --- | --- |
| `php -l app/Libraries/Inscripciones/NuevoIngreso/Planilla/NuevoIngresoPlanillaService.php` (línea base) | Sin errores de sintaxis. |
| `php -l app/Views/inscripciones/nuevo_ingreso/paso3/planilla.php` (línea base) | Sin errores de sintaxis. |
| `vendor\bin\phpunit.bat tests/app/Libraries/Inscripciones/NuevoIngreso/Planilla/NuevoIngresoPlanillaServiceTest.php` (línea base) | OK: 11 pruebas, 42 aserciones. |
| `vendor\bin\phpunit.bat tests/app/Integration/Paso4PlanillaTest.php` (línea base) | OK: 8 pruebas, 19 aserciones. |
| `php -l` sobre servicio, vista y prueba (después) | Sin errores de sintaxis. |
| `vendor\bin\phpunit.bat tests/app/Libraries/Inscripciones/NuevoIngreso/Planilla/NuevoIngresoPlanillaServiceTest.php` (después) | OK: 14 pruebas, 74 aserciones. |
| `vendor\bin\phpunit.bat tests/app/Integration/Paso4PlanillaTest.php` (después) | OK: 8 pruebas, 19 aserciones. |

Nota: PHPUnit 8.5 imprime el aviso preexistente «This version of PHPUnit does not support code coverage on PHP 8»; no afecta el resultado de las pruebas.

## Verificación

- **Línea base (antes):** `php -l` sin errores en servicio y vista; 11 pruebas (42 aserciones) del servicio y 8 pruebas (19 aserciones) de integración en verde.
- **Prueba manual (flujo normal):** no ejecutada en el entorno real por no disponer de una postulación con `paso_actual = 4`, pago aprobado/verificado y sesión de nuevo ingreso. La renderización de la vista y la descarga se cubren de forma automatizada en las pruebas del servicio y de integración.
- **Pruebas automatizadas / lint:** `php -l` sin errores; `NuevoIngresoPlanillaServiceTest` 14/14 en verde; `Paso4PlanillaTest` 8/8 en verde.
- **Criterios del plan:**
  - [x] Campos nuevos mostrados en la planilla.
  - [x] Sección del representante condicionada a datos `rep_*`.
  - [x] Discapacidad, alergia y trabajo muestran `No` sin detalle cuando corresponde (cubierto por prueba).
  - [x] Fecha `dd/mm/aaaa` y horas `HH:MM` (cubierto por prueba, incluidos valores inválidos).
  - [x] Se conservan Carrera, Sede, Turno y Modalidad (aserciones existentes en verde).
  - [x] No se muestran IDs ni metadatos técnicos.
  - [ ] Verificación manual en postulación completa y sin representante: pendiente en entorno real; la ausencia de la sección del representante sí está cubierta por prueba.
  - [x] `php -l` y pruebas indicadas sin errores nuevos.
  - [x] Sin cambios en migraciones, rutas, controladores, pagos ni planilla regular.

## Desviaciones del plan

- En `testPaisYProvinciaAusentesSeMuestranComoNoDisponible` se limpió también `rep_pais_provincia_id`: al existir ahora país del representante, la aserción original «no contiene Venezuela» dejaba de ser válida. El objetivo de la prueba (país/provincia del aspirante ausentes) se mantiene.
- Se agregó `testFechaYHoraInvalidasSeMuestranComoNoDisponible` para verificar explícitamente los casos inválidos descritos en el plan.
- Se usó `assertRegExp` (PHPUnit 8) en lugar de `assertMatchesRegularExpression`, que no existe en esta versión.

## Riesgos y pendientes

- **Verificación manual pendiente:** falta abrir `/inscripciones/nuevo-ingreso/paso-4` con una postulación real y confirmar visualmente el PDF, el orden de secciones y el salto a varias páginas.
- **Extensión del PDF:** con todos los campos es probable que ocupe dos páginas. La cabecera fija «PAGINA: 1 DE 1» no se modificó porque no forma parte del alcance; evaluar en una edición aparte si debe ser dinámica.
- **Catálogo del representante:** si `rep_pais_provincia_id` apunta a un registro inactivo o inexistente, se mostrará `No disponible` y se registrará una advertencia, sin romper la generación.
- **Registros antiguos:** las postulaciones sin datos de representante omiten la sección; salud y trabajo muestran `No`; los campos obligatorios vacíos muestran `No disponible`.
