Skip to main content

Módulo 07: Veículos & FIPE — UI

Status: Rascunho Inicial Regras de negócio: ver regras-negocio/07_veiculos_fipe.md Domínio: ver dominio/veiculo.md

1. Fluxo de Navegação de Telas​

2. Modal: Adicionar Veículo​

Acessado a partir do Perfil do Cliente, o modal possui duas abas:

2.1 Aba "Busca por Placa" (Consulta Rápida)​

  • Campo único: Placa (máscara MERCOSUL e formato antigo).
  • Ao digitar e confirmar, o sistema chama a API externa e preenche automaticamente: Marca, Modelo, Ano de Fabricação, Ano Modelo, Chassi mascarado e Código FIPE.
  • O consultor pode revisar e ajustar os campos pré-preenchidos antes de salvar.
  • Se a API externa falhar: exibe mensagem de erro amigável e oferece opção de alternar para "Entrada Manual".

2.2 Aba "Entrada Manual"​

Usada quando a placa não está disponível (veículo 0km, carro do interior sem dados na API, etc.):

  1. Tipo — Select: Carro, Moto, Caminhão, Bicicleta, Outros
  2. Marca — Dropdown alimentado pelo cache local FIPE (filtrado pelo tipo)
  3. Modelo — Dropdown dependente da Marca (cache local)
  4. Ano — Dropdown dependente do Modelo; exibe também o valor FIPE atual de cada opção

Para tipos não tabelados (Bicicleta, Outros), os dropdowns de Marca/Modelo/Ano são substituídos por campos de texto livre e um campo "Valor Declarado (R$)".

2.3 Campos Comuns (ambas as abas)​

CampoObrigatórioObservação
PlacaNãoAceita formato antigo e MERCOSUL. Pode ser omitida para 0km
ChassiNãoObrigatório se Placa ausente
RenavamNão
CorNão

3. Tela: Detalhe do Veículo​

Acessada a partir do Perfil do Cliente, exibe:

3.1 Cabeçalho​

  • Marca + Modelo + Ano Modelo
  • Placa (ou "0km / sem placa")
  • Tipo (badge)
  • Código FIPE (se tabelado)
  • Valor FIPE atual (consultado em tempo real no cache local; exibe mês de referência)

3.2 Seções​

  • Dados do Veículo — todos os atributos com opção de edição inline (exceto tipo)
  • Propostas Associadas — lista de propostas com status e data de criação
  • Contratos — contratos ativos e encerrados vinculados ao veículo
  • Vistorias — histórico de vistorias realizadas

3.3 Ações Disponíveis​

  • Editar Dados — permite alterar marca, modelo, cor, placa, chassi, renavam. tipo é imutável.
  • Nova Proposta — inicia o fluxo de cotação (Módulo 08). Desabilitado com tooltip explicativo se o plano exigir FIPE e o codigo_fipe estiver ausente.

4. Indicadores Visuais​

SituaçãoIndicador
Veículo com FIPE válidoBadge verde "FIPE Disponível" + valor e mês de referência
Veículo sem codigo_fipeBadge amarelo "Sem Código FIPE"
Tabela local desatualizada (> 35 dias)Aviso de sistema no topo da tela para Admin
Veículo não tabeladoBadge neutro "Valor Declarado" com o valor informado