# Detalle administrativo de una postulación con sus recaudos digitales

- **Código:** FEAT-017
- **Tipo:** feature
- **Estado:** en curso
- **Fecha:** 2026-10-30
- **Autor:** opencode (agente)

## Objetivo

Que un administrador autorizado con el módulo `inscripciones_ni` abra, desde el listado de postulaciones de nuevo ingreso, el detalle de una postulación y consulte el resumen del prospecto y la tabla de sus recaudos digitales. Las acciones de consulta y descarga deben aparecer únicamente cuando el recaudo tenga un archivo disponible.

## Alcance

- **Incluye:**
  - Registrar `GET admin/panel/inscripciones-nuevo-ingreso/(:num)` dentro del grupo `admin/panel`, con el filtro `adminPanel:module=inscripciones_ni`.
  - Agregar el método de detalle al controlador existente `App\Controllers\Admin\InscripcionesNuevoIngreso`, delegando la consulta en `PostulacionesAdminService::obtenerDetalle()`.
  - Redirigir al listado con el flash `admin_error` cuando la postulación no exista o el `id` sea `0`.
  - Crear la vista `app/Views/admin/nuevo_ingreso/detalle.php` con el header administrativo, un botón “Volver al listado”, el resumen del prospecto y la tabla de recaudos.
  - Mostrar la identificación completa (`identificacion_completa`), nombre completo, correo, teléfono, carrera, sede, paso actual con etiqueta y descripción, y estado de pago como badge.
  - Mostrar “No registrado” cuando el correo o el teléfono estén vacíos; conservar “No disponible” y “Pendiente” cuando el servicio los devuelva como respaldo.
  - Listar los recaudos activos devueltos por el servicio, en su orden, con las columnas “Recaudo”, “Estado” y “Acciones”.
  - Mostrar el estado “Disponible” cuando `disponible === true` y “No adjuntado” cuando sea `false`.
  - Mostrar los botones “Ver” y “Descargar” solo en las filas con `disponible === true`, con enlaces a las rutas previstas en los Slices 8 y 9, `target="_blank"` y `rel="noopener noreferrer"`.
  - Agregar una columna “Acciones” con el enlace “Ver” en cada fila del listado de FEAT-015, para que el detalle sea alcanzable desde la interfaz.
  - Agregar pruebas de vista del detalle y del enlace del listado, y ejecutar como regresión las pruebas del servicio y del filtro `AdminPanel`.

- **No incluye:**
  - Implementar los endpoints de visualización en línea o descarga de archivos. Corresponden a los Slices 8 y 9, y con este cambio los enlaces quedarán temporalmente sin endpoint hasta que se implementen.
  - Leer archivos del disco, verificar existencia física, calcular MIME real, resolver rutas o servir contenido. La disponibilidad se toma exclusivamente de `disponible` en el contrato de FEAT-016.
  - Modificar `PostulacionesAdminService::obtenerDetalle()`, `NiInscripcionRecaudoModel` o el contrato de datos de detalle.
  - Aprobar, rechazar, marcar recibidos o modificar postulaciones, pagos o recaudos. El cambio es estrictamente de solo lectura.
  - Agregar observaciones, montos, fechas de pago, `archivo_path`, `archivo_hash` ni rutas del sistema de archivos a la vista o a la respuesta.
  - Agregar filtros, búsqueda o paginación dentro de la tabla de recaudos.
  - Cambiar el enmascarado de la identificación en el listado. El listado sigue usando `mask_identificacion()`; solo el detalle muestra la identificación completa.
  - Cambiar los filtros, el tamaño de página, el orden o la paginación del listado de FEAT-015.
  - Modificar el menú, el helper `admin_access`, el login, el filtro `AdminPanel`, el panel Zelle, la SPA, la API JWT o el flujo de estudiantes.
  - Crear migraciones, seeds, tablas o datos de prueba persistentes.

