Communitygithub.com

Sistema de Visualização de Dados

Projete e implemente uma estrutura sistemática para gráficos e tabelas, gerenciando hierarquia visual, teoria de cores acessível e comportamento responsivo para transformar dados complexos em insights acionáveis.

O que é Sistema de Visualização de Dados?

O Sistema de Visualização de Dados fornece uma metodologia abrangente para projetar gráficos e tabelas que comunicam claramente tendências, comparações e distribuições. Ele estabelece regras para seleção de gráficos, normalização óptica, codificação de cores acessível e reflow responsivo, prevenindo 'ruído visual' e sobrecarga cognitiva. O sistema suporta plataformas como SaaS Dashboards, Financial Reports e Analytics Platforms, e oferece um fluxo de trabalho estruturado que inclui identificar o objetivo de comunicação, selecionar o tipo de gráfico apropriado (linha, barra, pizza, dispersão), aplicar hierarquia visual com rotulagem direta e garantir acessibilidade com paletas seguras para daltônicos e redundância de codificação. Decisões de design como a 'Regra do Zero' para gráficos de barras e a 'Regra Sem Pizza' para evitar sobrecarga de categorias garantem precisão e clareza, enquanto restrições de responsividade e acessibilidade garantem que os gráficos funcionem em qualquer dispositivo.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/data-visualization-system

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Sistema de Visualização de Dados faz?

Propósito

O Sistema de Visualização de Dados fornece uma metodologia para projetar gráficos e tabelas que se situam acima do nível de métricas individuais. Ele garante que relações quantitativas—como tendências ao longo do tempo, comparações entre categorias e distribuições de valores—sejam comunicadas de forma clara, precisa e acessível. Este sistema previne "ruído visual" e sobrecarga cognitiva, estabelecendo regras para seleção de gráficos, normalização óptica, codificação de cores acessível e reflow responsivo.

Casos de Uso

  • Dashboards SaaS: Visualizando crescimento de usuários, tendências de receita ou desempenho do sistema.
  • Relatórios Financeiros: Mostrando distribuições de portfólio, categorias de despesas ou flutuações de mercado.
  • Plataformas de Analytics: Exibindo fontes de tráfego, funis de conversão ou coortes comportamentais.
  • Relatórios de Impacto e Sustentabilidade: Visualizando métricas ambientais ou dados de impacto social ao longo do tempo.
  • Aplicativos de Saúde e Fitness: Acompanhando sinais vitais, níveis de atividade ou progresso em direção a metas.

Quando NÃO Usar

  • Números Únicos de Alto Impacto: Para KPIs isolados (ex: "Receita Total: $10k"), use sistema-de-metricas-e-estatisticas.
  • Dados Brutos com Múltiplos Atributos: Se o usuário precisar ler valores específicos para 20+ itens em várias colunas, use sistema-de-tabela-de-dados-ui.
  • Infográficos Puramente Decorativos: Quando o objetivo é expressão artística ou narrativa com gráficos não dinâmicos e não orientados a dados.
  • Status Passo a Passo: Para processos lineares (ex: "Etapa 2 de 4"), use sistema-de-progresso-por-etapas.

Entradas

  1. Objetivo do Usuário: O que o usuário está tentando entender? (Comparação, Tendência, Distribuição ou Parte-Todo).
  2. Tipo de Dado: Os dados são categóricos (ex: "Tipo de Navegador"), temporais (ex: "Vendas por Mês") ou quantitativos (ex: "Preço vs. Qualidade")?
  3. Cardinalidade: Quantos itens ou séries precisam ser exibidos simultaneamente?
  4. Restrições de Dispositivo: Viewports alvo e modos de interação (Toque vs. Mouse).
  5. Tokens da Marca: Paleta, tipografia e espaçamento do sistema de design pai.

Saídas

  1. Mapa de Seleção de Gráfico: O tipo de gráfico escolhido (Linha, Barra, Pizza, Dispersão) com base no objetivo e nos dados.
  2. Especificação de Cores Acessível: Uma paleta que permanece distinguível para usuários com daltonismo (Protanopia, Deuteranopia, Tritanopia).
  3. Especificação de Anatomia e Rotulagem: Regras para títulos de eixos, legendas, dicas de ferramentas e marcadores de dados.
  4. Mapa de Transição Responsiva: Como o gráfico se adapta de desktop para mobile (ex: mudanças de orientação, simplificação de dados).

Fluxo de Trabalho

1. Identificar o Objetivo de Comunicação

Antes de escolher um gráfico, defina o que os dados devem "dizer":

  • Tendência ao Longo do Tempo: Use um Gráfico de Linha ou Gráfico de Área.
  • Comparação de Categorias: Use um Gráfico de Barras (Vertical ou Horizontal).
  • Relação Parte-Todo: Use um Gráfico de Rosca ou Treemap (Evite gráficos de Pizza padrão para >3 categorias).
  • Correlação/Distribuição: Use um Gráfico de Dispersão ou Histograma.

2. Selecionar e Normalizar o Tipo de Gráfico

Aplique as regras "Verdade nos Dados" para garantir precisão:

  • A Regra da Linha de Base Zero: Gráficos de barras DEVEM começar em uma linha de base zero no eixo de valores para evitar exagerar diferenças.
  • A Regra da "Proporção de Aspecto": Para gráficos de linha, mantenha uma proporção de aspecto equilibrada (geralmente 2:1 ou 3:2) para que as inclinações não sejam artificialmente acentuadas ou suavizadas.
  • Geometria Minimalista: Remova elementos não essenciais "lixo de gráfico" como efeitos 3D, linhas de grade pesadas ou sombras que não transmitem dados.

