Design de dashboard de analytics
Um dashboard para um produto responde a uma pergunta à primeira vista: está crescendo e onde as pessoas estão desistindo? Tudo na página existe para responder a isso e, em seguida, permitir que o proprietário investigue o porquê.
Esta skill foi destilada da construção e operação do dashboard de analytics de um aplicativo Mac enviado (site → download → instalação → trial → pago) e de cada bug que o proprietário pegou em uma captura de tela. O exemplo funcional está em examples/product-analytics.html com dados de amostra fixos.
Como trabalhar
Siga os passos em ordem. Cada um termina em um pronto quando você puder verificar.
1. Escreva o contrato de dados primeiro
Antes de qualquer UI, liste cada número que a página mostrará e, para cada um: o evento que ele conta, a janela de contagem, único ou total, o fuso horário e com qual 'período anterior' ele é comparado. Coloque-o na forma da resposta da API, não no código da UI. Veja references/metrics.md.
Pronto quando cada bloco, coluna e gráfico tiver uma linha no contrato, e dois lugares que mostram 'o mesmo' número o lerem do mesmo campo.
2. Faça o layout da página
Sidebar com links de seção, uma barra superior fixa com status de atualização e o seletor de período, depois seções na ordem da jornada: visão geral → países → funil → compradores → app → retenção → site → eventos. Uma coluna de conteúdo, máximo 1280 px. Veja references/layout.md.
Pronto quando a visão geral responder à pergunta de relance sem rolagem em 1440 × 900.
3. Construa os componentes a partir da referência
Use os padrões em references/components.md e o código em references/snippets.md: linha de KPI com traço fino, deltas com uma linha de base 'era', sparklines na janela do gráfico, abas de métricas sublinhadas sobre um único gráfico com alternância de tabela, tabela de países classificável com uma barra de participação na coluna ordenada, barras de funil com conversão por etapa, linhas de compradores expansíveis com uma linha do tempo, donuts com uma fatia explícita 'não informado', mapa de calor de retenção com níveis classificados.
As cores vêm apenas dos tokens em references/tokens.md; claro e escuro são obrigatórios.
Pronto quando nenhum componente inventar uma cor, raio ou tamanho de fonte fora dos tokens.
4. Verificação de honestidade
Percorra references/metrics.md seção por seção. Os culpados comuns: um '−100%' em uma base de 1, receita que atrasa em relação ao provedor de pagamento, pedidos de $0 contados como clientes, somas de únicos diários rotuladas como únicos, fatias de donut que silenciosamente descartam as pessoas que não informaram, uma 'fonte' que é um palpite mostrado como fato.
Pronto quando cada número declarar sua janela e cada estimativa disser que é uma.
5. Verificação de privacidade
Analytics para um produto em que as pessoas confiam não deve se tornar aquilo em que elas desconfiam. Siga references/privacy.md: sem cookies no site, sem IPs armazenados, sem conteúdo do usuário em eventos, IDs aleatórios por instalação, uma opção de exclusão no app e jornadas unidas por um hash diário com sal, nunca por identidade.
Pronto quando você puder colar o esquema de eventos na política de privacidade do produto sem editá-lo.
6. QA de captura de tela
Execute references/qa.md: capturas de tela reais em 1440, 1024 e 390 px, claro e escuro, cada período, com os totais verificados em relação a números calculados fora da página. Olhe para as imagens, não para o código.
Pronto quando todas as capturas de tela estiverem limpas e os totais conhecidos corresponderem.
Regras que se aplicam em todos os lugares
- Ordem da jornada. As seções seguem o caminho que um cliente percorre, para que uma desistência seja lida de cima para baixo.
- Uma janela por número, declarada. 'período', 'hoje', 'últimos 30 dias' fica sob a coluna ou na dica do bloco.
- Compare semelhante com semelhante. O período anterior tem a mesma duração e termina onde o atual começa.
- Sem alarde em bases pequenas. 0 → 3 é 'novo', não '+∞%'; um delta em 1 → 2 é mostrado, mas discreto.
- Desconhecido é uma linha, não um buraco. Países desconhecidos, permissões não informadas e fontes não correspondidas são mostrados, classificados por último e contados nos totais.
- Atualização é visível. 'Atualizado 09:00 UTC' e 'pagamentos sincronizados 08:57' no cabeçalho; um ponto vermelho e um erro em linguagem simples quando o carregamento falha.
- A tabela está sempre a um clique de distância. Cada gráfico tem os valores diários exatos por trás de uma alternância 'Tabela'.
- Teclado e leitores de tela. Gráficos recebem foco e percorrem os pontos com ← →; cabeçalhos classificáveis são botões com
aria-sort; linhas expansíveis sãorole="button"comaria-expanded. - Sem dependências. SVG, gradientes cônicos CSS e
Intlcobrem todos os gráficos aqui; o exemplo é um único arquivo HTML.
Estilo da casa
Cinzas neutros, uma cor de série azul, verde e vermelho apenas para bom e ruim, laranja apenas para a marca. Texto base de 13,5 px, valores de KPI de 24 px, peso 600 para números e títulos, figuras tabulares em todos os lugares onde um número pode mudar. Traços finos, não sombras. Raio de card de 8 px, controles de 6 px, barras de 4 px. Veja references/tokens.md.
Formato de crítica
Quando for solicitado a revisar um dashboard (código, uma URL ou uma captura de tela), responda nesta ordem:
- Veredito em uma frase: ele responde à pergunta de relance?
- Números que discordam — a mesma métrica mostrando dois valores, totais que não somam, janelas que não correspondem. Estes vêm primeiro porque destroem a confiança.
- Problemas de honestidade de references/metrics.md.
- Problemas de privacidade de references/privacy.md.
- Problemas de layout e componente, classificados por quanto eles atrasam o proprietário.
- O que funciona — seja breve, mas diga, para que um redesenho não o perca.
Cada problema: o que você viu, por que engana ou retarda, a correção.
Referências
| Arquivo | O que cobre |
|---|---|
| metrics.md | contrato de dados, janelas de contagem, deltas, receita, atribuição, funis, coortes |
| layout.md | sidebar, barra superior, ordem das seções, grids, pontos de quebra, layout para celular |
| components.md | cada componente na página, seus estados e sua acessibilidade |
| tokens.md | tokens de cor claro e escuro, escala de tipo e espaçamento |
| snippets.md | delta, ticks de eixo bonitos, buckets, sparkline, donut, lista de barras, níveis de heatmap, plural |
| privacy.md | visitas sem cookies, redes com hash, IDs de instalação, opção de exclusão, o que nunca coletar |
| qa.md | protocolo de captura de tela, totais conhecidos, tabela de cheiros |
| case-study-typecorrect.md | o dashboard real de onde isso veio e os bugs que cada regra corrigiu |