Hallazgo central: todo filtro/segmentador es del lado del cliente sobre el snapshot — nunca se convierte en SQL. Eso tiene tres consecuencias buenas: costo cero por interacción, ninguna superficie de inyección a través del segmentador, y el límite pasa a ser lo que está en el snapshot. Los ejemplos usan el workspace sintético Comércio Aurora Ltda.
Segmentadores (8 tipos) y ámbitos#
- Qué es — 8 tipos de segmentador:
select,daterange,buttons,range,hier(encadenado),number("y si"),field(campo-parámetro) ymeasure. - Cuándo usarlo — recortar el panel por categoría, período, rango; o cambiar campo/medida (field/measure) y simular un número (number/what-if).
- Cómo funciona — cada segmentador tiene un ámbito: dashboard, página o por
visual (destino); búsqueda en el filtro (≥20 opciones), selección múltiple (OR/AND),
seleccionar todo/limpiar. Sincronización entre páginas (
syncPages): un control en una página vale en todo el panel. - Requisitos previos — snapshot con las columnas que usa el segmentador.
- Cómo validar — agrega un
selectdeprodutos.categoriaen el ámbito del dashboard, selecciona "Bebidas" y confirma que todos los visuales se recortan; cambia el ámbito a un solo visual y confirma el aviso cuando "no alcanza nada". - Límites y salvedades — el filtro personal por usuario (segmentador personal) está en
Roadmap; lo que existe por usuario es la RLS (consulta Seguridad). Los segmentadores operan sobre el snapshot, no sobre la base en vivo. - Datos de ejemplo (sintéticos) — categorías {Bebidas, Limpeza, Higiene}; seleccionar "Bebidas" deja solo ingresos=250.
- Evidencia (código/prueba) —
DASH_FILTER_TYPESendashboard-widgets.ts; renders endashboard-filters.tsx; pruebas de segmentadores.
Fechas relativas#
- Qué es — presets de período: hoy, 7d, 30d, mes, año, y el genérico
-Nd/-Nw/-Nm/-Ny(estilo Power BI), en la zona horaria del panel. - Cuándo usarlo — unos "últimos 30 días" que avanzan solos cada día.
- Cómo funciona —
presetRangecalcula la ventana en la zona horaria configurada del panel. - Requisitos previos — una columna de fecha en el snapshot.
- Cómo validar — configura "últimos 30 días" y confirma que el intervalo se desplaza al cambiar la fecha de referencia.
- Límites y salvedades — depende de la zona horaria del panel (America/Sao_Paulo por defecto).
- Datos de ejemplo (sintéticos) — hoy=2026-07-31 → ventana 2026-07-02..07-31.
- Evidencia (código/prueba) —
presetRange(dashboard-widgets.ts) + prueba.
Filtro cruzado / resaltado cruzado y editor de interacciones#
- Qué es — hacer clic en un visual resalta la selección y recorta los demás; y un editor de interacciones origen→destino para definir, por par de visuales, si la acción es Filtrar / Resaltar / Ignorar.
- Cuándo usarlo — el gesto que "se parece a Power BI": hacer clic en una barra y ver reaccionar el resto del panel.
- Cómo funciona — el clic aplica el filtro cruzado (Ctrl acumula; volver a hacer clic limpia); el editor de pares define el modo por destino, heredando el modo global ("predeterminado") y con vista previa en memoria antes de guardar; saneamiento con allowlist (modos válidos, ids existentes, sin autorreferencia, tope de pares). La misma semántica vale en el visor autenticado, en el público y en el embed.
- Requisitos previos — dos o más visuales en la página.
- Cómo validar — en el editor de interacciones, define "Barras de categoría → Tabla = Filtrar"; haz clic en una barra y confirma que la tabla se recorta; cambia a "Ignorar" y confirma que la tabla no reacciona.
- Límites y salvedades — la persistencia de la selección entre sesiones es parcial (ver abajo).
- Datos de ejemplo (sintéticos) — hacer clic en "Bebidas" en las barras filtra la tabla a los ítems de Bebidas.
- Evidencia (código/prueba) —
interactions-editor.tsx,interactions-sanitize.ts+ prueba;applyCrossFilter(dashboard-widgets.ts);dashboard-view.tsx.
Drill-down / drill-up#
- Qué es — bajar/subir niveles por jerarquía de columnas y por fechas (año → mes → día).
- Cuándo usarlo — explorar de "Región" hasta "Ciudad", o de año hasta día.
- Cómo funciona —
config.drillsobre la jerarquía; etiquetas de contexto + botón de drill-up; las fechas usandateBucket. - Requisitos previos — jerarquía definida en el modelo (consulta Modelo semántico).
- Cómo validar — en un visual con la jerarquía
Região > UF > Cidade, haz clic para bajar de Sudeste a São Paulo y usa drill-up para volver. - Límites y salvedades — el drill opera sobre el snapshot del visual.
- Datos de ejemplo (sintéticos) — Sudeste → SP → São Paulo.
- Evidencia (código/prueba) —
config.drill(dashboard-widgets.ts),dashboard-filters.tsx.
Drill-through entre páginas#
- Qué es — saltar a otra página llevando el contexto (por columna), automático al hacer clic o mediante un botón, con una etiqueta "volver".
- Cuándo usarlo — hacer clic en un producto e ir a la página de detalle de ese producto.
- Cómo funciona —
DashPageTab.drillthroughdefine la columna clave; el destino nace filtrado por el valor en el que se hizo clic. - Requisitos previos — página de destino configurada como objetivo de drill-through.
- Cómo validar — configura "Detalle del producto" como destino por
produtos.id; haz clic en un producto en la visión general y confirma que la página de detalle ya está filtrada. - Límites y salvedades — el contexto se pasa por la columna configurada.
- Datos de ejemplo (sintéticos) — hacer clic en el producto id=10 abre "Detalle" con
produto_id=10. - Evidencia (código/prueba) —
DashPageTab.drillthrough,dashboard-filters.tsx.
Tooltips y páginas de tooltip (tooltip pages)#
- Qué es — tooltips con campos extra, tooltip enriquecido (contenido más allá del número) y páginas de tooltip (una página entera del panel como tooltip, estilo Power BI).
- Cuándo usarlo — mostrar detalles al pasar el mouse sin saturar el visual.
- Cómo funciona —
config.tooltipFields/tooltipPage; la página de tooltip queda oculta de la barra y aparece al pasar el mouse sobre el punto. - Requisitos previos — campos extra y/o una página marcada como tooltip.
- Cómo validar — agrega
produtos.marcacomo campo de tooltip y confirma que aparece al pasar el mouse; crea una tooltip page y confirma la vista previa. - Límites y salvedades — el tooltip enriquecido es contenido estructurado; el motor de datos es el mismo del visual de origen.
- Datos de ejemplo (sintéticos) — tooltip de "Ingresos por categoría" mostrando marca y n.º de pedidos.
- Evidencia (código/prueba) —
dashboard-tooltip.ts(+15 pruebas),tooltip-rich.ts+ prueba.
Marcadores (bookmarks)#
- Qué es — hasta 10 marcadores que guardan el estado completo del panel, aplicables mediante un botón.
- Cuándo usarlo — guardar la "vista ejecutiva" y la "vista detallada" y alternar con un clic.
- Cómo funciona — el marcador guarda selecciones/filtros/estado; un botón puede aplicarlo.
- Requisitos previos — un estado configurado para guardar.
- Cómo validar — configura filtros, guárdalos como marcador "Julio", cambia todo y aplica el marcador para restaurar.
- Límites y salvedades — los marcadores son del dashboard, no por usuario.
- Datos de ejemplo (sintéticos) — marcador "Bebidas · Julio".
- Evidencia (código/prueba) —
saveBookmarksAction,dashboard-filters.tsx.
Persistencia y compartir selecciones por URL#
- Qué es — la selección viaja en la URL (
?f=, base64url) para compartir una vista filtrada. - Cuándo usarlo — enviar un enlace ya filtrado a un colega.
- Cómo funciona — la URL guarda selección + fecha; los parámetros (field/measure/what-if) también viajan por el códec de estado.
- Requisitos previos — filtros/parámetros aplicados.
- Cómo validar — filtra "Bebidas", copia la URL, ábrela en otra pestaña y confirma el filtro restaurado.
- Límites y salvedades — rango/jerarquía no sobreviven solo con la URL (dependen de un marcador); no hay autoguardado por usuario.
- Datos de ejemplo (sintéticos) —
?f=…con categoría=Bebidas, período=Julio. - Evidencia (código/prueba) —
dashboard-filters.tsx(?f=),url-state.ts.