Saltar al contenido principal

Solicitudes e Inventarios — pruebas unitarias de sus flujos completos

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

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)​

BloqueQué fija
ListadoTabla 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 avanzadaEstado, tipo, prioridad y oficina viajan en el contrato del API; limpiar vuelve a vacío; filtros guardados con su búsqueda y su orden
CRUDAlta 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
EstadosAprobar con confirmación; rechazar con motivo obligatorio; aprobación multinivel pendiente sin despacho disponible; bloqueo de completar con entregas pendientes
Despacho y rolesApertura 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)​

BloqueQué fija
CapturaProducto, stock y entregado previo; confirmación deshabilitada sin unidades; exceso sobre el remanente; exceso sobre el stock; detalle ya completo
PersistenciaDetalle 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
RolesAuditor 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)​

BloqueQué fija
Listado y métricasTarjetas desde el resumen del servidor, listado paginado, detalle del movimiento, paginación, vacío, error, panel de estadísticas con preferencia persistida
Búsqueda avanzadaBú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 stockEntrada 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
ResumenEstado de error propio cuando no puede cargar productos

Resumen de inventario (src/__tests__/inventario-resumen.test.tsx, 9 casos)​

BloqueQué fija
Datos y semáforosProducto 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ónFiltro por nombre, SKU y ubicación; cero coincidencias; selección que acota la grid de movimientos
CargaIndicador de espera, error del API y conteo en cero

Lista y detalle de movimientos (src/__tests__/inventario-lista-detalle.test.tsx, 11 casos)​

BloqueQué fija
ListaIndicador 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
DetalleEstado 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)​

BloqueQué fija
GridPrimera página, detalle al seleccionar, «Cargar más» por cursor con concatenación, vacío con exportación deshabilitada, error de carga
AccionesExportació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 Select de Radix se abren con clic y se eligen por el nombre visible de la opción; los diálogos se acotan con within para 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.