Relatórios e dashboards automáticos

Cada painel lê uma tabela gold com grão único, escrito no nome e numa frase da descrição ('uma linha por anúncio por dia'). Tabela com nome mensal não recebe dado diário. A chave de atualização é o próprio grão: chave diferente do grão duplica linhas em silêncio.

CTR, CPC, CPM, ticket médio, taxa de conversão e custo por resultado guardados por linha são médias e não somam. A gold entrega as colunas aditivas (investimento, cliques, impressões, receita, quantidade) e o BI recalcula a taxa como soma sobre soma no recorte filtrado. Taxa sem denominador é nula, não zero.

Se a gold traz uma linha de total (todas as regiões, todos os canais), ela vem marcada e nunca é somada às linhas de detalhe. Na dúvida, deixe o total para o BI.

Seguidores, alcance deduplicado de vida inteira, saldo e estoque são retratos. Quando aparecem repetidos em todas as linhas de data, não somam: o painel usa o último valor do período. Recortes em formato longo (idade, gênero, posicionamento, dispositivo) são filtrados um tipo de recorte por vez, ou o total sai multiplicado.

Cada métrica tem a sua data de referência escrita: lead pela data de criação, venda pela data de ganho, receita pela data de pagamento ou de competência. O período é fechado e no fuso local, e o mês corrente aparece rotulado como parcial.

Ao migrar de planilha, Power BI, Qlik ou outro BI, reproduza os nomes e os números do relatório atual. Medida que o BI calculava com média ponderada por linhas de histórico precisa vir com o peso na gold. Compare mês fechado contra mês fechado e só depois desligue o antigo. A partir daí, a gold é a fonte canônica e outras fontes são conferência.

Ingestão que para não gera erro, só números parados. A gold carrega a data da última carga de cada fonte (a partir de _nekt_sync_at, convertida para o fuso local) e o painel mostra esse cartão. Para fontes de volume diário, um alerta de completude compara o dia com o pico recente, por exemplo menos de 70% das lojas com venda.

A gold roda depois que a fonte termina, por gatilho de evento. Agendar num horário fixo cria painel com metade do dado em dia de atraso, e gatilho manual é esquecido.

Um painel por unidade, serviço ou cliente não justifica uma transformação por botão. Uma gold com a dimensão (unidade, serviço, cliente) e o filtro no BI substitui dezenas de cópias quase iguais, que divergem com o tempo.

Alguns conectores de BI quebram com timestamp: entregue data como data e, se preciso, timestamp como texto. Destinos Postgres podem reinterpretar meia-noite UTC no fuso local e jogar a venda para o dia anterior: grave a data comercial como data, já na gold.