Saltar al contenido principal

SREQ-UX-04 · Tour guiado del Tablero de Administración

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

El Tablero de Administración era la pantalla con más funciones concentradas y ninguna explicación dentro de la aplicación: tablero por rol, indicadores configurables, estados de publicación, plantillas compartidas y acciones por fila. Ahora tiene tour guiado detallado, lanzado a mano desde el icono (?) de la cabecera. Sigue el mismo patrón que el resto: sin auto-arranque y con pasos anclados a data-tour="tablero.*".

🧭 Ocho pasos base (siempre presentes)​

#AnclajeQué explica
1tablero.contenidoLa página y sus tres zonas: estado, indicadores y panel de tableros
2tablero.detalleNombre, categoría de rol, tipo (personalizado/sugerido), activo o previsualización y descripción
3tablero.boton.principal«Guardar tablero sugerido», «Agregar indicadores» o «Copiar para personalizar»
4tablero.boton.refrescarRecarga del tablero y del listado
5tablero.grillaLos indicadores, cada tarjeta con carga aislada
6tablero.listadoEl panel: mis tableros frente a plantillas del rol
7tablero.mis-tablerosSus tableros personales, con sus estados y metadatos
8tablero.plantillasPlantillas predefinidas y las publicadas por compañeros

➕ Pasos que se añaden cuando el elemento existe​

AnclajeCuándo
tablero.boton.volverEn previsualización de otro tablero
tablero.boton.publicarSi el tablero se puede editar (no es el sugerido)
tablero.widget.actualizarCon indicadores en pantalla
tablero.widget.abrirSi algún indicador tiene vista completa
tablero.accion.previsualizarCon tableros propios en el listado
tablero.accion.usarSi algún tablero propio no es el activo
tablero.accion.publicarCon tableros propios
tablero.accion.eliminarCon tableros propios
tablero.accion.copiarCon plantillas disponibles

Decisión de diseño: el guion se compone con pasosTablero(estado) al pulsar (?), así que el recorrido de un tablero sugerido sin filas propias es corto y honesto, y el de un tablero propio con plantillas llega hasta las diecisiete paradas sin resaltar nada que no exista.

🛠️ Cambios​

  • src/pages/tablero.tsx — botón (?) con el guion armado desde el estado real y anclajes tablero.boton.volver, .publicar, .principal y .refrescar.
  • src/components/tableros/widget-tile.tsx — anclajes tablero.widget.abrir y tablero.widget.actualizar.
  • src/components/tableros/listado-tableros-panel.tsx — anclajes por acción de fila: previsualizar, usar, publicar, eliminar y copiar.
  • src/config/tours.ts — pasosTablero(estado) con el bloque base y los condicionales.

✅ Verificación​

  • tours.spec.ts: composición del guion base (8) y completa (17) y chequeo cruzado de anclajes.
  • tableros-personalizados.test.tsx: anclajes en el DOM y lanzamiento del recorrido.
  • tsc y ESLint limpios.

📄 Documento del requerimiento: SREQ-UX-04: Tour guiado por funcionalidad.