Cadastro de Cliente

O Customer (Cliente) e a entidade central do CRM, representando pessoas fisicas ou juridicas que sao clientes do petshop.

Descricao

Clientes podem ser consumidores finais (varejo) ou empresas (atacado). O sistema detecta automaticamente o tipo de pessoa com base no documento informado (CPF ou CNPJ).

Dados

Identificacao

Campo	Tipo	Obrigatorio	Descricao
name	Texto	Sim	Nome completo ou razao social
whatsapp	Telefone	Sim	WhatsApp principal (usado para comunicacao)
cpf_or_cnpj	Texto	Nao	CPF ou CNPJ (unico por Account)
email	Texto	Nao	Email de contato
phone	Telefone	Nao	Telefone alternativo
birth_date	Data	Nao	Data de nascimento
gender	Selecao	Nao	Genero: male, female, other

Classificacao

Campo	Tipo	Padrao	Descricao
type	Selecao	retail	Tipo: retail (varejo) ou wholesale (atacado)
person_type	Texto	Auto	PF (Pessoa Fisica) ou PJ (Pessoa Juridica)

Dados Fiscais

Campo	Tipo	Descricao
state_registration_number	Texto	Inscricao Estadual
city_registration_number	Texto	Inscricao Municipal

Preferencias e Segmentacao

Campo	Tipo	Descricao
benefit_club	Referencia	Clube de beneficios
knowledge_channel	Referencia	Como conheceu o petshop
tags	Multipla Escolha	Tags de segmentacao
obs	Texto Longo	Observacoes gerais
photos	Arquivos	Fotos do cliente

Vouchers

Campo	Tipo	Padrao	Descricao
voucher_limit	Monetario	0	Limite de voucher do cliente

Relacionamentos

Possui Muitos

Entidade	Descricao
pets	Animais do cliente (multiplos tutores possivel)
addresses	Enderecos de entrega/faturamento
sales	Vendas realizadas
payments	Pagamentos
credit_transactions	Transacoes de credito
cashback_transactions	Transacoes de cashback
beauty_packages	Pacotes de beleza
beauty_services	Servicos de estetica
cart_items	Itens no carrinho
activities	Historico de atividades
comments	Comentarios internos

Pertence a

Entidade	Descricao
account	Conta (multi-tenant)
benefit_club	Clube de beneficios
knowledge_channel	Canal de conhecimento
crm_settings	Configuracoes de CRM

Regras de Negocio

Deteccao Automatica de Tipo de Pessoa

O sistema detecta automaticamente se e PF ou PJ:

Validacoes

Campo	Validacao
name	Obrigatorio
whatsapp	Obrigatorio
cpf_or_cnpj	Unico por Account (se informado)
voucher_limit	Deve ser >= 0

Unicidade de CPF/CNPJ

• CPF ou CNPJ deve ser unico dentro da mesma Account
• Validado apenas se o campo estiver preenchido
• Permite clientes sem documento

Campos Calculados

Metricas de Vendas

Campo	Calculo	Descricao
ltv	Soma dos totais de vendas validas	Lifetime Value
average_ticket	ltv / sales_quantity	Ticket medio
sales_quantity	Contagem de vendas validas	Quantidade de compras
last_sale_date	Data da ultima venda	Ultima compra

Campos Financeiros

Campo	Calculo	Descricao
credit_value	Soma de credit_transactions	Saldo de credito
cashback_value	Soma de cashback_transactions	Saldo de cashback
pending_value	Soma de pagamentos pendentes	Valor em aberto

Campos de Pets

Campo	Calculo	Descricao
have_pets	number_of_pets > 0	Se tem pets
number_of_pets	Contagem de pets	Quantidade de pets

Automacoes

Ao Criar Cliente

1. Mensagem de Boas-Vindas
   • Se whatsapp informado
   • Cria WhatsappNotification
   • Tipo: "welcome"

Ao Salvar Cliente

1. Define person_type

   • Detecta formato do CPF/CNPJ
   • Define PF, PJ ou null

2. Atualiza contadores de pets

   • Recalcula number_of_pets
   • Atualiza have_pets

3. Sincroniza com pets

   • Adiciona customer_id aos pets vinculados
   • Remove customer_id dos pets desvinculados

Integracao com Pets

A relacao Cliente-Pet e many-to-many (N:N):

• Um cliente pode ter multiplos pets
• Um pet pode ter multiplos tutores (clientes)

Sincronizacao Bidirecional

Endereco Padrao

O cliente pode ter um endereco padrao para faturamento:

• Campo default_address armazena copia do endereco
• Atualizado automaticamente quando endereco muda
• Usado na emissao de notas fiscais

Filtros Disponiveis

Filtro	Tipo	Descricao
search	Busca	Nome, WhatsApp, CPF/CNPJ, email
person_type	Selecao	PF ou PJ
gender	Selecao	Genero
knowledge_channel	Selecao	Canal de conhecimento
type	Selecao	Varejo ou atacado
scope	Selecao	Com pets ou sem pets

Acoes Disponiveis

Acao	Descricao
index	Listar clientes
show	Ver detalhes
new/create	Criar cliente
edit/update	Editar cliente
destroy	Excluir cliente

Visualizacao

Lista (Tabela)

Colunas exibidas:

• Foto
• Nome (clicavel)
• WhatsApp
• CPF/CNPJ
• Quantidade de pets
• LTV
• Ticket medio
• Ausencia (dias)

Detalhes (Show)

Abas disponiveis:

• Atividades
• Sobre
• Enderecos
• Pets
• Pacotes
• Vendas
• Comentarios

Exportacao

• PDF: Formato A4, paisagem
• Excel: Relatorios RFM
• CSV: Relatorios RFM

Permissoes

Acao	Quem Pode
Criar	Usuarios com permissao CRM
Editar	Usuarios com permissao CRM
Excluir	Usuarios com permissao CRM
Ver	Usuarios com permissao CRM

Restricoes

1. CPF/CNPJ unico: Por Account
2. WhatsApp obrigatorio: Campo principal de contato
3. Voucher nao negativo: Limite >= 0
4. Sincronizacao de pets: Automatica e bidirecional