⚠ Com um mês em curso selecionado no filtro de Período, o painel projeta a Tendência de Fechamento do Cash Margem pelo ritmo diário observado até hoje (mesmo cálculo já usado em Acompanhamento Objetivos e Planos de Ação) — em mês já fechado ou sem mês selecionado, a tendência é igual ao realizado. O comparativo de Margem % com o mesmo período do ano anterior passa a usar essa tendência de fechamento, não o realizado parcial, para não subestimar a comparação num mês ainda em andamento. As tabelas por Gerente/Supervisor/Vendedor e por Categoria abaixo trazem essa mesma Tendência de Cash Margem (e % de atingimento sobre a Meta Cash Margem) lado a lado com Meta Cash Margem, Cash Margem realizado, Meta Margem % e Margem % realizada.

⚠ Sem filtro de hierarquia, Cliente/Produto vêm de um Top 50 por Cash Margem calculado direto na base (cobre corretamente clientes/produtos de menor faturamento mas margem alta). Com filtro de Gerente/Supervisor/Vendedor, Cliente/Produto usam o Top 50 por Receita daquele recorte reordenado por Cash Margem — uma aproximação (pode não incluir um cliente de baixo faturamento e altíssima margem que ficou fora do Top 50 por receita daquela entidade). Vendedor não usa Top 50: sem filtro mostra o Top 50 da empresa; com filtro de Gerente/Supervisor/Vendedor mostra todos os vendedores daquele recorte.

⚠ O ranking por Margem % (Cliente/Produto, sem filtro de hierarquia) exige faturamento ≥ R$ 500 no período — sem esse piso, uma única venda de poucos reais com custo perto de zero (ex.: baixa de avaria) dominava os primeiros lugares com 100% de margem, sem relevância de negócio. Com filtro de Gerente/Supervisor/Vendedor, Cliente/Produto usam o Top 50 por Receita daquele recorte reordenado por Margem % — uma aproximação. Vendedor não usa Top 50: sem filtro mostra o Top 50 da empresa; com filtro de Gerente/Supervisor/Vendedor mostra todos os vendedores daquele recorte. Meta Margem %/% Ating. só existem para Vendedor (nível de hierarquia real) — Cliente/Produto não têm meta individual no ERP.

⚠ Personalizado (datas exatas): compara qualquer intervalo de dias (ex.: 01/09 a 15/09) com o mesmo intervalo do ano anterior (mesmo dia/mês, ajustado p/ 29/02 em ano bissexto) — mas só Realizado (a Meta do ERP só existe por mês, não por dia) e só filtro de Gerente (Supervisor/Vendedor não têm grão diário no cubo). Para as demais opções de Período (Mês/Bimestre/Semestre/Personalizado por meses): todas as tabelas desta aba (Geral, por Gerente/Supervisor/Vendedor, por Categoria) somam exatamente os meses escolhidos no filtro de Período acima. Bimestre segue a numeração real do calendário (1º Bim = Jan/Fev ... 6º Bim = Nov/Dez) — no 2º semestre os bimestres disponíveis são 4º, 5º e 6º. Semestre = os 6 meses do semestre selecionado no topo da tela. Não há opção de Quadrimestre: o 2º Quadrimestre do calendário (Mai-Ago) cruzaria os dois semestres, que são cubos de dados separados — use Personalizado para esse caso. Tendência = projeção do(s) mês(es) ainda em curso pelo ritmo diário observado (meses já fechados usam o valor real) — só existe no nível empresa, não com filtro de Gerente/Supervisor/Vendedor. A Tendência de Cash Margem (na tabela por Categoria e no resumo geral) aplica essa mesma projeção separadamente a Faturamento e Custo. Meta Margem % = Meta Cash Margem ÷ Meta Faturamento. A meta não tem granularidade por Grupo/Cliente. KG Fumo, Papel e Produto Estratégico são parte da Meta Geral (não somam a ela) e têm aba própria — ver "Metas KG Fumo, Papel e Estratégico" no menu.

⚠ Estas 3 metas são parte da Meta Geral — o próprio ERP as cadastra como categorias de meta separadas (12=Produto Estratégico, 13=FUMO KG, 14=Papel) e o cálculo da Meta Geral já as exclui, então não devem ser somadas a ela nesta ou em nenhuma outra aba. KG Fumo é medido em kg (peso). Papel é medido em quantidade (unidade de embalagem padrão do produto), não em R$. Produto Estratégico: o realizado soma o valor vendido dos produtos da lista oficial (`produtos_estrategicos`) em todas as categorias em que aparecerem, não só em uma categoria específica. Com um mês selecionado, meta e realizado usam o valor exato daquele mês (não o semestre inteiro). Esta aba não tem granularidade por Grupo/Cliente — só por Gerente/Supervisor/Vendedor/Mês.

