Skip to main content

Mapeamento de Domínio e Regras de Negócio

Outros documentos: ver Visão do Produto/CRM Proteção Veicular · Arquitetura/Decisões Técnicas e Arquiteturais · Jornadas/Jornada Comercial


1. Mapeamento de Entidades Core

EntidadeDescrição Comercial
LeadPotencial cliente recém captado; possui apenas contato básico.
ClientePessoa Física ou Jurídica com documentação validada.
VeículoO bem a ser protegido. Um Cliente pode ter múltiplos Veículos.
PlanoO produto vendido (regras de preço, vigência e se exige vistoria).
Proposta / CotaçãoA oferta formal gerada pelo Consultor para 1 Veículo.
VistoriaInspeção (fotos + geo + laudo) para validar o estado do veículo.
ContratoO acordo jurídico a ser assinado.
TimeGrupo de consultores organizados em hierarquia multinível dinâmica (N1-N).
TarefaAção agendada (Ligação, Reunião, Follow-up) com prazo e responsável.
Evento (Timeline)Registro imutável de uma ação ocorrida no sistema (Lead criado, WhatsApp enviado).
AutomaçãoRegra de negócio configurável (Gatilho → Ação) para facilitar o processo.
Regra de ComissãoDefinição de percentual/valor por plano, cargo e nível na hierarquia.
Configuração de IntegraçãoCadastro do provedor (WhatsApp, DocuSign, ERP) na conta do Tenant.

2. Casos de Uso Core (Features)

  1. Gestão de Leads: Como consultor, eu quero cadastrar Leads e enviar propostas comerciais com dados mínimos de contato e do veículo, para depois convertê-los em Clientes no momento do fechamento.
  2. Cotação e Propostas: Como consultor, eu quero gerar múltiplas propostas para o veículo de um Lead/Cliente, para que ele possa escolher a opção ideal.
  3. Vistoria Self-Service: Como consultor/vistoriador, eu quero enviar um link seguro (com token) para que o próprio cliente tire fotos do veículo e envie o laudo.
  4. Automação de Contrato: Como gerente, eu quero que, ao aprovar uma vistoria, o sistema automaticamente gere o PDF do contrato e envie o link de assinatura digital ao cliente.
  5. Painel Hierárquico: Como gestor, eu quero visualizar a árvore de consultores sob minha gestão para analisar métricas de vendas e produção agregada.
  6. Agenda e Tarefas: Como Consultor, eu quero registrar e visualizar minhas ligações, retornos e follow-ups do dia para não perder o timing das vendas.
  7. Timeline do Cliente: Como vendedor, eu quero ver o histórico completo (eventos) de tudo que aconteceu com um lead/cliente em uma linha do tempo única (estilo HubSpot).
  8. Motor de Automação: Como administrador, eu quero criar regras de ação-reação ("se X acontecer, faça Y") para automatizar follow-ups e alertas de ociosidade.
  9. Comissionamento Cascata: Como administrador, eu quero configurar as regras de divisão de comissão (por plano, cargo e nível N1-N) para automatizar o split financeiro.

3. Regras de Negócio Inegociáveis

  1. Qualificação Comercial Flexível (Conversão no Contrato): O Lead pode receber Propostas/Cotações e realizar/aprovar a Vistoria (presencial ou por link self-service) usando apenas dados mínimos de contato e do veículo, reduzindo o atrito de vendas difíceis. A aprovação da vistoria não converte o lead automaticamente. A promoção formal de Lead para Cliente (conversão) ocorre estritamente na emissão ou assinatura do Contrato, instante no qual a validação e preenchimento de CPF/CNPJ, RG e endereço completo tornam-se de fornecimento obrigatório pelo cliente.
  2. Vínculo Proposta 1:1 Veículo: Cada proposta gerada deve apontar para apenas um veículo específico. Para frotas, geram-se múltiplas propostas.
  3. Exclusão Mútua de Propostas: Ao fechar/assinar uma proposta, todas as outras propostas abertas atreladas àquele mesmo veículo são invalidadas (status Substituída).
  4. Condição de Vigência e Cobertura (Vistoria): A assinatura do contrato e a realização da vistoria podem ocorrer inverte-se. No entanto, se o plano contratado exigir vistoria, a ativação da cobertura operacional fica condicionada à aprovação desta. O contrato assinado permanece inativo (sem cobertura) no status AGUARDANDO_VISTORIA até que as fotos sejam aprovadas. O não envio no prazo limite configurado pelo tenant (ex: vistoria_prazo_envio_dias) ou a reprovação definitiva da vistoria cancelam o contrato automaticamente.
  5. Auditoria de Vistoria: Qualquer vistoria (feita por consultor ou cliente via link) obriga a captura via sistema de metadados invioláveis: Geolocalização (Lat/Lng) e Timestamp (data e hora da vistoria).
  6. Visibilidade Silo: Um consultor jamais enxerga a carteira de outro consultor, a não ser que este último esteja posicionado abaixo dele na hierarquia de time.

4. Estrutura de Integrações Exigidas (Mapeamento Funcional)

Para que as regras acima funcionem e o fluxo não quebre, o CRM mapeia a necessidade de se conectar a serviços externos para:

  • Bureau de Dados (FIPE): Para consultar modelo, ano e precificação base do veículo.
  • Provedor de Mensageria: Para disparar o Link de Vistoria e o Link de Assinatura (WhatsApp/SMS).
  • Provedor de Assinatura (e-Signature): Para validar juridicamente o aceite do contrato.
  • ERP Financeiro: Para delegar o faturamento e a ativação financeira final (ex: SGA Hinova).