Sistema de verdade e governança de métricas

Um painel pode estar correto tecnicamente e errado para a decisão

Duas áreas podem usar dados válidos e chegar a resultados diferentes porque aplicam janelas, populações, moedas, estados ou regras de atribuição incompatíveis. A divergência aparece no número, mas sua origem costuma estar no contrato ausente. Por isso, governar métricas começa pela pergunta que será respondida e termina no uso permitido, em vez de começar pela ferramenta de visualização.

O sistema de verdade organiza autoridade por domínio. O financeiro pode ser a fonte oficial de receita reconhecida; um gateway, a evidência operacional do pagamento; o CRM, o registro da oportunidade; e a plataforma de mídia, a leitura atribuída de campanha. Cada fonte responde a uma pergunta própria. Quando uma única ferramenta é tratada como autoridade universal, diferenças legítimas de finalidade parecem defeitos.

O contrato transforma um rótulo em uma métrica reproduzível

Nomes familiares escondem escolhas importantes. “Cliente”, “receita”, “conversão” e “cancelamento” podem representar eventos, populações e datas diferentes. O contrato registra essas escolhas antes que o indicador chegue ao painel.

• O contrato descreve a pergunta antes de descrever a consulta.
• Numerador, denominador, exclusões e tratamento de valores ausentes estão explícitos.
• Fuso horário, moeda, arredondamento e janela de maturação possuem regra.
• A fonte de verdade é definida por domínio e finalidade.
• Usos permitidos e proibidos acompanham o indicador no catálogo e no painel.

Fonte oficial, espelho e contraste exercem papéis diferentes

O sistema de registro, também chamado de system of record, possui autoridade sobre um fato dentro de um domínio e de uma pergunta. O repositório analítico torna esse fato consultável; a fonte de contraste ajuda a detectar atraso, perda ou diferença de semântica. O desenho robusto preserva os três papéis sem fingir que eles produzem o mesmo número.

Linhagem mínima que acompanha a decisão

1. Origem do fato. Registre sistema, objeto, campo, evento, chave e horário em que o dado nasceu.
2. Movimentação. Identifique coleta, atraso esperado, duplicação possível, reprocessamento e política de retenção.
3. Transformação. Versione filtros, junções, deduplicação, conversão de moeda e regras de negócio.
4. Agregação. Declare grão, janela, maturação e condição que fecha o período.
5. Consumo. Liste painel, relatório, automação e decisão que dependem da métrica.

Quatro estados separam aprendizado de autoridade

O estado aparece junto ao valor, e não apenas em uma documentação distante. Assim, uma análise promissora continua útil sem ganhar autoridade prematura, enquanto um indicador degradado deixa de orientar decisões até a recertificação.

Reconciliação começa alinhando a pergunta

Antes de comparar totais, alinhe população, evento, tempo, estado e unidade monetária. Muitos conflitos desaparecem quando cada número recebe a pergunta que realmente responde. Os conflitos restantes precisam de decomposição, causa, materialidade e tratamento.

1. Congele o recorte. Registre período, horário, versão, filtros e data de extração para impedir que fontes em movimento confundam a investigação.
2. Alinhe o grão. Compare registros equivalentes antes de comparar agregados. Escolha chaves de negócio e declare relações de um para muitos.
3. Classifique a diferença. Separe atraso, duplicidade, ausência, cancelamento, estado, moeda, atribuição, identidade e regra de transformação.
4. Meça materialidade. Relacione volume e valor da diferença à decisão afetada. Uma diferença pequena pode ser crítica em uma coorte específica.
5. Defina tratamento. Corrija a origem quando possível; caso contrário, documente ajuste, limite, vigência e risco residual.
6. Reproduza e comunique. Execute novamente, preserve a memória de cálculo e avise consumidores antes de liberar o resultado.

Mudou a régua, mudou a versão

Uma alteração semântica quebra comparabilidade mesmo quando o nome permanece. Nova versão é obrigatória quando muda fórmula, população, fonte oficial, evento, janela, modelo de atribuição, política de identidade ou tratamento de estado. Correções puramente técnicas também recebem registro quando alteram valores já publicados.

Incidente de dados é uma quebra de confiança com consumidores identificáveis

O incidente começa quando uma métrica deixa de cumprir contrato, qualidade ou atualização e pode induzir uma ação inadequada. A severidade depende do impacto e da reversibilidade da decisão, além do tamanho da divergência.

1. Detectar e bloquear. Mude o estado no catálogo e no painel para impedir uso silencioso.
2. Identificar consumidores. Use a linhagem para localizar relatórios, automações, metas e pessoas expostas.
3. Comunicar o que se sabe. Informe impacto, período, uso proibido, responsável e próxima atualização, sem antecipar uma causa ainda incerta.
4. Corrigir e reprocessar. Preserve o antes e o depois, teste regressões e marque dados corrigidos.
5. Recertificar. Volte ao estado reconciliado e execute novamente o gate de estabilidade antes da certificação.
6. Aprender sem culpar. Corrija sistema, contrato, teste ou ritual que permitiu a falha chegar à decisão.

Semântica, operação e consumo precisam de donos diferentes

Ficha de contrato e certificação

Copie o modelo para o catálogo, preencha com links rastreáveis e mantenha a ficha ao lado da métrica. Campos desconhecidos recebem responsável e prazo; não recebem suposição silenciosa.

MÉTRICA
Nome:
Identificador e versão:
Estado: experimental | reconciliada | certificada | proibida para decisão

DECISÃO
Pergunta de negócio:
Usos permitidos:
Usos proibidos:
Consumidores críticos:

CONTRATO
Fórmula:
Numerador:
Denominador:
População e exclusões:
Grão:
Evento de data:
Janela e maturação:
Fuso, moeda e arredondamento:

FONTES E LINHAGEM
Sistema de registro:
Espelho analítico:
Fonte de contraste:
Origem → coleta → transformação → consumo:
Frequência e atraso esperado:

QUALIDADE
Testes e limites:
Divergências conhecidas:
Regra de bloqueio:

GOVERNANÇA
Dono de negócio:
Guardião técnico:
Aprovador:
Vigência:
Histórico de versões:
Incidentes relacionados:

CERTIFICAÇÃO
Reconciliação reproduzida por:
Dia 1:
Dia 2:
Dia 3:
Decisão de liberar, limitar ou bloquear:
Próxima revisão:

Plano de 90 dias para instituir o sistema de verdade

Indicadores do próprio sistema de governança

• Percentual de métricas críticas com contrato completo e dono ativo.
• Percentual de decisões críticas atendidas somente por métricas certificadas.
• Tempo entre detecção, bloqueio, reconciliação e recertificação.
• Quantidade de versões sem consumidor ou período de transição identificado.
• Taxa de reprodução independente e quantidade de divergências reincidentes.

Perguntas para destravar a governança

Fontes para aprofundar

• W3C: PROV Overview, visão geral da família pública de padrões para representar procedência, entidades, atividades e agentes.
• Governo do Reino Unido: Government Data Quality Framework, para organizar qualidade ao longo do ciclo de vida e relacioná-la à finalidade.
• OpenLineage: documentação oficial, para compreender captura padronizada de eventos de linhagem em processos de dados.
• Google SRE Workbook: Monitoring, para distinguir sintomas, causas, instrumentação e sinais que apoiam uma resposta operacional.
• Statistics Canada: Data Quality Toolkit, referência pública para avaliar dimensões de qualidade e adequação ao uso.