Skip to main content

Módulo 06: Leads & Clientes — UI

Status: Rascunho Inicial Regras de negócio: ver regras-negocio/06_leads_clientes.md Domínio: ver dominio/lead.md · dominio/cliente.md

1. Fluxo de Navegação de Telas​

2. Kanban de Leads (Consultor)​

Visualização em colunas para gestão ágil do funil:

  • Colunas: NOVO | EM_ANDAMENTO | QUALIFICADO
  • Card de Lead: exibe nome, temperatura (🔴🟡🟢), data do último contato e indicador de atraso.
    • Cards com atraso de contato dentro do limiar: borda amarela.
    • Cards com atraso que atingiram o limiar de alerta: borda vermelha.
  • Ações disponíveis no card:
    • Registrar Interação
    • Ligar (integração telefone/WhatsApp)
    • Ver Detalhes
    • Descartar (abre modal com motivo obrigatório)
    • Converter (ativo apenas no status QUALIFICADO)
  • Filtros: por status, por temperatura, por data de criação.

3. Perfil do Lead​

Visão 360° do contato em fase de prospecção:

3.1 Cabeçalho​

  • Nome completo (PF) ou razão social (PJ)
  • Status atual com badge colorido
  • Temperatura (quente / morno / frio)
  • Dados principais: telefone, e-mail, CPF/CNPJ (se preenchido)
  • Consultor responsável + data de criação

3.2 Timeline​

  • Histórico cronológico de todos os eventos: criação, interações, mudanças de status, alertas do sistema.
  • Cada evento exibe: tipo, descrição, autor e timestamp.
  • Eventos de sistema (alerta, expiração automática) são exibidos com ícone distinto.

3.3 Ações Disponíveis​

  • Registrar Interação — tipo (LIGACAO, WHATSAPP, EMAIL, REUNIAO) + descrição + data.
  • Agendar Tarefa — link para o Módulo de Tarefas (Módulo 14).
  • Editar Dados do Lead — formulário inline.
  • Descartar — modal com motivo obrigatório (seleção + campo livre).
  • Converter em Cliente — disponível apenas se status = QUALIFICADO. Abre modal de conversão.

3.4 Modal de Conversão​

Campos obrigatórios para a promoção Lead → Cliente:

  • CPF (PF) ou CNPJ (PJ) — com validação algorítmica em tempo real
  • Endereço completo: CEP (auto-preenchimento via API de CEP), logradouro, número, complemento, bairro, cidade, UF

Ao confirmar, o lead some do Kanban e o usuário é redirecionado ao Perfil do Cliente recém-criado.

4. Perfil do Cliente​

Visão 360° do contato formalizado:

4.1 Cabeçalho​

  • Nome completo / razão social + CPF/CNPJ
  • Status (ATIVO, INATIVO, BLOQUEADO) com badge
  • Lead de origem (link clicável)
  • Consultor responsável

4.2 Seções​

  • Dados Pessoais / Empresariais — editáveis (exceto tipo_pessoa e CPF/CNPJ)
  • Veículos Associados — lista de veículos com status e valor FIPE. Botão "Adicionar Veículo".
  • Propostas — lista de propostas ativas e encerradas por veículo.
  • Contratos — contratos assinados (link para Módulo de Contratos).
  • Timeline — histórico completo (unificado com o histórico do Lead de origem).
  • Tarefas Pendentes — integração com Módulo 14.

4.3 Ações Disponíveis​

  • Editar Dados — formulário inline para nome, telefone, e-mail, endereço.
  • Adicionar Veículo — inicia fluxo de consulta FIPE (Módulo 07).
  • Nova Proposta — disponível apenas se houver veículo cadastrado.

5. Gestão de Carteira (Gestor / Gerente)​

5.1 Visão em Lista​

  • Listagem de todos os leads e clientes dos consultores subordinados.
  • Filtros: por consultor, por time, por status, por data de inatividade.
  • Ordenação: por data de último contato (padrão decrescente).
  • Colunas: nome, status, consultor responsável, último contato, temperatura.

5.2 Redistribuição de Carteira​

  • Seleção múltipla de leads (checkbox).
  • Ação "Redistribuir Selecionados": abre modal com seleção do novo consultor (apenas consultores subordinados ao gestor).
  • Após confirmação, cada lead transferido recebe evento de sistema na sua timeline: "Lead redistribuído de [consultor A] para [consultor B] por [gestor X]".

5.3 Métricas​

  • Taxa de conversão: Leads → Clientes (por período e por consultor).
  • Tempo médio de primeiro contato após captação.
  • Volume de leads por status e por consultor.