SREQ-UX-04 · Tour guiado del Tablero de Administración
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)
| # | Anclaje | Qué explica |
|---|---|---|
| 1 | tablero.contenido | La página y sus tres zonas: estado, indicadores y panel de tableros |
| 2 | tablero.detalle | Nombre, categoría de rol, tipo (personalizado/sugerido), activo o previsualización y descripción |
| 3 | tablero.boton.principal | «Guardar tablero sugerido», «Agregar indicadores» o «Copiar para personalizar» |
| 4 | tablero.boton.refrescar | Recarga del tablero y del listado |
| 5 | tablero.grilla | Los indicadores, cada tarjeta con carga aislada |
| 6 | tablero.listado | El panel: mis tableros frente a plantillas del rol |
| 7 | tablero.mis-tableros | Sus tableros personales, con sus estados y metadatos |
| 8 | tablero.plantillas | Plantillas predefinidas y las publicadas por compañeros |
➕ Pasos que se añaden cuando el elemento existe
| Anclaje | Cuándo |
|---|---|
tablero.boton.volver | En previsualización de otro tablero |
tablero.boton.publicar | Si el tablero se puede editar (no es el sugerido) |
tablero.widget.actualizar | Con indicadores en pantalla |
tablero.widget.abrir | Si algún indicador tiene vista completa |
tablero.accion.previsualizar | Con tableros propios en el listado |
tablero.accion.usar | Si algún tablero propio no es el activo |
tablero.accion.publicar | Con tableros propios |
tablero.accion.eliminar | Con tableros propios |
tablero.accion.copiar | Con 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 anclajestablero.boton.volver,.publicar,.principaly.refrescar.src/components/tableros/widget-tile.tsx— anclajestablero.widget.abrirytablero.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.tscy ESLint limpios.
📄 Documento del requerimiento: SREQ-UX-04: Tour guiado por funcionalidad.
