Tecnologia para empresas · 13 min de leitura
Como criar um dicionário de indicadores para que as áreas discutam o mesmo número
Defina unidade, população, período e responsabilidade dos indicadores e resolva divergências entre relatórios com exemplos de inclusão e exclusão.
Por Tironi Tech · Publicado em · Atualizado em
Dois painéis podem estar calculados corretamente e mostrar números diferentes porque usam definições distintas de pedido, cliente ativo ou atraso. Este tutorial ensina a construir um dicionário de negócio com exemplos e versões. O cenário fictício acompanha uma empresa em que comercial e operação apresentam totais diferentes de serviços concluídos.
O que você vai levar deste guia
- Separar divergência de conceito de erro de cálculo.
- Definir população, evento e período de cada indicador.
- Usar casos de fronteira para testar a definição.
- Versionar mudanças e comunicar efeitos nas comparações.
- Decisão
- Definição
- Exemplos
- Validação
- Versão
Um nome familiar só se torna uma medida comum quando as condições de contagem estão explícitas.
Comece por um indicador que gera uma decisão real
Escolha uma medida usada em reunião, compromisso ou avaliação de processo. Pergunte o que alguém decide quando ela muda. Serviços concluídos pode orientar capacidade, faturamento ou acompanhamento de entrega, e cada finalidade pode exigir um evento diferente. O dicionário deve começar pelo propósito, não pela consulta existente no banco. Um cálculo pode estar tecnicamente correto e responder à pergunta errada. A definição de negócio precisa explicar qual fenômeno está sendo medido e por que ele é útil para aquela decisão.
No cenário fictício da Nível Serviços, o comercial conta contratos marcados como entregues, enquanto a operação conta ordens com atividade finalizada. Um contrato pode ter várias ordens, e a documentação pode ser concluída depois da execução. Os totais diferem sem que isso prove erro em qualquer painel. A primeira tarefa é explicitar as unidades e os eventos. Talvez a empresa precise de dois indicadores com nomes distintos, em vez de forçar um único número para decisões que observam partes diferentes do serviço.
Crie uma ficha inicial com nome atual, pergunta de gestão, usuário, decisão e relatórios em que aparece. Liste sinônimos usados pelas áreas. Concluído, entregue e encerrado podem parecer equivalentes na conversa e representar estados diferentes no sistema. O inventário revela onde a ambiguidade se espalhou. Escolha um responsável de negócio capaz de resolver a definição com as áreas envolvidas. A equipe de dados pode implementar e investigar, mas não deve decidir sozinha o significado de um compromisso operacional.
Defina unidade, população e evento de contagem
Escreva a unidade: contrato, ordem, cliente ou ocorrência. Depois defina a população incluída e o evento que faz a unidade entrar na contagem. Para ordens concluídas, pode ser a primeira passagem válida para determinado estado, dentro de um período. Para clientes ativos, a empresa precisa escolher qual comportamento ou condição caracteriza atividade. Não use a palavra ativo como se tivesse significado universal. A regra deve refletir a decisão e permitir avaliar registros individuais sem depender de uma interpretação informal a cada relatório.
Na Nível fictícia, a operação pode definir ordem executada como atividade finalizada e conferida pelo responsável, enquanto serviço entregue inclui documentação disponibilizada ao cliente. Esses indicadores têm relação, mas não são substitutos. O dicionário deve explicitar a diferença e evitar títulos quase idênticos no painel. Uma medida pode mostrar capacidade de execução e a outra o fim da jornada. A escolha do evento altera prazo e quantidade. O objetivo não é escolher o número mais favorável, e sim representar o estágio pertinente à decisão.
Use um modelo com unidade, população, evento de entrada, evento de saída e exclusões. Inclua tratamento de cancelamento, reabertura e duplicidade. Se uma ordem é reaberta e concluída novamente, ela conta uma ou duas vezes? A resposta depende da medida. Contagem de unidades concluídas pode contar uma, enquanto ocorrências de conclusão pode contar duas. Nomeie de modo que essa diferença seja visível. Sem exemplos, a fórmula pode parecer inequívoca e ainda permitir interpretações diferentes na implementação.
Especifique tempo, corte e atualizações
Defina a data usada e o intervalo de fechamento. Data de criação, execução e registro podem diferir. Um serviço realizado no último dia do mês pode ser registrado no seguinte. A gestão precisa saber se o relatório acompanha ocorrência ou lançamento. Registre também como correções tardias afetam períodos anteriores. Uma série que muda depois do fechamento não é necessariamente errada, mas o comportamento precisa ser conhecido. Caso contrário, duas pessoas podem exportar em dias diferentes e discutir totais distintos como se uma tivesse calculado incorretamente.
Na Nível fictícia, o painel operacional usa data de execução, enquanto um relatório administrativo usa data de conferência. A empresa decide manter ambos com nomes e finalidades claras. Para uma reunião mensal, estabelece um corte e indica quando os dados ainda podem mudar. O dicionário deve explicar a atualização, sem inventar um prazo universal de fechamento. A regra precisa ser compatível com a rotina e com as fontes. Se a informação chega com atraso, essa limitação deve acompanhar o indicador e orientar melhorias de registro.
Crie campos para granularidade, data de referência, frequência de atualização, corte e política de correção. Acrescente exemplos de borda: evento perto da virada do dia, registro retroativo e reabertura. Se a operação envolve fusos diferentes, a implementação deve refletir a convenção de negócio definida. Não esconda uma escolha temporal em uma configuração técnica que só o desenvolvedor conhece. O usuário do painel precisa compreender por que uma ocorrência aparece em determinado período, principalmente quando o número sustenta compromissos ou decisões de capacidade.
Escreva a fórmula e um exemplo que possa ser refeito
Depois de definir o conceito, registre a fórmula em linguagem compreensível e os componentes usados. Para uma taxa, explique numerador e denominador com a mesma população e período quando essa for a lógica da medida. Não faça uma média simples de percentuais de grupos com tamanhos diferentes sem justificar. Se o indicador usa ponderação, registre pesos e motivo. A fórmula deve ser acompanhada de um pequeno conjunto de dados ilustrativos que permita verificar a contagem e perceber diferenças de interpretação antes de implementar em escala.
Um exemplo fictício pode conter cinco ordens: duas executadas e documentadas, uma executada sem documentação, uma cancelada e uma reaberta. A regra precisa dizer quais entram em cada medida e por quê. Se ordens executadas considera a situação vigente, a reaberta pode ficar fora; se considera ocorrência de execução no período, pode entrar com uma condição diferente. O exemplo não busca uma resposta universal. Ele força a empresa a escolher o significado e permite à equipe técnica verificar se o cálculo respeita essa decisão.
Use uma tabela de casos com identificador, estados, datas, resultado esperado e justificativa. Inclua pelo menos um caso que não entra. Muitas definições parecem claras quando todos os exemplos são normais; a ambiguidade aparece nas exclusões. O artefato pode servir de verificação de negócio sem se tornar um teste que apenas repete o código. A referência é a regra aprovada e o resultado esperado em situações concretas. Se a equipe não consegue decidir um caso, a definição ainda precisa de trabalho antes de ser apresentada como oficial.
Registre origem, qualidade e limitações
Identifique fontes e campos que sustentam a medida, mas não limite o dicionário a nomes técnicos. Explique quem registra a informação, em que momento e quais problemas são conhecidos. Um campo preenchido não garante que represente corretamente a realidade. A orientação do GOV.UK sobre qualidade de dados relaciona metadados, responsabilidade e comunicação das limitações. Aplique esse princípio para que o usuário saiba se a medida está completa o suficiente para a decisão e onde precisa de cautela ou verificação adicional.
Na Nível fictícia, algumas equipes registram a execução no mesmo dia e outras no fechamento da semana. A diferença afeta o acompanhamento diário. O painel pode mostrar cobertura ou atraso de atualização, em vez de tratar ausência como zero. Defina regras de qualidade ligadas ao propósito: data obrigatória para ordens concluídas, identificador único e coerência entre estados. O framework de questões de qualidade do GOV.UK destaca que regras precisam de finalidade. Aqui, cada verificação deve proteger uma interpretação concreta do indicador, sem criar controles sem uso.
Monte uma seção da ficha com fonte, responsável pelo registro, atualização, cobertura, verificações e limitações. Se uma parcela não pode ser calculada, apresente indisponível ou parcial conforme a regra, evitando zeros falsos. Registre como o problema será tratado e quem responde. O dicionário deve ajudar a interpretar o número atual e a melhorar a fonte. Uma definição perfeita sobre dados inconsistentes não resolve a decisão; a qualidade precisa estar visível e conectada a ações proporcionais ao impacto.
Valide diferenças entre áreas com registros de fronteira
Reúna representantes das decisões envolvidas e compare as fichas, não apenas os totais. Percorra unidade, evento, período e exclusões. Se houver divergência, use registros concretos para localizar o ponto. Pode ser necessário manter indicadores diferentes ou escolher uma definição comum. Não transforme a reunião em disputa sobre qual área possui o número verdadeiro. A pergunta é qual medida atende a qual decisão e como os nomes evitarão confusão. Uma organização pode ter várias visões legítimas desde que a relação entre elas seja explicada.
Na Nível fictícia, a empresa mantém ordens executadas para capacidade e serviços entregues para acompanhamento do compromisso. Cria também uma medida de pendência documental para conectar os dois estágios. Essa decisão é mais informativa do que obrigar todos a usar o total comercial. O dicionário registra a relação e os casos de diferença. O painel pode mostrar os três com nomes claros. A escolha deve ser revisada quando o processo mudar, mas não reaberta em toda reunião apenas porque os números não são iguais.
Use um termo de validação operacional com definição, exemplos, áreas consultadas, responsável e data de vigência. Não é necessário um documento burocrático; uma aprovação registrada no fluxo da empresa pode bastar. O importante é que exista uma referência comum. A equipe técnica implementa a versão validada e demonstra os casos de exemplo. Se encontrar uma condição não prevista, devolve a pergunta ao responsável de negócio. Essa passagem mantém significado e cálculo alinhados, sem transferir decisões semânticas para quem apenas constrói o relatório.
Versione mudanças e preserve comparações honestas
Quando a definição mudar, registre motivo, data e impacto. Pode haver uma nova população, outro evento ou correção de um erro. Distinga mudança de conceito de correção de implementação. Se a regra antiga foi aplicada incorretamente, o histórico pode precisar de recálculo. Se o conceito mudou, a comparação entre versões exige explicação. Não una séries diferentes silenciosamente. Um gráfico contínuo pode sugerir melhora ou piora que decorre apenas da nova regra de contagem, e a gestão precisa reconhecer essa quebra antes de agir.
No exemplo fictício, a empresa passa a incluir ordens de uma nova unidade. O aumento de total não representa necessariamente crescimento do mesmo universo. A ficha deve indicar a expansão e, quando útil, permitir uma comparação com população constante. Se a documentação passa a ser obrigatória para marcar entrega, a série também muda de significado. A versão permite explicar o que aconteceu. Evite atualizar apenas a fórmula no sistema e deixar materiais, metas e relatórios antigos usando a definição anterior sem aviso.
Mantenha um registro de versões com número ou data, alteração, justificativa, período afetado e tratamento do histórico. Atualize painéis e instruções que dependem da medida. Se metas foram definidas sobre outra base, os responsáveis precisam reavaliá-las. O dicionário funciona como um mapa de dependências de negócio. Ele permite localizar o que deve ser revisto quando a regra muda, reduzindo a chance de uma área continuar avaliando desempenho com uma referência que já não corresponde ao número exibido.
Faça o dicionário aparecer no momento de uso
Disponibilize uma explicação curta no painel e um caminho para a ficha completa. O usuário deve conseguir descobrir unidade, período e limitações sem procurar um arquivo esquecido. Não coloque toda a documentação em cada gráfico, mas mantenha o significado acessível. Um título claro e uma nota de atualização podem evitar dúvidas recorrentes. O dicionário precisa ser usado por quem toma decisões, não apenas por quem desenvolve o BI. Se ninguém o consulta, investigue se está difícil de encontrar ou excessivamente técnico.
Escolha um processo para incluir indicadores novos: pergunta de gestão, definição, exemplos, qualidade e responsável antes da publicação. Não transforme cada medida exploratória em indicador oficial. Uma análise temporária pode ter um rótulo e um prazo próprios. O acervo deve distinguir medidas estáveis de investigações. Isso reduz a multiplicação de números com nomes semelhantes e permite que a equipe experimente sem criar uma obrigação de manutenção para cada gráfico produzido em uma reunião.
Um projeto com a Tironi Tech pode transformar essas definições em cálculos rastreáveis e uma experiência de BI compreensível. Leve as fichas e os casos de fronteira para orientar a implementação. A tecnologia deve preservar o significado acordado e mostrar limitações quando a fonte não atende à regra. Quando o dicionário funciona, as áreas deixam de gastar a reunião discutindo o que o número quer dizer e podem discutir o que fazer com ele, mantendo espaço para corrigir conceitos quando o negócio realmente mudar.
Perguntas frequentes
O dicionário é apenas uma lista de fórmulas?
Não. Ele também precisa explicar propósito, população, eventos, período, exclusões, fonte, qualidade e responsabilidade pela definição.
Se os totais diferem, um painel está necessariamente errado?
Não. Eles podem responder a perguntas diferentes. Primeiro compare definições e recortes; depois investigue cálculo e qualidade dos dados.
Posso mudar uma definição sem alterar o nome?
Pode haver situações em que o nome permanece, mas a mudança precisa ser versionada e comunicada. Comparações históricas devem explicar a quebra ou usar uma base recalculada adequada.
Dê significado consistente aos números do seu BI
A Tironi Tech pode ajudar a transformar definições de negócio em indicadores rastreáveis e painéis que as equipes consigam interpretar e conferir.
Organizar meus indicadores