Saltar al contenido principal

SREQ-UX-04 · Tour guiado de Solicitudes masivas

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

La carga masiva crea decenas de solicitudes de una sola vez, cada una con su cadena de aprobación y su descuento de presupuesto, y era la pantalla que más dudas dejaba: ¿qué pasa si una fila está mal?, ¿validar crea algo?, ¿dónde quedan los errores? Ahora tiene tour guiado al detalle, lanzado desde el icono (?) de la cabecera, junto a «Descargar plantilla».

🧭 Trece pasos fijos (siempre presentes)​

#AnclajeQué explica
1cargas-masivas.contenidoLa pantalla y sus tres zonas
2cargas-masivas.titulo«Solicitudes masivas»: carga en bloque del módulo
3cargas-masivas.subtituloLa regla de oro: una fila = una solicitud (y el código SOL-006)
4cargas-masivas.boton.plantillaBotón con icono de descarga: columnas obligatorias/opcionales y tolerancia de identificadores
5cargas-masivas.boton.ayudaEl icono (?): repite el recorrido sin perder lo cargado
6cargas-masivas.nueva-cargaIcono de hoja de cálculo y título del formulario
7cargas-masivas.nueva-carga.formatoLínea de formato y límites: 500 filas, 5 MB, columnas mínimas
8cargas-masivas.campo.archivoEtiqueta y selector del lote; botones deshabilitados sin archivo
9cargas-masivas.campo.procesoProceso de contratación opcional y su trazabilidad
10cargas-masivas.boton.validarIcono de aviso: ensayo que no crea ni consume presupuesto
11cargas-masivas.boton.procesarIcono de subida: parcial, crea solo las filas válidas
12cargas-masivas.historialCard del historial y qué se audita
13cargas-masivas.boton.refrescarFlecha circular: recarga el listado

➕ Pasos que se añaden si el elemento está en pantalla​

AnclajeCuándo
cargas-masivas.campo.archivo.hintHay un archivo elegido (nombre y tamaño en KB)
cargas-masivas.validacionTras «Validar sin crear» (resumen con el check verde)
cargas-masivas.validacion.erroresLa validación dejó filas con error
cargas-masivas.detalleHay una carga abierta (número, archivo y etiqueta de estado)
cargas-masivas.detalle.resumenTotales del detalle: creadas, errores y contratación
cargas-masivas.boton.erroresEsa carga tiene filas fallidas
cargas-masivas.detalle.tablaCon el detalle abierto (fila → error o «Solicitud #id»)
cargas-masivas.historial.tablaEl historial tiene cargas (columnas una a una)
cargas-masivas.boton.ver-filasEl historial tiene cargas
cargas-masivas.historial.vacioEl historial está vacío (se explica el aviso, no la tabla)

El recorrido completo llega a 22 pasos. Nada se resalta si no está pintado: la primera visita recorre los trece fijos más el aviso de historial vacío; con un archivo elegido y una validación con errores suma la pista del archivo, el resumen y la tabla de errores; y con una carga abierta entra el detalle completo.

🛠️ Cambios​

  • src/config/tours.ts — pasos fijos por título, subtítulo, icono (?), línea de formato, pista de archivo, resumen del detalle y estado vacío del historial, y pasosCargasMasivas(estado) que compone el orden visual.
  • src/pages/cargas-masivas.tsx — veintitrés anclajes (data-tour) y lanzamiento con el guion armado desde el estado real (archivo, validación, detalle y filas del historial).

✅ Verificación​

  • cargas-masivas-tour.test.tsx: composición del guion (14 con historial vacío y 22 completo) y recorridos en pantalla «1 / 14», «1 / 15» con cargas y «1 / 17» tras validar con errores.
  • tours.spec.ts y tour-host.test.tsx: chequeo cruzado de anclajes y guion base de catorce pasos.
  • tsc y ESLint limpios.

📄 Manual relacionado: Carga masiva de solicitudes (SOL-006).