Fidelidade - Visão Geral

O que é

O Dashboard de Fidelidade é a tela inicial do módulo Programa de Fidelidade. Concentra, em uma única página, o status do programa, seis indicadores numéricos (KPIs), a distribuição de clientes por nível, o ranking dos cinco maiores acumuladores e as dez transações mais recentes (créditos e débitos de pontos).

Normalmente o usuário chega aqui pelo menu Módulos > Programa de Fidelidade. Quem está abrindo o módulo pela primeira vez vê um banner roxo de Configuração Rápida; quem já tem regras configuradas mas pausou o programa vê um alerta amarelo. empresas com o programa em pleno funcionamento usam esta tela como termômetro diário do engajamento.

Como usar

1. Vá em Módulos > Programa de Fidelidade no sidebar.
2. Confira o subtítulo do cabeçalho: aparece o nome do programa seguido de Programa ativo ou Programa pausado.
3. Se houver banner roxo Configure seu programa em minutos, clique em Configuração Rápida para abrir o assistente.
4. Leia a faixa de seis KPIs no topo:
   • Clientes no programa - total geral de clientes cadastrados no programa.
   • Clientes ativos - clientes marcados como ativos (não cancelados/bloqueados).
   • Saldo em circulacao - soma dos saldos atuais, formatada na moeda do programa.
   • Emitidos este mês - pontos creditados desde o primeiro dia do mês corrente.
   • Resgatados este mês - pontos debitados (em valor absoluto) no mês corrente.
   • Total acumulado (geral) - soma histórica de tudo que já foi acumulado.
5. Use o painel Distribuicao por Nivel (lado esquerdo) para ver quantos clientes estão em cada tier e a porcentagem correspondente. Esse bloco só aparece quando o programa tem tiers ativos e existe pelo menos uma distribuição.
6. No bloco Top Clientes (lado direito) clique no nome de qualquer cliente para abrir a ficha completa com histórico e ajuste manual de pontos.
7. Role até Ultimas Transacoes para inspecionar as dez movimentações mais recentes (data, cliente, origem, pontos com sinal e saldo posterior). Clique em Ver todos os clientes para ir à listagem completa.

Casos especiais

Programa nunca configurado

Quando o programa está pausado e ainda não existe nenhuma regra de acúmulo cadastrada, o dashboard mostra um banner roxo chamando a Configuração Rápida (assistente que cria regras, níveis e recompensas padrão de uma vez). Use esse caminho para a primeira configuração; depois você ainda pode editar tudo nas telas específicas.

Programa pausado com regras já existentes

Se o programa estiver pausado mas já houver regras cadastradas, aparece um alerta amarelo informando que os clientes não estão acumulando pontos, com link Ativar programa que leva direto para a tela de Configuração para reativar.

Sem tiers ativos

Se o programa não usa níveis (tiers desativados na configuração) o bloco Distribuicao por Nivel não é renderizado e o dashboard fica apenas com KPIs + Top Clientes + Últimas Transações.

Cliente removido aparecendo no Top ou nas Transações

Se um cliente foi excluído mas ainda tem registro de fidelidade, a lista mostra Cliente removido no lugar do nome. O ranking continua válido pelos pontos acumulados.

Programa sem movimento

Quando ainda não há transações registradas, o bloco Ultimas Transacoes exibe Nenhuma transacao registrada ainda.. Quando não há clientes inscritos, Top Clientes exibe Nenhum cliente no programa ainda..

Erros comuns e como resolver

• KPIs zerados mesmo com vendas acontecendo - Causa: nenhuma regra de acúmulo ativa ou programa pausado. Solução: vá em Configuração para ativar o programa e em Regras de Acúmulo para cadastrar pelo menos uma regra (ex: 1 ponto por real gasto).
• Bloco Distribuicao por Nivel não aparece - Causa: tiers desativados ou nenhum cliente em nenhum tier. Solução: ative tiers em Configuração e cadastre níveis na tela Níveis do Programa.
• Pontos emitidos no mês não batem com vendas - Causa: vendas anteriores ao primeiro dia do mês corrente não entram nesse KPI; ele só conta o intervalo do mês atual. Solução: comparar com o KPI Total acumulado (geral) ou abrir o histórico de transações na ficha do cliente.

Onde encontrar

• URL: /admin/fidelidade (também atendida em /admin/fidelidade)
• Caminho no menu: Módulos > Programa de Fidelidade
• Permissão necessária: ver a fidelidade
• Módulo necessário: Fidelidade (uma trava de acesso)

Veja também

• Configuração do Programa de Fidelidade
• Regras de Acúmulo
• Níveis do Programa
• Recompensas
• Clientes Fidelidade
• Resgates
• Indicações