Ubicaciones del Almacén — pruebas unitarias de la jerarquía y su CRUD
· 3 min de lectura
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):
| Bloque | Qué fija |
|---|---|
| Carga y jerarquía | Indicador 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 |
| Contenido | Consulta 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ón | Producto 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 |
| Tour | Sin 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
withinpara distinguir selección, edición y eliminación. - Los
Selectde 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.
