Communitygithub.com

voytas75/design-de-dashboard-operacional

Use ao projetar dashboards operacionais.

O que é design-de-dashboard-operacional?

Este skill, chamado 'Design de Dashboard Operacional', define um processo rigoroso e orientado a dados para criar dashboards operacionais eficazes. Ele é útil para desenvolvedores e designers que precisam projetar ou revisar dashboards de KPIs, gráficos analíticos compactos ou sistemas visuais consistentes, ajudando os usuários a identificar exceções e agir sobre os dados. Suporta qualquer plataforma que possa gerar entregáveis como mockups, HTML, imagens ou dashboards funcionais, sem exigir bibliotecas ou serviços específicos. O fluxo principal segue a hierarquia 'visão geral → atenção → detalhe → ação', mantendo a visualização primária livre de frases explicativas, mas sem esconder informações essenciais para interpretar dados ou operar controles. Ele inclui etapas para estabelecer um contrato de dados, definir hierarquia e ações, escolher codificações visuais apropriadas, aplicar linguagem concisa e acessibilidade, e verificar a qualidade do artefato final por meio de uma checklist detalhada.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/voytas75/skills/tree/HEAD/skills/operational-dashboard-design

Perguntar na sua IA favorita

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

Documentação

Design de Dashboard Operacional

Construa um dashboard orientado a dados com o fluxo visão geral → atenção → detalhe → ação. Mantenha a visualização primária livre de frases explicativas sem esconder informações necessárias para interpretar dados ou operar controles.

Quando Usar

  • Projetar ou revisar um dashboard operacional, visualização de KPI ou gráfico analítico compacto.
  • Ajudar usuários a identificar exceções e tomar uma ação definida a partir dos dados afetados.
  • Refatorar um dashboard desorganizado em um sistema visual consistente e escaneável.

Não use isso como regra universal para relatórios narrativos, gráficos educacionais, onboarding ou interfaces que precisam de instruções explícitas. Gráficos estáticos não podem depender de tooltips nem fingir fornecer ações interativas.

Entradas e Pré-requisitos

Obtenha o conjunto de dados ou esquema preciso, público-alvo, decisão operacional, formato de entrega (mockup, imagem, HTML ou dashboard funcional) e dispositivo alvo. Identifique unidades de métrica, janelas de tempo, linhas de base, limites, direção desejada e ações permitidas.

Nenhuma biblioteca, serviço ou cliente de agente específico é necessário. Use ferramentas disponíveis para inspecionar dados, construir o artefato solicitado e testá-lo. Pergunte apenas por informações críticas para a decisão que estejam faltando; rotule suposições provisórias. Nunca invente medições, limites, ações ou resultados bem-sucedidos de QA.

Procedimento

1. Estabeleça o contrato de dados

  • Verifique totais, agregação, denominadores, unidades, janelas de tempo e comparabilidade de linha de base com cálculos reais.
  • Distinga valores zero, ausentes, desatualizados, indisponíveis e não aplicáveis; nunca converta silenciosamente dados ausentes em zero.
  • Defina se valores mais altos ou mais baixos são problemáticos para cada métrica. Para métricas neutras, como gasto, use um orçamento ou faixa aprovada; sem um, use estilo neutro e não implique um problema.
  • Mantenha a incerteza estatística e a atualidade dos dados visíveis quando afetarem decisões.

Completo quando: cada métrica exibida tem uma interpretação definida e limitações de dados conhecidas.

2. Defina hierarquia e ação

  • Comece pelo estado geral, depois exceções sinalizadas diretamente nos dados, depois detalhes.
  • Defina prioridade de atenção com base na gravidade e relevância para a decisão, não em decoração visual arbitrária.
  • Coloque a ação sobre ou ao lado do dado afetado: por exemplo, uma célula acionável de heatmap abre seu detalhe ou fluxo de trabalho relevante.
  • Use nomes acessíveis significativos, foco visível e affordances interativas claras. Nunca invente uma ação de remediação nem a execute como parte do design da visualização.

Completo quando: cada sinalização tem uma razão definida e uma ação real ou um destino de detalhe explicitamente não interativo.

3. Escolha codificações visuais

Prefira posição em uma escala comum, depois comprimento, depois ângulo/área, depois cor quando adequados à tarefa. Isso é uma heurística de design, não uma garantia de que uma codificação se adapta a cada conjunto de dados.

Vocabulário visual padrão:

  • Heatmap classificado: limites discretos e rotulados para varredura de exceções.
  • Gráfico de bala: valor, alvo comparável e faixas significativas em vez de medidores. Alinhe escalas quando comparações exigirem.
  • Barra de participação segmentada: partes de um todo definido em vez de gráficos de pizza, incluindo participações de duas categorias. Mostre o denominador e não implique um todo para categorias sobrepostas.
  • Sparkline: contexto temporal compacto com informação suficiente de ponto final, escala ou faixa para evitar comparações enganosas.
  • Superfície de detalhe consistente: tooltips com um popover ou painel de detalhe acessível por foco/toque equivalente.

