Saltar al contenido principal

SREQ-UX-04 · Tour guiado de Almacenes

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

La pantalla de bodegas es la raíz del inventario: de ella cuelgan el stock, las zonas, los movimientos y los accesos de los usuarios. Tiene además una particularidad —las acciones cambian según el rol— y el tour la respeta: no resalta un botón que el usuario no tiene delante.

🧭 Pantalla: 20 pasos, sin títulos ni textos​

#AnclajeControl
1almacenes.contenidoQué cuelga de una bodega (stock, zonas, movimientos, accesos)
2almacenes.boton.recargarFlecha circular: refresca, incluidas las inactivas
3almacenes.boton.nuevoSigno más: alta (solo Administrador y Almacenista)
4almacenes.boton.ayudaEl (?) de la pantalla
5–8almacenes.filtros, .filtros.titulo, .filtros.buscar, .filtros.contadorLa card en una fila, el embudo con «Filtros», buscador y «N de M»
9–11almacenes.cargando, .error, .vacioEstados de la consulta
12–13almacenes.tabla, .tabla.encabezadoTabla y sus cinco columnas
14–19almacenes.tabla.fila, .nombre, .direccion, .responsable, .estado, .accionesCelda por celda
20.tabla.boton.editar, .boton.activar, .boton.usuarios, .boton.eliminarSolo los que el rol permite

Recuentos: 20 pasos con Administrador, 18 con Almacenista (sin usuarios ni eliminar), 15 con rol de consulta (sin alta ni acciones de fila) y 9 sin bodegas.

🧾 Formulario: 7 pasos​

(?) dentro del alta o de la edición, con la modal abierta: almacenes.formulario → .nombre → .direccion → .responsable → .descripcion → .boton.cancelar → .boton.guardar.

👥 Accesos por bodega: 2 a 4 pasos​

(?) dentro de la modal de usuarios: almacenes.usuarios → .usuarios.lista → .usuarios.item → .usuarios.boton.cerrar. Sin usuarios cargados el recorrido se queda en 2.

🧱 El buscador se convierte en card de filtros​

Antes era un div con un input absoluto y un contador suelto, sin card ni nombre. Ahora es una card con un CardContent en flex flex-wrap items-end: embudo + «Filtros» como primer elemento, el buscador con flex-1 y Label asociada, y el contador al final (sm:ml-auto). El filtrado sigue siendo local —no consulta al servidor— y ocurre mientras se escribe.

🛠️ Cambios​

  • src/pages/almacenes.tsx — data-tour-modulo ya existía; se añaden los anclajes de acciones, filtros, tabla, celdas y de los tres diálogos, tres botones (?), y la card de filtros en una fila con título e icono.
  • src/config/tours.ts — pasosAlmacenes(estado), pasosFormularioAlmacen(estado) y pasosUsuariosAlmacen(estado); el módulo almacenes pasa a activo y reemplaza el guion corto que estaba inerte.
  • src/config/tours.spec.ts — lista canónica y composición de los tres guiones.
  • src/components/__tests__/almacenes-tour.test.tsx (nuevo) — 6 pruebas.

✅ Verificación​

  • almacenes-tour.test.tsx: 6/6 en verde (fila única con buscador y contador, filtrado local comprobado por el contador, anclajes completos, «1 / 20», «1 / 9», formulario «1 / 7» y accesos «1 / 4»).
  • tours.spec.ts: 25/25 en verde, incluido el chequeo cruzado de los anclajes activos.
  • ESLint limpio en los archivos tocados.

📄 Requerimiento: SREQ-UX-04: Tour guiado por funcionalidad