> **Evaluación de alcance:** el cambio cubre una sola capacidad de negocio: “consultar el detalle de una postulación desde el panel administrativo”. La ruta, el controlador, la vista y el enlace desde el listado forman una unidad necesaria para que la pantalla sea alcanzable. Las acciones “Ver” y “Descargar” solo construyen enlaces a endpoints que pertenecen a otros slices; no se implementan aquí. No se detectó necesidad de dividir este cambio.

## Contexto y supuestos

- El cambio corresponde al **Slice 7** de `docs/slices/panel-administrativo-inscripciones-nuevo-ingreso/plan.md`.
- `App\Libraries\Inscripciones\NuevoIngreso\Admin\PostulacionesAdminService::obtenerDetalle(int $id): ?array` ya existe (FEAT-016) y devuelve los datos del prospecto y la lista de recaudos activos con la bandera booleana `disponible`.
- El contrato de `obtenerDetalle()` incluye `identificacion_completa`, `nombre_completo`, `correo`, `telefono`, `carrera_nombre`, `sucursal_nombre`, `paso_actual_etiqueta`, `paso_actual_descripcion`, `estado_pago_nombre`, `recaudos_total`, `recaudos_disponibles` y `recaudos`.
- Cada elemento de `recaudos` incluye `id` (fila de `ni_inscripciones_recaudos`), `recaudo_id`, `nombre`, `es_requerido`, `estado` y `disponible`.
- El servicio no expone `archivo_path` ni rutas físicas; la vista no debe intentar reconstruirlas ni verificar archivos.
- `identificacion_completa` ya incluye el prefijo `V-` o `E-`; el detalle no vuelve a construirlo ni lo enmascara.
- Las rutas previstas para las acciones son las definidas en el plan de slices:
  - Ver: `GET admin/panel/inscripciones-nuevo-ingreso/{id}/recaudo/{recaudoId}` (Slice 8).
  - Descargar: la misma ruta con `?descargar=1` (Slice 9).
- Hasta que se implementen los Slices 8 y 9, esos enlaces responderán 404. Es una condición conocida y temporal; la vista de detalle no debe fallar por ello.
- El listado de FEAT-015 no tiene actualmente enlace al detalle. Este cambio agrega la columna “Acciones” y el enlace “Ver” sin alterar los filtros ni la paginación.
- El header administrativo ya acepta `usuario`, `modulos_admin`, `url_inicio` y `menu_activo`. El detalle reutilizará esos datos y marcará `menu_activo = 'inscripciones_ni'`.
- El controlador reutilizará `admin_modulos_perfil()` y `admin_url_inicio()` con la conexión principal, igual que el listado, para mantener la navegación del header.
- El flash `admin_error` ya se muestra en el header y en el listado; se reutiliza para informar que la postulación no existe.
- El esquema documental del proyecto es `FEAT-NNN`. El siguiente número libre es `FEAT-017`, verificado contra `docs/features/`. El directorio usa el patrón `017-<slug-en-kebab-case>`.
- La rama actual es `feature/panel-administrativo-documentos-ni`.
- La suite completa tiene un fallo preexistente ajeno a este cambio; se ejecutan las pruebas del área afectada.
- No se requieren dependencias nuevas ni cambios de esquema.

## Flujo normal

