# Aislamiento de pagos regulares frente a pagos de nuevo ingreso

- **Código:** BUG-004
- **Tipo:** bugfix
- **Estado:** en curso

## Objetivo

Impedir que el portal regular (`Pagos` y `Reportes`) consulte, cobre, cancele o muestre recibos de intenciones de pago de nuevo ingreso, aunque compartan la misma `identificacion`. El discriminador debe ser `pg_intenciones_pago.ni_inscripcion_id`: nulo para pagos regulares y no nulo para pagos de nuevo ingreso. El flujo de nuevo ingreso y el de pagos regulares deben conservar su comportamiento actual.

## Problema

`pg_intenciones_pago` almacena tanto intenciones de estudiantes regulares como intenciones de aspirantes de nuevo ingreso. Desde la incorporación de `ni_inscripcion_id` (migración `2026-10-27-000099`) existe un discriminador de origen, pero los flujos regulares siguen seleccionando y autorizando intenciones únicamente por `identificacion`.

En concreto:

- `IntencionesPagoModel::getPagosPorCedulaConDetalle()` filtra por `identificacion` y estados, sin exigir `ni_inscripcion_id IS NULL` (`app/Models/PagosOnline/IntencionesPagoModel.php:92-120`). Ese método alimenta `Pagos::tipopago()`, la creación de detalles de deuda/inscripción, `Pagos::pagarIt()`, `Pagos::elegirFormaPago()`, `detalleExiste()` y `PaymentOrchestrator::obtenerIntencionPrePago()`.
- `Pagos::index()` consulta directamente `pg_intenciones_pago` solo por `identificacion` (`app/Controllers/Pagos.php:48-59`).
- `Pagos::validarPropietario()` solo compara la cédula de la sesión con `identificacion` (`app/Controllers/Pagos.php:1309-1336`). No distingue el origen.
- `Reportes::Recibo()` solo valida la cédula antes de generar el recibo (`app/Controllers/Reportes.php:718-745`).
- `Pagos::retirarDetalle()` elimina un detalle por ID sin validar propietario ni origen (`app/Controllers/Pagos.php:719-756`).
- `IntencionesPagoModel::cancelarIntencion()` solo compara `ni_inscripcion_id` cuando se pasa `$niId`; si se llama sin ese parámetro, permite cancelar una intención de nuevo ingreso (`app/Models/PagosOnline/IntencionesPagoModel.php:552-596`).
- `IntencionesPagoModel::cierraPagosVencidos()` cierra todas las intenciones en estado `1`/`2` con `fecha` anterior a ayer, sin filtrar origen (`app/Models/PagosOnline/IntencionesPagoModel.php:126-163`). Se invoca desde el portal regular en `Pagos::tipopago()` y `Pagos::pagarIt()` (`app/Controllers/Pagos.php:114` y `:828`) y desde el servicio NI en `NuevoIngresoPagoService::crearIntencion()` (`app/Libraries/Inscripciones/NuevoIngreso/Pago/NuevoIngresoPagoService.php:247`). Un estudiante regular puede cerrar así intenciones NI vencidas de cualquier cédula.

El servicio de nuevo ingreso sí filtra correctamente por `ni_inscripcion_id` al consultar (`app/Libraries/Inscripciones/NuevoIngreso/Pago/NuevoIngresoPagoService.php:432-444` y `:451-483`). La asimetría está en los flujos regulares y en el cierre global de vencidos, que son anteriores al discriminador.

## Impacto

- **Usuarios:** un estudiante regular cuya cédula coincida con la de un aspirante puede ver el pago de nuevo ingreso en `/Pagos`, usarlo como intención activa, agregarle deudas o inscripciones regulares, iniciar el cobro por pasarela, cancelarlo o abrir su recibo.
- **Integridad del pago:** el riesgo principal es aplicar un cobro regular sobre una intención de nuevo ingreso o modificar su estado y sus detalles. También existe un IDOR en `retirarDetalle`, que permite borrar detalles de otra intención o de otro estudiante con solo conocer el ID. El cierre global de vencidos permite que un estudiante regular cancele intenciones NI ajenas por el simple paso del día.
- **Datos:** no se ha confirmado pérdida de datos. El defecto puede producir mutaciones de estado no autorizadas.
- **Gravedad:** alta por tratarse de aislamiento de pagos, pero **no hay evidencia de afectación a producción**. El usuario confirmó que solo se ha observado en desarrollo/pruebas. Si aparece evidencia en producción, el caso debe reclasificarse como **hotfix**.
- **Alcance:** portal regular (`Pagos` y `Reportes`). No se rediseña el flujo de nuevo ingreso ni se agrega UI de pago NI.
- **Contexto:** el Paso 4 de nuevo ingreso sigue siendo un placeholder (`app/Controllers/Inscripciones/NuevoIngreso/Paso3.php`), pero las intenciones NI pueden existir por el servicio, pruebas o datos sembrados. El defecto es latente para la UI completa y real para los datos ya presentes.

