SREQ-UX-04 · Tour guiado de Solicitudes masivas
· 3 min de lectura
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)
| # | Anclaje | Qué explica |
|---|---|---|
| 1 | cargas-masivas.contenido | La pantalla y sus tres zonas |
| 2 | cargas-masivas.titulo | «Solicitudes masivas»: carga en bloque del módulo |
| 3 | cargas-masivas.subtitulo | La regla de oro: una fila = una solicitud (y el código SOL-006) |
| 4 | cargas-masivas.boton.plantilla | Botón con icono de descarga: columnas obligatorias/opcionales y tolerancia de identificadores |
| 5 | cargas-masivas.boton.ayuda | El icono (?): repite el recorrido sin perder lo cargado |
| 6 | cargas-masivas.nueva-carga | Icono de hoja de cálculo y título del formulario |
| 7 | cargas-masivas.nueva-carga.formato | Línea de formato y límites: 500 filas, 5 MB, columnas mínimas |
| 8 | cargas-masivas.campo.archivo | Etiqueta y selector del lote; botones deshabilitados sin archivo |
| 9 | cargas-masivas.campo.proceso | Proceso de contratación opcional y su trazabilidad |
| 10 | cargas-masivas.boton.validar | Icono de aviso: ensayo que no crea ni consume presupuesto |
| 11 | cargas-masivas.boton.procesar | Icono de subida: parcial, crea solo las filas válidas |
| 12 | cargas-masivas.historial | Card del historial y qué se audita |
| 13 | cargas-masivas.boton.refrescar | Flecha circular: recarga el listado |
➕ Pasos que se añaden si el elemento está en pantalla
| Anclaje | Cuándo |
|---|---|
cargas-masivas.campo.archivo.hint | Hay un archivo elegido (nombre y tamaño en KB) |
cargas-masivas.validacion | Tras «Validar sin crear» (resumen con el check verde) |
cargas-masivas.validacion.errores | La validación dejó filas con error |
cargas-masivas.detalle | Hay una carga abierta (número, archivo y etiqueta de estado) |
cargas-masivas.detalle.resumen | Totales del detalle: creadas, errores y contratación |
cargas-masivas.boton.errores | Esa carga tiene filas fallidas |
cargas-masivas.detalle.tabla | Con el detalle abierto (fila → error o «Solicitud #id») |
cargas-masivas.historial.tabla | El historial tiene cargas (columnas una a una) |
cargas-masivas.boton.ver-filas | El historial tiene cargas |
cargas-masivas.historial.vacio | El 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, ypasosCargasMasivas(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.tsytour-host.test.tsx: chequeo cruzado de anclajes y guion base de catorce pasos.tscy ESLint limpios.
📄 Manual relacionado: Carga masiva de solicitudes (SOL-006).
