Análisis de consumo y KPIs de gestión — pruebas unitarias de los tableros
· 3 min de lectura
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)
| Bloque | Qué fija |
|---|---|
| Resumen | Las seis métricas del período (unidades, valor, variación, promedio, CV y anomalías) con su formato local |
| Calidad de datos | Aviso del consumo no atribuible a un área, y su ausencia cuando no hay brecha |
| Gráficas y desgloses | Serie 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ías | Top 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 |
| Detalle | Tabla por producto y área, paginación de 10 y búsqueda que vuelve a la página 1 |
| Filtros y exportación | Fechas, área, clasificación, categoría y agrupación; exportación a Excel y PDF con sus avisos y errores |
| Tour | Disponible o con su aviso de no disponible |
KPIs de gestión — src/__tests__/kpis-gestion-gestion.test.tsx (19 casos)
| Bloque | Qué fija |
|---|---|
| Indicadores | Rotació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 desgloses | Barra de progreso con aria-valuenow, detalles de apoyo de cada tarjeta y guiones cuando el indicador no se pudo medir |
| Resumen y tendencias | Inventario vigente, salidas valorizadas, pedidos evaluados y muestra de tiempo de ciclo; las cuatro gráficas mensuales |
| Desgloses | Rotación por categoría ordenada de menor a mayor, exactitud por categoría y fill rate por área, con sus vacíos |
| Filtros y tour | Fechas, 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
toasty 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
Intlen 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.tsxykpi-dashboard.tsx.ccf-almacen-web/src/models/analisis-consumo.entity.tsykpi-gestion.entity.ts.