## Reproducción

> Ejecutar solo en una base de desarrollo o pruebas autorizada. No usar producción.

1. Confirmar en la base principal que existe una intención de nuevo ingreso con `ni_inscripcion_id` no nulo, `identificacion = 'V00000000'` (valor de ejemplo) y estado `1`, `2`, `3` u `8`.
2. Confirmar que existe una sesión de estudiante regular cuya cédula sea también `V00000000`.
3. Iniciar sesión como estudiante regular y abrir `/Pagos`.
4. Resultado actual: la intención de nuevo ingreso aparece en la lista de pagos del estudiante regular.
5. Abrir `/Pagos/tipopago` cuando la intención NI esté en estado `1` o `2`.
6. Resultado actual: la intención NI se trata como el pago actual; puede mostrarse como pago en proceso o cargarse como intención editable.
7. Con el ID de la intención NI, probar `/Pagos/CambiarPagar/{id}`, `/Pagos/prePago/{forma}/{id}`, `/Pagos/postPago/{forma}/{id}`, `/Pagos/CancelarPago/{id}` y `/Pagos/IntencionesPagos/{id}`.
8. Resultado actual: `validarPropietario()` acepta la intención porque solo compara la cédula; el estado o el cobro puede avanzar.
9. Si la intención NI está aprobada o verificada (`3` u `8`), abrir `/Reportes/Recibo/{id}`.
10. Resultado actual: el recibo de nuevo ingreso se genera para la sesión regular.
11. Con el ID de un detalle de la intención NI, abrir `/Pagos/retirarDetalle/{idDetalle}`.
12. Resultado actual: el detalle se elimina sin validar que pertenezca al estudiante ni que la intención sea regular.
13. Invocar `IntencionesPagoModel::cancelarIntencion($id)` sin el segundo argumento sobre una intención NI en estado `1` o `2`.
14. Resultado actual: la intención se cancela, aunque el llamador no haya declarado la postulación de origen.
15. Crear o localizar una intención NI en estado `1` o `2` con `fecha` anterior a ayer y abrir `/Pagos/tipopago` o `/Pagos/pagarIt` con la sesión regular.
16. Resultado actual: `cierraPagosVencidos()` marca la intención NI como cancelada (`estados_id = 5`) y borra sus detalles, aunque no pertenezca a la sesión regular.

## Comportamiento esperado

