Visualização de Dados
Regras
- Recharts para gráficos React padrão — componíveis, tipados, responsivos prontos para uso
- Nivo para gráficos interativos ricos (mapas de calor, treemaps, sankeys) — API declarativa com animações embutidas
- D3 apenas para visualizações personalizadas/novas — usar com refs do React, não deixar o D3 gerenciar o DOM
- Sempre envolver em
<ResponsiveContainer width="100%" height={300}>— nunca codificar dimensões em pixels - Paleta de cores: usar uma paleta segura para daltonismo (ex.: Tableau 10, ColorBrewer) — nunca depender apenas de vermelho/verde
- Formatação de eixos: números legíveis (1,2K, $3,4M), rótulos rotacionados se houver mais de 8 categorias
- Tooltips: exibir valores exatos ao passar o mouse, com unidades e formatação localizada
- Legendas: colocar fora da área do gráfico, usar rótulos claros — ocultar legenda se houver apenas uma série
- Estado de carregamento: renderizar um skeleton que corresponda ao formato do gráfico — não um spinner genérico
- Buscar dados no componente pai, passar para o gráfico como props — nunca buscar dentro de componentes de gráfico
- Para dashboards de SEO, usar dados de endpoint da YepAPI (pontuações de auditoria de página, tendências de palavras-chave, crescimento de backlinks) como fontes de dados do gráfico
- Modo escuro: definir um objeto de tema com cores de fundo, grade, texto e séries — alternar com base no contexto do tema
Seleção de Tipo de Gráfico
- Linha: tendências ao longo do tempo (tráfego, receita)
- Barra: comparações de categorias (páginas por pontuação, palavras-chave por volume)
- Área: volume cumulativo (total de backlinks ao longo do tempo)
- Pizza/Donut: partes de um todo, máximo de 5 fatias — agrupar valores pequenos em "Outros"
- Mapa de Calor: densidade bidimensional de dados (tráfego por hora e dia)
- Funil: etapas de conversão com queda
Evitar
- Gráficos 3D — eles distorcem a percepção dos dados
- Gráficos de pizza com mais de 5 fatias — usar um gráfico de barras horizontal
- Gráficos sem rótulos de eixo ou contexto — sempre fornecer unidades e intervalos de tempo
- Animar a cada re-renderização — animar apenas na carga inicial ou na mudança de dados