3. Estabelecer Hierarquia Visual e Rotulagem

Aplique sistema-de-hierarquia-visual aos componentes do gráfico:

  • Rotulagem Direta: Sempre que possível, rotule as séries de dados diretamente ao lado das linhas/barras em vez de usar uma legenda separada para reduzir a fadiga de rastreamento ocular.
  • Ênfase: Use uma cor de alto contraste para a série de dados "Atual" ou "Alvo" e neutros suaves para dados históricos ou de referência.
  • Hierarquia de Contexto: Os títulos dos eixos devem estar presentes, mas subordinados (menores/mais claros) em relação aos dados primários e ao título do gráfico.

4. Aplicar Cor e Padrão Acessíveis

Garanta que os dados sejam perceptíveis por todos:

  • Paletas Seguras para Daltônicos: Use matizes distintos e passos de luminosidade variados. Evite emparelhar apenas Vermelho e Verde para indicar "Ruim" vs. "Bom"; use Vermelho/Azul ou adicione ícones/símbolos.
  • Codificação Redundante: Use mais do que apenas cor. Adicione linhas tracejadas, formas de marcadores diferentes (círculos, quadrados, triângulos) ou padrões/texturas distintos para diferenciar séries.
  • Contraste: Garanta que todo o texto (rótulos, eixos) atenda ao contraste WCAG AA (4,5:1) contra o fundo.

5. Projetar para Interação e Responsividade

  • Divulgação Progressiva: Use dicas de ferramentas para mostrar valores exatos ao passar o mouse/tocar, para que o gráfico permaneça limpo e escaneável.
  • Reflow Responsivo:
    • Horizontal para Vertical: Um gráfico de barras verticais largo no desktop deve mudar para um gráfico de barras horizontais no mobile para evitar rolagem horizontal.
    • Redução de Dados: No mobile, reduza o número de rótulos do eixo X (ex: mostrar a cada dois meses) ou agregue pontos de dados.
    • Bloqueio de Proporção de Aspecto: Garanta que o gráfico mantenha sua legibilidade; use aspect-ratio em CSS para reservar espaço e evitar CLS.

Regras de Decisão

  • A "Regra Sem Pizza": Evite gráficos de Pizza/Rosca se você tiver mais de 5 categorias ou se as diferenças entre as categorias forem pequenas. Use um gráfico de Barras Horizontais.
  • Rotulagem em vez de Legendas: Se uma legenda for necessária, coloque-a o mais próximo possível dos dados (ex: acima do gráfico ou alinhada à direita) em vez de no fundo absoluto.
  • Sucesso Monocromático: Um bom gráfico ainda deve ser compreensível se impresso em escala de cinza. Se não for, as escolhas de cor ou marcadores são muito dependentes apenas do matiz.
  • Precisão vs. Escaneamento: Em dashboards, arredonde valores (ex: 1,2M vs. 1.242.301) para escaneamento instantâneo. Mantenha alta precisão para as dicas de ferramentas.

Restrições

  • Acessibilidade: Os gráficos devem ter uma tabela de dados acompanhante ou um aria-label descritivo resumindo o insight principal. Use role="graphics-document" ou role="img" com um aria-label. Garanta que todos os elementos interativos (marcadores) atendam ao tamanho mínimo alvo de 24x24px.
  • Responsividade: Os gráficos nunca devem ter uma largura fixa em pixels; devem ser fluidos. Para gráficos SVG complexos, use viewBox para escalonamento.
  • Hierarquia: O título do gráfico deve ser o texto mais proeminente, seguido pelos próprios dados.

Padrões Comuns de Falha

  • Sobrecarga de Gráfico de Pizza: Tentar mostrar 10 fatias em um gráfico de pizza, tornando as menores impossíveis de distinguir.
  • Eixo Truncado: Iniciar um gráfico de barras em um valor diferente de zero para fazer uma pequena diferença parecer enorme (design enganoso).
  • Dependência Apenas de Cor: Diferenciar 5 linhas em um gráfico de linha usando apenas tons semelhantes de azul, tornando-o inacessível para usuários daltônicos.
  • Fadiga de Legenda: Forçar o usuário a olhar para frente e para trás entre uma chave de cores e os dados 10 vezes para entender o gráfico.
  • Gráficos Mobile Transbordantes: Não ajustar o tipo de gráfico ou a rotulagem para mobile, resultando em texto minúsculo e ilegível ou layouts quebrados.

Critérios de Validação

  • A seleção do tipo de gráfico corresponde ao objetivo de comunicação (ex: Linha para Tendência).
  • Gráficos de barras começam em uma linha de base zero.
  • A paleta de cores é segura para daltônicos e usa codificação redundante (marcadores/padrões).
  • A rotulagem direta é usada onde o espaço permite; legendas são colocadas em proximidade próxima.
  • O gráfico é fluido e se adapta corretamente ao mobile (ex: reflow horizontal).
  • Acessibilidade: aria-label fornece um resumo dos dados/insight.
  • Interação: Dicas de ferramentas fornecem dados precisos ao passar o mouse/tocar.
  • Todo o texto atende ao contraste WCAG AA (4,5:1).

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

Habilidades Relacionadas