- `IntencionesPagoModel::getPagosPorCedulaConDetalle()` devuelve únicamente intenciones con `ni_inscripcion_id IS NULL`. `detalleExiste()` hereda ese aislamiento.
- `Pagos::index()` no lista intenciones de nuevo ingreso para la sesión regular.
- `Pagos::tipopago()`, `Pagos::pagarIt()`, `Pagos::elegirFormaPago()`, `Pagos::CambiarPagar()`, `Pagos::prePago()`, `Pagos::postPago()`, `Pagos::CancelarPago()` y `Pagos::IntencionesPagos()` rechazan intenciones con `ni_inscripcion_id` no nulo mediante el mensaje genérico de permisos que ya usa `validarPropietario()`: **“No tienes permisos para usar este movimiento.”** No se debe revelar si la intención existe ni a qué postulación pertenece.
- `Reportes::Recibo()` rechaza intenciones con `ni_inscripcion_id` no nulo con el mensaje existente **“No tienes permisos para ver este recibo.”** y no genera el PDF.
- `Pagos::retirarDetalle()` valida que el detalle exista, resuelve su `intencio_pago_id` y comprueba explícitamente que la intención exista, que sea regular (`ni_inscripcion_id` nulo) y que su `identificacion` coincida con la sesión. No debe depender solo del silencio de `validarPropietario()` cuando la intención no existe. Un detalle de nuevo ingreso, de otro estudiante, de una intención inexistente o un ID de detalle inexistente no se elimina.
- `IntencionesPagoModel::cierraPagosVencidos()` recibe un parámetro opcional `$niInscripcionId`. Sin parámetro cierra únicamente intenciones regulares (`ni_inscripcion_id IS NULL`); con un ID cierra únicamente las intenciones NI de esa postulación. El servicio de nuevo ingreso debe pasar su `$niInscripcionId` para conservar la expiración de sus propias intenciones.
- `IntencionesPagoModel::cancelarIntencion($id)` sin `$niId` rechaza intenciones con `ni_inscripcion_id` no nulo y no modifica la cabecera ni los detalles.
- `IntencionesPagoModel::cancelarIntencion($id, $niId)` sigue funcionando para el servicio de nuevo ingreso cuando `$niId` coincide con `pg_intenciones_pago.ni_inscripcion_id`.
- El flujo de nuevo ingreso conserva su capacidad de crear, consultar, cobrar y cancelar sus propias intenciones.
- El flujo regular conserva la creación de intenciones, el agregado de deudas/inscripciones, el pago, la cancelación y el recibo cuando `ni_inscripcion_id` es nulo.
- No se modifican rutas, filtros, CSRF, pasarelas, montos ni el esquema.

## Causa raíz (hipótesis)

Hipótesis confirmada por lectura de código; la reproducción manual queda pendiente hasta ejecutar los pasos en la base de desarrollo.

La tabla `pg_intenciones_pago` es compartida por dos dominios, pero los flujos regulares no incorporaron el discriminador `ni_inscripcion_id`:

- Las consultas regulares usan `identificacion` como única clave de pertenencia (`IntencionesPagoModel.php:101`, `Pagos.php:56`).
- La autorización regular usa la misma clave (`Pagos.php:1321-1334`, `Reportes.php:731-735`).
- `retirarDetalle()` ni siquiera consulta la intención antes de borrar el detalle (`Pagos.php:719-756`).
- La cancelación del modelo solo valida `ni_inscripcion_id` cuando el llamador pasa `$niId`; no exige que una cancelación sin `$niId` sea de una intención regular (`IntencionesPagoModel.php:564-568`).
- El cierre de vencidos no filtra `ni_inscripcion_id` (`IntencionesPagoModel.php:134`) y se ejecuta tanto desde el portal regular como desde el servicio NI, por lo que un flujo regular puede cerrar intenciones NI ajenas.
- El servicio de nuevo ingreso y `ProceNi()` sí usan `ni_inscripcion_id` para delimitar propiedad (`NuevoIngresoPagoService.php:432-444`, `IntencionesPagoModel.php:607-638`), lo que confirma que el discriminador es la fuente correcta y que el defecto está en los consumidores regulares y en el cierre global.

## Archivos afectados

| Acción | Archivo | Motivo |
| --- | --- | --- |
| Agregar | `docs/bugfix/004-aislamiento-pagos-regulares-nuevo-ingreso/plan.md` | Documento de este plan. |
| Modificar | `app/Models/PagosOnline/IntencionesPagoModel.php` | Añadir `ni_inscripcion_id IS NULL` en `getPagosPorCedulaConDetalle()`; rechazar en `cancelarIntencion()` las intenciones NI cuando se invoca sin `$niId`; parametrizar `cierraPagosVencidos()` por origen. |
| Modificar | `app/Controllers/Pagos.php` | Filtrar `pg_intenciones_pago.ni_inscripcion_id IS NULL` en `index()`; rechazar intenciones NI en `validarPropietario()`; validar detalle, existencia de la intención, propietario y origen en `retirarDetalle()`. |
| Modificar | `app/Controllers/Reportes.php` | Rechazar en `Recibo()` las intenciones con `ni_inscripcion_id` no nulo antes de generar el PDF. |
| Modificar | `app/Libraries/Inscripciones/NuevoIngreso/Pago/NuevoIngresoPagoService.php` | Pasar `$niInscripcionId` a `cierraPagosVencidos()` en `crearIntencion()` para que la expiración siga aplicando solo a sus propias intenciones. |
| Modificar | `tests/app/Models/PagosOnline/IntencionesPagoModelNiTest.php` | Agregar casos de regresión para el filtro por origen, la cancelación sin `$niId` y el cierre de vencidos por origen; conservar los casos NI existentes. |
| Modificar | `tests/app/Libraries/Inscripciones/NuevoIngreso/Pago/NuevoIngresoPagoServiceTest.php` | Agregar un caso que demuestre que `crearIntencion($niId)` cierra solo las intenciones vencidas de esa postulación y no las de otra. |

No se modifica `app/Libraries/Payments/PaymentOrchestrator.php`: su consulta pasa por `getPagosPorCedulaConDetalle()` y queda cubierta por el filtro del modelo.

`Pagos::CancelarPago()` e `Pagos::IntencionesPagos()` no requieren cambios propios porque delegan en `validarPropietario()`; quedan cubiertos al endurecer ese método. No se cambia el borrado físico de detalles que hace `CancelarPago()`.

## Plan de verificación

### Prueba manual (flujo normal)

> Requiere una base de desarrollo o pruebas autorizada con una intención NI y un estudiante regular que compartan la misma cédula. No ejecutar en producción.

**Preparación y auditoría de datos**

1. Ejecutar una consulta de solo lectura para localizar intenciones de la cédula de prueba:
   ```sql
   SELECT id, identificacion, estados_id, ni_inscripcion_id, monto_total, fecha
   FROM pg_intenciones_pago
   WHERE identificacion = 'V00000000'
   ORDER BY id DESC;
   ```
2. Confirmar que al menos una fila tiene `ni_inscripcion_id` no nulo y que existe una sesión regular con la misma cédula.
3. Verificar que no existan intenciones NI históricas con `ni_inscripcion_id` nulo:
   ```sql
   SELECT i.id, i.identificacion, i.estados_id
   FROM pg_intenciones_pago i
   JOIN pg_intenciones_pago_det d ON d.intencio_pago_id = i.id
   WHERE i.ni_inscripcion_id IS NULL
     AND d.datos LIKE '%NiInscripcionID%';
   ```
   Si devuelve filas, tratarlas como corrección de datos aparte (ver “Riesgos y efectos secundarios”).

**Portal regular**

1. Iniciar sesión como estudiante regular y abrir `/Pagos`.
2. Resultado esperado: no aparece ninguna intención con `ni_inscripcion_id` no nulo. Si solo existe la intención NI, la vista debe comportarse como si el estudiante no tuviera pagos en línea.
3. Abrir `/Pagos/tipopago`.
4. Resultado esperado: la intención NI no se muestra como pago actual ni como pago en proceso. Si hay una intención regular, solo esa puede editarse.
5. Intentar `/Pagos/CambiarPagar/{idNi}`, `/Pagos/prePago/{forma}/{idNi}`, `/Pagos/postPago/{forma}/{idNi}`, `/Pagos/CancelarPago/{idNi}` y `/Pagos/IntencionesPagos/{idNi}`.
6. Resultado esperado: en todos los casos se muestra “No tienes permisos para usar este movimiento.” y no cambia el estado de la intención NI.
7. Abrir `/Reportes/Recibo/{idNi}` para una intención NI en estado `3` u `8`.
8. Resultado esperado: se muestra “No tienes permisos para ver este recibo.” y no se genera el PDF.
9. Abrir `/Pagos/retirarDetalle/{idDetalleNi}`.
10. Resultado esperado: se muestra el mensaje de permisos y el detalle sigue existiendo en `pg_intenciones_pago_det`.
11. Repetir `/Pagos/retirarDetalle/{idDetalleDeOtroEstudiante}`.
12. Resultado esperado: también se rechaza; el detalle no se elimina.
13. Abrir `/Pagos/retirarDetalle/{idDetallePropioRegular}`.
14. Resultado esperado: el detalle propio se elimina y el total de la intención regular se recalcula como hoy.
15. Con una intención NI vencida (estado `1`/`2` y `fecha` anterior a ayer), abrir `/Pagos/tipopago` y luego `/Pagos/pagarIt` con la sesión regular.
16. Resultado esperado: la intención NI vencida conserva su estado y sus detalles; el cierre de vencidos del portal regular solo afecta intenciones regulares.

