Veículos
Cadastre e configure a frota — dados do veículo, mapa de assentos por andar e porões de carga.
A tela de Frota centraliza tudo sobre os ônibus da empresa: dados básicos, configuração visual do mapa de assentos e declaração dos porões de carga. Um veículo bem configurado é pré-requisito para criar viagens com venda de passagens por assento.
Após criar um veículo, o sistema redireciona automaticamente para a tela de configuração. Aproveite para montar o mapa de assentos imediatamente.
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 título Frota e botão Novo veículo.
- Três cartões de estatística — frota total, total de assentos, capacidade de carga combinada.
- Busca + alternador de visualização (grade / lista).
- Grade ou lista de cartões, um por veículo.
- Cartão tracejado Adicionar veículo no fim da grade.
Os cartões de estatística
| Cartão | O que mostra |
|---|---|
| Frota total | Quantidade de veículos. À direita, quantos batem com a busca atual. |
| Total de assentos | Soma de todos os assentos da frota. Média por veículo à direita. |
| Capacidade de carga | Soma do totalMaxWeightKg de todos os veículos. |
Anatomia de um cartão
| Parte | Descrição |
|---|---|
| A | Ícone colorido (cor derivada do ID), nome, placa em monospace. |
| B | Marca, modelo e cor separados por ·. Só aparece se preenchidos. |
| C | Mini-stats de assentos e carga máxima. |
| D | Configurar (abre a tela de detalhes) + lápis (editar) + lixeira (excluir). |
Visualização em lista
Clique no ícone de lista ao lado da busca. Cada linha mostra ícone, nome, marca/modelo, placa, assentos e as mesmas ações.
Criar um novo veículo
Abrir o formulário
Clique em Novo veículo ou no cartão tracejado Adicionar veículo.
Escolher a categoria
Novo Veículo
Categoria
Pré-configurando 36 assentos no mapa de assentos. Você pode ajustar abaixo.
A categoria define o layout inicial do mapa de assentos. Escolha a mais próxima da realidade — você poderá ajustar depois.
| Categoria | Padrão | Layout inicial |
|---|---|---|
| Convencional | 48 assentos | 4 fileiras × 12 cols |
| Semi-leito | 44 assentos | 4 fileiras × 11 cols |
| Leito | 36 assentos | 2 fileiras × 18 cols |
| Leito-cama | 26 assentos | 2 fileiras × 13 cols |
| Double Decker | 60 assentos | 2 andares |
| Micro-ônibus | 28 assentos | 3 fileiras × 9 cols |
Em modo edição a categoria não aparece — o mapa já existe e não é reiniciado.
Preencher os campos
| Campo | Obrigatório | Regra |
|---|---|---|
| Nome | Sim | Nome interno de exibição. Ex: Ônibus SP-BH 01. |
| Placa | Sim | Formato antigo AAA0000 ou Mercosul AAA0A00 (sem traço). |
| Total de assentos | Sim | Mínimo 1. Pré-preenchido pela categoria escolhida. |
| Marca | Não | Ex: Mercedes, Volvo. Exibido no cartão. |
| Modelo | Não | Ex: Tourismo. Concatenado com marca e cor. |
| Cor | Não | Texto livre. Ex: Branco. |
| Peso máximo (kg) | Não | Capacidade total de carga declarada. Somado no painel. |
Salvar
Clique em Criar veículo. O sistema salva e abre automaticamente a tela de detalhes do veículo criado — configure o mapa de assentos logo em seguida.
Editar dados básicos
No cartão do veículo, clique no lápis. O mesmo formulário abre sem o seletor de categoria. Altere o que precisar e clique em Salvar alterações.
Excluir um veículo
Abrir a confirmação
Clique na lixeira vermelha do cartão.
Excluir veículo
Tem certeza que deseja excluir Ônibus SP-01? Esta ação não pode ser desfeita.
Confirmar
Clique em Excluir. A ação é irreversível — o mapa de assentos e os porões são excluídos junto. Viagens já criadas com esse veículo não são afetadas (mantêm o registro histórico).
Tela de detalhes
Clicar em Configurar (ou qualquer ação de detalhe) abre a página do veículo, com três abas.
| Aba | Conteúdo |
|---|---|
| Informações | Dados cadastrais com botões Editar e Excluir. |
| Mapa de Assentos | Editor visual de assentos por andar. |
| Porões de Carga | Cadastro de compartimentos de bagagem. |
Aba Informações
Dados do veículo
Nome
Ônibus SP-01
Placa
ABC1D23
Total de assentos
44
Detalhes
Marca
Mercedes
Modelo
Tourismo
Cor
Branco
Capacidade
Peso máximo
3.000 kg
Exibe três seções em cartão dividido:
- Dados — Nome, Placa, Total de assentos.
- Detalhes — Marca, Modelo, Cor (só aparece se ao menos um campo estiver preenchido).
- Capacidade — Peso máximo (só aparece se informado).
Botões Editar e Excluir ficam no topo da aba.
Aba Mapa de Assentos
O editor de mapa é a parte mais rica do sistema de veículos. Ele permite desenhar visualmente onde cada assento, banheiro, escada e corredor ficam.
O editor só está disponível em desktop. Em telas menores aparece um aviso.
Disponível apenas no computador
O editor de mapa de assentos requer uma tela maior para funcionar corretamente.
O editor completo
Semi-leito
Melhor reclinação e apoio · 42–46 lugares
CAPACIDADE CONFIGURADA
24 / 44 assentos posicionados
MODO
CATEGORIA DE ASSENTO
ESPAÇO ESPECIAL
O editor tem quatro zonas:
- Barra de ações — badge de alterações não salvas, botão Pré-visualizar e botão Salvar mapa.
- Banner de categoria — categoria selecionada e barra de progresso de capacidade.
- Linha de andares — abas de andar + contador de assentos + Desfazer / Refazer / Redefinir.
- Painel de ferramentas — modo de edição, categoria de assento e tipos especiais.
- Cartão do ônibus — representação visual do veículo com grid interativo.
Barra de ações
| Elemento | O que faz |
|---|---|
| Badge âmbar Alterações não salvas | Indica que há mudanças ainda não enviadas ao servidor. |
| Pré-visualizar | Alterna para modo leitura — números aparecem sem borda de edição. |
| Salvar mapa | Envia todas as alterações de todos os andares ao servidor. |
Banner de categoria
Mostra o tipo do veículo (ex: Semi-leito) e uma barra de progresso comparando assentos posicionados com a capacidade padrão da categoria. Útil para saber se o mapa está completo.
Linha de andares
- Abas de andar — seleciona qual andar está sendo editado. Cada aba mostra a contagem de assentos daquele andar.
- Contador — total de assentos do andar ativo.
- Desfazer (⌘Z) / Refazer (⌘⇧Z) / Redefinir — histórico de até 50 ações por sessão.
Double Decker — dois andares
Veículos Double Decker têm duas abas: 1º andar — Inferior (leito, 2 fileiras) e 2º andar — Superior (semi-leito, 4 fileiras). Configure cada um separadamente.
Cada andar tem seu próprio mapa. Configure um de cada vez.
Painel de ferramentas
MODO controla o que acontece ao clicar em uma célula:
| Modo | Ação ao clicar |
|---|---|
| Pintar tipo | Aplica o tipo selecionado (assento de categoria ou especial). |
| Editar número | Abre campo para digitar o número do assento manualmente. |
Para apagar uma célula: segure Alt e clique sobre ela enquanto estiver no modo Pintar tipo. A célula volta a ser vazia.
CATEGORIA DE ASSENTO lista as categorias cadastradas em Categorias de Assento. Cada categoria tem uma cor própria. O assento pintado recebe essa cor no mapa.
ESPAÇO ESPECIAL — tipos que não são assentos de passageiro:
| Tipo | Cor | Uso |
|---|---|---|
| Motorista | Roxo | Posição do motorista. Fica no bloco frontal arredondado. |
| Banheiro | Azul | Sanitário a bordo. |
| Escada | Âmbar | Acesso ao 2º andar (Double Decker). |
| Corredor | Zinc | Espaço de passagem entre fileiras. |
| Vazio | Transparente | Remove tipo atribuído à célula. |
Cartão do ônibus
Representa o ônibus horizontalmente: frente à esquerda (bloco arredondado com motorista), assentos no centro, traseira à direita.
- Rótulos de coluna — numeração de 1 a N no topo da grade.
- CORREDOR — divisor horizontal entre a metade superior e inferior do ônibus.
- Clique e arraste — pinte várias células sem soltar o mouse.
- Números aparecem automaticamente em Pré-visualizar para assentos sem número definido manualmente.
Salvar o mapa
Clique em Salvar mapa. Notificação: "Mapa de assentos salvo com sucesso". O badge âmbar desaparece. Todos os andares são salvos em uma só operação.
Mudanças no mapa de assentos valem para novas viagens. Viagens já abertas para venda usam o mapa que estava ativo quando foram criadas.
Aba Porões de Carga
Declare os compartimentos de bagagem do veículo. Cada porão tem nome e dimensões opcionais.
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áx (kg) | Não | Capacidade de carga do compartimento. |
| Altura (cm) | Não | Altura interna. |
| Largura (cm) | Não | Largura interna. |
| Comprimento (cm) | Não | Profundidade interna. |
Clique em Novo porão, preencha e salve. Use o lápis para editar e a lixeira para excluir cada porão.
Erros comuns
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Placa rejeitada | Formato inválido | Use ABC1234 (antiga) ou ABC1D23 (Mercosul) |
| Badge âmbar volta após salvar | Erro de rede silencioso | Tente novamente; verifique a conexão |
| Assento sem número em modo edição | Número é gerado só em Pré-visualizar | Normal — números aparecem ao pré-visualizar |
| Editor de mapa não aparece | Tela pequena (mobile) | Acesse pelo computador |
| Desfazer não retorna ao estado inicial | Histórico limitado a 50 ações | Use Redefinir para voltar ao último salvo |
Próximos passos
Com a frota configurada, você pode criar Viagens e atribuir os veículos às rotas. Confira as categorias de assento em Categorias de Assento para garantir que os tipos usados no mapa estejam cadastrados. Alterações na frota ficam registradas em Atividade Recente.