1. Paso 1: Un administrador autorizado con el módulo `inscripciones_ni` abre el listado `admin/panel/inscripciones-nuevo-ingreso`.
2. Paso 2: La vista del listado muestra la columna “Acciones” con el enlace “Ver” de cada postulación.
3. Paso 3: El administrador pulsa “Ver”; el navegador solicita `GET admin/panel/inscripciones-nuevo-ingreso/{id}`.
4. Paso 4: El filtro `adminPanel:module=inscripciones_ni` valida la sesión `admin_user`, el usuario activo, el módulo y la asignación del perfil.
5. Paso 5: `InscripcionesNuevoIngreso::detalle($id)` recibe el identificador y lo normaliza a entero mayor o igual a `0`.
6. Paso 6: Si el `id` es `0`, el controlador redirige al listado con el flash `admin_error` y no consulta el servicio.
7. Paso 7: Si el `id` es positivo, el controlador llama a `PostulacionesAdminService::obtenerDetalle((int) $id)`.
8. Paso 8: Si el servicio devuelve `null`, el controlador redirige al listado con el flash `admin_error` “Postulación no encontrada.”.
9. Paso 9: Si el servicio devuelve el detalle, el controlador reúne los datos del header, el detalle y un mensaje de error vacío.
10. Paso 10: La vista `admin/nuevo_ingreso/detalle` renderiza el header, el botón “Volver al listado” y el título.
11. Paso 11: La vista muestra el resumen: identificación completa, nombre completo, correo o “No registrado”, teléfono o “No registrado”, carrera, sede, etiqueta y descripción del paso, y badge del estado de pago.
12. Paso 12: La vista renderiza la tabla de recaudos con el nombre, el estado “Disponible” o “No adjuntado” y la celda de acciones.
13. Paso 13: Para cada recaudo con `disponible === true`, la vista genera los botones “Ver” y “Descargar” con los identificadores de la postulación y del recaudo, en pestaña nueva.
14. Paso 14: Para cada recaudo con `disponible === false`, la vista no genera botones y muestra un guion en la celda de acciones.
15. Paso 15: El administrador puede volver al listado con el botón correspondiente o con el menú del header. La operación no ejecuta escrituras ni lecturas de archivos.

## Flujos alternativos / variantes

### Postulación sin recaudos

1. Paso 1: El administrador abre el detalle de una postulación sin filas activas de recaudos.
2. Paso 2: El servicio devuelve `recaudos = []`, `recaudos_total = 0` y `recaudos_disponibles = 0`.
3. Paso 3: La vista muestra el resumen del prospecto y, en lugar de la tabla, el estado vacío “Sin recaudos registrados”.
4. Paso 4: No se generan botones de acción.

### Recaudos disponibles y ausentes en la misma postulación

1. Paso 1: La postulación tiene dos recaudos con archivo disponible y uno sin archivo.
2. Paso 2: El servicio devuelve los tres recaudos activos en el orden del catálogo, con `disponible = true` en dos y `false` en uno.
3. Paso 3: La vista muestra “Disponible” en los dos primeros y “No adjuntado” en el tercero.
4. Paso 4: Solo los dos primeros recaudos tienen botones “Ver” y “Descargar”; el tercero muestra únicamente el guion en la celda de acciones.

### Postulación sin intención de pago

1. Paso 1: La postulación está en un paso anterior al pago y no tiene intención registrada.
2. Paso 2: El servicio devuelve `estado_pago_id = null` y `estado_pago_nombre = 'Pendiente'`.
3. Paso 3: La vista muestra el badge “Pendiente”.
4. Paso 4: El resto del resumen y la tabla se renderizan normalmente.

### Datos de contacto vacíos

1. Paso 1: La postulación no tiene correo o teléfono registrado.
2. Paso 2: El servicio devuelve cadena vacía en el campo correspondiente.
3. Paso 3: La vista muestra “No registrado” en lugar de un valor vacío.
4. Paso 4: Los demás campos se muestran sin cambios.

### Paso actual desconocido o nulo

1. Paso 1: `ni_inscripciones.paso_actual` tiene un valor fuera de rango o `NULL`.
2. Paso 2: El resolvedor del servicio devuelve la etiqueta y la descripción de respaldo.
3. Paso 3: La vista muestra esos textos sin lanzar una excepción.
4. Paso 4: No se expone el valor crudo del paso.

### Oferta académica no encontrada

1. Paso 1: La postulación referencia una oferta que no existe.
2. Paso 2: El servicio devuelve “No disponible” en carrera y sede.
3. Paso 3: La vista muestra esos valores de respaldo.
4. Paso 4: La postulación sigue siendo visible; no se trata como inexistente.

### Postulación con muchos recaudos