Se este vocabulário não puder representar honestamente a tarefa solicitada, explique a incompatibilidade e proponha uma alternativa adequada em vez de forçar os dados nele.

Completo quando: cada componente suporta uma comparação ou decisão e sua escala é interpretável.

4. Aplique linguagem concisa e saliência acessível

  • Na visualização primária de dados, use nomes de métrica concisos, valores, unidades, rótulos de período, rótulos de linha de base e rótulos de controle/status necessários; sem insights narrativos ou parágrafos explicativos.
  • Uma comparação compacta como ▼ 15% vs Set deve identificar o que está sendo comparado e se a mudança é favorável. Uma seta sozinha não deve codificar gravidade.
  • Coloque explicações de suporte nos detalhes, mas nunca torne o significado essencial acessível apenas por hover. Forneça acesso por teclado e toque, nomes acessíveis e uma representação textual/de dados equivalente quando apropriado.
  • Use escalas sequenciais para magnitude ordenada, escalas divergentes em torno de um ponto médio significativo ou escalas classificadas para limites definidos.
  • Aumente a intensidade visual em direção a um problema estabelecido. Onde valores baixos são ruins, inverta o mapeamento de gravidade; onde ambos os extremos são ruins, use limites bilaterais.
  • Combine cor com um indicador não cromático, como forma, ícone, padrão, borda ou rótulo de status curto explícito.
  • Almeje pelo menos contraste 4,5:1 para texto comum e 3:1 para texto grande e limites gráficos/de controle significativos. Teste combinações reais de primeiro plano/fundo e estados de interação; evite texto de destaque sobre um tom de destaque não verificado.
  • Remova decorações, linhas de grade redundantes e fundos desnecessários. Mantenha legendas, rótulos e guias quando necessários para interpretar os dados.

Completo quando: a visualização permanece compreensível sem cor, hover ou frases explicativas em sua superfície de dados primária.

5. Construa e verifique o artefato solicitado

Entregue o formato solicitado, não apenas uma descrição de design. Para um dashboard funcional, exercite suas interações e estados de dados; para uma imagem ou mockup, identifique claramente controles não funcionais.

Execute a lista de verificação abaixo. Corrija defeitos confirmados e rotule verificações não executadas como não verificado. Não chame uma especificação de dashboard implementado nem uma revisão estrutural de teste de usabilidade.

Completo quando: o artefato é entregue com QA baseado em evidências e limitações explícitas.

Verificação

  • Dados: totais e participações calculadas reconciliam; unidades, janelas de tempo, denominadores e linhas de base correspondem; estados ausentes/desatualizados/neutros são testados.
  • Saliência: inspecione a visualização renderizada e verifique se a exceção pretendida é proeminente. Distinga uma revisão visual de um teste medido de atenção do usuário.
  • Cor: inspecione uma simulação real de visão de cores quando a ferramenta permitir; confirme independentemente que indicadores não cromáticos transmitem gravidade. A simulação sozinha não estabelece acessibilidade.
  • Contraste: meça pares de cores renderizados e estados relevantes; relate o método e falhas em vez de afirmar conformidade a partir de nomes de paleta.
  • Linguagem: inspecione a superfície primária em busca de frases explicativas, mantendo a redação necessária de controle, status e segurança.
  • Interação: exercite navegação por teclado, foco visível, detalhes de foco/toque, descarte e a rota de ação pretendida sem realizar ações externas não aprovadas.
  • Layout: verifique viewport alvo, clipping, overflow, rótulos longos e estados representativos vazio/único/vários itens.
  • Integridade: legendas e escalas são suficientes, regras de layout não entram em conflito e a saída não inventa dados nem implica ações não suportadas.

Contrato de Saída

Retorne:

  1. O artefato solicitado ou sua localização verificada.
  2. Uma breve descrição da decisão primária e caminho de ação.
  3. Um relatório de QA compacto separando verificações aprovadas, reprovadas e não verificadas, com métodos ou evidências.
  4. Suposições ou bloqueios restantes e um próximo passo concreto se inacabado.

A regra de não narrativa se aplica à superfície de dados primária do dashboard, não a este relatório de entrega, texto de acessibilidade ou mensagens essenciais de erro/segurança.

Armadilhas

  • Minimalismo que remove contexto necessário é ambiguidade, não eficiência.
  • Um valor vermelho não é necessariamente um problema; gravidade requer uma regra específica da métrica.
  • Uma tooltip não é um substituto acessível para informações essenciais visíveis ou acessíveis por foco.
  • Gráficos esparsos ainda podem enganar por meio de escalas incompatíveis, faixas truncadas ou denominadores ausentes.
  • Não reivindique conformidade com WCAG apenas a partir de uma verificação de contraste.
  • Não reivindique rastreamento ocular, simulação de visão de cores ou interações testadas sem realmente realizá-las.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas