CRM — Gestão de Clientes

Tempo estimado: 2 minutos por cliente

Para Que Serve

Em vez de "cliente" virar invisível depois que pagou e foi embora, o CRM mantém:

• Histórico de pedidos — o que pediu, quando, quanto gastou
• Preferências — alergias, restrições alimentares, mesa preferida
• Tags — VIP, vegano, "sempre pede sem cebola"
• Notas livres — informações úteis para a próxima visita

Resultado: na 5ª visita, atendente sabe que João não come glúten e prefere mesa janela.

Onde Acessar

/admin/crm lista todos os clientes (cadastrados + identificados em comandas).

Cadastrando

3 caminhos:

1. Cliente cadastra-se

No app/site, cliente cria conta com nome + email + telefone. CRM já tem dados básicos.

2. Identificação no PDV

Atendente pergunta na hora de pagar: "Posso identificar para fidelidade?"

• CPF / email / telefone
• Sistema busca; se existe, vincula. Se não, cria.

3. Manual no admin

CRM → Novo cliente:

• Dados básicos (nome, contato)
• Aniversário (para campanha)
• Notas iniciais

Perfil do Cliente

Painel completo:

Aba "Geral"

• Foto (se cadastrou)
• Dados pessoais
• Endereços salvos
• Tier de fidelidade + saldo de pontos

Aba "Histórico"

• Todos os pedidos (cronológico)
• Total gasto
• Ticket médio dele
• Item mais pedido
• Padrão (sempre vem terças? aniversário?)

Aba "Preferências"

• Alergias ⚠️ — campo destacado, vermelho. Aparece em banner no PDV ao identificar o cliente
• Restrições alimentares — vegano, sem glúten, kosher, halal
• Preferências de serviço — "longe da TV", "sem música alta", "rápido"

Aba "Tags"

Sistema sugere ou você cria:

• VIP (top 5% gastadores)
• Frequente (≥ 4 visitas/mês)
• Em risco (não vem há 60 dias)
• Aniversariante do mês
• Custom (digite seu)

Tags alimentam segmentação de campanhas.

Aba "Notas"

Texto livre. Útil para:

• "Trabalha no prédio vizinho — sempre vem 12h"
• "Reclamou da última lasanha — oferecer cortesia na próxima"
• "Marido alérgico, não dele"

Notas são vistas por staff. Nada sensível.

Alergia → Cozinha

Quando cliente identificado faz pedido:

1. Sistema captura alergias do perfil
2. Snapshot vai junto com o pedido (Order.customerAllergies)
3. KDS mostra banner vermelho no ticket: "⚠️ ALÉRGICO A: amendoim, glúten"
4. Histórico mantém — auditável se cozinha negligenciar

Snapshot é importante: se você editar alergia depois, pedidos antigos mantêm o que valia na hora. Auditoria preservada.

Segmentação

Em CRM → Segmentos:

Pré-construídos

• Champions (RFM alto: recente, frequente, monetário)
• Em risco (frequente mas parou)
• Lapsed (sumiu há 90+ dias)
• Aniversariantes do mês

Custom

Filtre por:

• Frequência (último período)
• Ticket médio
• Tag
• Aniversário no mês
• Visitou X vezes nos últimos Y dias

Salve segmento. Use em campanhas.

Campanhas

Veja loyalty.md e intelligence-briefs.md. Em resumo:

• AI gera drafts semanalmente para cada segmento (RFM)
• Você revisa e aprova antes do envio
• Email + WhatsApp (se opt-in)

Privacy / LGPD

• Cliente pode pedir exclusão dos dados via /lgpd/dsr (portal público)
• Você cumpre em 15 dias
• Sistema anonimiza o registro mantendo o histórico de pedidos (CPF na NF-e é fixo por lei)

Veja lgpd-rights.md para detalhes.

Erros Comuns

• "Cliente diz que tem perfil mas não acho" — busque por todos os campos: nome, email, telefone, CPF. Pode ter sido cadastrado por outro caminho.
• "Alergia não está aparecendo no KDS" — verifique: cliente foi identificado no momento do pedido? Se foi guest, alergia não viaja com o pedido.
• "Notas estão sumindo" — notas estão no perfil; pedidos são separados. Confirme onde está editando.