SREQ-UX-04 · Tour guiado de Transferencias entre almacenes
Transferencias es la pantalla donde el almacén mueve stock de una bodega a otra en dos fases, y su
mayor riesgo es de concepto: crear una transferencia no mueve el inventario; lo mueve el envío y,
al final, la recepción. Eso es exactamente lo que ahora explica el tour, lanzado desde el botón (?)
de la cabecera.
🧭 Veintitrés pasos en la página
| # | Anclaje | Qué explica |
|---|---|---|
| 1 | transferencias.contenido | La pantalla y el flujo completo (pendiente → en tránsito → recibida / cancelada) |
| 2 | transferencias.offline | Aviso de modo sin conexión (solo si aparece) |
| 3 | transferencias.titulo | El módulo y su pestaña de trabajo |
| 4 | transferencias.subtitulo | La regla: el origen despacha, el destino confirma |
| 5 | transferencias.boton.recargar | La flecha circular: refresca sin perder filtros ni página |
| 6 | transferencias.boton.nueva | El +: crea en pendiente, sin tocar stock |
| 7 | transferencias.boton.ayuda | El (?) y el recorrido del formulario |
| 8 | transferencias.filtros | La card: título y campos en una fila, sin botón «Aplicar» |
| 9 | transferencias.filtros.titulo | El embudo y la palabra «Filtros» que antes no existían |
| 10 | transferencias.filtros.estado | Los cinco valores del filtro por fase |
| 11 | transferencias.filtros.almacen | Filtra por bodega en cualquiera de las dos puntas |
| 12 | transferencias.cargando | «Cargando…» frente a «no hay datos» |
| 13 | transferencias.error | Error de consulta y cómo reintentar |
| 14 | transferencias.vacio | Estado vacío |
| 15 | transferencias.tabla | El histórico, de la más reciente a la más antigua |
| 16 | transferencias.tabla.encabezado | Las seis columnas |
| 17-24 | transferencias.tabla.fila y sus celdas | Anatomía de una fila: código, ruta con flecha, líneas, estado, fecha y acciones |
| 25-27 | transferencias.tabla.boton.enviar, .cancelar, .recibir | Cada acción con su efecto real en el stock y su confirmación |
| 28 | transferencias.paginacion | «Página X de Y» y Anterior/Siguiente |
Sin filas el guion se queda en 11 pasos (los 10 de pantalla + el estado vacío); con error, otros 11 (los 10 de pantalla + el aviso). Las acciones de fila solo se incluyen si hay alguna pendiente (Enviar/Cancelar) o en tránsito (Recibir), así que nunca se resalta un botón que no existe.
🧾 Catorce pasos en el formulario
El (?) del diálogo —arriba a la derecha del título— lanza un recorrido propio con la modal
abierta: el motor del tour se pinta por encima del diálogo, así que no hace falta abrirlo ni
cerrarlo desde el guion de la página.
| Anclaje | Qué explica |
|---|---|
transferencias.dialogo | La modal y que nada toca el inventario hasta el envío |
transferencias.dialogo.titulo / .descripcion | Título y consecuencia del alta |
transferencias.dialogo.origen / .destino | Selectores con la bodega opuesta deshabilitada |
transferencias.dialogo.aviso | Aviso rojo si origen y destino coinciden (solo si se pinta) |
transferencias.dialogo.productos | La sección de líneas |
transferencias.dialogo.boton.agregar-linea | Añadir líneas |
transferencias.dialogo.linea | Anatomía de una línea |
transferencias.dialogo.linea.producto | Producto con SKU y nombre (caché offline) |
transferencias.dialogo.linea.cantidad | Cantidad mínima 1 |
transferencias.dialogo.linea.quitar | Papelera (deshabilitada con una sola línea) |
transferencias.dialogo.observaciones | Notas para el destino, hasta 1000 caracteres |
transferencias.dialogo.boton.cancelar / .crear | Cerrar sin crear / crear cuando el formulario es válido |
🧱 De dos selectores sueltos a una card de filtros
La pantalla tenía un div con dos Select sin título. Ahora es una card con un único contenido
flex flex-wrap items-end: el embudo y «Filtros» abren la fila —como pidió el requerimiento— y los
dos campos la acompañan con flex-1 y ancho máximo. Se conserva la lógica intacta: cada cambio
consulta al servidor y vuelve a la página 1.
🛠️ Cambios
src/pages/transferencias.tsx—data-tour-modulo="transferencias", anclajes de sección, campo, icono y botón;(?)de página y(?)del formulario conuseTourOpcional; card de filtros en una fila con título e icono;aria-hiddenen los iconos decorativos.src/config/tours.ts—pasosTransferencias(estado)(23) ypasosNuevaTransferencia(estado)(14), con el módulotransferenciasactivo.src/config/tours.spec.ts— lista canónica de módulos activos.src/components/__tests__/transferencias-tour.test.tsx(nuevo) — 6 pruebas: fila única de filtros, anclajes, «1 / 23», «1 / 11» sin filas, «1 / 11» con error y «1 / 14» del formulario.
✅ Verificación
transferencias-tour.test.tsx: 6/6 en verde.tsc --noEmitlimpio.
📄 Requerimiento: SREQ-UX-04: Tour guiado por funcionalidad
