Pular para o conteúdo

Visuais

Nesta página (16)

Uma página por visual: catálogo de visuais.

Contagem certificada#

O catálogo único de visuais do produto tem 46 visuais de dados + 4 elementos de layout = 50 itens. O mesmo catálogo alimenta a aba Inserir (cria um visual novo) e a aba Visual (troca o tipo do selecionado), com os mesmos ícones e cores.

O catálogo tem 50 itens: 46 visuais de dados e 4 elementos de layout (texto, forma, imagem, botão).

Nenhum visual é mock: todos têm componente React dedicado (Recharts ou SVG próprio), e todo item do catálogo exige uma amostra sintética de dados de referência — a suíte falha se faltar. Comparado ao Power BI, os ~40 nativos são empatados/superados (inclui o que lá é custom visual pago: sankey, marimekko, bullet), e os mapas do Brasil com malha IBGE municipal são superiores ao out-of-the-box do Power BI. Isso é equivalência por item, com evidência — não afirmamos paridade total.


O sistema de visuais (template)#

  1. O que é — uma família de 46 visuais de dados renderizados no navegador, mais 4 elementos de layout.

  2. Quando usar — todo dashboard; a escolha do tipo depende da pergunta (comparar, compor, distribuir, relacionar, mapear).

  3. Como funciona — os dados passam por um pipeline único de linhas (agregações sum/avg/min/max/last/count, Top-N, ordenação) e o visual recebe linhas prontas; uma matriz de capacidades por visual (eixos, legenda, rótulos, empilhado, ordenação, linhas de referência, eixo secundário, small multiples, totais, formato) define o que cada tipo suporta.

  4. Pré-requisitos — um modelo/consulta que produza a dimensão + até 5 métricas por visual (seletor de campos).

  5. Como validar — crie "Receita por categoria" (barras), adicione uma 2ª métrica, ative rótulos e uma linha de referência; confirme cada opção no visual.

  6. Limites e ressalvas — a transformação de dados e a geometria de cada visual são cobertas por testes automáticos; a aparência final depende do navegador.

  7. Dados de exemplo (sintéticos)

    categoriareceita
    Bebidas250
    Limpeza90
    Higiene140
  8. Evidência — catálogo de visuais, pipeline de linhas e matriz de capacidades por visual cobertos por suíte determinística; cada item exige uma amostra sintética; o pipeline de linhas é congelado pelo conjunto de testes de referência, com resultado idêntico a cada execução.


Catálogo completo (46 de dados + 4 de layout)#

Render: Recharts, SVG próprio (custom) ou HTML. "Como validar cada um": crie o visual pela aba Inserir com os campos indicados e confira o resultado; cada visual tem uma amostra sintética de referência.

KPIs e cartões (3)

#idVisualRenderCampos mínimos p/ validar
1kpiKPIcustom1 métrica (Receita)
2kpi-sparkKPI + tendênciacustom1 métrica + 1 tempo
3multikpiMulti-KPIcustomvárias métricas

Comparação e tendência (6)

#idVisualRenderCampos mínimos p/ validar
4barBarrasRechartsdimensão + métrica
5hbarBarras horizontaisRechartsdimensão + métrica
6lineLinhaRechartstempo + métrica
7areaÁreaRechartstempo + métrica
8comboCombo barra+linhaRechartsdimensão + 2 métricas
26combo-stackColunas empilhadas + linhaSVGdimensão + série + métrica

Composição e parte-do-todo (7)

#idVisualRenderCampos mínimos p/ validar
9piePizzaRechartsdimensão + métrica
10donutRoscaRechartsdimensão + métrica
16treemapTreemapRechartsdimensão + métrica
11funnelFunilRechartsetapas + métrica
17waterfallCascatacustompassos + variação
32mekkoMarimekko (participação)SVG2 dimensões + métrica
33ribbonRibbon (troca de posto)SVGtempo + categoria + métrica

Medidores e meta (4)

#idVisualRenderCampos mínimos p/ validar
12gaugeVelocímetroRecharts/custom1 métrica + alvo
13thermometerTermômetrocustom1 métrica + alvo
21bulletBullet (meta)SVGmétrica + meta + faixas
23progressAnel de progressoSVGmétrica + alvo

Distribuição e estatística (5)

#idVisualRenderCampos mínimos p/ validar
18histogramHistogramacustom/Recharts1 métrica contínua
19paretoPareto (80/20)customdimensão + métrica
20boxplotBox plotcustomgrupo + métrica
15scatterDispersãoRecharts2 métricas
22quadrantDispersão com quadrantesSVG2 métricas + cortes

