Módulo 12: Ativações & Vigência — UI
Status: Rascunho Inicial Regras de negócio: ver
regras-negocio/12_ativacoes.mdDomínio: verdominio/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").
- Cada card representa um veículo e exibe: Placa (ou "Aguardando Emplacamento" em destaque amarelo), Marca, Modelo, Ano e o Badge de Status Operacional (
-
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.
- Lista contratos em status
- Ações:
- Confirmar Pagamento e Ativar: Abre modal para preenchimento de
recebido_em,valor_recebidoe upload do comprovante. Dispara ativação operacional imediata. - Negar / Invalidar: Cancela o fluxo, devolvendo o status para comercial.
- Confirmar Pagamento e Ativar: Abre modal para preenchimento de
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
| Status | Badge UI | Descrição na Interface | Ações Disponíveis |
|---|---|---|---|
AGUARDANDO_ATIVACAO | Cinza / Charcoal | Aguardando liberação financeira | Ativar manualmente (Financeiro) |
ATIVO | Verde | Veículo com cobertura ativa | Copiar link de boletos, Suspender, Cancelar |
INADIMPLENTE | Amarelo | Mensalidade em atraso (com cobertura) | Gerar segunda via de boleto |
SUSPENSO | Laranja / Vermelho | Proteção suspensa por inadimplência | Exibir termo de suspensão, Reenviar boleto + link vistoria |
CANCELADO | Vermelho | Proteção cancelada | Clonar 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."