Transportes - Editar Veículo

O que é

A página Editar Veículo é o formulário usado para atualizar qualquer dado de um veículo já cadastrado na frota. Reúne em um único fluxo a foto, os dados de identificação (modelo, placa, Renavam, ano), o vínculo com a empresa de transporte, o tipo, a capacidade total, as comodidades e o status de ativação.

O usuário chega aqui a partir da listagem de veículos (clicando em Editar na linha) ou da página de detalhes do veículo (botão Editar no cabeçalho). É a tela usada sempre que a frota muda - placa nova, troca de empresa parceira, ajuste de capacidade após reforma, atualização de comodidades para divulgação no site ou retirada temporária de operação.

Como usar

1. Vá em Cadastros > Veículos no sidebar (URL "/admin/veiculos") e clique no botão Editar da linha do veículo desejado. Você cai em "/admin/veiculos/{veiculo}/edit".
2. No card Foto do Veículo, troque ou remova a imagem se necessário. O upload usa recorte 3:2 via Cropper; ao salvar uma foto nova, a anterior é descartada automaticamente.
3. No card Dados do Veículo, ajuste o que for preciso:
   • Empresa de Transporte - só lista transportadoras ativas.
   • Tipo de Veículo - Van, Micro-ônibus, Ônibus, Ônibus Leito, Ônibus Semileito, Ônibus Executivo, Ônibus Double Decker, Minivan ou Carro.
   • Capacidade Total - inteiro entre 1 e 100. Lugares de motorista e guia não entram nesta conta.
   • Nome/Modelo - texto livre (ex.: "Mercedes-Benz Sprinter").
   • Placa - caixa alta automática, sem caracteres especiais, máximo 7 dígitos, formato Mercosul (ABC1D23) ou antigo (ABC1234). Precisa ser única na sua empresa (a placa atual do próprio veículo é ignorada na validação).
   • Renavam - até 15 caracteres.
   • Ano de Fabricação - entre 1990 e o próximo ano.
4. No card Comodidades, marque ou desmarque os checkboxes: Ar Condicionado, Wi-Fi, Banheiro, TV, Tomadas e Reclináveis. Desmarcar um item zera o campo (false), não mantém o valor antigo.
5. (Opcional) Em Observações, atualize as anotações internas livres.
6. No rodapé, use o toggle Veículo ativo para ligar ou desligar o veículo. Inativo não aparece nas listas de alocação em excursões, mas o histórico é preservado.
7. Clique em Salvar Alterações para gravar e voltar para a página de detalhes do veículo. Para continuar editando sem sair da tela, escolha Salvar e continuar editando no dropdown ao lado do botão.

Casos especiais

Alterar a capacidade total com excursões futuras agendadas

Quando o campo Capacidade Total muda, o sistema percorre automaticamente as excursões futuras (data_inicio >= hoje) que já usam este veículo e sincroniza o campo vagas_total de cada vínculo para o novo valor. Excursões passadas não são tocadas. Importante: a quantidade de vagas vendidas não é checada nesse momento - se você reduzir a capacidade abaixo do número de passageiros já confirmados em alguma excursão futura, vai precisar resolver o excedente manualmente nessas excursões.

Trocar a foto do veículo

Ao subir uma foto nova pelo componente de upload, o arquivo antigo armazenado no S3 é apagado automaticamente (via trait CleansOldUploads). Se você só quiser remover a foto sem trocar, use o controle de remoção do próprio componente antes de salvar.

Configurar o mapa de assentos

O botão Configurar Assentos (canto superior direito, em roxo) leva direto para o editor de layout ("/admin/veiculos/{veiculo}/layout"). Use sempre que mudar o tipo de veículo ou a capacidade, para refazer o mapa. A capacidade cadastrada continua sendo a fonte da verdade; o mapa é uma representação visual.

Excluir o veículo

A página de edição não tem botão de exclusão. Para excluir, volte à listagem em Cadastros > Veículos, abra o dropdown de ações da linha do veículo e clique em Excluir. Aparece um modal de confirmação com a mensagem "Tem certeza que deseja excluir {modelo}? Esta ação não pode ser desfeita." A exclusão é lógica (soft delete) - o registro fica preservado no banco mas some das listas.

Campos personalizados (Custom Fields)

Se você configurou campos personalizados para a entidade veiculo, eles aparecem inline dentro do card Dados do Veículo (seção dados_gerais) e em cards separados abaixo (demais seções). Campos marcados como obrigatórios no catálogo passam a exigir preenchimento, inclusive os campos padrão Modelo, Placa, Renavam, Ano de Fabricação, Foto e Observações.

Erros comuns e como resolver

• "The placa has already been taken." - Causa: outro veículo da sua empresa já usa essa placa. Solução: confira se não é duplicidade de cadastro; se for placa correta, verifique se já existe outro registro do mesmo veículo.
• "The capacidade total field must be at least 1." - Causa: campo Capacidade Total vazio, zero ou negativo. Solução: informe um inteiro de 1 a 100.
• "The transporte id field is required." - Causa: Empresa de Transporte não selecionada. Solução: escolha uma transportadora ativa da lista.
• "The tipo field is required." - Causa: o seletor Tipo de Veículo ficou em branco. Solução: selecione um dos nove tipos suportados.
• "The ano fabricacao must be a number between 1900 and {ano+1}." - Causa: ano fora do intervalo válido. Solução: corrija para um ano entre 1900 e o próximo ano civil.
• "Veículo atualizado com sucesso!" - Confirmação de gravação. Se você usou Salvar e continuar editando, a página recarrega no modo edição; caso contrário, o sistema te leva para a página de detalhes.
• "Veiculo ativado com sucesso!" / "Veiculo desativado com sucesso!" - Mensagens do endpoint toggle-status, que pode ser disparado da página de detalhes. Veículo desativado não aparece nas listas de alocação de transporte das excursões.

Onde encontrar

• URL: /admin/veiculos/{veiculo}/edit
• Caminho no menu: Cadastros > Veículos (botão Editar na linha do veículo)
• Permissão necessária: editar os transportes (para atualizar e alternar status) e excluir os transportes (para excluir pela listagem)
• Módulo necessário: nenhum

Veja também

• Cadastrar Veículo
• Detalhes do Veículo
• Configurar Assentos
• Layout de Assentos
• Cadastrar Empresa de Transporte
• Vincular Transporte a Excursão