Saltar al contenido principal

Ubicaciones del Almacén — pruebas unitarias de la jerarquía y su CRUD

La pantalla Operaciones › Inventarios › Ubicaciones (/ubicaciones, módulo 24) administra la jerarquía física Zona › Pasillo › Estante › Nivel, el filtro por almacén, el contenido de cada nodo y la reubicación de productos. Ahora cuenta con una suite de 40 casos sobre la pantalla completa, con las fronteras del API y los sockets mockeadas.

1. Qué se cubre​

ccf-almacen-web/src/__tests__/ubicaciones-gestion.test.tsx (40 casos):

BloqueQué fija
Carga y jerarquíaIndicador inicial con almacenes, listado de zonas, vacío, filtro por almacén con limpieza de selección, drill-down Zona → Pasillo → Estante → Nivel, descarte de hijos al cambiar de padre, actualizar con reinicio del árbol y fallo del catálogo de almacenes sin romper la pantalla
ContenidoConsulta por el nodo más específico (zona, pasillo, estante, nivel), totales de productos y unidades, tabla con SKU/producto/ubicación/stock, vacío, error del API y recarga por los eventos de socket reubicacion-creada y ubicacion-actualizada
Zonas (CRUD)Alta con almacén obligatorio, validación de nombre, edición de nombre y almacén, baja con confirmación y aviso de hijos, cancelaciones, mensaje del servidor y descarte de la selección al eliminar
Pasillos (CRUD)Alta dentro de la zona elegida (también con Enter), edición, baja con confirmación, error de edición y botón deshabilitado sin zona
Estantes (CRUD)Alta dentro del pasillo, edición, baja con aviso de hijos y error del servidor conservando la lista
Niveles (CRUD)Alta dentro del estante, edición, baja sin el aviso de hijos (es el último nivel) y vacíos de cada nivel hijo
ReubicaciónProducto y ubicación actual, confirmación bloqueada sin nivel destino, cascada Zona → Pasillo → Estante → Nivel, registro con usuario y comentarios, alta sin usuario en sesión, error del API conservando el diálogo y cancelación
TourSin proveedor no se pinta el botón; con motor inicia el recorrido ubicaciones; si el motor no está listo se avisa

2. Patrón de las pruebas​

Se mantiene el patrón del resto del dashboard:

  • Se monta la pantalla real (components/ubicaciones/ubicaciones-management).
  • Se mockean solo las fronteras: api/ubicacion, api/almacenes, helpers/sockets, el contexto opcional del tour y los avisos.
  • Los cuatro niveles de la jerarquía se recorren como lo haría el operador y las filas se acotan con within para distinguir selección, edición y eliminación.
  • Los Select de Radix se abren con clic y se eligen por el nombre visible; los diálogos se localizan por su rol (dialog / alertdialog).
  • 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__/ubicaciones-gestion.test.tsx
# Test Suites: 1 passed, 1 total
# Tests: 40 passed, 40 total

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

Archivos clave​

  • ccf-almacen-web/src/__tests__/ubicaciones-gestion.test.tsx — suite de la pantalla.
  • ccf-almacen-web/src/components/ubicaciones/ubicaciones-management.tsx — jerarquía, contenido, CRUD y reubicación.
  • ccf-almacen-web/src/api/ubicacion.ts — contrato de zonas, pasillos, estantes, niveles, contenido y reubicaciones.