Solicitudes e Inventarios — pruebas unitarias de sus flujos completos
Los módulos Solicitudes e Inventarios del dashboard ya tienen suites de comportamiento que cubren su ciclo completo: listado y filtros, alta, edición y baja, aprobación y rechazo, despacho con movimiento de inventario, carga de stock y consulta de movimientos. En total son seis suites y 103 casos que se ejecutan con Jest y React Testing Library, sin tocar el API real.
La pantalla que el menú rotula Operaciones › Inventarios › Inventario (módulos
2 → 21, ruta /inventory) es pages/inventory.tsx; se cubre desde su pantalla y
desde sus tres piezas (resumen, lista de movimientos y detalle).
1. Qué se cubre
Solicitudes (src/__tests__/solicitudes-gestion.test.tsx, 29 casos)
| Bloque | Qué fija |
|---|---|
| Listado | Tabla con código, área, tipo, prioridad y estado; búsqueda de texto con reinicio a la página 1; refresco; orden por columna con alternancia asc/desc; paginación en servidor; consulta propia cuando el rol es Usuario Interno; lista vacía y error de carga |
| Búsqueda avanzada | Estado, tipo, prioridad y oficina viajan en el contrato del API; limpiar vuelve a vacío; filtros guardados con su búsqueda y su orden |
| CRUD | Alta maestro-detalle con producto y auditoría; rechazo de alta sin elementos; validación de producto obligatorio; edición con actualización de observaciones; baja con confirmación; tope por stock; fusión de líneas repetidas; editar y quitar elementos; cancelación; creación sin identificador |
| Estados | Aprobar con confirmación; rechazar con motivo obligatorio; aprobación multinivel pendiente sin despacho disponible; bloqueo de completar con entregas pendientes |
| Despacho y roles | Apertura del despacho, vuelta con refresco, despacho restringido para Auditor y Usuario Interno, y ausencia de acciones de estado para Auditor |
Despacho (src/__tests__/solicitudes-despacho.test.tsx, 14 casos)
| Bloque | Qué fija |
|---|---|
| Captura | Producto, stock y entregado previo; confirmación deshabilitada sin unidades; exceso sobre el remanente; exceso sobre el stock; detalle ya completo |
| Persistencia | Detalle actualizado (cantidadEntregada + estado), movimiento de salida con almacén, descuento de stock y cambio de estado a en_proceso o completada; observaciones de línea y generales; fallo del movimiento sin cambio de estado; cancelaciones |
| Roles | Auditor y Usuario Interno no capturan ni despachan; el intento del Auditor queda auditado como DESPACHO_BLOQUEADO |
Gestión de Inventario — pantalla (src/__tests__/inventario-gestion.test.tsx, 29 casos)
| Bloque | Qué fija |
|---|---|
| Listado y métricas | Tarjetas desde el resumen del servidor, listado paginado, detalle del movimiento, paginación, vacío, error, panel de estadísticas con preferencia persistida |
| Búsqueda avanzada | Búsqueda, tipo, producto, categoría, almacén, zona, orden y dirección en el contrato; limpiar; Enter; filtro por producto desde el resumen; buscador del resumen; filtros guardados |
| Carga de stock | Entrada con almacén y cantidad, bodega alternativa, validación de cantidad, confirmación y cancelación, retorno con refresco, error, producto duplicado, limpieza, detalle plegable con nuevo stock proyectado, precio saneado, motivo/referencia, quitar producto, lote, números de serie y aviso sin bodega |
| Resumen | Estado de error propio cuando no puede cargar productos |
Resumen de inventario (src/__tests__/inventario-resumen.test.tsx, 9 casos)
| Bloque | Qué fija |
|---|---|
| Datos y semáforos | Producto con SKU, stock, unidad y ubicación; contadores de entradas, salidas y ajustes; último movimiento; orden por actividad; los cinco estados de stock (sin stock, bajo mínimo, normal, crítico y bajo reorden) y el stock de seguridad |
| Búsqueda y selección | Filtro por nombre, SKU y ubicación; cero coincidencias; selección que acota la grid de movimientos |
| Carga | Indicador de espera, error del API y conteo en cero |
Lista y detalle de movimientos (src/__tests__/inventario-lista-detalle.test.tsx, 11 casos)
| Bloque | Qué fija |
|---|---|
| Lista | Indicador de carga, vacío, paginación interna de 10 en 10, modo sin paginación para el padre, las siete etiquetas de tipo y los cambios de stock con signo |
| Detalle | Estado sin selección; producto, SKU, unidad, stock, ubicación, descripción, fecha, cantidades, saldo antes/después, cambio, usuario, referencia y comentarios; respaldos cuando faltan datos y cambio en cero |
Movimientos de inventario (src/__tests__/inventario-movimientos.test.tsx, 11 casos)
| Bloque | Qué fija |
|---|---|
| Grid | Primera página, detalle al seleccionar, «Cargar más» por cursor con concatenación, vacío con exportación deshabilitada, error de carga |
| Acciones | Exportación CSV (contenido y descarga), panel de estadísticas persistido, filtros guardados aplicados y su menú |
2. Patrón de las pruebas
Se sigue el patrón del resto de las suites del dashboard:
- Se monta la pantalla completa o el componente real, no una copia reducida.
- Se mockean solo las fronteras:
api/*, filtros guardados, avisos y los subpaneles que consultan por su cuenta (aprobaciones, devoluciones, actas de despacho). Así cada caso comprueba lo que ve el operador y el contrato que se envía al API. - Los
Selectde Radix se abren con clic y se eligen por el nombre visible de la opción; los diálogos se acotan conwithinpara no confundir botones repetidos. - No hay pruebas de solo instantánea ni aserciones sobre clases de estilo.
3. Cómo verificarlo
cd ccf-almacen-web
npx jest src/__tests__/solicitudes-gestion.test.tsx \
src/__tests__/solicitudes-despacho.test.tsx \
src/__tests__/inventario-gestion.test.tsx \
src/__tests__/inventario-resumen.test.tsx \
src/__tests__/inventario-lista-detalle.test.tsx \
src/__tests__/inventario-movimientos.test.tsx
# Test Suites: 6 passed, 6 total
# Tests: 103 passed, 103 total
npx tsc --noEmit y npx eslint sobre los seis archivos también pasan sin
errores.
Archivos clave
ccf-almacen-web/src/__tests__/solicitudes-gestion.test.tsx— pantalla de solicitudes: listado, filtros, CRUD y estados.ccf-almacen-web/src/__tests__/solicitudes-despacho.test.tsx— despacho real con movimiento de inventario y restricciones de rol.ccf-almacen-web/src/__tests__/inventario-gestion.test.tsx— gestión de inventario: métricas, filtros, resumen y carga de stock.ccf-almacen-web/src/__tests__/inventario-resumen.test.tsx— panel de resumen por producto: semáforos, stock de seguridad, búsqueda y selección.ccf-almacen-web/src/__tests__/inventario-lista-detalle.test.tsx— lista paginada y detalle de movimientos, tipos, cambios de stock y datos de respaldo.ccf-almacen-web/src/__tests__/inventario-movimientos.test.tsx— grid de movimientos por cursor, detalle, CSV y filtros guardados.