Lugares
Cadastre os pontos de embarque e desembarque utilizados nas suas viagens — rodoviárias, terminais e paradas customizadas.
A tela de Lugares centraliza todos os pontos de embarque e desembarque que aparecem nas viagens. Existem dois tipos:
- Meus lugares — pontos específicos da sua operação (rodoviária, posto, shopping, terminal universitário). Você cria, edita e exclui.
- Lugares globais — capitais e cidades padrão do sistema. Somente leitura — aparecem com um cadeado e servem como referência geográfica.
Toda viagem precisa de pelo menos uma origem e um destino. Antes de cadastrar viagens, garanta que os lugares existem aqui.
Onde encontrar
Menu lateral → Gestão → Lugares. URL direta: /management/places.
Permissões necessárias
| Ação | Permissão exigida |
|---|---|
| Visualizar a tela | trips:read |
| Criar / editar | trips:edit |
| Excluir | trips:delete |
Sem trips:edit, o botão Novo lugar e o lápis somem. Sem trips:delete,
a lixeira não aparece. Lugares globais nunca mostram os botões — são
imutáveis por design.
A tela em um relance
Lugares
Pontos de embarque e desembarque utilizados nas suas viagens.
Rodoviária Central
Posto Trevo da BR-040
Terminal Universidade
Shopping Boulevard
Belo Horizonte / MG
Rio de Janeiro / RJ
São Paulo / SP
Da esquerda para a direita, de cima para baixo:
- Cabeçalho com título, descrição e o botão Novo lugar.
- Três cartões de estatísticas — total, meus, globais.
- Barra de filtros — abas, busca, ordenação e modo de exibição.
- Seção "Meus lugares" — seus pontos editáveis.
- Seção "Lugares globais" — capitais padrão (somente leitura).
Abas: Todos, Meus, Globais
- Todos — mostra as duas seções na mesma tela.
- Meus — esconde os globais para focar no que você cadastrou.
- Globais — útil para conferir nomes oficiais antes de criar uma viagem.
O número em cada aba é o total absoluto — não considera o termo da busca.
Buscar, ordenar e mudar a visualização
- Buscar — filtra por nome (sem diferenciar maiúsculas). Aplica-se às duas seções simultaneamente.
- A → Z / Z → A — clica para alternar a direção da ordenação alfabética.
- Grade / Lista — ícone à direita troca entre os dois modos.
Modo lista
A visualização em lista é mais densa — boa para inventários grandes.
Lugares globais aparecem com o badge GLOBAL e o cadeado.
Criar um novo lugar
Abrir o diálogo
Clique em Novo lugar (canto superior direito). Se a seção "Meus lugares" estiver vazia, o estado-vazio também tem um botão de atalho.
Preencher o nome
Só existe um campo, Nome do lugar (obrigatório). Use um nome curto e reconhecível — ele aparecerá em todos os seletores de origem/destino do sistema.
Novo lugar
Exemplos bons:
Rodoviária CentralPosto Trevo da BR-040Terminal Universidade — Saída A
Se você deixar o nome em branco, o formulário mostra "O nome do lugar é obrigatório" e bloqueia o envio.
Salvar
Clique em Salvar. Você verá a notificação "Lugar criado com sucesso" e o cartão aparece imediatamente em Meus lugares.
Editar um lugar
Localizar e abrir
Encontre o cartão em Meus lugares (use a busca se necessário) e clique no ícone de lápis.
Ajustar e salvar
O mesmo diálogo abre com o título Editar lugar e o nome atual preenchido. Altere e clique em Salvar. Confirmação: "Lugar atualizado com sucesso".
Renomear um lugar não quebra viagens que já o utilizam — a referência é por ID interno, não pelo nome.
Excluir um lugar
Abrir a confirmação
No cartão, clique no ícone de lixeira vermelha.
Excluir Lugar
Tem certeza que deseja excluir o lugar “Rodoviária Central”? Esta ação não pode ser desfeita.
Confirmar
Clique em Excluir. A operação é definitiva.
Se o lugar estiver em uso em alguma viagem ativa, o backend pode rejeitar a exclusão. Nesse caso, edite as viagens que o referenciam antes de tentar novamente.
Lugares globais
Belo Horizonte / MG
O cadeado indica que o lugar é padrão do sistema — não pode ser editado nem excluído.
Globais existem para padronizar nomes de cidades e capitais entre todas as empresas que usam o sistema. Você não pode criar, editar nem excluir — apenas referenciá-los nas suas viagens.
Estado vazio
Quando você ainda não cadastrou nada (ou a busca não retorna resultados), a seção mostra um placeholder convidando à ação:
Nenhum lugar customizado ainda
Crie o primeiro lugar para suas linhas.
Erros comuns
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| "Não foi possível carregar os lugares." | Falha de rede ou backend indisponível | Clique em Tentar novamente ou recarregue a tela |
| Botão Novo lugar não aparece | Falta da permissão trips:edit | Solicite ajuste do seu cargo a um administrador |
| Lápis/lixeira ausentes em um cartão | Lugar é global, ou faltam permissões | Globais são imutáveis — verifique o cadeado |
| Falha ao excluir um lugar | Lugar referenciado por uma viagem ativa | Remova-o das viagens antes de excluir |
Próximos passos
Com lugares cadastrados, o próximo cadastro natural é o de Viagens — onde você combina origem, destino, veículo e categorias de assento para montar a oferta vendável.