Saltar al contenido principal

SREQ-UX-04 · Tour guiado de Transferencias entre almacenes

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

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​

#AnclajeQué explica
1transferencias.contenidoLa pantalla y el flujo completo (pendiente → en tránsito → recibida / cancelada)
2transferencias.offlineAviso de modo sin conexión (solo si aparece)
3transferencias.tituloEl módulo y su pestaña de trabajo
4transferencias.subtituloLa regla: el origen despacha, el destino confirma
5transferencias.boton.recargarLa flecha circular: refresca sin perder filtros ni página
6transferencias.boton.nuevaEl +: crea en pendiente, sin tocar stock
7transferencias.boton.ayudaEl (?) y el recorrido del formulario
8transferencias.filtrosLa card: título y campos en una fila, sin botón «Aplicar»
9transferencias.filtros.tituloEl embudo y la palabra «Filtros» que antes no existían
10transferencias.filtros.estadoLos cinco valores del filtro por fase
11transferencias.filtros.almacenFiltra por bodega en cualquiera de las dos puntas
12transferencias.cargando«Cargando…» frente a «no hay datos»
13transferencias.errorError de consulta y cómo reintentar
14transferencias.vacioEstado vacío
15transferencias.tablaEl histórico, de la más reciente a la más antigua
16transferencias.tabla.encabezadoLas seis columnas
17-24transferencias.tabla.fila y sus celdasAnatomía de una fila: código, ruta con flecha, líneas, estado, fecha y acciones
25-27transferencias.tabla.boton.enviar, .cancelar, .recibirCada acción con su efecto real en el stock y su confirmación
28transferencias.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.

AnclajeQué explica
transferencias.dialogoLa modal y que nada toca el inventario hasta el envío
transferencias.dialogo.titulo / .descripcionTítulo y consecuencia del alta
transferencias.dialogo.origen / .destinoSelectores con la bodega opuesta deshabilitada
transferencias.dialogo.avisoAviso rojo si origen y destino coinciden (solo si se pinta)
transferencias.dialogo.productosLa sección de líneas
transferencias.dialogo.boton.agregar-lineaAñadir líneas
transferencias.dialogo.lineaAnatomía de una línea
transferencias.dialogo.linea.productoProducto con SKU y nombre (caché offline)
transferencias.dialogo.linea.cantidadCantidad mínima 1
transferencias.dialogo.linea.quitarPapelera (deshabilitada con una sola línea)
transferencias.dialogo.observacionesNotas para el destino, hasta 1000 caracteres
transferencias.dialogo.boton.cancelar / .crearCerrar 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 con useTourOpcional; card de filtros en una fila con título e icono; aria-hidden en los iconos decorativos.
  • src/config/tours.ts — pasosTransferencias(estado) (23) y pasosNuevaTransferencia(estado) (14), con el módulo transferencias activo.
  • 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 --noEmit limpio.

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