Saltar al contenido principal

Informe de cobertura — pruebas unitarias de ccf-almacen-web

Cerrar el mapa de pantallas era la condición para medir. Hoy las 77 páginas del dashboard tienen prueba directa (49) o la reciben a través de sus componentes (28), y la suite completa suma 221 archivos y 2 659 casos en verde. Este informe fija el número real de cobertura, dice dónde está la deuda y qué se corrigió al probar.

1. Resultado global​

Medición con npx jest --coverage --maxWorkers=2 sobre el árbol completo de ccf-almacen-web:

MétricaCubiertoTotalPorcentaje
Sentencias20 75427 47475,54 %
Ramas10 08716 20362,25 %
Funciones4 5086 33771,13 %
Líneas19 35824 96577,54 %

Y la suite que produce esos números:

BloqueArchivosCasos
Módulos (src/__tests__/*-gestion.test.tsx)441 031
Componentes (src/components/**/__tests__)1231 079
Base: configuración, utilidades, hooks, contratos34278
Total2212 659

No hay suites fallidas ni casos omitidos por error. El único ruido en la salida es el aviso esperado de una pantalla que cae a datos de ejemplo cuando el API no responde.

2. Mapa de la suite por módulo​

Los 44 archivos *-gestion.test.tsx son la capa de módulo: montan la pantalla real y mockean solo las fronteras (funciones de api/*, hooks de React Query, sonner, tour guiado y el armazón de autenticación).

MóduloCasosMóduloCasos
Ubicaciones40Órdenes de compra24
Almacenes36Análisis de consumo23
Tickets35Carga masiva23
Sesiones35Administración del menú23
Áreas33Firmas22
Inventario32Presupuestos21
Transferencias32Gestión de IPs21
Plantillas de solicitud31Ideas y novedades21
Lotes y series30Personalización20
Conteos30Clasificación ABC20
Solicitudes29Alertas de stock19
Alertas inteligentes29KPIs de gestión19
Recepciones28Proveedores19
Demanda predictiva27Trabajos19
Devoluciones25Auditoría de accesos16
Obsolescencia25Seguridad 2FA15
Reorden24Rate limit13
Intercambio EDI/XML/JSON24Jobs (complemento)12
Webhooks24Políticas de contraseña12
Ventas del POS28Cajas y turnos24
Reportes del POS22Movimientos del POS19
Pantallas de error6Acerca de1

Según el módulo, cada suite recorre el CRUD completo, los filtros y la paginación, los estados de carga, vacío y error con reintento, las confirmaciones destructivas, la visibilidad por rol y —cuando existe— el tour guiado.

3. Cobertura por capa​

Suma ponderada por archivo (no promedio de porcentajes), para que un archivo diminuto no pese igual que uno grande:

CapaArchivosSentenciasRamasFuncionesLíneas
src/components18376,1 %60,5 %75,0 %77,7 %
src/pages4986,2 %73,0 %80,9 %87,8 %
src/config791,2 %83,7 %39,4 %92,3 %
src/utils2481,9 %73,2 %87,7 %83,6 %
src/registry (shadcn/ui)2984,8 %53,8 %53,8 %87,0 %
src/lib582,8 %76,3 %75,0 %87,4 %
src/models2674,0 %57,8 %56,8 %71,9 %
src/services1370,4 %50,0 %63,6 %73,5 %
src/hooks1365,4 %48,3 %54,8 %67,1 %
src/api2733,2 %28,8 %18,6 %36,2 %
scripts / deploy261,0 %30,3 %64,3 %61,0 %

Las páginas y los componentes están por encima del 75 % de líneas; las funciones quedan algo más bajas porque los manejadores de eventos cortos (onOpenChange, onValueChange) solo se ejecutan cuando la interacción exacta ocurre.

Por familia funcional (agrupando por nombre de archivo):

FamiliaArchivosSentenciasLíneas
Veterinaria (vete_* / veterinaria)2396,0 %97,0 %
Solicitudes, cargas, plantillas, aprobaciones, presupuestos1482,9 %84,9 %
Seguridad, sesiones, auditoría, contraseñas1679,0 %82,0 %
Inventario, productos, lotes, stock4577,3 %79,3 %
POS — componentes483,3 %90,5 %
Tablero672,8 %73,5 %
POS — pantallas582,8 %84,8 %
Sala de continuidad (offline)158,3 %62,9 %
Empresa249,5 %50,5 %

4. Dónde está la deuda​

4.1 Pantallas con menor cobertura de líneas​

PantallaSentenciasLíneasPor qué
empresa.tsx45,5 %46,8 %Subida de logos y datos institucionales
offline.tsx58,3 %62,9 %Bucle de reconexión con retroceso exponencial
tablero.tsx70,5 %70,6 %Widgets configurables y sus estados
login-form.tsx74,7 %74,3 %Errores de credenciales y bloqueo
inventory-movements.tsx75,9 %81,2 %Estadísticas y exportación CSV
pos.tsx79,7 %81,5 %Carrito, lote/serie y cobro
stock-alerts.tsx82,2 %82,1 %Ramas de orden y paginación
solicitudes/page.tsx86,4 %88,4 %Despacho y aprobación multinivel
firmas.tsx87,0 %89,0 %Evidencia firmada (TEC-014)

4.2 Componentes con menor cobertura​

ComponenteSentenciasLíneasRiesgo
requests/request-detail-standalone.tsx9,1 %10,0 %Detalle de solicitud fuera del armazón
almacenes/horario-panel.tsx17,0 %19,6 %Ventanas horarias por almacén
devoluciones/devolucion-desde-solicitud.tsx17,2 %18,6 %Alta de devolución desde una solicitud
requests/approval-timeline.tsx17,6 %18,8 %Cadena multinivel (SOL-002)
general-dashboard/profile.tsx19,7 %20,2 %Perfil del usuario
reports/warehouse-reports.tsx21,7 %23,2 %Reportes de almacén
firmas/signature-pad.tsx28,2 %28,2 %Evidencia legal (TEC-014)
upload/product-image-upload.tsx30,6 %32,6 %Imagen de producto
devoluciones/devoluciones-historial.tsx42,9 %47,4 %Historial de devoluciones
notification/panel-notificaciones.tsx56,0 %56,9 %Centro de notificaciones (UX-004)

4.3 Hooks​

HookSentencias
use-firmas8,1 %
use-enhanced-toast8,6 %
use-devoluciones13,6 %
use-retroalimentacion19,0 %
use-tickets72,5 %

5. Defectos reales corregidos al probar​

Probar encontró cuatro defectos que no eran de las pruebas:

  1. urlEvidencia() rompía fuera de development/production. El mapa de configuración no declara otros entornos, así que con cualquier NODE_ENV distinto la entrada era undefined y el detalle de un ticket con evidencias lanzaba Cannot read properties of undefined (reading 'apiDashboard'). Ahora cae a config.development. Archivo: src/components/tickets/ticket-catalogos.ts.
  2. altaLimite enviaba idUsuario: 0. En sesiones-panel.tsx, el límite por usuario se podía crear sin usuario seleccionado porque la validación solo miraba el número de sesiones. Ahora exige idUsuario > 0. Archivo: src/components/security/sesiones-panel.tsx.
  3. Las plantillas de solicitud guardaban espacios sobrantes. El payload viajaba con el nombre y el propósito sin recortar, lo que permitía duplicados visualmente idénticos. Se aplica trim antes de enviar. Archivo: src/pages/plantillas-solicitud.tsx.
  4. La grid avisaba del cambio de orden durante el render. DataGrid.cambiarOrden() llamaba a onCambioOrden dentro del actualizador de setOrden, es decir, actualizaba el estado del padre mientras el grid se renderizaba: React lo denuncia («Cannot update a component while rendering a different component») y en StrictMode la consulta se dispara dos veces. Ahora el orden se calcula con el estado vigente y se avisa después de setOrden. Archivo: src/components/common/data-grid.tsx.

6. Límites de esta medición​

  • src/api está mockeada por diseño (36,2 % de líneas). Esto no mide el contrato HTTP: que la API responda lo que el cliente espera es responsabilidad de las pruebas del backend y de una capa de contrato que hoy no existe.
  • src/registry (shadcn/ui) mide 87,0 % de líneas, pero sus funciones quedan en 53,8 %: son primitivas de Radix cuyos callbacks solo corren con la interacción exacta.
  • La cobertura es de líneas, no de comportamiento. Un 100 % no garantiza que una regla de negocio esté bien; por eso cada suite verifica el payload exacto que llega al API y los textos que ve el usuario.
  • No hay E2E en esta medición. La suite de Playwright (ADR-009) es un nivel aparte y no levanta aquí.

7. Riesgos y recomendaciones​

  1. POS ya no es la deuda. Las cuatro pantallas de administración pasaron de 43–60 % a 89,5–92,5 % de líneas con 93 casos nuevos (pos-ventas-gestion, pos-cajas-gestion, pos-movimientos-gestion, pos-reportes-gestion). Lo que queda es pos.tsx (81,5 %), el carrito, que ya tenía suite propia.
  2. signature-pad y approval-timeline son evidencia y control. El trazo de una firma (TEC-014) y la cadena de aprobación (SOL-002) tienen cobertura de líneas por debajo del 30 %. Aunque la defensa real está en el backend, conviene fijar su comportamiento en el cliente.
  3. Fijar --maxWorkers=2 en la integración continua. En paralelo por defecto, jsdom se queda sin memoria y aparecen fallos espurios que no existen en la ejecución acotada.
  4. Umbral de cobertura por capa, no global. Un umbral único (por ejemplo 75 %) se cumple o se incumple por accidente. Es más útil exigir pages ≥ 80 %, components ≥ 75 % y dejar api fuera del trato hasta que exista la capa de contrato.
  5. Mantener la convención *-gestion.test.tsx. Un archivo por módulo, montando la pantalla real, hace evidente qué falta y evita duplicar lo que ya cubren las specs de componentes.

8. Cómo reproducirlo​

cd ccf-almacen-web

# Suite completa (2 workers: jsdom agota memoria en paralelo)
npx jest --maxWorkers=2

# Con cobertura
npx jest --maxWorkers=2 --coverage

# Solo la capa de módulos
npx jest --maxWorkers=2 src/__tests__/*-gestion.test.tsx

Salida esperada de la suite completa:

Test Suites: 221 passed, 221 total
Tests: 2659 passed, 2659 total
Statements : 75.54% ( 20754/27474 )
Branches : 62.25% ( 10087/16203 )
Functions : 71.13% ( 4508/6337 )
Lines : 77.54% ( 19358/24965 )

npx tsc --noEmit, npx eslint y npm run verificar:etiquetas pasan sin errores.

Archivos clave​

  • ccf-almacen-web/src/__tests__/ — 44 suites de módulo y 20 de inventario, solicitudes y POS.
  • ccf-almacen-web/src/components/**/__tests__/ — 123 suites de componentes y tours.
  • ccf-almacen-web/coverage/coverage-summary.json — cobertura por archivo (base de las tablas).
  • ccf-almacen-web/.jest-report.json — resultado por suite y conteo de casos.
  • ccf-almacen-web/jest.config.js — recolección de cobertura y setup de jsdom.
  • ccf-almacen-web/src/components/tickets/ticket-catalogos.ts — corrección de urlEvidencia().
  • ccf-almacen-web/src/components/security/sesiones-panel.tsx — validación de idUsuario.
  • ccf-almacen-web/src/pages/plantillas-solicitud.tsx — recorte del payload.
  • ccf-almacen-web/src/components/common/data-grid.tsx — cambio de orden fuera del render.
  • ccf-almacen-wiki/blog/2026-11-13-pos-cobertura-pruebas-unitarias.md — detalle del incremento POS.