Cargos
Defina quais funcionalidades cada cargo pode acessar. Permissões são granulares — por área (Viagens, Veículos, Acesso, etc.) e por ação (ler, gerenciar, excluir).
A tela de Cargos & Permissões é o coração do controle de acesso. Cada
cargo agrupa um conjunto de permissões — códigos como trips:read,
vehicles:manage, access:delete — e cada usuário pode ter um cargo.
Permissões são granulares. Em vez de "perfil admin/básico", você desenha cargos sob medida: Operador vê e edita viagens, mas não toca em usuários; Vendas gerencia reservas, mas não exclui veículos.
Onde encontrar
Menu lateral → Sistema → Cargos. URL direta: /management/roles.
Permissões necessárias
| Ação | Permissão exigida |
|---|---|
| Visualizar a tela | access:read |
| Criar, editar, excluir | access:manage |
| Editar permissões de cargo | access:manage |
A tela em um relance
Cargos & Permissões
Defina quais funcionalidades cada cargo pode acessar no sistema.
Estrutura:
- Cabeçalho com botão Novo cargo.
- Três cartões — cargos cadastrados, permissões disponíveis, cargos padrão.
- Busca + contador de cargos no filtro atual.
- Grade de cartões — um por cargo, com barra de progresso de permissões.
Os cartões de estatística
| Cartão | O que mostra |
|---|---|
| Cargos cadastrados | Quantos cargos existem. À direita, quantos usuários têm cargo atribuído. |
| Permissões disponíveis | Total de permissões no sistema (granular por área). |
| Cargos padrão | Cargos do sistema — sempre inclui Admin, que não pode ser editado. |
Anatomia de um cartão de cargo
- Avatar + nome + descrição — identidade do cargo.
- Barra de progresso — quantas permissões estão concedidas, sobre o total disponível.
- Rodapé — usuários atribuídos + ações (editar, excluir, permissões).
A barra de progresso mostra rapidamente o quanto o cargo está aberto — Admin tem 100%, Vendas ~25%, etc. Útil para identificar cargos que viraram quase-admins por descuido.
Cargos padrão
O cargo Admin é padrão do sistema. Não pode ser editado nem excluído — o botão Ver mostra as permissões em modo leitura.
O cargo Admin vem com o sistema e tem todas as permissões. Por segurança, ele:
- Não pode ser editado (sem lápis).
- Não pode ser excluído (sem lixeira).
- Suas permissões podem ser visualizadas (botão Ver), mas não alteradas.
Você sempre precisa de pelo menos um usuário com cargo Admin para gerenciar o sistema. Trate como conta de emergência.
Criar um novo cargo
Abrir o formulário
Clique em Novo cargo no topo. Há também um cartão tracejado Adicionar novo cargo ao final da grade.
Definir nome e descrição
Novo cargo
- Nome (obrigatório) — curto e reconhecível. Ex.:
Operador,Vendas,Financeiro. Exibido em selects de usuário e em badges. - Descrição (opcional) — uma frase que ajude outros administradores a entenderem o escopo.
Salvar
Clique em Salvar. O cargo entra na grade com 0 permissões — ainda não dá acesso a nada. Vá para o próximo passo.
Atribuir permissões
Abrir o gerenciador
No cartão do cargo, clique no botão Permissões →.
Marcar o que esse cargo pode fazer
Permissões — Operador
Selecione as permissões que este cargo terá no sistema.
As permissões vêm agrupadas por área (Viagens, Veículos, Usuários e acesso, etc.). Em cada grupo:
- A checkbox do título marca/desmarca todas as permissões da área.
- Quando algumas estão marcadas e outras não, o checkbox vira indeterminado (traço).
- O contador
18/32no rodapé indica o total marcado no cargo.
Para "operador básico", uma receita comum: tudo de Viagens, leitura de Veículos, leitura de Lugares e Categorias de Assento. Nada de Usuários ou Cargos.
Salvar
Clique em Salvar. Notificação: "Permissões atualizadas com sucesso". A mudança vale para o próximo login dos usuários afetados — sessões abertas continuam com o set antigo até reautenticar.
Editar nome ou descrição
Clique no lápis do cartão (somente cargos não-padrão). Mesmo diálogo da criação, agora com os dados atuais. Renomear não desatribui ninguém — a referência é por ID.
Excluir um cargo
Abrir a confirmação
Clique no lixeira vermelha (somente cargos não-padrão).
Excluir Cargo
Tem certeza que deseja excluir o cargo “Operador”? Usuários que tinham esse cargo ficam sem permissões até receberem outro.
Confirmar
Clique em Excluir. Usuários que tinham esse cargo continuam existindo, mas ficam sem permissões até receberem outro cargo via Usuários e Perfis.
Antes de excluir, abra a tela de Usuários, filtre por este cargo e realoque cada pessoa. Caso contrário, eles entram no sistema sem conseguir fazer nada e abrem chamado.
Receitas comuns de cargos
| Cargo sugerido | Permissões típicas |
|---|---|
| Operador | Viagens (tudo), Veículos (ler), Lugares (ler), Reservas (gerenciar) |
| Vendas | Reservas (tudo), Passageiros (tudo), Viagens (ler) |
| Financeiro | Reservas (ler), Cobranças (tudo), Descontos (tudo) |
| Suporte | Tudo de leitura, nada de escrita; Atividade Recente (ler) |
Ajuste à sua operação — não há "cargo certo", há cargo adequado.
Erros comuns
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Usuário entra mas não vê nada | Cargo sem permissões, ou sem cargo | Abra Permissões no cargo e marque o que falta |
| Mudança de permissão "não pegou" | Sessão antiga aberta | Peça ao usuário para sair e entrar de novo |
| Botão Salvar está desabilitado em Admin | Por design — Admin não é editável | Crie um cargo novo se precisar de algo customizado |
| Erro ao excluir cargo | Algum constraint no backend | Realoque usuários e tente novamente |
Próximos passos
Com cargos prontos, volte para Usuários e Perfis e atribua o cargo certo a cada operador. Conferir mudanças via Atividade Recente — ações de criação, edição e atribuição ficam registradas.