# Prototipo de ejecución — FEAT-001 Esquema y configuración del pago de nuevo ingreso

- **Rama:** p-feature/esquema-configuracion-pago-nuevo-ingreso
- **Rama base:** feature/desacoplar-contructor-pagos
- **Plan:** docs/features/001-esquema-configuracion-pago-nuevo-ingreso/plan.md
- **Fecha:** 2026-10-27
- **Estado:** consolidado
- **Consolidado:** 2026-10-27 en `feature/desacoplar-contructor-pagos` (merge `--no-ff`)

## Resumen

Se preparó el sustrato de base de datos y configuración para el futuro Paso 4 de pago de nuevo ingreso: columna `ni_inscripcion_id` e índice en `pg_intenciones_pago`, ampliación de `identificacion` a `VARCHAR(20)`, tipo de pago `_ni`, configuración local `ni_plan_pago_id` vacía por sede y dos planes demo con sus detalles. No se agregaron UI, rutas, controladores ni procesamiento de pagos.

## Tareas realizadas

- [x] Migración `099` con columna `ni_inscripcion_id INT(11) NULL`, índice `idx_pg_intenciones_pago_ni_inscripcion_id`, sin foreign key ni backfill. Evidencia: `MigracionesNiPagoTest`.
- [x] `down()` de `099` idempotente, ejecutable dos veces. Evidencia: `testDownDeLaMigracion099SePuedeEjecutarDosVeces`.
- [x] Migración `100` con ampliación de `identificacion` a `VARCHAR(20) NOT NULL` y `down()` no-op. Evidencia: implementación y pruebas de idempotencia/preservación de datos.
- [x] Registro de `099` y `100` en `InitPrincipalDb` después de la `098`.
- [x] `PgTiposPagosSeeder` siembra `id = 3`, `codigo = '_ni'`, `descripcion = 'Nuevo Ingreso'` sin alterar las filas 1 y 2. Evidencia: `PgTiposPagosSeederTest`.
- [x] `GbConfigSucursalSeeder` inserta `ni_plan_pago_id = ''` solo si falta. Evidencia: `GbConfigSucursalSeederTest` (7 pruebas).
- [x] Constantes y seeders demo de `PLAN NI CONTADO` (900002, detalle 900021) y `PLAN NI CUOTAS` (900003, detalles 900031-900035). Evidencia: `SucursalPagosSeederTest`.
- [x] `demo:seed` deja `ni_plan_pago_id = '900002,900003'` por sede demo; `init:sucursal` lo deja vacío por el seeder insert-only.
- [x] Pruebas del área ejecutadas; segunda ejecución no duplica planes, detalles ni claves.
- [ ] Smoke test en una base de desarrollo o pruebas autorizada con `init:principal`, `init:sucursal` y `demo:seed` — Motivo: no hay entorno autorizado disponible y no se debe tocar una base real sin respaldo.
- [x] `MEMORY.md` actualizado con el esquema, la configuración y el pendiente del smoke test.

## Criterios de aceptación

| Criterio | Cómo se verificó | Resultado |
| --- | --- | --- |
| Migración `099` idempotente con columna e índice, sin FK ni backfill | `MigracionesNiPagoTest` sobre SQLite: creación, segunda ejecución y ausencia de FK | ok |
| `down()` de `099` elimina índice y columna y se ejecuta dos veces | `testDownDeLaMigracion099SePuedeEjecutarDosVeces` | ok |
| Migración `100` idempotente, `VARCHAR(20) NOT NULL`, `down()` no-op | Pruebas de idempotencia, preservación de datos y `down()`; longitud no medible en SQLite | parcial |
| `InitPrincipalDb` incluye ambas migraciones después de `098` y se reejecuta sin duplicar | Revisión de código y pruebas de idempotencia de las migraciones; `init:principal` real no ejecutado | parcial |
| `PgTiposPagosSeeder` deja `_ni` y conserva filas 1 y 2 | `PgTiposPagosSeederTest` (5 pruebas) | ok |
| `GbConfigSucursalSeeder` inserta `ni_plan_pago_id` vacío sin sobrescribir | `GbConfigSucursalSeederTest` (7 pruebas) | ok |
| Los dos planes demo y sus detalles tienen montos, porcentajes y fechas | `SucursalPagosSeederTest` | ok |
| `demo:seed` deja `900002,900003`; `init:sucursal` deja vacío | Pruebas del seeder y del seeder de configuración | ok |
| Segunda ejecución de `demo:seed` no duplica datos | `testSeederEsIdempotente` | ok |
| Las pruebas del área pasan | Ejecución individual de los cuatro archivos y del directorio `tests/app/Database` | ok |
| Smoke test en base autorizada documentado | No ejecutado por falta de entorno autorizado | pendiente |
| No se modificaron UI, rutas, controladores, servicios ni la migración `098` | Revisión de `git status` y del alcance | ok |
| `MEMORY.md` refleja el estado | Revisión del documento | ok |

