Transferencias entre almacenes — pruebas unitarias del flujo completo
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):
| Bloque | Qué fija |
|---|---|
| Listado | Indicador 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ón | Filtro 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 |
| Alta | Formulario 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 |
| Transiciones | Confirmación de Enviar (descuenta stock), Recibir (suma stock) y Cancelar (no mueve stock); Volver sin ejecutar; error del servidor con cierre del diálogo |
| Contrato | Payload 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/onErrorpara comprobar los avisos y el cierre de diálogos, sin depender de React Query en la prueba. - Los
Selectde Radix se abren con clic y se eligen por el nombre visible; las líneas del formulario se localizan por suaria-label(«Producto de la línea N») y por los idscantidad-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.