Veículos
Cadastre a frota, vincule o mapa de assentos de cada veículo e declare os porões de carga.
A tela de Frota (item Veículos no menu) concentra o cadastro da frota: os dados de cada veículo, o mapa de assentos vinculado a ele e os porões de carga utilizados nas encomendas. Um veículo com mapa vinculado é pré-requisito para a venda de passagens por poltrona.
O layout de poltronas não é desenhado aqui. Ele é cadastrado em Mapas de Assentos e apenas vinculado ao veículo, o que permite que vários veículos compartilhem o mesmo layout.
Onde encontrar
Menu lateral → Gestão → Veículos. URL direta: /management/vehicles.
Permissões necessárias
| Ação | Permissão exigida |
|---|---|
| Visualizar a frota | vehicles.read |
| Criar, editar, excluir | vehicles.manage |
| Configurar mapa de assentos | vehicles.manage |
| Configurar porões de carga | vehicles.manage |
A tela em um relance
Frota
Veículos disponíveis para viagens. Clique para configurar assentos e cargas.
Estrutura:
- Cabeçalho com o título Frota e o botão Novo veículo.
- Dois cartões com a frota total e a capacidade de carga somada.
- Busca por placa, nome, marca ou modelo, e o alternador de visualização, em grade ou em lista. A busca é feita no servidor e passa a valer a partir de três caracteres digitados.
- Grade ou lista de cartões, um por veículo.
- Cartão Adicionar veículo ao final da grade.
Os cartões de estatística
| Cartão | O que mostra |
|---|---|
| Frota total | Quantidade de veículos exibidos, considerando a busca. À direita, a mesma contagem com a indicação no filtro. |
| Capacidade de carga | Soma do peso máximo declarado dos veículos exibidos. |
Anatomia de um cartão
| Parte | Descrição |
|---|---|
| A | Ícone com cor derivada da identificação, nome e placa. |
| B | Marca, modelo e cor. A linha aparece apenas quando algum campo está preenchido. |
| C | Carga máxima declarada. |
| D | Configurar, que abre a tela de detalhes, além das ações de editar e excluir, e do botão Ver agenda do veículo. |
Agenda do veículo
O botão de calendário, em cada cartão ou linha, abre a agenda do veículo: as
viagens que ocupam aquele veículo nos próximos 30 dias, do início do embarque ao
horário de chegada. É a mesma janela verificada pelo sistema na detecção de
conflito, e responde quando o veículo está livre antes de uma nova alocação. A
agenda é somente de consulta e exige a permissão trips.read.
Cada linha apresenta a data, os horários de embarque, partida e chegada, e o status da viagem. Uma viagem dispensada da verificação de conflito recebe a indicação Sobreposição.
Visualização em lista
Clique no ícone de lista ao lado da busca. Cada linha apresenta o ícone, o nome, a marca e o modelo, a placa e as ações: agenda, configurar, editar e excluir.
Criar um novo veículo
Abrir o formulário
Clique em Novo veículo ou no cartão Adicionar veículo.
Preencher os campos
Novo Veículo
| Campo | Obrigatório | Regra |
|---|---|---|
| Nome | Sim | Nome interno de exibição. Ex.: Ônibus São Paulo. |
| Placa | Sim | Formato antigo ABC-1234 ou Mercosul ABC1D23. O hífen é opcional: a placa é gravada sem hífen e em maiúsculas. |
| Marca | Não | Ex.: Mercedes, Volvo. Apresentada no cartão. |
| Modelo | Não | Ex.: Tourismo. Apresentado junto com a marca e a cor. |
| Cor | Não | Texto livre. Ex.: Branco. |
| Peso máximo (kg) | Não | Capacidade total de carga declarada, somada no painel. |
O cadastro não pede a quantidade de poltronas nem uma categoria de veículo. A capacidade vem do mapa de assentos vinculado ao veículo.
Salvar
Clique em Criar veículo. O veículo é criado sem mapa de assentos e a tela de detalhes abre automaticamente: vincule um mapa na aba Mapa de Assentos antes de programar viagens com ele.
Editar dados básicos
No cartão do veículo, clique no ícone de edição. O mesmo formulário abre com os dados atuais. Altere o que for necessário e clique em Salvar alterações.
Excluir um veículo
Abrir a confirmação
Clique no ícone de exclusão do cartão.
Excluir Veículo
Tem certeza que deseja excluir o veículo “Ônibus SP-01” (placa ABC1D23)? Esta ação não pode ser desfeita.
Confirmar
Clique em Excluir. A ação é irreversível e remove também os porões de carga do veículo. O mapa de assentos não é excluído, porque outros veículos podem utilizá-lo.
Um veículo utilizado por alguma viagem, inclusive concluída ou cancelada, não pode ser excluído: a exclusão é recusada e o veículo permanece na frota.
Tela de detalhes
Clicar em Configurar abre a página do veículo. O topo apresenta o link Voltar para Veículos, o nome, a placa e a indicação Ativo ou Inativo, seguidos de três abas.
Ônibus SP-01
ABC1D23
| Aba | Conteúdo |
|---|---|
| Informações | Dados cadastrais, com as ações de editar e excluir. |
| Mapa de Assentos | Vinculação do mapa utilizado pelo veículo. |
| Porões de Carga | Cadastro dos compartimentos de bagagem. |
Aba Informações
Dados do veículo
Nome
Ônibus SP-01
Placa
ABC1D23
Detalhes
Marca
Mercedes
Modelo
Tourismo
Cor
Branco
Capacidade
Peso máximo
3000 kg
Exibe três seções em cartão dividido:
- Dados do veículo: nome e placa.
- Detalhes: marca, modelo e cor. A seção aparece apenas quando algum campo está preenchido.
- Capacidade: peso máximo, quando informado.
A indicação Ativo ou Inativo e as ações Editar e Excluir ficam no topo da aba.
Aba Mapa de Assentos
Esta aba vincula o mapa de assentos ao veículo. O desenho do layout é feito em Mapas de Assentos.
A aba apresenta:
- O mapa atual do veículo, com o nome, a quantidade de assentos e o link Editar mapa, que abre o editor daquele mapa. Sem mapa vinculado, a aba informa Nenhum mapa vinculado e explica que as viagens com o veículo só podem ser criadas depois da vinculação.
- O campo Mapa de assentos, com a lista dos mapas cadastrados, e o botão Vincular.
- O botão Criar novo mapa, que abre o editor com um mapa vazio.
Ao vincular um mapa em um veículo que já tinha outro, o sistema pede
confirmação no diálogo Trocar o mapa de assentos. Quando o mapa escolhido
já é utilizado por outros veículos, a tela informa as placas deles. O campo e
os botões aparecem apenas com a permissão vehicles.manage.
A aba permite trocar o mapa por outro, mas não deixar o veículo sem mapa.
As viagens já criadas mantêm o mapa adotado na criação: a troca do mapa do veículo não altera viagens existentes nem as passagens já vendidas.
Um veículo sem mapa vinculado não pode ser utilizado em uma viagem. A criação da viagem é recusada com o aviso de que o veículo não tem mapa de assentos.
Aba Porões de Carga
Declare os compartimentos de bagagem do veículo. Cada porão tem nome e dimensões opcionais, e é a partir deles que as encomendas são alocadas.
Porões de carga
Compartimentos de bagagem deste veículo.
Porão Principal
Porão Lateral
Campos do porão
| Campo | Obrigatório | Descrição |
|---|---|---|
| Nome | Sim | Ex.: Porão principal, Lateral. |
| Peso máximo (kg) | Não | Capacidade de carga do compartimento. |
| Altura (cm) | Não | Altura interna. |
| Largura (cm) | Não | Largura interna. |
| Compr. (cm) | Não | Comprimento interno. |
Clique em Novo porão, preencha os campos e clique em Criar porão. Para alterar um porão cadastrado, utilize o ícone de edição e clique em Salvar alterações. O ícone de exclusão remove o porão após a confirmação.
O peso e as dimensões declarados são a referência de capacidade das encomendas. O formulário e o detalhe da encomenda apresentam o quanto do porão selecionado já está utilizado.
Erros comuns
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Placa recusada | Formato inválido | Utilize ABC-1234 ou ABC1D23 |
| A criação da viagem é recusada com aviso de mapa de assentos | O veículo está sem mapa de assentos vinculado | Vincule um mapa na aba Mapa de Assentos |
| A exclusão do veículo é recusada | O veículo é utilizado por alguma viagem, inclusive concluída ou cancelada | Mantenha o veículo na frota |
| O veículo não pode ser alocado na viagem | Ele já está em outra viagem no mesmo período | Consulte a agenda do veículo e escolha outro |
| A troca do mapa não alterou as viagens | As viagens mantêm o mapa da criação | Situação esperada. Ajuste o veículo na própria viagem |
| A encomenda não pode ser cadastrada | O veículo não tem porões de carga | Cadastre os porões na aba Porões de Carga |
Próximos passos
Com a frota cadastrada e os mapas vinculados, programe as Viagens. Confira também as Categorias de Assento, que definem o preço de cada poltrona no mapa. As alterações na frota ficam registradas em Atividade Recente.