Fidelidade - Clientes do Programa

O que é

A página Clientes do Programa lista todos os clientes que ja estao inscritos no programa de fidelidade da sua empresa, com saldo de pontos, nivel (tier) e status de cada participante. E o ponto de entrada para auditar quem ganhou pontos, abrir o perfil de fidelidade de um cliente e fazer ajustes manuais de saldo.

Os clientes não são adicionados manualmente nesta tela - eles entram no programa automaticamente quando executam ações que geram pontos (compras, indicacoes, bonus de aniversario, etc.). Por isso o uso tipico aqui e consulta, conferencia e ajuste, e não cadastro.

Como usar

1. Va em Fidelidade > Clientes do Programa no sidebar (a entrada Programa de Fidelidade so aparece se o módulo Fidelidade estiver ativo).
2. Use a barra de filtros logo abaixo do cabecalho Clientes do Programa para refinar a lista:
   • Buscar por nome, email ou telefone... - busca em qualquer um dos tres campos do cliente vinculado.
   • Status - filtra por Todos os status, Ativos, Inativos ou Suspensos.
   • Nivel - filtra por um dos tiers cadastrados, Sem nivel (ainda não classificado) ou Todos os niveis. O filtro so aparece se ja existirem tiers no programa.
   • Saldo - escolha Com saldo para esconder quem esta com saldo zerado.
3. Cada item da lista mostra avatar, nome, email, saldo de pontos, nivel, total acumulado e a data da última movimentacao. Status diferente de ativo aparece como tag vermelha ao lado do nome.
4. Clique no nome do cliente para abrir o perfil de fidelidade dele.
5. No perfil, você ve quatro cards de resumo (Saldo Atual, Total Acumulado, Total Resgatado, Nivel), os dados cadastrais e o Extrato de Transacoes paginado (data, descrição, origem, pontos e saldo após a transacao).
6. Se você tiver a permissão fidelidade.adjust_points, clique em Ajustar Pontos (botao roxo no canto superior direito do perfil) para creditar ou debitar pontos manualmente. Informe a quantidade de pontos (positiva para creditar, negativa para debitar - zero não e aceito) e o motivo do ajuste. O ajuste e registrado no extrato com o motivo informado.

A lista vem ordenada por pontos acumulados (do maior para o menor) e e paginada de 15 em 15. Os filtros e a busca são preservados ao mudar de página (withQueryString).

Casos especiais

Cliente removido aparece como "Cliente removido"

Quando o cliente vinculado ao registro de fidelidade foi excluido do cadastro mas o histórico de pontos permaneceu, o item da lista mostra Cliente removido no lugar do nome. O registro continua acessivel para consulta do extrato e auditoria.

Filtrar quem ainda não tem nivel

Escolha Sem nivel no select Nivel. Util para identificar clientes que entraram no programa mas ainda não atingiram a faixa minima de pontos do primeiro tier configurado. Para criar/ajustar os tiers, va em Niveis do Programa.

Programa não existe ainda

Se você nunca configurou o programa, o controller cria um programa padrão automaticamente ao acessar a página (via getOuCriarPrograma). A lista aparece vazia com a mensagem Nenhum cliente no programa e a descrição Os clientes serão adicionados automaticamente ao realizarem ações que concedem pontos.

Ajuste de pontos sem permissão

O botao Ajustar Pontos so aparece para quem tem a permissão fidelidade.adjust_points. Mesmo que o usuário consiga ver a lista e o perfil (com ver a fidelidade), a ação de credito/debito manual fica oculta.

Erros comuns e como resolver

• "Informe a quantidade de pontos." - Causa: o campo de quantidade ficou vazio ao ajustar pontos. Solucao: digite um número inteiro diferente de zero (positivo credita, negativo debita).
• "A quantidade de pontos não pode ser zero." - Causa: foi enviado 0 no ajuste. Solucao: informe um valor positivo ou negativo, nunca zero.
• "Informe o motivo do ajuste." - Causa: o campo de motivo ficou em branco. Solucao: escreva uma justificativa curta (ate 255 caracteres) - ela fica salva no extrato do cliente.
• Saldo insuficiente ao tentar debitar - Causa: o serviço não permite deixar o saldo negativo (ajustarPontos lanca InvalidArgumentException quando o debito excede o saldo). Solucao: confira o Saldo Atual no topo do perfil e reduza o valor do debito.

Onde encontrar

• URL: /admin/fidelidade/clientes
• Caminho no menu: Programa de Fidelidade > Clientes do Programa
• Permissão necessária: ver a fidelidade (lista e perfil) e fidelidade.adjust_points (botao Ajustar Pontos)
• Módulo necessário: Fidelidade

Veja também

• Painel do Programa de Fidelidade
• Niveis do Programa
• Regras de Acumulo
• Recompensas
• Resgates
• Indicacoes
• Configuração do Programa