**Flujo de nuevo ingreso**

1. Ejecutar las pruebas del servicio NI y, si existe una sesión de aspirante en desarrollo, confirmar que puede consultar y cancelar su propia intención.
2. Resultado esperado: `NuevoIngresoPagoService::cancelar($id, $niId)` sigue devolviendo `true` para una intención NI en estado `1` o `2`; los detalles quedan con `borrado_dt`.
3. Confirmar que `getPagosPorCedulaConDetalle()` no es usado por el servicio NI para mostrar su pago; el servicio consulta directamente por `ni_inscripcion_id`.
4. Con una intención NI vencida de la postulación, llamar a `NuevoIngresoPagoService::crearIntencion($niId)`.
5. Resultado esperado: el servicio cierra solo las intenciones vencidas de esa postulación y no toca las de otras postulaciones ni las regulares.

**Flujo regular completo**

1. Con una intención regular (`ni_inscripcion_id` nulo) en estado `1` o `2`, repetir el flujo de agregar detalle, cambiar a pagando, abrir la pasarela y cancelar.
2. Resultado esperado: el comportamiento es idéntico al actual.

**Consulta de control posterior**

1. Repetir la consulta del paso de preparación y comparar estados y `borrado_dt` de la intención NI y sus detalles.
2. Resultado esperado: ninguna operación regular modificó la intención NI.

### Prueba automatizada / código de verificación

No se crea código de prueba nuevo en esta fase de planificación porque existe una verificación manual ejecutable en desarrollo. La corrección debe incorporar estos casos en `tests/app/Models/PagosOnline/IntencionesPagoModelNiTest.php`, que ya usa SQLite en memoria y un esquema compatible. Para crear intenciones regulares y detalles con `AdMovID` se puede parametrizar el helper `crearIntencion()` con `niId` nulo o agregar helpers `crearIntencionRegular()` y `crearDetalle()`:

1. `testGetPagosPorCedulaConDetalleExcluyeNuevoIngreso`: crear una intención regular (`ni_inscripcion_id` nulo) y una NI con la misma `identificacion` y estado `2`; afirmar que solo se devuelve la regular.
2. `testDetalleExisteIgnoraDetallesDeNuevoIngreso`: crear una intención NI en estado `1` con un detalle `AdMovID` y afirmar que `detalleExiste()` devuelve `false`; luego crear una intención regular con el mismo detalle y afirmar que devuelve `true`.
3. `testCancelarIntencionSinNiIdRechazaNuevoIngreso`: crear una intención NI en estado `2`; afirmar que `cancelarIntencion($id)` devuelve `false`, que el estado sigue en `2` y que el detalle conserva `borrado_dt` nulo.
4. `testCancelarIntencionRegularSinNiIdSigueFuncionando`: crear una intención regular en estado `2`; afirmar que `cancelarIntencion($id)` devuelve `true` y que la cabecera pasa a `5`.
5. `testCierraPagosVencidosNoTocaNuevoIngreso`: crear una intención regular vencida y una NI vencida con la misma cédula; llamar `cierraPagosVencidos()` sin parámetro y afirmar que solo la regular pasa a `5` y pierde detalles.
6. `testCierraPagosVencidosDeUnaPostulacion`: crear dos intenciones NI vencidas (postulaciones 20 y 21) y una regular; llamar `cierraPagosVencidos(20)` y afirmar que solo la NI 20 se cierra, mientras la 21 y la regular conservan estado y detalles.
7. En `NuevoIngresoPagoServiceTest`, `testCrearIntencionCierraSoloVencidasDeSuPostulacion`: sembrar dos intenciones NI vencidas (postulaciones 20 y 21) y llamar `crearIntencion(20)`; afirmar que la 20 se cierra y se crea/reutiliza la de esa postulación, mientras la 21 conserva estado y detalles.
8. Conservar en verde los casos existentes de cancelación con `$niId` coincidente y no coincidente.

Comandos:

