Saltar al contenido principal

SREQ-UX-04 · La Bandeja de entrada estrena tour detallado

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

La Bandeja de entrada tenía un tour de seis pasos que agrupaba bloques enteros: «tarjetas de métricas», «columnas por estado». Se pidió el mismo nivel de detalle que en el resto de pantallas, así que ahora cada tarjeta de métrica es un paso, cada columna es un paso y las tarjetas de solicitud tienen el suyo, con el botón de despacho incluido.

🧭 Base de quince pasos (siempre presentes)​

#AnclajeQué explica
1bandeja-entrada.contenidoLa pantalla y sus cinco bloques
2bandeja-entrada.encabezadoTítulo, descripción y las dos ayudas de la cabecera
3bandeja-entrada.boton.estadisticasEl ojo: muestra u oculta las métricas (la preferencia se guarda)
4bandeja-entrada.metrica.este-anio«Este Año»: solicitudes del año, filtra al pulsar y se desactiva con otro clic
5bandeja-entrada.metrica.despachadas«Despachadas»: completadas y entregadas
6bandeja-entrada.metrica.pendientes«Pendientes»: sin aprobar ni despachar
7bandeja-entrada.metrica.novedades«Novedades»: rechazadas o canceladas
8bandeja-entrada.metrica.urgentes«Urgentes»: prioridad urgente en cualquier estado
9bandeja-entrada.busquedaBuscador por código, propósito, solicitante u oficina
10bandeja-entrada.boton.limpiar«Limpiar»: vacía el término
11bandeja-entrada.tableroEl tablero de columnas
12bandeja-entrada.columna.recien«Recién Solicitadas», con su contador y su estado vacío
13bandeja-entrada.columna.gestion«En Gestión»: aprobadas o en proceso
14bandeja-entrada.columna.entregadas«Entregadas»: completadas
15bandeja-entrada.detalleEl detalle de la solicitud activa

➕ Pasos que se añaden si existen en pantalla​

AnclajeCuándo
bandeja-entrada.tarjetaHay solicitudes en alguna columna (número, prioridad, propósito, fecha, solicitante)
bandeja-entrada.boton.despacharAlguna tarjeta permite despachar según rol y estado
bandeja-entrada.filtro.panelHay una métrica activa: el listado filtrado sustituye las columnas
bandeja-entrada.filtro.cerrarHay una métrica activa: botón «Cerrar»

Con el ojo apagado, el guion baja a diez pasos; con filtro activo cambia las tres columnas por el listado. El detalle sigue siendo el último paso en todos los casos.

🛠️ Cambios​

  • src/components/requests/request-inbox.tsx — anclajes por botón, métrica, columna, tarjeta y acción, y iniciarTour('bandeja-entrada', pasos) con el guion armado desde el estado real.
  • src/config/tours.ts — pasosBandejaEntrada(estado) con el bloque base y los condicionales.

✅ Verificación​

  • tours.spec.ts: composición del guion (15 pasos base; 10 sin métricas; 14 con filtro) y orden de los pasos condicionales.
  • bandeja-entrada-tour.test.tsx y tour-host.test.tsx actualizados al nuevo contador.
  • tsc y ESLint limpios.

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