Veículos - Configurar Assentos

O que é

O editor de assentos é a tela em que o usuário desenha o mapa interno do veículo célula a célula. Cada posição da grade vira um registro em veiculo_layouts com tipo, fila, coluna e coordenadas, e esse layout é o que aparece depois na escolha de poltrona pelo cliente, na rooming list e no check-in da excursão.

O usuário normalmente chega aqui logo após cadastrar o veículo (a partir da página de detalhes ou clicando em "Configurar Layout" na listagem). É um passo obrigatório antes de vincular o veículo a uma excursão se a empresa quiser que o passageiro escolha assento numerado.

Como usar

1. Vá em Cadastros > Veículos no sidebar.
2. Clique no veículo desejado e acesse Configurar Assentos (URL /admin/veiculos/{veiculo}/layout).
3. Aplique um template pronto para começar rápido:
   • No card Templates (coluna direita), escolha um template no select Selecionar Template.
   • Clique no botão roxo Aplicar Template. O sistema preenche a grade com o modelo escolhido.
4. Ajuste posições no grid central:
   • Selecione a ferramenta desejada no card Ferramentas (Normal, Semi-leito, Executivo, Leito, Motorista, Guia, Corredor, Escada, Porta, Banheiro, Vazio).
   • Clique ou arraste pelas células do grid para pintar com o tipo escolhido.
5. Numere os assentos no card Numeração:
   • Informe o Número Inicial e escolha a Direção (Esquerda para Direita, Direita para Esquerda, Frente para Trás, Trás para Frente, ou Ímpar Janela / Par Corredor).
   • Clique em Auto-numerar Assentos. Apenas células do tipo Normal, Semi-leito, Executivo e Leito recebem número.
6. Confira a Composição (card direita) para validar total de assentos, vendáveis e quebra por tipo.
7. Clique em Salvar Layout no rodapé. O sistema apaga o layout anterior do veículo e grava o novo.

Casos especiais

Aplicar template pronto por tipo

A lista de templates é filtrada automaticamente pelo tipo do veículo (van, micro-ônibus, ônibus, leito, semi-leito, executivo, double decker). O select mostra ao lado do nome a diferença em relação à capacidade cadastrada do veículo: +N, -N ou marca de confere quando bate exato. Use isso para escolher o template mais próximo do tamanho real.

Salvar layout como meu template

Depois de ajustar o grid do jeito que precisa, abra o card Salvar como Template (destaque indigo/roxo na coluna direita) e clique em Salvar como Meu Template. No modal, informe Nome do Template (obrigatório, máx. 100 chars) e Descrição (opcional, máx. 500 chars) e confirme em Salvar Template. O template fica disponível só para veículos do mesmo tipo e aparece na seção "Meus Templates" do select.

Veículo de dois andares (Double Decker / Leito)

Quando o veículo é double decker ou ônibus leito, aparecem abas de piso acima do grid (Piso Inferior / Piso Superior). Cada aba é editada separadamente - selecione a aba ativa antes de aplicar template ou pintar células. O template é aplicado apenas no piso atualmente visível. Use o tipo Escada para marcar o ponto de acesso entre andares.

Criar layout do zero com dimensões customizadas

Para veículos fora do padrão, use o card Layout Personalizado > Criar Layout Personalizado. No modal, informe Linhas (fileiras) (mín. 2, máx. 20) e Colunas (mín. 2, máx. 7), confira a pré-visualização e confirme. O layout atual é substituído por uma grade vazia das dimensões pedidas para você pintar célula a célula.

Edição manual de número de assento

No card Numeração, ative o toggle Modo edição manual. Com o modo ligado, clicar em um assento abre o modal Editar Número mostrando posição (linha/coluna) e tipo, permitindo digitar o número exato (útil quando o veículo tem numeração fora do padrão sequencial).

Reservar assento sem vender

Pinte a célula com o tipo Reservado. Esses assentos contam no total da grade mas não entram em vendáveis. Quando há reservados, aparece um aviso amarelo no card Templates avisando que a capacidade de venda será a soma de Normal + Semi-leito + Executivo + Leito.

Divergência com a capacidade cadastrada

O capacidade_total do veículo (cadastro) continua sendo a fonte da verdade comercial. Se a quantidade de assentos vendáveis no layout for diferente, a página apenas sinaliza a divergência no retorno do save (divergente: true) - o cadastro do veículo NÃO é alterado pelo salvamento do layout. Para corrigir, atualize Capacidade Total na edição do veículo.

Erros comuns e como resolver

• "Já existe um template com este nome para este tipo de veículo." - Causa: tentativa de salvar template personalizado com nome duplicado dentro do mesmo tipo. Solução: troque o nome ou exclua o template antigo pelo ícone de lixeira na seção "Meus Templates".
• "Funcionalidade de templates personalizados não está disponível. Execute as migrações da sua empresa." - Causa: tabela veiculo_templates ausente no banco da sua empresa. Solução: rodar tenants:migrate --force no servidor (responsabilidade técnica, abrir chamado no suporte).
• "Template não encontrado" - Causa: o ID do template selecionado não existe mais (foi excluído por outro usuário ou template padrão removido). Solução: recarregar a página e escolher outro template na lista atualizada.
• Validação layout.*.tipo - Aparece se algum tipo enviado não estiver entre: normal, semi_leito, executivo, leito, reservado, motorista, guia, corredor, escada, porta, banheiro, vazio. Solução: usar somente os tipos do card Ferramentas.
• Capacidade da grade diferente do cadastro do veículo - Não é erro bloqueante, mas o card Templates exibe alerta amarelo. Para alinhar, corrija o capacidade_total na edição do veículo ou ajuste a quantidade de assentos vendáveis no layout.

Onde encontrar

• URL: /admin/veiculos/{veiculo}/layout
• Caminho no menu: Cadastros > Veículos > (abrir veículo) > Configurar Assentos
• Permissão necessária: ver os transportes (para abrir), editar os transportes (para salvar layout e criar template), excluir os transportes (para excluir template personalizado)
• Módulo necessário: nenhum (faz parte do módulo de Transportes nativo)

Veja também

• Cadastrar Veículo
• Editar Veículo
• Detalhes do Veículo
• Vincular Transporte à Excursão