Como a classificação funciona

Fonte de dados e travas

Tempo: nenhum mês fixo no código

• Mês atual — em andamento. Nunca conta como quebra de sequência e não entra no faturamento nem em meses ativos.
• Mês anterior (M-1) — mês fechado mais recente. É ele que decide ativo ou em reativação.
• Janela de análise — os 12 meses fechados, de M-12 a M-1.
• Fuso da operação — Belém: é ele que define quando “hoje” vira o dia seguinte.
• Até os rótulos de mês da tela são derivados da data de hoje, nunca tabelados.

Faturamento líquido

Bruto     = SUM(vlr_atendido)  tipo='VENDA'  posicao='F - Faturado'  tv=1  codfilial=1
Devolução = SUM(vlr_atendido)  tipo='DEV'    posicao='DEV - Devolucao'      codfilial=1
                               -- sem filtrar tv: DEV sempre tem tv nulo
Líquido   = Bruto − Devolução

• Sempre pela data de faturamento (datafat), que reflete o movimento real, inclusive nas devoluções.
• Bonificação nunca entra.
• Só movimento dentro dos 12 meses fechados soma no valor exibido.
• Devolução não é evento de compra: não conta como mês ativo, não entra no streak e não vira última compra.

O que é calculado para cada cliente

Streak: sequência sem buraco

Anda do mês fechado mais recente para trás e para no primeiro mês sem compra. O mês atual não participa, porque ainda não fechou.

M-4    M-3    M-2    M-1        streak
 ·    venda    ·    venda   →     1     ← M-2 quebrou a continuidade
venda venda  venda  venda   →     4
venda venda  venda    ·     →     0     ← não comprou no mês fechado mais recente

Segmentação: a árvore completa

Duas perguntas resolvem a classificação inteira, e nenhuma delas depende de histórico salvo.

Contorno tracejado é decisão; contorno colorido é grupo final. Etapa ao vivo de 1 ou mais vai para Consolidação; etapa 0 desce para a última pergunta.

Top 30: como o score é apurado

• Elegibilidade: só quem está no pool de Recorrentes (streak de 3 meses ou mais).
• Score = metade faturamento líquido, metade meses ativos, ambos normalizados dentro do pool de cada RCA1 — nenhuma das duas métricas domina o ranking só por ter escala maior.
• O corte do #30 é relativo àquele vendedor, nunca um valor fixo em reais: varia conforme o tamanho do pool de cada RCA.
• Pool com 30 clientes ou menos entra inteiro, sem disputa.
• Média mensal de faturamento aparece como referência e não entra no score.

Consolidação: as 3 etapas

A etapa é o streak “ao vivo”: o fechado mais a compra do mês corrente, quando ela existe.

Reativação e +120 dias

Os dois grupos exigem streak 0 e nenhuma compra no mês atual. O corte de 120 dias sem comprar separa um do outro. Cliente que nunca comprou cai em +120: é carteira fria, não janela de atenção.

Quem vê o quê

O papel chega carimbado pelo hub no ato do login. Este app nunca consulta o cadastro de acesso por conta própria.

• O recorte acontece depois da segmentação. O Top 30 é apurado sobre a carteira do time, então a posição do cliente na visão do vendedor é a mesma que a supervisão vê — a visão individual é um subconjunto exato da geral.
• Na dúvida, nega. Papel ausente, desconhecido ou sem carteira definida não entra: erro nunca pode resultar em ver dado a mais.
• Mudança de papel no hub vale na próxima carga da página, sem precisar sair e entrar de novo.

Leitura, cache e falhas

• Toda leitura é paginada e o total lido é conferido contra a contagem do servidor: linha faltando derruba a tela com erro, em vez de mostrar número menor em silêncio.
• O histórico é buscado bem além da janela só para a última compra de cliente frio continuar aparecendo.
• O resultado é reaproveitado dentro do mesmo dia; erro não fica preso no cache até a virada.
• Nada é pré-renderizado — a classificação depende de “hoje”.

Como a tela se comporta

• Os seis indicadores do topo são clicáveis: os cinco grupos levam à aba de cada um, e o total ao lado abre a carteira completa — a mesma lista sem recorte, com a coluna “Grupo” dizendo onde cada cliente caiu. O número dele continua sendo a validação visual de que a soma bate com a carteira inteira.
• Cada aba guarda seu próprio estado de busca, filtro de RCA e ordenação — trocar de aba não perde o que você montou na anterior.
• Clicar no cabeçalho de uma coluna ordena do maior para o menor; clicar de novo inverte. “Nunca comprou” ordena como o caso mais extremo.
• Dias sem comprar mudam de cor: vermelho acima de 120, laranja acima de 60.
• No Top 30, ordenar por RCA agrupa a lista por vendedor e a posição reinicia dentro de cada carteira.

O que é verificado automaticamente

• Os cinco grupos somam o total da carteira, e nenhum cliente aparece em dois.
• A virada de mês não muda a classificação relativa — nada está fixo no código.
• Os recortes por vendedor somados reconstroem a carteira inteira, preservando posição no Top 30 e etapa.
• Streak exige sequência; devolução não gera mês ativo; o corte do Top é por RCA, não global.

Correções que não devem ser revertidas