Almacenes y Áreas — pruebas unitarias de bodegas, permisos y traslados
· 3 min de lectura
Las pantallas Almacenes (/almacenes, INV-002 + REQ-POS-01 + ADR-026) y Gestión de
Áreas (/areas, REQ-ADM-03) administran las dos dimensiones físicas y organizativas del
inventario. Ahora suman 69 casos de prueba entre ambas.
1. Qué se cubre
Almacenes — src/__tests__/almacenes-gestion.test.tsx (36 casos)
| Bloque | Qué fija |
|---|---|
| Listado | Espera, error con mensaje del servidor, vacío según rol, contador, búsqueda por nombre y dirección, tipo (General/Tienda/Dispensación), teléfono formateado + NIT, responsable, banderas POS / Stock − / Vet, estado y guiones cuando falta el dato |
| Usuarios relacionados | Recuento por bodega (asignados + responsable) solo para Administrador; un rol sin gestión no consulta ni pinta acciones |
| Alta y edición | Nombre obligatorio, payload con todas las columnas, POS bloqueado en bodega general, textos vacíos enviados como null, error del servidor, «Guardando…», edición precargada y cancelación |
| Estado y baja | Inactivar/reactivar con su aviso y recarga, error, eliminación con confirmación, mensaje que sugiere inactivar ante dependencias y cancelación sin efectos |
| Accesos por bodega | Carga de asignados, Administrador no restringible, conceder y revocar acceso con sus avisos, error de carga y de cambio |
| Horario y tour | Solo la dispensación ofrece horario; tours de pantalla, formulario y accesos con su aviso de no disponible |
Áreas — src/__tests__/areas-gestion.test.tsx (33 casos)
| Bloque | Qué fija |
|---|---|
| Listado | Espera, nombre/descripción/estado/usuarios, vacío con y sin invitación a crear, búsqueda con reinicio a página 1, filtro por estado, error de carga, paginación y recarga |
| Alta y edición | Nombre obligatorio (botón deshabilitado), alta con descripción y responsable, alta inactiva, error del servidor, «Guardando…» con acciones bloqueadas, edición precargada y error al cargar |
| Detalle | Información, estado, descripción, dirección, responsable con su rol, tabla de usuarios (documento, correo, rol, estado), textos neutros y refresco al cerrar |
| Eliminación | Confirmación, bloqueo si el área tiene usuarios, error del servidor y cancelación sin consultar |
| Asignación de usuarios | Candidatos con su área actual, selección y alta con addUsersToArea, sin selección deshabilitado, sin candidatos, búsqueda con criterio, error de búsqueda, error al asignar y ausencia para roles sin administración |
2. Patrón de las pruebas
- Se mockean los hooks de almacenes, la API de áreas y permisos, el
toastdel registro y el contexto de tour; las páginas se montan completas dentro de unAuthContext.Providercon el rol que cada caso necesita. - El selector de usuario se sustituye por un doble que expone una opción por botón, para probar
que la selección llega al formulario sin depender del
Commandde Radix en jsdom. - Las casillas de permisos se localizan con
getByLabelText(/nombre/)porque la etiqueta incluye también el rol; las acciones por fila, por suaria-labelexplícito. AlertDialogyDialogde Radix requieren anular el foco programático (anularFocoProgramatico).
3. Cómo verificarlo
cd ccf-almacen-web
npx jest src/__tests__/almacenes-gestion.test.tsx src/__tests__/areas-gestion.test.tsx
# Test Suites: 2 passed, 2 total
# Tests: 69 passed, 69 total
npx tsc --noEmit y npx eslint pasan sin errores.
Archivos clave
ccf-almacen-web/src/__tests__/almacenes-gestion.test.tsx— suite de bodegas.ccf-almacen-web/src/__tests__/areas-gestion.test.tsx— suite de áreas.ccf-almacen-web/src/pages/almacenes.tsxysrc/pages/areas.tsx— páginas bajo prueba.ccf-almacen-web/src/models/almacen.entity.ts— formulario y normalización del payload.ccf-almacen-web/src/api/areas.ts— contrato del modelo únicooficinas.
