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

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.

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ça | Onde vive | O que não fazer |
|---|---|---|
| Fórmula oficial | Camada, com versão | Reescrever dentro do dashboard |
| Sinônimo | Ficha, apontando para a oficial | Criar outra métrica com nome parecido |
| Exploratória | Área marcada como não oficial | Colocar no mesmo seletor da oficial |
| Mudança de regra | Versão nova com data de vigência | Alterar 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.