⚠ Agregação por dia da semana (Segunda a Sexta) usando a data real de cada pedido (dataped) — fins de semana não entram na média. O seletor "Base de comparação" troca a janela usada: Últimos 90 dias (janela móvel que sempre termina hoje, independente do filtro de Período do topo da tela — pode incluir dias de dois semestres diferentes), Mês vigente (do dia 1 até hoje) ou Semestre anterior (o semestre calendário fechado imediatamente antes do atual). Cada base compara com a mesma janela um ano antes, quando houver dado. Esta aba só é recortável por Gerente (não por Supervisor/Vendedor) — só existe cubo diário nesse nível.

⚠ Sempre os últimos 90 dias corridos até hoje (janela móvel, independente do filtro de Período do topo da tela — mesmo critério de Estoque x Venda/Clientes de A a I). Clique em um dia da semana para ver as categorias, e numa categoria para ver os 10 produtos mais vendidos dela naquele dia (por Faturamento). Recortável por Gerente/Supervisor/Vendedor e Categoria, como as demais abas — com filtro de hierarquia ativo, a consulta é feita sob demanda no banco (leva alguns segundos).

⚠ A coluna "Δ vs ano ant." busca o mesmo nome no Top 50 do período anterior. Se o item cresceu para o Top 50 agora mas não estava entre os maiores no ano passado, aparece "sem hist." (a receita antiga existe na base, só não está nesse recorte pré-agregado).

⚠ Sem uma base de clientes cadastrados (universo total), a "positivação" aqui é um proxy: nº de meses do semestre em que o cliente comprou. Cross-referência com o cadastro completo de clientes é necessária para o indicador oficial.

⚠ Candidatos = clientes que já estão no Top 50 de receita de algum vendedor (mesma fonte da tabela acima) — não é a carteira inteira, mas garante que todo vendedor apareça com os clientes mais relevantes dele. Produtos por mês/categoria vêm do período selecionado.

⚠ Racional da classificação: o Faturamento e a Margem de cada cliente são SEMPRE a soma dos últimos 90 dias corridos a partir de hoje — não mudam com o filtro de Período no topo da tela. Cada dimensão tem DOIS limites de referência: igual ou acima do limite "Alto/Alta" = Alto/Alta; igual ou abaixo do limite "Baixo/Baixa" = Baixo/Baixa; entre os dois = Médio/Média. Cruzando Faturamento (Alto/Médio/Baixo) × Margem (Alta/Média/Baixa) formam-se 9 grupos. Os valores padrão (Faturamento Alto ≥ R$ 4.000, Baixo ≤ R$ 800; Margem Alta ≥ 27%, Baixa ≤ 18%) podem ser substituídos pelos seus próprios valores de referência abaixo; a classificação inteira recalcula na hora. Os 9 grupos: A Alta Venda + Alta Margem (clientes-âncora), B Alta Venda + Média Margem, C Alta Venda + Baixa Margem (rever desconto/mix), D Venda Média + Alta Margem (espaço para crescer volume), E Venda Média + Média Margem, F Venda Média + Baixa Margem (rever mix), G Baixa Venda + Alta Margem (nicho — bom mix, falta volume), H Baixa Venda + Média Margem, I Baixa Venda + Baixa Margem (menor prioridade).

⚠ Este painel foca sempre no mês vigente (hoje), independente do filtro de Período/Mês do restante da tela — mesmo critério de "sempre até hoje" já usado em Estoque x Venda e Clientes de A a I. Usa as mesmas metas e realizados de Acompanhamento Objetivos (Faturamento por Categoria) e Metas KG Fumo, Papel e Produto Estratégico. Ritmo diário = valor ÷ dias úteis decorridos no mês; Tendência = ritmo atual projetado para todos os dias úteis do mês; a ação recomendada indica o ritmo necessário nos dias úteis restantes para fechar em 100% da meta.

⚠ Positivação de categoria aqui = % dos clientes ativos do período que compraram pelo menos 1 item dessa categoria (dado real, não estimado). Os planos são gerados a partir de regras objetivas sobre os números do próprio período (comparação com a média da empresa e com o ano anterior) — não é IA analisando texto, é lógica determinística sobre os dados. Categorias abaixo de 100% de atingimento ganham uma Parte 4 — Oportunidades de Cross-Sell: até 5 clientes reais (Top 50 de receita de cada vendedor) que já compram a categoria mas não os produtos mais vendidos dela, e até 5 clientes que compram a categoria mais correlacionada (por co-ocorrência real na base) mas não esta — com Gerente/Supervisor/Vendedor/Cliente, produto sugerido, potencial de faturamento (cenário ilustrativo) e prioridade (Alta/Média/Baixa). Atualiza sozinho a cada ciclo do ETL, conforme novas vendas entram.

