Saltar al contenido principal

Almacenes y Áreas — pruebas unitarias de bodegas, permisos y traslados

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

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)​

BloqueQué fija
ListadoEspera, 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 relacionadosRecuento por bodega (asignados + responsable) solo para Administrador; un rol sin gestión no consulta ni pinta acciones
Alta y ediciónNombre 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 bajaInactivar/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 bodegaCarga de asignados, Administrador no restringible, conceder y revocar acceso con sus avisos, error de carga y de cambio
Horario y tourSolo 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)​

BloqueQué fija
ListadoEspera, 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ónNombre 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
DetalleInformación, estado, descripción, dirección, responsable con su rol, tabla de usuarios (documento, correo, rol, estado), textos neutros y refresco al cerrar
EliminaciónConfirmación, bloqueo si el área tiene usuarios, error del servidor y cancelación sin consultar
Asignación de usuariosCandidatos 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 toast del registro y el contexto de tour; las páginas se montan completas dentro de un AuthContext.Provider con 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 Command de 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 su aria-label explícito.
  • AlertDialog y Dialog de 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.tsx y src/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 único oficinas.