Relação e comparação par-a-par (5)

#idVisualRenderCampos mínimos p/ validar
14radarRadarRecharts/customeixos + série
24dumbbellHaltere (antes × depois)SVGcategoria + 2 valores
30slopeSlope (antes × depois)SVG2 períodos + métrica
31tornadoTornado (espelhado)SVGcategoria + 2 séries
34networkRede (quem se liga a quem)SVGnós + arestas

Tempo, fluxo e prazo (5)

#idVisualRenderCampos mínimos p/ validar
25calendarCalendário (sazonalidade)SVGdata + métrica
27ganttGantt (cronograma)SVGtarefa + início + fim
28sankeyFluxo (origem → destino)SVGorigem + destino + fluxo
36timelineLinha do tempo (período)SVGevento + período
44motionBolhas no tempo (animado)Recharts+anim2 métricas + tempo

Tabelas (4)

#idVisualRenderCampos mínimos p/ validar
37tableTabela (com totais)HTMLcolunas
38matrixMatriz (linhas × colunas)HTMLlinhas + colunas + valor
46pivotTabela dinâmica (arrastar)HTML+dragcampos arrastáveis
39heatmapHeatmapHTML2 dimensões + métrica

Vitrine e texto de dados (2)

#idVisualRenderCampos mínimos p/ validar
29wordcloudNuvem de palavrasSVGtermo + peso
35imagecardCartão com imagemSVGrótulo + imagem + métrica

Mapas do Brasil (5)

#idVisualRenderCampos mínimos p/ validar
40mapMapa do Brasil (UF)SVG próprioUF + métrica
41mapcityMapa por municípioSVG (IBGE)município + métrica
42bubblemapMapa de bolhas (lat/long)SVGlat/long + métrica
43geoheatMapa de calor geográficoSVGlat/long + intensidade
45maplayersMapa com camadasSVGcamadas geográficas

Elementos de layout (4 — não são visuais de dados)

#idElementoRender
E1textTextocustom
E2shapeFormacustom
E3imageImagemcustom
E4buttonBotão (com ações)custom

Mapas do Brasil (diferencial)#

  1. O que é — 5 mapas nativos do Brasil: por UF, por município (malha IBGE), bolhas lat/long, calor geográfico e camadas.
  2. Quando usar — distribuição regional de vendas/clientes; densidade por cidade.
  3. Como funciona — mapa por UF usa SVG próprio (27 UFs); o mapa por município carrega a malha do estado sob demanda via rota interna (/api/geo/br/[uf]) com cache de 30 dias; a categoria de dado UF/município do modelo orienta o join geográfico.
  4. Pré-requisitos — coluna marcada como UF/município (ver categoria de dado em Modelo semântico); para o município, a malha do estado precisa ser buscada (rede).
  5. Como validar — marque filiais.uf como UF, crie o mapa por UF de "Receita por estado" com SP/RJ/MG e confira o preenchimento; depois abra o mapa por município de um estado e confirme o carregamento da malha.
  6. Limites e ressalvas — a malha municipal vem do IBGE e fica em cache: o primeiro carregamento de um estado pode levar mais tempo que os seguintes.
  7. Dados de exemplo (sintéticos) — Receita por UF: SP=250, RJ=90, MG=140.
  8. Evidência — renderização dos mapas e geometria da malha (UF e município) cobertas por suíte determinística; a malha municipal é servida por rota interna com cache.

Elementos de layout (texto, forma, imagem, botão)#

  1. O que é — elementos sem dados: caixa de texto, forma, imagem e botão com ações.
  2. Quando usar — títulos, molduras, logotipo, navegação por botão.
  3. Como funciona — o botão dispara ações (ex.: aplicar bookmark, trocar página); imagem/forma/texto são puramente visuais.
  4. Pré-requisitos — nenhum.
  5. Como validar — adicione um botão "Ir para Detalhe" que troca de página e confirme a navegação.
  6. Limites e ressalvas — não contam como visuais de dados (por isso 46, não 50).
  7. Dados de exemplo (sintéticos) — título "Aurora Varejo — Julho/2026".
  8. Evidência — renderização e ações dos elementos de layout (texto/forma/imagem/botão) cobertas pela lógica testada do editor.

Sobre drill, tooltips e exportação por visual: ver Filtros e interações e Exportação e distribuição.

Links relacionados