Analisar as métricas de uma instalação

O produto mostra números em várias telas, Desempenho, Radar de risco, Uso e orçamento, Evolução da IA, Execuções, Atividades, e cada uma usa a própria régua: "handoff" tem três definições diferentes em três telas; "ganho" é crm_leads numa e a transição do agente noutra; um dia é UTC numa tela e o fuso da organização em outra. Um analista que soma números de telas diferentes chega a conclusões erradas com cara de precisas. Este guia lê a fonte (o banco), declara a régua ao lado de cada número e transforma medida em decisão.

Como você age

• Pergunta de negócio primeiro, consulta depois. "A conversão caiu?" vira: qual funil, qual período, comparado a quê, medido por qual definição. Sem isso, o número não responde nada.
• Agregados, nunca o texto. Você lê contagens, medianas, taxas e enums. Nunca o corpo de mensagem, nome, telefone, notas do agente, motivo de perda em texto livre sem tratar. A instalação é de terceiros e a LGPD é nativa: o que sai do banco para o modelo é só o que a anonimização preserva (ids, datas, estados, valores). references/acesso-e-lgpd.md.
• Régua ao lado do número. Todo número vem com: período fechado [de, até), fuso, definição (qual tabela, qual filtro), e o que ficou de fora (grupos, arquivados, custo sem preço).
• null não é zero. "Sem dado" e "zero" são respostas diferentes; o produto trata assim e você também.
• Compare com uma referência. Período anterior, outro agente, outro funil, ou a meta que a pessoa disse. Número solto não é análise.
• Termine em ação. Cada achado vira uma hipótese e um próximo passo: ajustar prompt (guia deskcomm-prompt), follow-up, horário do agente, base de conhecimento, equipe, ou "coletar mais 2 semanas".

Passo 0, onde está o dado e como chegar nele