Saltar al contenido principal

Análisis de consumo y KPIs de gestión — pruebas unitarias de los tableros

· 3 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

Análisis de consumo (/analisis-consumo, REP-005) explica patrones, anomalías y detalle por producto y área; KPIs de gestión (/kpis-gestion, REP-001) compara los cuatro indicadores operativos con su meta. Ahora suman 42 casos de prueba.

1. Qué se cubre​

Análisis de consumo — src/__tests__/analisis-consumo-gestion.test.tsx (23 casos)​

BloqueQué fija
ResumenLas seis métricas del período (unidades, valor, variación, promedio, CV y anomalías) con su formato local
Calidad de datosAviso del consumo no atribuible a un área, y su ausencia cuando no hay brecha
Gráficas y desglosesSerie por período y su agrupación, consumo por área (incluida «Sin área») y por categoría, con sus mensajes de vacío
Top y anomalíasTop de productos con SKU/categoría/participación; anomalías con severidad, pico/caída, observado/esperado, variación, método z-robusto o regla de razón y series con muestra insuficiente
DetalleTabla por producto y área, paginación de 10 y búsqueda que vuelve a la página 1
Filtros y exportaciónFechas, área, clasificación, categoría y agrupación; exportación a Excel y PDF con sus avisos y errores
TourDisponible o con su aviso de no disponible

KPIs de gestión — src/__tests__/kpis-gestion-gestion.test.tsx (19 casos)​

BloqueQué fija
IndicadoresRotación, exactitud, fill rate y tiempo de ciclo con su valor, su meta y su clasificación (En meta / Sobre la línea base / Bajo / Sin datos)
Avance y desglosesBarra de progreso con aria-valuenow, detalles de apoyo de cada tarjeta y guiones cuando el indicador no se pudo medir
Resumen y tendenciasInventario vigente, salidas valorizadas, pedidos evaluados y muestra de tiempo de ciclo; las cuatro gráficas mensuales
DesglosesRotación por categoría ordenada de menor a mayor, exactitud por categoría y fill rate por área, con sus vacíos
Filtros y tourFechas, almacén y área; restablecer a los valores iniciales; actualización manual y recorrido guiado

2. Patrón de las pruebas​

  • Se mockean las APIs de reportes, almacenes y oficinas, el toast y el tour; los gráficos de Recharts se montan reales dentro de jsdom.
  • Las tarjetas de KPI se localizan por su anclaje de tour ([data-tour="kpis-gestion.kpi.*"]) porque el título «Fill rate» también aparece en otras secciones.
  • Los importes y porcentajes se afirman con Intl en es-CO (1.180, 9,5x, 96,5%), y los textos compuestos se buscan con expresiones regulares.

3. Cómo verificarlo​

cd ccf-almacen-web
npx jest src/__tests__/analisis-consumo-gestion.test.tsx src/__tests__/kpis-gestion-gestion.test.tsx
# Test Suites: 2 passed, 2 total
# Tests: 42 passed, 42 total

npx tsc --noEmit y npx eslint pasan sin errores.

4. Nota sobre la ejecución en lote​

Los tableros con Recharts consumen bastante memoria de jsdom: al correr las 31 suites de la carpeta en paralelo, algunas fallan por contención de recursos (no por regresiones). Con npx jest --maxWorkers=2 la corrida completa pasa: 31 suites / 751 pruebas.

Archivos clave​

  • ccf-almacen-web/src/__tests__/analisis-consumo-gestion.test.tsx — suite del tablero de consumo.
  • ccf-almacen-web/src/__tests__/kpis-gestion-gestion.test.tsx — suite de KPIs de gestión.
  • ccf-almacen-web/src/components/reports/consumo-dashboard.tsx y kpi-dashboard.tsx.
  • ccf-almacen-web/src/models/analisis-consumo.entity.ts y kpi-gestion.entity.ts.