Design de Dashboards de KPIs

Padrões abrangentes para projetar dashboards eficazes de Indicadores-Chave de Performance (KPIs) que impulsionam decisões de negócios.

Quando Usar Esta Habilidade

• Projetar dashboards executivos
• Selecionar KPIs significativos
• Construir displays de monitoramento em tempo real
• Criar visualizações de métricas específicas de departamento
• Melhorar layouts de dashboards existentes
• Estabelecer governança de métricas

Conceitos Essenciais

1. Estrutura de KPIs

2. KPIs SMART

Specific: Clear definition
Measurable: Quantifiable
Achievable: Realistic targets
Relevant: Aligned to goals
Time-bound: Defined period

3. Hierarquia do Dashboard

├── Executive Summary (1 page)
│   ├── 4-6 headline KPIs
│   ├── Trend indicators
│   └── Key alerts
├── Department Views
│   ├── Sales Dashboard
│   ├── Marketing Dashboard
│   ├── Operations Dashboard
│   └── Finance Dashboard
└── Detailed Drilldowns
    ├── Individual metrics
    └── Root cause analysis

Exemplos Detalhados e Padrões

Seções detalhadas (começando com ## Common KPIs by Department) estão em references/details.md. Leia este arquivo quando o resumo de navegação acima for insuficiente.

Melhores Práticas

O Que Fazer

• Limitar a 5-7 KPIs - Focar no que importa
• Mostrar contexto - Comparações, tendências, metas
• Usar cores consistentes - Vermelho=ruim, verde=bom
• Permitir drilldown - Do resumo para o detalhe
• Atualizar apropriadamente - Corresponder à frequência da métrica

O Que Não Fazer

• Não mostrar métricas de vaidade - Focar em dados acionáveis
• Não sobrecarregar - Espaço em branco ajuda na compreensão
• Não usar gráficos 3D - Eles distorcem a percepção
• Não ocultar a metodologia - Documentar os cálculos
• Não ignorar o mobile - Garantir design responsivo

Solução de Problemas

MRR exibido no dashboard contradiz o número das finanças

A causa mais comum é o tratamento inconsistente de planos anuais. As finanças podem prorratear para uma taxa diária enquanto o dashboard normaliza para mensal. Alinhe-se a uma única fórmula e documente-a diretamente no card do dashboard:

-- Explicit formula shown in tooltip / data dictionary
-- Annual plans: divide total contract value by 12
-- Quarterly plans: divide by 3
-- Monthly plans: use as-is
CASE subscription_interval
    WHEN 'monthly'   THEN amount
    WHEN 'quarterly' THEN amount / 3.0
    WHEN 'yearly'    THEN amount / 12.0
END AS normalized_mrr

Dashboard mostra verde, mas a equipe de produto relata reclamações de usuários

O dashboard provavelmente rastreia o tempo de atividade do sistema (um indicador defasado), mas não métricas de qualidade percebidas pelo usuário. Adicione métricas percebidas pelo cliente ao lado das métricas de infraestrutura:

Coorte de retenção parece plana — sem variação entre coortes

Verifique se a consulta da coorte está particionando corretamente pelo mês de inscrição. Um bug comum é usar created_at::date em vez de DATE_TRUNC('month', created_at), que agrupa por dia e produz coortes pequenas demais para mostrar tendências:

-- Wrong: too granular, cohorts are too small
DATE_TRUNC('day', created_at) AS cohort_date

-- Correct: monthly cohorts
DATE_TRUNC('month', created_at) AS cohort_month

Dashboard em tempo real sobrecarrega o banco de dados

Um dashboard ao vivo atualizando a cada 10 segundos com SQL de coorte complexo degradará o desempenho das consultas de produção. Separe cargas de trabalho OLAP de OLTP escrevendo métricas pré-agregadas para uma tabela de resumo via um job agendado, e faça o dashboard ler dessa tabela:

# Scheduled every 5 minutes via cron/Celery
def refresh_mrr_summary():
    conn.execute("""
        INSERT INTO kpi_snapshot (metric, value, snapshot_at)
        SELECT 'mrr', SUM(...), NOW()
        FROM subscriptions WHERE status = 'active'
        ON CONFLICT (metric) DO UPDATE SET value = EXCLUDED.value
    """)

Limiares de alerta disparam constantemente, a equipe os ignora

…