```sh
vendor\bin\phpunit.bat tests\app\Models\PagosOnline\IntencionesPagoModelNiTest.php --no-coverage
vendor\bin\phpunit.bat tests\app\Libraries\Payments --no-coverage
vendor\bin\phpunit.bat tests\app\Libraries\Inscripciones\NuevoIngreso\Pago --no-coverage
```

Estado de referencia verificado antes de este plan: `IntencionesPagoModelNiTest` pasa con 8 tests y 20 assertions; `tests/app/Libraries/Payments` pasa con 18 tests y 67 assertions; `tests/app/Libraries/Inscripciones/NuevoIngreso/Pago` pasa con 15 tests y 50 assertions. Después de la corrección se esperan 14 tests en el archivo del modelo (8 existentes + 6 nuevos), al menos un caso nuevo en el test del servicio NI y las tres suites en verde.

La verificación de los controladores (`Pagos::index`, `validarPropietario`, `retirarDetalle` y `Reportes::Recibo`) se hace manualmente porque dependen de sesión CI4, `BaseController`, conexión por sucursal y vistas. No se propone una prueba HTTP completa para este bugfix pequeño.

## Riesgos y efectos secundarios

- **Intenciones NI históricas sin discriminador:** la migración `099` no hizo backfill. Si existieran intenciones de nuevo ingreso creadas antes de esa migración, tendrían `ni_inscripcion_id` nulo y este filtro no las aislaría. Antes de cerrar el bugfix se debe auditar la base y, si aparecen, tratarlas como corrección de datos separada.
- **Cambio de contrato del modelo:** `getPagosPorCedulaConDetalle()` dejará de devolver intenciones NI a cualquier consumidor. Hoy todos sus llamadores son flujos regulares y el servicio NI consulta directamente, pero un consumidor futuro que necesite ambos orígenes deberá usar una consulta explícita o un parámetro adicional. Se documenta para evitar reutilizarlo por error.
- **Dependencia de esquema:** la columna `ni_inscripcion_id` y su índice deben existir en la base principal. La migración `2026-10-27-000099` es la fuente; sin ella, las consultas fallarían.
- **`retirarDetalle` cambia de comportamiento:** ahora consulta el detalle y valida al propietario. Un ID inexistente o ajeno dejará de borrar y mostrará un mensaje. Es el comportamiento deseado, pero debe probarse para no romper el retiro de un detalle propio.
- **`validarPropietario` conserva el comportamiento ante ID inexistente:** si la intención no existe, el método actual no rechaza explícitamente. Este plan no amplía ese caso para no cambiar mensajes de `postPago()` con `$id` nulo; queda como deuda de endurecimiento separada. `retirarDetalle()` sí debe comprobar explícitamente la existencia, el origen y la propiedad de la intención antes de borrar, porque resuelve el detalle y puede fallar cerrado sin afectar otros flujos.
- **Controladores legacy:** `Pagos_r`, `Pagos_old` y `Pagos_old2` no se modifican en este bugfix. Si alguna ruta los expone en el portal actual, deben revisarse en un análisis aparte con el mismo criterio de `ni_inscripcion_id`. No se asume que estén en uso solo porque existan en `app/Controllers`.
- **Cancelación:** `Pagos::CancelarPago()` sigue haciendo borrado físico de detalles y no usa `cancelarIntencion()`. La protección regular depende de `validarPropietario()`; el guard del modelo protege a los llamadores directos y al servicio NI. No se unifican ambas rutas de cancelación en este bugfix.
- **`cierraPagosVencidos` cambia de contrato:** el parámetro opcional hace que, sin argumento, solo cierre intenciones regulares. Todos los llamadores actuales deben quedar explícitos: el portal regular no pasa argumento; `NuevoIngresoPagoService` debe pasar su `$niInscripcionId`. Si se olvida, el servicio NI podría reutilizar una intención vencida. Las pruebas deben cubrir ambos caminos. El método sigue borrando físicamente los detalles de las intenciones vencidas; no se cambia a borrado lógico en este bugfix.
- **Expiraciones simultáneas:** el cierre de vencidos del portal regular ya no tocará NI, pero el servicio NI seguirá cerrando solo su propia postulación. No se introduce un cron ni un cierre global nuevo; se conserva el comportamiento por demanda.
- **Recibo NI:** se bloquea siempre en el portal regular. Si el producto necesita un recibo para el aspirante, debe implementarse en el flujo de nuevo ingreso como una funcionalidad aparte.
- **Misma cédula es legítima:** un aspirante puede convertirse en estudiante. La separación correcta es por origen (`ni_inscripcion_id`), no por identidad. No se deben borrar ni duplicar datos por “misma cédula”.
- **Sin cambios de rutas ni filtros:** no se alteran CSRF, `sessionAdmin`, `adminPanel`, `jwtAuth` ni el contrato HTTP.