1. Paso 1: La postulación tiene más recaudos que los que caben en una pantalla.
2. Paso 2: El servicio devuelve la lista completa ordenada.
3. Paso 3: La vista muestra todos los recaudos en una sola tabla sin paginación propia.
4. Paso 4: La tabla permite desplazamiento horizontal en pantallas pequeñas, igual que el listado.

### Acciones hacia endpoints aún no implementados

1. Paso 1: El administrador pulsa “Ver” o “Descargar” antes de implementar los Slices 8 y 9.
2. Paso 2: El navegador solicita la ruta prevista, que todavía no existe.
3. Paso 3: CodeIgniter responde 404 en la pestaña nueva.
4. Paso 4: La pantalla de detalle original permanece intacta; la acción queda temporalmente no funcional y se habilita al implementar el slice correspondiente.

### Listado sin postulaciones

1. Paso 1: Los filtros del listado no devuelven resultados.
2. Paso 2: La vista muestra el estado vacío existente.
3. Paso 3: La columna “Acciones” existe, pero no hay filas con enlace “Ver”.
4. Paso 4: No se modifica el comportamiento actual de filtros ni paginación.

## Flujos de control de errores

| Error / condición | Detección | Respuesta del sistema | Estado final |
| --- | --- | --- | --- |
| Petición sin sesión administrativa | `admin_user` ausente o inválido en `AdminPanel` | Redirige a `admin/panel/login` con `admin_error` | Acceso denegado; sin consulta |
| Usuario eliminado o inactivo | Consulta de `AdminPanel` sin resultado o con `borrado_dt` | Redirige al login y limpia `admin_user` | Acceso denegado |
| Módulo `inscripciones_ni` inexistente o borrado | Consulta de `AdminPanel` sin resultado | Redirige al login con `admin_error` | Acceso denegado |
| Perfil sin asignación activa del módulo | Consulta de `AdminPanel` sin asignación activa | Redirige al login y limpia `admin_user` | Acceso denegado |
| Permiso revocado durante la sesión | La siguiente petición es evaluada por `AdminPanel` | Deniega el acceso y limpia la sesión | El usuario debe volver a autenticarse |
| `id` igual a `0` | Validación del controlador | Redirige al listado con `admin_error` “Postulación no encontrada.” | Sin detalle |
| `id` no numérico en la URL | La ruta `(:num)` no coincide | CodeIgniter responde 404 antes del controlador | Recurso no encontrado |
| Postulación inexistente | `obtenerDetalle()` devuelve `null` | Redirige al listado con `admin_error` | Sin detalle |
| Fallo de base de datos al consultar el detalle | `DatabaseException` capturada en el controlador | Registra el `id` en el log, renderiza la vista con mensaje genérico y responde 500 | Sin datos; error visible |
| Endpoint de recaudo aún no implementado | El navegador solicita la ruta de los Slices 8 o 9 | 404 en pestaña nueva; la vista de detalle no falla | Acción temporalmente no funcional |
| Recaudo sin archivo | `disponible === false` | Muestra “No adjuntado” y no genera botones | Fila informativa |
| Postulación sin recaudos | `recaudos = []` | Muestra “Sin recaudos registrados” | Detalle válido |
| Correo o teléfono vacío | Cadena vacía en el contrato del servicio | Muestra “No registrado” | Dato informativo |
| Paso actual desconocido o nulo | Resolvedor sin coincidencia | Usa etiqueta y descripción de respaldo | Detalle válido |
| Sin intención de pago | `estado_pago_nombre = 'Pendiente'` | Muestra el badge “Pendiente” | Detalle válido |
| Oferta o carrera inexistente | El servicio devuelve “No disponible” | Muestra el valor de respaldo | Detalle válido |
| Datos con HTML o caracteres especiales | Renderizado con `esc()` | Se muestran como texto escapado | Sin ejecución de HTML ni scripts |
| Error al cargar los módulos del header | Consulta de `admin_modulos_perfil()` lanza excepción | Se registra en el log; el detalle conserva su contenido y el header usa valores por defecto seguros | Vista operativa con menú reducido |

