Skip to main content

Módulo 12: Ativações & Vigência — UI

Status: Rascunho Inicial Regras de negócio: ver regras-negocio/12_ativacoes.md Domínio: ver dominio/plano-contratado.md


1. Fluxo de Navegação de Telas


2. Componentes da Interface

2.1 Perfil do Cliente (Visão Operacional / Gestão de Frota)

Ao contrário da visão de vendas (Lead/Proposta), a tela operacional foca na frota contratada e sua regularidade.

  • Mosaico / Lista de Veículos Protegidos:

    • Cada card representa um veículo e exibe: Placa (ou "Aguardando Emplacamento" em destaque amarelo), Marca, Modelo, Ano e o Badge de Status Operacional (ATIVO, INADIMPLENTE, SUSPENSO, CANCELADO).
    • Barra de vigência com indicador gráfico de tempo restante (ex: "Faltam 240 dias para expiração").
  • Seção de Faturamento Rápido (Proxy Hinova):

    • Lista as faturas mais recentes associadas ao veículo.
    • Exibe data de vencimento, valor e status do boleto (Pago, Pendente, Em Atraso).
    • Botão de Ação Rápida: "Copiar Código de Barras" e "Download do PDF do Boleto" (efetua chamada em background para a API do ERP e entrega o link direto para o consultor enviar ao cliente).

2.2 Painel de Ativações Pendentes (Financeiro)

Utilizado nos Tenants com configuração de gatilho PAGAMENTO_ADESAO sem baixa integrada ou que necessitam de intervenção manual.

  • Tabela de Pendências:
    • Lista contratos em status AGUARDANDO_ATIVACAO.
    • Exibe: Nome do Cliente, Veículo (placa/modelo), Consultor, Valor da Taxa de Adesão e Data da Assinatura do Contrato.
  • Ações:
    • Confirmar Pagamento e Ativar: Abre modal para preenchimento de recebido_em, valor_recebido e upload do comprovante. Dispara ativação operacional imediata.
    • Negar / Invalidar: Cancela o fluxo, devolvendo o status para comercial.

2.3 Modal de Emplacamento (Veículo 0km)

  • Exibido nos planos em que o veículo foi cadastrado sem placa.
  • Campos: Placa (com validação Mercosul/Antiga), Renavam e upload de documento do veículo (CRLV/Nota Fiscal).
  • Ação de salvar valida a placa e remove a tarefa comercial de cobrança no Módulo 14.

3. Indicadores Visuais de Status Operacional

StatusBadge UIDescrição na InterfaceAções Disponíveis
AGUARDANDO_ATIVACAOCinza / CharcoalAguardando liberação financeiraAtivar manualmente (Financeiro)
ATIVOVerdeVeículo com cobertura ativaCopiar link de boletos, Suspender, Cancelar
INADIMPLENTEAmareloMensalidade em atraso (com cobertura)Gerar segunda via de boleto
SUSPENSOLaranja / VermelhoProteção suspensa por inadimplênciaExibir termo de suspensão, Reenviar boleto + link vistoria
CANCELADOVermelhoProteção canceladaClonar dados para nova cotação

4. Alertas Importantes na Interface

  • Alerta de Inadimplência: Banner em destaque na barra superior do cliente informando atrasos de pagamento que possam comprometer a cobertura.
  • Aviso de Falta de Placa: Banner amarelo no veículo: "Este veículo foi ativado como 0km e está sem placa há X dias. Regularize o cadastro para evitar recusa de sinistro."