Sistema de Estrelas (Fidelidade)

O Sistema de Estrelas e o programa de fidelidade do Onepet2, baseado em categorias de produtos comprados e recencia das compras.

Como Funciona

O cliente ganha estrelas com base nas categorias de produtos que compra. Cada estrela tem uma validade em dias, e se o cliente nao renovar a compra dentro do prazo, a estrela fica inativa.

Configuracao

As estrelas sao configuradas no CRM Settings:

Configuracao	Descricao
star_category_ids	IDs das categorias que geram estrelas
star_category_ids_labels	Nomes de exibicao das categorias
days_for_stars	Dias de validade para cada estrela

Exemplo de Configuracao

Estrela 1: Racao (categoria_id: 123) - Validade: 30 dias
Estrela 2: Higiene (categoria_id: 456) - Validade: 45 dias
Estrela 3: Acessorios (categoria_id: 789) - Validade: 60 dias
Estrela 4: Medicamentos (categoria_id: 012) - Validade: 90 dias
Estrela 5: Petiscos (categoria_id: 345) - Validade: 30 dias

Estrutura da Estrela

Cada estrela armazena:

Campo	Tipo	Descricao
_id	ID	ID da categoria de estoque
label	Texto	Nome da categoria
days	Numero	Dias de validade
last_sale_at	Data/Hora	Data da ultima compra

Calculo de Estrelas

Processo de Calculo

Para cada categoria configurada:

1. Busca compras - Encontra todos os CartItems pagos do cliente na categoria
2. Identifica ultima compra - Pega a data mais recente
3. Verifica validade - Compara com a data atual

Status da Estrela

Status	Condicao	Exibicao
ATIVA	dias desde compra menor ou igual a validade	Estrela colorida (amarela)
INATIVA	dias desde compra maior que validade	Estrela opaca (cinza)
SEM	Nunca comprou na categoria	Estrela vazia

Visualizacao

No Perfil do Cliente

Ate 5 estrelas sao exibidas:

★ ★ ★ ☆ ☆
Racao  Higiene  Acessorios  (inativo)  (inativo)

Legenda Visual

Icone	Significado
★ (amarelo)	Estrela ativa
☆ (cinza)	Estrela inativa/vencida
-	Sem estrela configurada

Tooltip

Ao passar o mouse sobre uma estrela:

• Nome da categoria
• Data da ultima compra
• Dias restantes de validade

Atualizacao das Estrelas

As estrelas NAO sao atualizadas automaticamente a cada venda. Sao recalculadas por:

1. Jobs em background - Periodicamente
2. Acesso ao perfil - Quando cliente e visualizado
3. Relatorios - Ao gerar relatorios RFM

Metodos de Atualizacao

Metodo	Comportamento
calculate_stars	Calcula e retorna (nao salva)
calculate_stars!	Calcula e persiste no banco

Uso em Segmentacao

Filtros por Quantidade de Estrelas

Clientes podem ser filtrados por quantidade de estrelas ativas:

Filtro	Descricao
1 estrela	Clientes com exatamente 1 estrela ativa
2 estrelas	Clientes com exatamente 2 estrelas ativas
3 estrelas	Clientes com exatamente 3 estrelas ativas
4 estrelas	Clientes com exatamente 4 estrelas ativas
5 estrelas	Clientes com exatamente 5 estrelas ativas

Uso em Campanhas

Estrelas podem ser usadas para segmentar campanhas:

Regras de Negocio

Renovacao de Estrela

1. Cliente compra produto da categoria
2. Sistema atualiza last_sale_at para data atual
3. Estrela volta a ficar ativa
4. Contador de validade reinicia

Perda de Estrela

1. Cliente nao compra na categoria
2. Dias passam alem da validade
3. Estrela fica inativa (nao e removida)
4. Historico mantem ultima compra

Limite de Estrelas

• Maximo de 5 estrelas por cliente
• Cada estrela representa uma categoria diferente
• Nao ha estrelas duplicadas por categoria

Integracao com PDV

Quando uma venda e finalizada:

1. Sistema identifica categorias dos produtos vendidos
2. Para cada categoria configurada como estrela:
   • Atualiza last_sale_at do cliente
3. Proximo calculo mostrara estrela ativa

Configuracao de Categorias

Adicionar Categoria de Estrela

1. Acesse CRM Settings
2. Na secao de estrelas, adicione a categoria
3. Defina a validade em dias
4. Defina o label de exibicao

Remover Categoria de Estrela

1. Acesse CRM Settings
2. Remova a categoria da lista
3. Clientes manterao historico, mas estrela nao sera exibida

Boas Praticas

Escolha de Categorias

• Escolha categorias de consumo recorrente (racao, higiene)
• Defina validades realistas para o ciclo de compra
• Limite a 5 categorias mais importantes

Validade

Tipo de Produto	Validade Sugerida
Racao	30 dias
Higiene	45 dias
Medicamentos	60-90 dias
Acessorios	60 dias
Petiscos	30 dias

Monitoramento

• Acompanhe a evolucao de estrelas da base
• Identifique clientes perdendo estrelas
• Crie campanhas de reativacao

Relatorio de Estrelas

O sistema permite exportar:

• Lista de clientes por quantidade de estrelas
• Clientes com estrelas prestes a vencer
• Historico de evolucao de estrelas

Restricoes

1. Maximo 5 estrelas: Limite fixo do sistema
2. Categorias unicas: Uma categoria = uma estrela
3. Calculo sob demanda: Nao e automatico em tempo real
4. Dependencia de vendas: So considera vendas finalizadas e pagas