## Flujos cubiertos

- **Flujo normal:** migraciones `099`/`100`, registro en `InitPrincipalDb`, seed de `_ni`, seed insert-only de `ni_plan_pago_id`, planes demo y configuración demo por sede.
- **Flujos alternativos:** tabla `pg_intenciones_pago` inexistente, columna o índice ya existentes, índice con el nombre esperado sobre otra columna, `identificacion` ausente, `id = 3` ocupado por otro código, `_ni` ya existente con otro id, `gb_config` ausente, tablas de planes ausentes en la sede.
- **Control de errores:** se omite el cambio con advertencia cuando falta una tabla o columna; no se sobrescriben filas existentes; si faltan las tablas de planes se omite la sede demo sin interrumpir el resto; `demo:seed` conserva la validación existente de producción con `--force`.

## Archivos creados

| Archivo | Motivo |
| --- | --- |
| `app/Database/Migrations/2026-10-27-000099_AddNiInscripcionIdToPgIntencionesPago.php` | Columna e índice de vínculo con `ni_inscripciones` |
| `app/Database/Migrations/2026-10-27-000100_AlterIdentificacionPgIntencionesPago.php` | Ampliar `identificacion` a `VARCHAR(20)` |
| `tests/app/Database/Migrations/MigracionesNiPagoTest.php` | Cobertura de idempotencia y estructura de ambas migraciones |
| `tests/app/Database/Seeds/PgTiposPagosSeederTest.php` | Cobertura del tipo `_ni` y conservación de filas existentes |
| `tests/app/Database/Seeds/SucursalPagosSeederTest.php` | Cobertura de planes demo, detalles y configuración por sede |
| `docs/features/001-esquema-configuracion-pago-nuevo-ingreso/prototipo.md` | Registro de ejecución |

## Archivos modificados

| Archivo | Cambio realizado |
| --- | --- |
| `app/Commands/InitPrincipalDb.php` | Registro de las migraciones `099` y `100` después de la `098` |
| `app/Database/Seeds/PgTiposPagosSeeder.php` | Inserción idempotente de `_ni`; paso a insert-only para no alterar filas existentes |
| `app/Database/Seeds/GbConfigSucursalSeeder.php` | Guardia para `gb_config` ausente e inserción insert-only de `ni_plan_pago_id` |
| `app/Database/Seeds/Demo/DemoData.php` | Constantes de los dos planes demo, sus detalles y el valor de configuración |
| `app/Database/Seeds/Demo/SucursalPagosSeeder.php` | Planes demo, detalles, configuración local demo y guardia de tablas de planes |
| `tests/app/Database/Seeds/GbConfigSucursalSeederTest.php` | Pruebas de `ni_plan_pago_id` y total idempotente de 12 claves |
| `MEMORY.md` | Estado del esquema, configuración y pendientes de FEAT-001 |

## Rutas, permisos y datos

- **Rutas/endpoints nuevos o modificados:** no aplica.
- **Permisos y validaciones:** no se agregaron rutas ni accesos. La configuración sensible de planes queda local por sede y no se expone.
- **Migraciones/seeds:** `099` y `100` registradas en `InitPrincipalDb`; idempotencia probada sobre SQLite. `PgTiposPagosSeeder` y `GbConfigSucursalSeeder` son insert-only para filas existentes. `SucursalPagosSeeder` usa `upsert` para los planes demo y escribe la configuración demo.
- **Compatibilidad:** no se modificaron contratos HTTP, UI ni servicios. `identificacion` conserva `NOT NULL`; en SQLite no se aplica longitud declarada, por lo que la ampliación queda verificable solo en MySQLi. Los planes demo usan el rango `900000+` y no alteran el `PLAN PRUEBA` 900001.

