Resposta direta
O número só passa a ser explicável quando cada valor do relatório carrega quatro informações: de qual sistema e tabela veio, qual regra de cálculo foi aplicada, quem responde pela regra e em que horário o dado foi extraído. Sem esse registro, qualquer conferência vira discussão. A implementação começa escolhendo um número crítico, reconstruindo seu caminho até a origem e registrando esse caminho de forma que outra pessoa consiga repetir a conta. Depois o mesmo padrão se replica nos demais números, sem reescrever os sistemas de origem.
- Objetivo
- Orientar implementação
- Formato indicado
- Projeto de implementação
- Atualizado em
O que esta página acrescenta: Trata o número como item auditável, com ficha, versão de regra e responsável, em vez de discutir a divergência entre sistemas.
O percurso do valor até a linha do relatório
Todo número de relatório nasce em um campo de um sistema, passa por filtros, junções e agregações e, em muitos casos, por uma planilha no meio do caminho. Esse percurso raramente está escrito. Quem montou o relatório lembra de parte dele. Quem assumiu depois não tem como reconstruir.
A reconstrução vai do fim para o começo. Toma-se o valor publicado e pergunta-se qual consulta o produziu, qual tabela alimentou a consulta e qual campo guarda o dado original. Cada etapa dessa corrente precisa de um nome. O que não tem nome não se confere.
O que fica registrado junto do número
Junto de cada número crítico fica uma ficha com definição em uma frase, sistema e campo de origem, regra de cálculo, responsável pela regra, responsável pela extração e horário da última atualização. A ficha fica no mesmo lugar do relatório, não em arquivo paralelo que ninguém abre.
Regra de cálculo muda com o tempo. Quando alguém altera um filtro ou uma data de corte, os relatórios anteriores deixam de ser reproduzíveis se a versão da regra não ficou registrada. Anotar a versão e a data de vigência resolve boa parte das discussões que aparecem meses depois.
O que a rastreabilidade não resolve
Rastreabilidade não corrige dado errado na origem. Se o cadastro está incompleto ou o lançamento foi feito fora do prazo, a trilha mostra o erro, mas não o elimina. Também não decide qual definição está certa quando duas áreas usam o mesmo nome para coisas diferentes. Essa decisão é de governança, não de relatório.
Em relatórios com uma única fonte e uma regra simples, o custo de manter a ficha pode superar o benefício. O registro também exige alguém responsável por mantê-lo em dia. Sem essa manutenção, a trilha fica desatualizada e passa a dar falsa segurança.
Recurso prático
Roteiro para tornar rastreável um número crítico
- Escolher o número que mais gera pergunta e listar onde ele aparece: relatório, tela, planilha, apresentação.
- Reconstruir o caminho do valor até a origem: sistema, tabela, campo, filtro de data e regra de agregação.
- Escrever a definição em uma frase que outra pessoa consiga aplicar sem ajuda.
- Nomear quem responde pela regra e quem responde pela extração, cada um com substituto.
- Registrar o horário da extração e a versão da regra usada no cálculo.
- Refazer a conta a partir da origem e comparar linha por linha com o valor publicado.
- Guardar a ficha junto do relatório e revisá-la sempre que a regra mudar.
O erro mais comum é registrar a fonte do dado e esquecer a versão da regra e o horário da extração. Quando um filtro muda, os relatórios anteriores deixam de ser reproduzíveis e a trilha passa a apontar para uma regra que já não existe.
Conceitos usados nesta página
- Trilha de auditoria — Trilha de auditoria é o conjunto de registros que permite reconstruir quem fez o quê, quando e com qual dado — inclusive depois que o resultado já foi usado.
Sobre o que está escrito aqui
Conceitos relacionados: linhagem do dado · dicionário de indicadores · regra de cálculo · versão da regra · trilha de auditoria. Exemplos são ilustrativos. Não há cliente, resultado, preço, prazo ou certificação nesta página. Quando o formato indicado é Projeto de implementação, ele descreve uma possibilidade de trabalho — a conversa inicial avalia contexto e aderência.
Para continuar
- Integrações, sistemas e qualidade de dados — Página central do tema
- Relatório manual todo mês: como medir o impac… — relatório montado à mão todo mês
- Relatório montado à mão: como contratar a aut… — relatório montado à mão todo mês
Páginas relacionadas
O mesmo problema em outro objetivo
- Número que ninguém explica: reconstruir a conta até a origem — Diagnosticar
- Número que ninguém explica: como rastrear até a origem — Organizar um processo
- Relatório com número inexplicável: comparar caminhos — Comparar alternativas
- Número sem origem: como medir o que o relatório não explica — Explicar medição
- Relatório que ninguém explica: o que exigir na contratação — Orientar avaliação e contratação
Outras leituras em Integrações, sistemas e qualidade de dados
- Planilhas divergentes: o que exigir na contratação — Critérios para contratar a correção de planilhas divergentes, definindo entregáveis de processo e regras de negócio antes de escolher ferramentas.
- Log de integração sem nível de erro: o que exigir no contrato — Contrato de log de integração: níveis de severidade, campos obrigatórios, retenção, responsabilidade e teste de aceite com falha provocada.
- Fonte única por indicador: como provar qual sistema manda — A página define, para cada indicador, qual sistema é a fonte oficial, quem responde por ela e que conferência comprova que o número vem dali.
- Alteração sem registro: o que ainda dá para reconstruir — O que ainda pode ser reconstruído quando a alteração não foi registrada: fontes de rastro, limites da reconstrução e o que registrar daqui em diante.
- Exclusão sem trilha: o que exigir antes de contratar — O que um sistema precisa registrar em cada exclusão e o que o contrato deve cobrir antes da assinatura, incluindo acesso ao histórico.