## Reglas de negocio y validaciones

1. **Solo lectura:** el controlador, la vista y sus pruebas no ejecutan `INSERT`, `UPDATE`, `DELETE` ni DDL. Tampoco ejecutan `file_exists`, `is_file`, `readfile` ni `file_get_contents`.
2. **Autorización:** la ruta debe declararse dentro del grupo `admin/panel` con el filtro `adminPanel:module=inscripciones_ni`. No se permite una ruta de detalle sin filtro.
3. **Identidad desde la sesión:** el usuario, el perfil y los módulos del header salen de `admin_user` y de `admin_modulos_perfil()`. El único dato de la petición que se usa es el `id` de la postulación.
4. **Delegación:** el controlador no contiene SQL de postulaciones ni de recaudos; usa exclusivamente `PostulacionesAdminService::obtenerDetalle()`.
5. **Contrato de inexistencia:** un `id` menor o igual a `0`, o un `null` del servicio, se traduce en una redirección al listado con `admin_error`. No se renderiza una vista de detalle vacía.
6. **Identificación completa solo en el detalle:** se muestra `identificacion_completa` sin enmascarar. El listado continúa usando `mask_identificacion()`.
7. **Campos del resumen:** se muestran `identificacion_completa`, `nombre_completo`, `correo`, `telefono`, `carrera_nombre`, `sucursal_nombre`, `paso_actual_etiqueta`, `paso_actual_descripcion` y `estado_pago_nombre`. No se muestran valores crudos de paso ni `estado_pago_id`.
8. **Valores de respaldo:** correo o teléfono vacíos se muestran como “No registrado”; carrera o sede ausentes conservan “No disponible”; sin pago se muestra “Pendiente”. No se inventan datos.
9. **Estado de recaudo:** “Disponible” si y solo si `disponible === true`; “No adjuntado” en cualquier otro caso. No se usa `estado` para decidir la etiqueta.
10. **Acciones condicionadas:** por cada recaudo disponible se generan exactamente dos enlaces, “Ver” y “Descargar”. Un recaudo no disponible no genera ningún enlace de acción.
11. **Construcción de URLs:** las URLs usan el `id` de la postulación y el `id` del recaudo, convertidos a entero. No se usa `archivo_path`, `archivo_hash` ni ningún dato del cliente.
12. **Rutas futuras:** “Ver” apunta a `admin/panel/inscripciones-nuevo-ingreso/{id}/recaudo/{recaudoId}`. “Descargar” agrega `?descargar=1`. Ambas se abren con `target="_blank"` y `rel="noopener noreferrer"`.
13. **Sin validación de archivos:** la vista no comprueba la existencia, el tipo ni el tamaño del archivo. Esa responsabilidad pertenece a los Slices 8 y 9.
14. **Salida escapada:** todo dato dinámico se imprime con `esc()`, incluidos nombres, correo, teléfono, carrera, sede, etiquetas y atributos de URL. No se interpola HTML de usuario.
15. **Listado navegable:** se agrega la columna “Acciones” con el enlace “Ver” en cada fila. Se actualiza el `colspan` del estado vacío a 10. No se alteran filtros, orden, paginación ni el enmascarado.
16. **Header:** el detalle reutiliza el header existente con `menu_activo = 'inscripciones_ni'`, la lista de módulos activos y la URL de inicio resuelta por el helper. No se modifica el header.
17. **Manejo de errores:** un `DatabaseException` se registra con `log_message('error', ...)` incluyendo el `id`, y la vista muestra un mensaje genérico. No se exponen trazas, SQL ni datos personales en el error.
18. **Compatibilidad:** no se modifica la firma ni el comportamiento de `PostulacionesAdminService`, `obtenerDetalle()`, `NiInscripcionRecaudoModel`, el listado, el login, el filtro `AdminPanel` ni el panel Zelle.
19. **Idioma y estilo:** comentarios, docblocks, textos de interfaz y mensajes nuevos en español, siguiendo las convenciones de `AGENTS.md` y las clases Tailwind existentes.
20. **Sin dependencias nuevas:** no se agregan librerías, paquetes ni helpers globales.