## Criterios de finalización

- [ ] `getPagosPorCedulaConDetalle()` devuelve solo intenciones con `ni_inscripcion_id IS NULL` y `detalleExiste()` ya no ve detalles NI.
- [ ] `/Pagos` no lista intenciones de nuevo ingreso para la sesión regular.
- [ ] `validarPropietario()` rechaza intenciones con `ni_inscripcion_id` no nulo y conserva el rechazo por cédula distinta.
- [ ] `CambiarPagar`, `prePago`, `postPago`, `CancelarPago` e `IntencionesPagos` no modifican intenciones NI.
- [ ] `Reportes::Recibo()` rechaza intenciones NI y no genera PDF.
- [ ] `retirarDetalle()` rechaza detalles de intenciones NI, de otro estudiante o inexistentes, y sigue permitiendo retirar detalles propios regulares.
- [ ] `cancelarIntencion($id)` sin `$niId` rechaza intenciones NI; con `$niId` coincidente sigue funcionando.
- [ ] `cierraPagosVencidos()` sin parámetro no toca intenciones NI; con `$niInscripcionId` cierra solo las de esa postulación.
- [ ] `NuevoIngresoPagoService::crearIntencion()` pasa su `$niInscripcionId` al cierre de vencidos y conserva su comportamiento.
- [ ] El flujo NI conserva creación, consulta, cobro y cancelación de sus propias intenciones.
- [ ] El flujo regular conserva creación, edición, pago, cancelación y recibo de intenciones con `ni_inscripcion_id` nulo.
- [ ] `vendor\bin\phpunit.bat tests\app\Models\PagosOnline\IntencionesPagoModelNiTest.php --no-coverage` pasa con los nuevos casos.
- [ ] `vendor\bin\phpunit.bat tests\app\Libraries\Payments --no-coverage` y `vendor\bin\phpunit.bat tests\app\Libraries\Inscripciones\NuevoIngreso\Pago --no-coverage` siguen en verde.
- [ ] Se documentó la auditoría de intenciones NI con `ni_inscripcion_id` nulo.
- [ ] No se modificaron rutas, filtros, pasarelas, montos, esquema ni datos de producción.

## Notas del programador

- Este plan no implementa la corrección; solo define alcance, causa probable y verificación.
- El defecto es la contraparte de FEAT-003: el dominio de pago NI se implementó con `ni_inscripcion_id`, pero los flujos regulares no se adaptaron. Ver `docs/features/003-dominio-pago-nuevo-ingreso/plan.md`.
- `MEMORY.md` no existe en este checkout, aunque `AGENTS.md` lo referencia; no se actualiza en este plan.
- El Paso 4 de nuevo ingreso sigue siendo placeholder, por lo que la reproducción con UI NI completa no está disponible. La verificación se apoya en datos sembrados, pruebas del servicio y revisión de código.
- `graphify-out/graph.json` está disponible y se consultó para ubicar `NuevoIngresoPagoService`, `IntencionesPagoModel` y `Pagos`. No se ejecuta `graphify update .` porque este entregable solo agrega documentación, no código.
- El cierre de vencidos se incorporó al alcance por indicación del usuario tras detectarse que el portal regular podía cancelar intenciones NI ajenas. No forma parte de los cuatro puntos originales del reporte, pero pertenece al mismo defecto de aislamiento y a la verificación de cancelación solicitada.
- La consulta `SELECT ... WHERE identificacion = 'V00000000'` usa un valor de ejemplo; reemplazarlo por la cédula de prueba de desarrollo y no incluir datos personales en el plan ni en los logs.
- Si durante la implementación se detecta que algún consumidor regular necesita ver intenciones NI, no se debe relajar el filtro global: crear una consulta específica y justificarlo en un plan aparte.
