SREQ-UX-04 · Tour guiado de Almacenes
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
| # | Anclaje | Control |
|---|---|---|
| 1 | almacenes.contenido | Qué cuelga de una bodega (stock, zonas, movimientos, accesos) |
| 2 | almacenes.boton.recargar | Flecha circular: refresca, incluidas las inactivas |
| 3 | almacenes.boton.nuevo | Signo más: alta (solo Administrador y Almacenista) |
| 4 | almacenes.boton.ayuda | El (?) de la pantalla |
| 5–8 | almacenes.filtros, .filtros.titulo, .filtros.buscar, .filtros.contador | La card en una fila, el embudo con «Filtros», buscador y «N de M» |
| 9–11 | almacenes.cargando, .error, .vacio | Estados de la consulta |
| 12–13 | almacenes.tabla, .tabla.encabezado | Tabla y sus cinco columnas |
| 14–19 | almacenes.tabla.fila, .nombre, .direccion, .responsable, .estado, .acciones | Celda por celda |
| 20 | .tabla.boton.editar, .boton.activar, .boton.usuarios, .boton.eliminar | Solo 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-moduloya 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)ypasosUsuariosAlmacen(estado); el móduloalmacenespasa 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
