Saltar al contenido principal

Transferencias entre almacenes — pruebas unitarias del flujo completo

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

La pantalla Operaciones › Inventarios › Transferencias (/transferencias) mueve stock entre bodegas en dos fases: el origen despacha y el destino confirma la recepción. Ahora tiene una suite de 32 casos que cubre listado, filtros, paginación, modo offline, alta validada contra el stock por bodega y las transiciones enviar, recibir y cancelar.

1. Qué se cubre​

ccf-almacen-web/src/__tests__/transferencias-gestion.test.tsx (32 casos):

BloqueQué fija
ListadoIndicador de carga, error con el mensaje del servidor, vacío, código/ruta/líneas/estado/fecha, nombres de bodega de respaldo, acciones por estado (Enviar/Cancelar, Recibir, sin acciones en recibida/cancelada), recargar y banner de modo offline
Filtros y paginaciónFiltro por estado y por almacén (con vuelta a «Todos»), reinicio a la página 1, meta del API («Página 1 de 2 · 15 transferencias») y navegación Anterior/Siguiente
AltaFormulario vacío con Crear deshabilitado; productos con existencias del origen; aviso sin existencias; destino distinto; cantidad válida y suficiente; exceso con aviso y bloqueo; decimales y negativos; varias líneas; línea duplicada rechazada; agregar/quitar líneas; ajuste y descarte al cambiar de origen; alta con observaciones y sin ellas; estado «Creando…»; error del servidor; cancelación
TransicionesConfirmación de Enviar (descuenta stock), Recibir (suma stock) y Cancelar (no mueve stock); Volver sin ejecutar; error del servidor con cierre del diálogo
ContratoPayload exacto de creación con ruta, observaciones y detalles; identificadores enviados en cada transición

La suite se apoya en las pruebas ya existentes del tour (transferencias-tour.test.tsx) y del selector de producto (transferencias-selector-buscador.test.tsx).

2. Patrón de las pruebas​

  • Se monta la página real y se mockean sus hooks de datos y mutaciones (useTransferencias, useCreateTransferencia, useAccionTransferencia, useWarehouses, useOfflineInventory), además de conectividad, tour y avisos.
  • Las mutaciones se resuelven invocando onSuccess/onError para comprobar los avisos y el cierre de diálogos, sin depender de React Query en la prueba.
  • Los Select de Radix se abren con clic y se eligen por el nombre visible; las líneas del formulario se localizan por su aria-label («Producto de la línea N») y por los ids cantidad-N.
  • Las filas de la tabla se acotan con within(fila) para distinguir las acciones de cada transferencia.

3. Cómo verificarlo​

cd ccf-almacen-web
npx jest src/__tests__/transferencias-gestion.test.tsx
# Test Suites: 1 passed, 1 total
# Tests: 32 passed, 32 total

npx tsc --noEmit y npx eslint sobre el archivo también pasan sin errores.

Archivos clave​

  • ccf-almacen-web/src/__tests__/transferencias-gestion.test.tsx — suite de la página.
  • ccf-almacen-web/src/pages/transferencias.tsx — listado, filtros, formulario y transiciones.
  • ccf-almacen-web/src/utils/transferencias-stock.ts — disponibilidad por bodega y validación de cantidades.