## Comandos ejecutados

| Comando | Resultado |
| --- | --- |
| `vendor\bin\phpunit.bat tests/app/Database --no-coverage` (línea base) | OK, 24 tests, 44 assertions |
| `vendor\bin\phpunit.bat tests/app/Database --no-coverage` (final) | OK, 45 tests, 114 assertions |
| `vendor\bin\phpunit.bat tests/app/Database/Migrations/MigracionesNiPagoTest.php --no-coverage` | OK, 9 tests, 15 assertions |
| `vendor\bin\phpunit.bat tests/app/Database/Seeds/PgTiposPagosSeederTest.php --no-coverage` | OK, 5 tests, 11 assertions |
| `vendor\bin\phpunit.bat tests/app/Database/Seeds/GbConfigSucursalSeederTest.php --no-coverage` | OK, 7 tests, 11 assertions |
| `vendor\bin\phpunit.bat tests/app/Database/Seeds/SucursalPagosSeederTest.php --no-coverage` | OK, 5 tests, 40 assertions |
| `php -l` sobre los 11 archivos tocados | Sin errores de sintaxis |

## Verificación

- **Línea base (antes):** `tests/app/Database` en verde con 24 tests y 44 assertions.
- **Prueba manual (flujo normal):** no se ejecutó sobre MySQLi. El flujo equivalente se cubrió con migraciones y seeders reales sobre SQLite en memoria.
- **Flujos alternativos y errores:** cubiertos por pruebas de tabla/columna ausente, índice con nombre ocupado, `id = 3` ocupado, `_ni` con otro id, configuración existente y tablas de planes ausentes.
- **Pruebas automatizadas:** `MigracionesNiPagoTest`, `PgTiposPagosSeederTest`, `GbConfigSucursalSeederTest` y `SucursalPagosSeederTest`, todas en verde.
- **Criterios del plan:** cumplidos los de código, seeders, idempotencia, pruebas y documentación. Quedan pendientes el smoke test en base autorizada y la verificación directa de la longitud `VARCHAR(20)` en MySQLi.

## Desviaciones del plan

- `PgTiposPagosSeeder` pasó de actualizar filas existentes a ser insert-only para las filas 1 y 2, con el fin de cumplir el criterio de que permanezcan intactas. Las filas nuevas siguen insertándose y una segunda ejecución no duplica.
- `SucursalPagosSeeder` omite toda la siembra de una sede cuando faltan `ceplanpagoperio` o `ceplanpagoperiodet`, no solo los planes demo. Así se evita un fallo parcial y se cumple el control de errores del plan.
- `PgTiposPagosSeeder` usa `$this->db` en lugar de `Config\Database::connect()` para poder inyectar la conexión de pruebas; el comportamiento en CLI es equivalente.

## Riesgos y pendientes

- No se ejecutó DDL real sobre MySQLi; la ampliación de `identificacion` y las migraciones `099`/`100` deben validarse con el smoke test autorizado.
- Siguen abiertas las preguntas del plan: `NuCuotas` del plan contado, rango de IDs de detalle, texto exacto de la descripción, nulabilidad final de `identificacion`, formato definitivo de `ni_plan_pago_id`, ubicación del seeder demo y semántica de `TpDetPlan`.
- `MEMORY.md` está ignorado por git (`.gitignore`), por lo que su actualización queda solo en el árbol local y no aparecerá en el estado de Git.
- La rama es local y no se publicó; no se hicieron commits.

## Consolidación

- **Fecha:** 2026-10-27
- **Rama destino:** `feature/desacoplar-contructor-pagos`
- **Estrategia:** `git merge --no-ff`
- **Commits integrados:** 4 (`e8f8d40`, `24b0f33`, `8da3ce6`, `a7f097c`); el trabajo se confirmó antes de integrar, por lo que la nota de "no se hicieron commits" aplica solo al momento de la ejecución.
- **Verificación:** rama prototipo contenida en la destino, sin commits pendientes, sin diferencias de archivos y `tests/app/Database` en verde (45 tests, 114 assertions).
- **Rama prototipo:** eliminada con `git branch -d` tras confirmar que estaba contenida.
- **Pendiente:** smoke test en base autorizada y verificación de `VARCHAR(20)` en MySQLi; no bloquean la consolidación pero siguen abiertos.
