Camada semântica: a métrica publicada uma vez

Vários painéis ligados a um único bloco central de métrica

Camada semântica publica a métrica uma vez, com nome, fórmula e filtro que a empresa combinou. Sem ela, cada dashboard recalcula a receita do seu jeito e a reunião discute a fórmula, não a decisão.

A camada não é um catálogo de todos os campos. É o conjunto pequeno de métricas oficiais que mais de uma tela precisa. Campo solto continua na tabela. Métrica que dirige a semana passa a ter uma definição só, e as telas passam a chamá-la pelo nome.

Dois painéis que passam a mostrar o mesmo bloco de métrica no centro
Os painéis leem a mesma definição. A fórmula deixa de ser reescrita em cada tela.

O que é métrica e o que ainda é coluna?

Métrica tem fórmula, grão e o que fica de fora. “Pedido faturado, sem frete, contado no dia da nota” é métrica. A coluna de valor da nota é insumo. Publicar toda coluna como métrica só muda o lugar da confusão.

O grão importa tanto quanto a fórmula. Receita por pedido e receita por item não se somam do mesmo jeito se o desconto está na capa. A definição escreve o grão. Quem monta o gráfico não escolhe o grão na hora da apresentação.

Quem pode criar uma métrica oficial?

Quem é dono do número, junto com quem implementa a fórmula. Comercial não publica sozinho uma “receita” paralela, e o time de dados não inventa a regra que a controladoria não assinou. A métrica oficial tem os dois nomes na ficha.

Métrica exploratória pode existir, marcada como não oficial, numa área em que não entra no pacote que a diretoria abre. O erro é misturar as duas no mesmo seletor, com o mesmo tipo de letra. Se parece oficial, vai ser usada como oficial.

Como as telas passam a usar a mesma definição?

O painel chama a métrica pelo nome da camada, em vez de reescrever o filtro. Enquanto a fórmula mora dentro de cada arquivo de dashboard, a próxima cópia diverge. A migração é tela a tela, começando pela que a reunião já abre.

Durante a troca, mostre os dois números lado a lado uma vez, explique a diferença e apague o cálculo local. Manter os dois para sempre, “até todos se acostumarem”, faz a divergência virar opção. A tela antiga sai de circulação com data.

PeçaOnde viveO que não fazer
Fórmula oficialCamada, com versãoReescrever dentro do dashboard
SinônimoFicha, apontando para a oficialCriar outra métrica com nome parecido
ExploratóriaÁrea marcada como não oficialColocar no mesmo seletor da oficial
Mudança de regraVersão nova com data de vigênciaAlterar o passado sem aviso

O que muda quando a regra de negócio muda?

A fórmula nova tem vigência. O mês fechado continua explicável pela versão que valia naquele mês. Alterar a métrica para trás sem marcar a troca faz o gráfico histórico se mexer e ninguém sabe se foi a operação ou o dicionário.

A mudança passa pelo dono e por quem publica a tela. Aviso no catálogo e na própria métrica, na primeira semana, evita a acusação de que “o número foi mexido”. A camada existe para a mudança ser explícita, não para esconder o ajuste.

Como a camada segura um chat com os dados?

Se uma pergunta em linguagem natural vai responder número, ela só pode usar métrica da camada. Sem isso, o modelo inventa um join e batiza o resultado de receita. A recusa também é parte do desenho: pergunta ambígua devolve as métricas candidatas, não uma média das duas.

A resposta cita o nome da métrica e a vigência. A pessoa confere se era a receita que ela tinha em mente. Texto fluido sem o nome da métrica não entra em decisão. Esse é o mesmo cuidado de qualquer painel, só que o chat torna o desvio mais fácil.

Por qual métrica começar?

Pela que já aparece com dois valores na mesma reunião. Em geral receita, pedido ou custo de mídia. Uma métrica bem migrada, com as telas principais apontando para ela, vale mais do que um projeto que modela o dicionário inteiro e não desliga nenhum cálculo local.

Um exemplo: dois painéis de receita, um tira frete e outro não. A controladoria assina a definição sem frete, no dia da nota. Os dois painéis passam a chamar essa métrica. O painel que mostrava outra coisa ou muda de nome, para “receita com frete”, com ficha própria, ou sai. Na reunião seguinte, a discussão volta para o pedido que caiu, não para a fórmula.

Checklist prático

A camada está valendo quando a tela oficial já não tem a fórmula escrita por dentro.

  • Métrica com fórmula, grão e o que fica de fora
  • Dono de negócio e quem implementa, os dois nomeados
  • Exploratória visivelmente separada da oficial
  • Painel chama a métrica pelo nome, sem cálculo local
  • Tela antiga com data para sair, depois da comparação
  • Vigência quando a regra muda, sem reescrever o mês fechado em silêncio
  • Chat ou planilha conectada só enxerga a métrica oficial
  • Começo pela métrica que já diverge na reunião

Erros comuns

A camada vira mais um lugar com número se estes atalhos passarem.

  • Publicar toda coluna como se fosse métrica oficial
  • Deixar a fórmula dentro do dashboard “só neste gráfico”
  • Manter o número antigo e o novo para sempre, sem nome diferente
  • Alterar a fórmula e o histórico se mexer sem vigência
  • Colocar métrica exploratória no mesmo seletor da oficial
  • Deixar um chat consultar a tabela crua e chamar o resultado de receita
  • Começar por dezenas de métricas e não migrar nenhuma tela
  • Dono só técnico para uma regra que a controladoria define

Onde a métrica oficial entra?

Num trabalho de dados, tecnologia e automações, a camada semântica é o contrato do número: uma fórmula, um grão e as telas que deixam de reinventá-la.

Perguntas frequentes

▸Camada semântica substitui o catálogo?

Não. O catálogo explica e aponta. A camada calcula a versão oficial. A ficha do catálogo referencia a métrica da camada. Uma sem a outra ou não tem dono legível, ou não tem número único.

▸Toda métrica da empresa precisa entrar agora?

Não. Entre a que já diverge entre telas e dirige a reunião. Métrica de um único estudo pode continuar local, marcada como não oficial. Migrar o dicionário inteiro antes de desligar um cálculo local não muda a reunião.

▸Posso ter duas receitas oficiais?

Pode, se os nomes e os usos forem diferentes e as duas tiverem dono. “Receita faturada” e “receita para comissão” convivem. Duas fórmulas com o mesmo nome, não. O seletor não pode obrigar a pessoa a adivinhar qual é a da reunião.

▸O histórico muda quando a fórmula muda?

Só com vigência explícita. O mês fechado permanece na versão que valia. Se a mudança for mesmo retroativa, isso é uma decisão assinada, visível na métrica, não um efeito colateral de editar a fórmula.

▸Como impedir que o dashboard burle a camada?

A tela oficial não recebe a tabela crua com liberdade de refiltrar a receita. Ela recebe a métrica. Acesso exploratório continua existindo, fora do pacote que a diretoria abre, com marca de não oficial.

▸Chat com dados fica mais seguro com a camada?

Fica se a consulta só pode usar métrica publicada e se a resposta cita o nome e a vigência. Sem esse limite, o modelo inventa a fórmula. A camada não conserta um chat com acesso irrestrito às tabelas.

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *