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étrica | Cubierto | Total | Porcentaje |
|---|---|---|---|
| Sentencias | 20 754 | 27 474 | 75,54 % |
| Ramas | 10 087 | 16 203 | 62,25 % |
| Funciones | 4 508 | 6 337 | 71,13 % |
| Líneas | 19 358 | 24 965 | 77,54 % |
Y la suite que produce esos números:
| Bloque | Archivos | Casos |
|---|---|---|
Módulos (src/__tests__/*-gestion.test.tsx) | 44 | 1 031 |
Componentes (src/components/**/__tests__) | 123 | 1 079 |
| Base: configuración, utilidades, hooks, contratos | 34 | 278 |
| Total | 221 | 2 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ódulo | Casos | Módulo | Casos |
|---|---|---|---|
| Ubicaciones | 40 | Órdenes de compra | 24 |
| Almacenes | 36 | Análisis de consumo | 23 |
| Tickets | 35 | Carga masiva | 23 |
| Sesiones | 35 | Administración del menú | 23 |
| Áreas | 33 | Firmas | 22 |
| Inventario | 32 | Presupuestos | 21 |
| Transferencias | 32 | Gestión de IPs | 21 |
| Plantillas de solicitud | 31 | Ideas y novedades | 21 |
| Lotes y series | 30 | Personalización | 20 |
| Conteos | 30 | Clasificación ABC | 20 |
| Solicitudes | 29 | Alertas de stock | 19 |
| Alertas inteligentes | 29 | KPIs de gestión | 19 |
| Recepciones | 28 | Proveedores | 19 |
| Demanda predictiva | 27 | Trabajos | 19 |
| Devoluciones | 25 | Auditoría de accesos | 16 |
| Obsolescencia | 25 | Seguridad 2FA | 15 |
| Reorden | 24 | Rate limit | 13 |
| Intercambio EDI/XML/JSON | 24 | Jobs (complemento) | 12 |
| Webhooks | 24 | Políticas de contraseña | 12 |
| Ventas del POS | 28 | Cajas y turnos | 24 |
| Reportes del POS | 22 | Movimientos del POS | 19 |
| Pantallas de error | 6 | Acerca de | 1 |
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:
| Capa | Archivos | Sentencias | Ramas | Funciones | Líneas |
|---|---|---|---|---|---|
src/components | 183 | 76,1 % | 60,5 % | 75,0 % | 77,7 % |
src/pages | 49 | 86,2 % | 73,0 % | 80,9 % | 87,8 % |
src/config | 7 | 91,2 % | 83,7 % | 39,4 % | 92,3 % |
src/utils | 24 | 81,9 % | 73,2 % | 87,7 % | 83,6 % |
src/registry (shadcn/ui) | 29 | 84,8 % | 53,8 % | 53,8 % | 87,0 % |
src/lib | 5 | 82,8 % | 76,3 % | 75,0 % | 87,4 % |
src/models | 26 | 74,0 % | 57,8 % | 56,8 % | 71,9 % |
src/services | 13 | 70,4 % | 50,0 % | 63,6 % | 73,5 % |
src/hooks | 13 | 65,4 % | 48,3 % | 54,8 % | 67,1 % |
src/api | 27 | 33,2 % | 28,8 % | 18,6 % | 36,2 % |
scripts / deploy | 2 | 61,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):
| Familia | Archivos | Sentencias | Líneas |
|---|---|---|---|
Veterinaria (vete_* / veterinaria) | 23 | 96,0 % | 97,0 % |
| Solicitudes, cargas, plantillas, aprobaciones, presupuestos | 14 | 82,9 % | 84,9 % |
| Seguridad, sesiones, auditoría, contraseñas | 16 | 79,0 % | 82,0 % |
| Inventario, productos, lotes, stock | 45 | 77,3 % | 79,3 % |
| POS — componentes | 4 | 83,3 % | 90,5 % |
| Tablero | 6 | 72,8 % | 73,5 % |
| POS — pantallas | 5 | 82,8 % | 84,8 % |
Sala de continuidad (offline) | 1 | 58,3 % | 62,9 % |
| Empresa | 2 | 49,5 % | 50,5 % |
4. Dónde está la deuda
4.1 Pantallas con menor cobertura de líneas
| Pantalla | Sentencias | Líneas | Por qué |
|---|---|---|---|
empresa.tsx | 45,5 % | 46,8 % | Subida de logos y datos institucionales |
offline.tsx | 58,3 % | 62,9 % | Bucle de reconexión con retroceso exponencial |
tablero.tsx | 70,5 % | 70,6 % | Widgets configurables y sus estados |
login-form.tsx | 74,7 % | 74,3 % | Errores de credenciales y bloqueo |
inventory-movements.tsx | 75,9 % | 81,2 % | Estadísticas y exportación CSV |
pos.tsx | 79,7 % | 81,5 % | Carrito, lote/serie y cobro |
stock-alerts.tsx | 82,2 % | 82,1 % | Ramas de orden y paginación |
solicitudes/page.tsx | 86,4 % | 88,4 % | Despacho y aprobación multinivel |
firmas.tsx | 87,0 % | 89,0 % | Evidencia firmada (TEC-014) |
4.2 Componentes con menor cobertura
| Componente | Sentencias | Líneas | Riesgo |
|---|---|---|---|
requests/request-detail-standalone.tsx | 9,1 % | 10,0 % | Detalle de solicitud fuera del armazón |
almacenes/horario-panel.tsx | 17,0 % | 19,6 % | Ventanas horarias por almacén |
devoluciones/devolucion-desde-solicitud.tsx | 17,2 % | 18,6 % | Alta de devolución desde una solicitud |
requests/approval-timeline.tsx | 17,6 % | 18,8 % | Cadena multinivel (SOL-002) |
general-dashboard/profile.tsx | 19,7 % | 20,2 % | Perfil del usuario |
reports/warehouse-reports.tsx | 21,7 % | 23,2 % | Reportes de almacén |
firmas/signature-pad.tsx | 28,2 % | 28,2 % | Evidencia legal (TEC-014) |
upload/product-image-upload.tsx | 30,6 % | 32,6 % | Imagen de producto |
devoluciones/devoluciones-historial.tsx | 42,9 % | 47,4 % | Historial de devoluciones |
notification/panel-notificaciones.tsx | 56,0 % | 56,9 % | Centro de notificaciones (UX-004) |
4.3 Hooks
| Hook | Sentencias |
|---|---|
use-firmas | 8,1 % |
use-enhanced-toast | 8,6 % |
use-devoluciones | 13,6 % |
use-retroalimentacion | 19,0 % |
use-tickets | 72,5 % |
5. Defectos reales corregidos al probar
Probar encontró cuatro defectos que no eran de las pruebas:
urlEvidencia()rompía fuera dedevelopment/production. El mapa de configuración no declara otros entornos, así que con cualquierNODE_ENVdistinto la entrada eraundefinedy el detalle de un ticket con evidencias lanzabaCannot read properties of undefined (reading 'apiDashboard'). Ahora cae aconfig.development. Archivo:src/components/tickets/ticket-catalogos.ts.altaLimiteenviabaidUsuario: 0. Ensesiones-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 exigeidUsuario > 0. Archivo:src/components/security/sesiones-panel.tsx.- 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
trimantes de enviar. Archivo:src/pages/plantillas-solicitud.tsx. - La grid avisaba del cambio de orden durante el render.
DataGrid.cambiarOrden()llamaba aonCambioOrdendentro del actualizador desetOrden, 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 enStrictModela consulta se dispara dos veces. Ahora el orden se calcula con el estado vigente y se avisa después desetOrden. Archivo:src/components/common/data-grid.tsx.
6. Límites de esta medición
src/apiestá 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
- 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 espos.tsx(81,5 %), el carrito, que ya tenía suite propia. signature-padyapproval-timelineson 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.- Fijar
--maxWorkers=2en 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. - 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 dejarapifuera del trato hasta que exista la capa de contrato. - 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 ysetupde jsdom.ccf-almacen-web/src/components/tickets/ticket-catalogos.ts— corrección deurlEvidencia().ccf-almacen-web/src/components/security/sesiones-panel.tsx— validación deidUsuario.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.