## Áreas afectadas

- `app/Config/Routes.php`: nueva ruta `GET admin/panel/inscripciones-nuevo-ingreso/(:num)` con `adminPanel:module=inscripciones_ni`, después de la ruta del listado.
- `app/Controllers/Admin/InscripcionesNuevoIngreso.php`: nuevo método público `detalle(int $id)`, manejo de `null`, `DatabaseException`, datos del header y renderizado de la vista. Sin SQL propio.
- `app/Views/admin/nuevo_ingreso/detalle.php`: nueva vista con header, botón de regreso, resumen del prospecto, badge de pago, tabla de recaudos, estado vacío y acciones condicionadas.
- `app/Views/admin/nuevo_ingreso/index.php`: columna “Acciones”, enlace “Ver” por fila y ajuste del `colspan` del estado vacío.
- `tests/app/Views/Admin/DetallePostulacionViewTest.php`: nuevo. Cubre datos completos, identificación completa, respaldos, paso y pago, estados de recaudos, acciones condicionadas, URLs futuras, salida escapada y estado vacío.
- `tests/app/Views/Admin/ListadoNuevoIngresoViewTest.php`: nuevo. Cubre la columna “Acciones”, el enlace “Ver” y el `colspan` del estado vacío.
- `tests/app/Libraries/Inscripciones/NuevoIngreso/Admin/PostulacionesAdminServiceTest.php`: ejecutar como regresión; no se requieren cambios si el contrato de FEAT-016 se mantiene.
- `tests/app/Filters/AdminPanelTest.php`: ejecutar como regresión del control de acceso.
- `docs/features/017-detalle-administrativo-postulacion-recaudos/plan.md`: este documento.
- `MEMORY.md`: solo si al cerrar el cambio se altera el estado o una decisión documentada del proyecto.

No se modifican `PostulacionesAdminService.php`, `NiInscripcionRecaudoModel.php`, `Panel.php`, `PanelAuth.php`, el header, el helper `admin_access`, migraciones, seeds, la SPA, la API JWT, `vendor/`, `public/vendor/`, `system/` ni `app/ThirdParty/`.

## Criterios de finalización

