Una página por visual: catálogo de visuales.
Conteo certificado#
El catálogo único de visuales del producto tiene 46 visuales de datos + 4 elementos de diseño = 50 ítems. El mismo catálogo alimenta la pestaña Insertar (crea un visual nuevo) y la pestaña Visual (cambia el tipo del seleccionado), con los mismos íconos y colores.
El catálogo tiene 50 ítems: 46 visuales de datos y 4 elementos de diseño (texto, forma, imagen, botón).
Ningún visual es un mock: todos tienen un componente React dedicado (Recharts o SVG propio), y todo ítem del catálogo exige una muestra sintética de datos de referencia — la suite falla si falta. Comparados con Power BI, los ~40 nativos están empatados o superados (incluye lo que allá es un custom visual pago: sankey, marimekko, bullet), y los mapas de Brasil con malla municipal del IBGE son superiores a lo que Power BI trae de fábrica. Es una equivalencia por ítem, con evidencia — no afirmamos paridad total.
El sistema de visuales (plantilla)#
-
Qué es — una familia de 46 visuales de datos renderizados en el navegador, más 4 elementos de diseño.
-
Cuándo usarlo — todo dashboard; la elección del tipo depende de la pregunta (comparar, componer, distribuir, relacionar, mapear).
-
Cómo funciona — los datos pasan por un pipeline único de filas (agregaciones sum/avg/min/max/last/count, Top-N, ordenación) y el visual recibe filas listas; una matriz de capacidades por visual (ejes, leyenda, etiquetas, apilado, ordenación, líneas de referencia, eje secundario, small multiples, totales, formato) define lo que admite cada tipo.
-
Requisitos previos — un modelo/consulta que produzca la dimensión + hasta 5 métricas por visual (selector de campos).
-
Cómo validar — crea "Ingresos por categoría" (barras), agrega una 2.ª métrica, activa las etiquetas y una línea de referencia; confirma cada opción en el visual.
-
Límites y salvedades — la transformación de datos y la geometría de cada visual están cubiertas por pruebas automáticas; la apariencia final depende del navegador.
-
Datos de ejemplo (sintéticos)
categoría ingresos Bebidas 250 Limpeza 90 Higiene 140 -
Evidencia — catálogo de visuales, pipeline de filas y matriz de capacidades por visual cubiertos por una suite determinística; cada ítem exige una muestra sintética; el pipeline de filas está congelado por el conjunto de pruebas de referencia, con resultado idéntico en cada ejecución.
Catálogo completo (46 de datos + 4 de diseño)#
Render: Recharts, SVG propio (custom) o HTML. "Cómo validar cada uno": crea el visual desde la pestaña Insertar con los campos indicados y revisa el resultado; cada visual tiene una muestra sintética de referencia.
KPI y tarjetas (3)
| # | id | Visual | Render | Campos mínimos para validar |
|---|---|---|---|---|
| 1 | kpi | KPI | custom | 1 métrica (Receita) |
| 2 | kpi-spark | KPI + tendencia | custom | 1 métrica + 1 tiempo |
| 3 | multikpi | Multi-KPI | custom | varias métricas |
Comparación y tendencia (6)
| # | id | Visual | Render | Campos mínimos para validar |
|---|---|---|---|---|
| 4 | bar | Barras | Recharts | dimensión + métrica |
| 5 | hbar | Barras horizontales | Recharts | dimensión + métrica |
| 6 | line | Línea | Recharts | tiempo + métrica |
| 7 | area | Área | Recharts | tiempo + métrica |
| 8 | combo | Combo barra+línea | Recharts | dimensión + 2 métricas |
| 26 | combo-stack | Columnas apiladas + línea | SVG | dimensión + serie + métrica |
Composición y parte del todo (7)
| # | id | Visual | Render | Campos mínimos para validar |
|---|---|---|---|---|
| 9 | pie | Torta | Recharts | dimensión + métrica |
| 10 | donut | Dona | Recharts | dimensión + métrica |
| 16 | treemap | Treemap | Recharts | dimensión + métrica |
| 11 | funnel | Embudo | Recharts | etapas + métrica |
| 17 | waterfall | Cascada | custom | pasos + variación |
| 32 | mekko | Marimekko (participación) | SVG | 2 dimensiones + métrica |
| 33 | ribbon | Ribbon (cambio de puesto) | SVG | tiempo + categoría + métrica |
Medidores y metas (4)
| # | id | Visual | Render | Campos mínimos para validar |
|---|---|---|---|---|
| 12 | gauge | Velocímetro | Recharts/custom | 1 métrica + objetivo |
| 13 | thermometer | Termómetro | custom | 1 métrica + objetivo |
| 21 | bullet | Bullet (meta) | SVG | métrica + meta + franjas |
| 23 | progress | Anillo de progreso | SVG | métrica + objetivo |
Distribución y estadística (5)
| # | id | Visual | Render | Campos mínimos para validar |
|---|---|---|---|---|
| 18 | histogram | Histograma | custom/Recharts | 1 métrica continua |
| 19 | pareto | Pareto (80/20) | custom | dimensión + métrica |
| 20 | boxplot | Box plot | custom | grupo + métrica |
| 15 | scatter | Dispersión | Recharts | 2 métricas |
| 22 | quadrant | Dispersión con cuadrantes | SVG | 2 métricas + cortes |
Relación y comparación por pares (5)
| # | id | Visual | Render | Campos mínimos para validar |
|---|---|---|---|---|
| 14 | radar | Radar | Recharts/custom | ejes + serie |
| 24 | dumbbell | Mancuerna (antes × después) | SVG | categoría + 2 valores |
| 30 | slope | Slope (antes × después) | SVG | 2 períodos + métrica |
| 31 | tornado | Tornado (espejado) | SVG | categoría + 2 series |
| 34 | network | Red (quién se conecta con quién) | SVG | nodos + aristas |
Tiempo, flujo y plazo (5)
| # | id | Visual | Render | Campos mínimos para validar |
|---|---|---|---|---|
| 25 | calendar | Calendario (estacionalidad) | SVG | fecha + métrica |
| 27 | gantt | Gantt (cronograma) | SVG | tarea + inicio + fin |
| 28 | sankey | Flujo (origen → destino) | SVG | origen + destino + flujo |
| 36 | timeline | Línea de tiempo (período) | SVG | evento + período |
| 44 | motion | Burbujas en el tiempo (animado) | Recharts+anim | 2 métricas + tiempo |
Tablas (4)
| # | id | Visual | Render | Campos mínimos para validar |
|---|---|---|---|---|
| 37 | table | Tabla (con totales) | HTML | columnas |
| 38 | matrix | Matriz (filas × columnas) | HTML | filas + columnas + valor |
| 46 | pivot | Tabla dinámica (arrastrar) | HTML+drag | campos arrastrables |
| 39 | heatmap | Heatmap | HTML | 2 dimensiones + métrica |
Vitrina y texto de datos (2)
| # | id | Visual | Render | Campos mínimos para validar |
|---|---|---|---|---|
| 29 | wordcloud | Nube de palabras | SVG | término + peso |
| 35 | imagecard | Tarjeta con imagen | SVG | etiqueta + imagen + métrica |
Mapas de Brasil (5)
| # | id | Visual | Render | Campos mínimos para validar |
|---|---|---|---|---|
| 40 | map | Mapa de Brasil (UF) | SVG propio | UF + métrica |
| 41 | mapcity | Mapa por municipio | SVG (IBGE) | municipio + métrica |
| 42 | bubblemap | Mapa de burbujas (lat/long) | SVG | lat/long + métrica |
| 43 | geoheat | Mapa de calor geográfico | SVG | lat/long + intensidad |
| 45 | maplayers | Mapa con capas | SVG | capas geográficas |
Elementos de diseño (4 — no son visuales de datos)
| # | id | Elemento | Render |
|---|---|---|---|
| E1 | text | Texto | custom |
| E2 | shape | Forma | custom |
| E3 | image | Imagen | custom |
| E4 | button | Botón (con acciones) | custom |
Mapas de Brasil (diferencial)#
- Qué es — 5 mapas nativos de Brasil: por UF, por municipio (malla del IBGE), burbujas lat/long, calor geográfico y capas.
- Cuándo usarlo — distribución regional de ventas/clientes; densidad por ciudad.
- Cómo funciona — el mapa por UF usa SVG propio (27 UF); el mapa por municipio
carga la malla del estado bajo demanda mediante una ruta interna
(
/api/geo/br/[uf]) con caché de 30 días; la categoría de dato UF/municipio del modelo orienta el join geográfico. - Requisitos previos — una columna marcada como UF/municipio (consulta la categoría de dato en Modelo semántico); para el municipio, la malla del estado tiene que buscarse (red).
- Cómo validar — marca
filiais.ufcomo UF, crea el mapa por UF de "Ingresos por estado" con SP/RJ/MG y revisa el relleno; después abre el mapa por municipio de un estado y confirma que la malla se carga. - Límites y salvedades — la malla municipal viene del IBGE y queda en caché: la primera carga de un estado puede tardar más que las siguientes.
- Datos de ejemplo (sintéticos) — Ingresos por UF: SP=250, RJ=90, MG=140.
- Evidencia — renderizado de los mapas y geometría de la malla (UF y municipio) cubiertos por una suite determinística; la malla municipal se sirve por una ruta interna con caché.
Elementos de diseño (texto, forma, imagen, botón)#
- Qué es — elementos sin datos: cuadro de texto, forma, imagen y botón con acciones.
- Cuándo usarlo — títulos, marcos, logotipo, navegación por botón.
- Cómo funciona — el botón dispara acciones (p. ej., aplicar un marcador, cambiar de página); la imagen/forma/texto son puramente visuales.
- Requisitos previos — ninguno.
- Cómo validar — agrega un botón "Ir al Detalle" que cambie de página y confirma la navegación.
- Límites y salvedades — no cuentan como visuales de datos (por eso son 46, no 50).
- Datos de ejemplo (sintéticos) — título "Aurora Varejo — Julio/2026".
- Evidencia — renderizado y acciones de los elementos de diseño (texto/forma/imagen/botón) cubiertos por la lógica probada del editor.
Sobre drill, tooltips y exportación por visual: consulta Filtros e interacciones y Exportación y distribución.