⚠ Somente vendedores ativos no cadastro hoje (mesma trava usada em todo o painel) — vendedor desligado não aparece, mesmo que tenha vendido no período; não há regra de redistribuição de carteira no sistema. Base = ano civil vigente inteiro (não o semestre). Média mensal = receita total do vendedor ÷ nº de meses fechados do ano em que houve venda (exclui o mês em andamento — que ainda não teve o período todo para vender — e não pune quem entrou no meio do ano). O mês em andamento aparece à parte, comparado com essa média, para visualizar a evolução do vendedor. Cada faixa é organizada por Supervisor → Vendedor: clique no vendedor para abrir o plano de ação de 3 meses. Grupo 1 (abaixo de R$150 mil/mês) recebe um plano para superar essa barreira; Grupo 2 (entre R$150 mil e R$200 mil/mês) recebe um plano para se consolidar acima de R$200 mil. Respeita os filtros de Gerente/Supervisor/Vendedor da barra lateral.

⚠ Fonte do estoque: tabela de posição de estoque por vendedor do banco (via API) — é uma fotografia de hoje do que cada vendedor carrega, sempre a mesma independente do filtro de Período (não existe "estoque de um semestre passado"). A "venda média/dia útil" usa os últimos 90 dias corridos reais (sempre até hoje) ÷ dias úteis reais do calendário (considera feriado nacional), por par vendedor×produto (cada Gerente/Supervisor/Vendedor usa o próprio ritmo de venda, não uma média da empresa). Dias de cobertura = valor de estoque ÷ valor médio vendido por dia útil — se um produto não vendeu nada nesses 90 dias, aparece como "sem venda" (pior que 90 dias). Alguns códigos de vendedor no estoque são centros de distribuição/contas de teste (ex.: "CD - SAO PAULO"), não vendedores de campo — mantidos aqui porque representam estoque físico real.

⚠ Mesmo dado da aba Estoque x Venda (remessa do vendedor × base de vendas dos últimos 90 dias corridos reais), só que organizado por Supervisor → Vendedor → Produto em vez de Categoria → Grupo → Produto — pra achar rápido quem está carregando produto parado.

⚠ Todo produto na remessa do vendedor cuja descrição comece com "(P)" — parado ou não (sem o filtro de >90 dias da aba anterior). Mesmo formato de cascata Supervisor → Vendedor → Produto.

⚠ Fotografia atual do contas a receber — não muda com o filtro de Período/Mês (dívida vencida não pertence ao mês da tela). Fontes: duplicatas em aberto e vencidas (creceber, saldo = valor − pago) e cheques devolvidos há mais de 30 dias e não pagos (chqrec). A carteira é a do vendedor do título (quem vendeu), subindo por Supervisor e Gerente. Respeita o filtro de Gerente/Supervisor/Vendedor da barra lateral.

⚠ Fotografia atual (sempre até hoje — não muda com o filtro de Período/Mês): clientes com cadastro Ativo, sem título vencido/cheque devolvido em aberto (mesma regra de Inadimplência por Carteira) e cujo último pedido foi há mais de 60 dias. Gerente/Supervisor/Vendedor = time responsável pelo pedido mais recente do cliente — e esse vendedor precisa estar ativo no cadastro hoje (mesma trava usada em todo o painel); cliente cujo último pedido foi com vendedor hoje desligado não entra nesta análise (não há regra de redistribuição de carteira no sistema). Categorias e média mensal de faturamento por categoria consideram os últimos 365 dias de histórico do cliente. Respeita o filtro de Gerente/Supervisor/Vendedor da barra lateral.

⚠ Fonte: colunas reais da base de vendas — tipo (documento fiscal: Danfe = Nota Fiscal Eletrônica / Cupom = Cupom Fiscal) e tipocob (forma de pagamento: BOLETO, DINHEIRO, PIX, CHEQUE, OUTROS — os 5 valores reais encontrados na base, "OUTROS" incluído por completude). Comparativo vs. mesmo semestre do ano anterior. Respeita os filtros globais de Categoria/Gerente/Supervisor/Vendedor já usados no resto do portal (mesma cascata Gerente → Supervisor → Vendedor).

⚠ Cada card é calculado diretamente dos números do período (concentração de portfólio, variação de clientes ativos, classificação A/B/C/D, margem por categoria, estoque parado) comparados à média da empresa e/ou ao mesmo semestre do ano anterior — não é um texto genérico, é lógica objetiva sobre a base real.

⚠ Hierarquia real: Categoria → Grupo → Fornecedor → Produto (coluna "fornecedor" da base de vendas, nunca usada nas outras abas). Clique em ⊞ para expandir. Positivação = clientes distintos reais em cada nível; Mix = nº de grupos/fornecedores/produtos distintos abaixo daquele nó (nível Produto não tem Mix). Por limite de tamanho do arquivo, cada Fornecedor mostra até 20 por Grupo e até 8 Produtos por Fornecedor (os maiores por Faturamento — "n_prod"/"n_for" no tooltip do nó mostram o total real, mesmo quando a lista é maior que isso). Esta aba não é recortável por Gerente/Supervisor/Vendedor/Grupo/Cliente/Mês neste cubo (só Categoria, via o filtro global) — comparativo sempre vs. mesmo semestre do ano anterior.

⚠ O deck reflete o filtro/escopo ativo AGORA na barra lateral (Gerente/Supervisor/Vendedor, Período) — o escopo usado aparece por escrito na capa e no rodapé de cada slide.