- [ ] La ruta `GET admin/panel/inscripciones-nuevo-ingreso/(:num)` existe dentro del grupo `admin/panel` y usa el filtro `adminPanel:module=inscripciones_ni`.
- [ ] El método `InscripcionesNuevoIngreso::detalle(int $id)` existe, es público y delega la consulta en `PostulacionesAdminService::obtenerDetalle()`.
- [ ] El controlador no contiene SQL propio para postulaciones ni recaudos.
- [ ] Un `id` igual a `0` redirige al listado con el flash `admin_error` y no consulta el servicio.
- [ ] Una postulación inexistente redirige al listado con el flash `admin_error` “Postulación no encontrada.”.
- [ ] La ruta sin sesión redirige a `admin/panel/login` con `admin_error`, sin ejecutar la consulta.
- [ ] La ruta con un perfil sin `inscripciones_ni` redirige al login y no muestra datos.
- [ ] La ruta con el módulo activo responde 200 y muestra el detalle.
- [ ] La vista `app/Views/admin/nuevo_ingreso/detalle.php` existe y renderiza el header administrativo con `menu_activo = 'inscripciones_ni'`.
- [ ] La vista incluye un botón “Volver al listado” que apunta a `admin/panel/inscripciones-nuevo-ingreso`.
- [ ] La identificación se muestra completa, con prefijo `V-` o `E-`, sin enmascarar.
- [ ] Se muestran nombre completo, correo, teléfono, carrera, sede, etiqueta y descripción del paso, y estado de pago.
- [ ] Correo o teléfono vacíos se muestran como “No registrado”.
- [ ] El estado de pago se muestra como badge con el nombre del contrato del servicio.
- [ ] La tabla de recaudos muestra las columnas “Recaudo”, “Estado” y “Acciones”.
- [ ] Un recaudo con `disponible === true` muestra “Disponible” y exactamente dos enlaces: “Ver” y “Descargar”.
- [ ] Un recaudo con `disponible === false` muestra “No adjuntado” y ningún enlace de acción.
- [ ] El enlace “Ver” apunta a `admin/panel/inscripciones-nuevo-ingreso/{id}/recaudo/{recaudoId}`.
- [ ] El enlace “Descargar” apunta a la misma ruta con `?descargar=1`.
- [ ] Ambos enlaces usan `target="_blank"` y `rel="noopener noreferrer"`.
- [ ] Las URLs de las acciones usan únicamente los identificadores enteros; no contienen `archivo_path`, `archivo_hash` ni rutas del disco.
- [ ] Una postulación sin recaudos muestra “Sin recaudos registrados” y no genera acciones.
- [ ] La vista no ejecuta lecturas de archivos ni comprobaciones de MIME.
- [ ] Todos los datos dinámicos de la vista se escapan con `esc()`; una prueba verifica que un nombre con etiquetas HTML se renderiza escapado.
- [ ] El listado `index.php` incluye la columna “Acciones” con el enlace “Ver” por fila.
- [ ] El estado vacío del listado usa `colspan="10"`.
- [ ] El listado conserva la identificación enmascarada, los filtros, el orden y la paginación existentes.
- [ ] Un `DatabaseException` se registra en el log con el `id` y la vista muestra un mensaje genérico con código 500, sin trazas ni SQL.
- [ ] No se realizan escrituras en base de datos durante el detalle.
- [ ] Las pruebas nuevas de detalle y listado pasan.
- [ ] Las pruebas de `PostulacionesAdminServiceTest` y `AdminPanelTest` pasan como regresión.
- [ ] Se ejecuta `php -l` sobre el controlador y las vistas modificadas sin errores de sintaxis.
- [ ] Se completa el smoke test manual: enlace “Ver” desde el listado, detalle autorizado, caso no encontrado, recaudo disponible, recaudo ausente, botones condicionados, volver al listado y cierre de sesión.
- [ ] No se modificaron archivos de dependencias, la SPA, la API JWT, el panel Zelle ni el flujo de estudiantes.
- [ ] Se ejecuta `graphify update .` después de los cambios de código.

## Riesgos

- **Medio:** el detalle expone la identificación completa y datos personales. La única protección es el filtro `adminPanel:module=inscripciones_ni`; la ruta no debe declararse fuera del grupo ni sin filtro. El listado mantiene el enmascarado.
- **Medio:** los botones “Ver” y “Descargar” apuntarán a endpoints que aún no existen y responderán 404 hasta implementar los Slices 8 y 9. Es una decisión funcional registrada; no se debe presentar la descarga como operativa hasta cerrar esos slices.
- **Bajo:** el enlace “Ver” en el listado modifica una vista ya implementada. Se mitiga con una prueba de vista y con la verificación del `colspan` y del enmascarado.
- **Bajo:** la construcción de URLs puede duplicarse entre “Ver” y “Descargar”. Se mantiene explícita en la vista para no introducir un helper prematuro; si los Slices 8 y 9 cambian el patrón, se ajusta en un solo bloque.
- **Bajo:** si la vista no maneja las claves ausentes ante un error de base de datos, podría emitir avisos. Se debe inicializar el detalle como arreglo vacío y proteger cada sección.
- **Bajo:** la suite completa tiene un fallo preexistente; se ejecutan las pruebas del área y un smoke test manual.

## Bitácora

| Fecha | Cambio | Autor |
| --- | --- | --- |
| 2026-10-30 | Especificación inicial del detalle administrativo de una postulación con recaudos digitales, enlace desde el listado y acciones condicionadas a la disponibilidad. Se documenta que los endpoints de ver y descargar pertenecen a los Slices 8 y 9 y quedan fuera de este cambio. | opencode (agente) |
