Cargos
Defina quais funcionalidades cada cargo pode acessar. As permissões são granulares, por área (Viagens, Veículos, Acesso e outras) e por ação (ler, gerenciar, excluir).
A tela de Cargos concentra o controle de acesso. Cada cargo agrupa um
conjunto de permissões, que são códigos como trips.read,
vehicles.manage e access.manage, e cada usuário recebe um cargo.
As permissões são granulares. Em lugar de um perfil único de administrador ou de usuário básico, os cargos são definidos conforme a operação: um cargo de operação consulta e edita viagens sem acesso a usuários; um cargo de vendas gerencia reservas sem excluir veículos.
Onde encontrar
Menu lateral → Sistema → Cargos. URL direta: /management/roles.
Permissões necessárias
| Ação | Permissão exigida |
|---|---|
| Visualizar a tela e consultar as permissões | access.read |
| Ver o sistema como um cargo | access.read |
| Criar, editar, excluir | access.manage |
| Editar permissões de cargo | access.manage |
Sem access.manage, os botões de criação, edição e exclusão ficam ocultos, e o
diálogo de permissões abre somente para consulta.
A tela em um relance
Cargos & Permissões
Defina quais funcionalidades cada cargo pode acessar no sistema.
Estrutura:
- Cabeçalho com o botão Novo cargo.
- Três cartões: cargos cadastrados, permissões disponíveis e cargos padrão.
- Busca e contagem de cargos no filtro atual.
- Grade de cartões, um por cargo, com a barra de permissões concedidas.
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 do sistema, granulares por área. |
| Cargos padrão | Cargos do sistema. Sempre inclui o 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 permissões indica a proporção de permissões concedidas ao cargo: o Admin tem a totalidade, e um cargo de vendas costuma ter em torno de um quarto delas. É a forma mais rápida de identificar um cargo que acumulou permissões além do necessário.
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 acompanha o sistema e possui todas as permissões. Por segurança:
- Não pode ser editado.
- Não pode ser excluído.
- As permissões podem ser visualizadas pelo botão Ver, mas não alteradas.
A empresa precisa manter pelo menos um usuário com o cargo Admin para administrar o sistema. Trate esse acesso como conta de contingê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, descrição e alcance
Novo Cargo
Crie um novo cargo para atribuir a usuários.
Acesso a todos os registros da empresa. Aplica-se a reservas, passagens, encomendas e pagamentos. O usuário com mais de um cargo recebe o alcance mais restrito.
- Nome (obrigatório): curto e identificável. Ex.:
Operador,Vendas,Financeiro. É o nome apresentado na atribuição de usuários e nas indicações de cargo. - Descrição (opcional): uma frase que informe a outros administradores o escopo do cargo.
- Alcance dos dados: Toda a empresa, que é o padrão, ou Somente os próprios. No segundo caso, o usuário tem acesso apenas ao que ele mesmo vendeu ou recebeu: reservas, passagens, encomendas e pagamentos. É o alcance típico de um vendedor externo. Quem acumula mais de um cargo fica com o alcance mais restrito, e o cargo de proprietário nunca é restrito.
Criar
Clique em Criar. O cargo entra na grade sem permissão alguma, portanto ainda não concede acesso. Siga para a etapa seguinte.
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 são apresentadas em grupos, um por área do sistema (viagens, reservas, veículos, acesso, entre outras). O título de cada grupo é a descrição da área, e cada permissão aparece com a descrição do que ela libera. Em cada grupo:
- A caixa de seleção do título marca ou desmarca todas as permissões da área.
- Quando parte das permissões está marcada, a caixa do título fica no estado intermediário.
- A contagem ao lado do título, no formato
1/2, indica quantas permissões da área estão marcadas.
O rodapé informa o total concedido ao cargo, no formato
12 de 31 selecionada(s).
Uma composição comum para um cargo de operação: todas as permissões de
viagens, que também liberam a tela de Locais; a leitura de veículos, que
também libera Mapas de Assentos e Categorias de Assento; e nenhuma das
permissões de acesso (access.read e access.manage).
Salvar
Clique em Salvar. A alteração passa a valer no próximo login dos usuários com esse cargo: as sessões abertas continuam com o conjunto anterior até a nova autenticação.
Sem a permissão access.manage, o diálogo abre somente para consulta: as
caixas de seleção ficam desabilitadas, o botão Salvar não é exibido e o
único botão disponível é Fechar.
Ver o sistema como um cargo
Para conferir o resultado de um cargo antes de atribuí-lo, abra o menu do seu usuário, no rodapé do menu lateral, e escolha Ver como cargo. Selecione o cargo e clique em Visualizar.
- O menu, as telas e os botões passam a refletir as permissões do cargo selecionado.
- Uma faixa no topo da tela informa Visualizando como: seguido do nome do cargo.
- Durante a visualização, nenhuma alteração é salva: as ações retornam a mensagem "Visualização ativa: ações estão bloqueadas".
- Para encerrar, clique em Sair na faixa. Recarregar a página também encerra a visualização.
A visualização reproduz as permissões do cargo, mas não o alcance dos dados: os registros exibidos continuam sendo os que o seu usuário pode consultar.
Editar nome, descrição ou alcance
Clique no ícone de edição do cartão, disponível nos cargos que não são padrão. O formulário é o mesmo da criação, com os dados atuais. A renomeação não desatribui nenhum usuário, porque a referência é interna. A descrição pode ser apagada: o campo em branco remove a descrição.
A alteração do Alcance dos dados desconecta todos os usuários que têm esse cargo: na ação seguinte eles retornam à tela de login e precisam autenticar novamente, e passam a valer com o novo alcance. O formulário exibe um aviso quando o alcance é alterado. A alteração apenas do nome ou da descrição não desconecta ninguém.
Para um usuário com alcance Somente os próprios, um registro de outra pessoa é apresentado como não encontrado. Não é falha de permissão: o registro está fora do alcance do cargo.
Excluir um cargo
Abrir a confirmação
Clique no ícone de exclusão do cartão, disponível nos cargos que não são padrão.
Excluir cargo
Tem certeza que deseja excluir o cargo Operador? Usuários com esse cargo perderão as permissões associadas. Essa ação não pode ser desfeita.
Confirmar
Clique em Excluir. O cargo é excluído mesmo que esteja atribuído a usuários. Esses usuários continuam cadastrados, porém perdem as permissões do cargo a partir do próximo login. Quem não tiver outro cargo fica sem permissão alguma até receber um cargo em Usuários e Perfis.
Antes de excluir, abra a tela de Usuários, localize quem tem este cargo e atribua outro a cada pessoa. Sem isso, esses usuários acessam o sistema sem conseguir executar nenhuma ação.
Receitas comuns de cargos
| Cargo sugerido | Permissões típicas |
|---|---|
| Operador | Viagens (tudo, inclui a tela de Locais), Veículos (ler), Reservas (gerenciar) |
| Vendas | Reservas (tudo), Passageiros (tudo), Viagens (ler) |
| Vendedor externo | Reservas (tudo), Passageiros (tudo), Viagens (ler), com alcance Somente os próprios |
| Financeiro | Reservas (ler), Financeiro (tudo), incluindo contas a pagar, caixa e comissões |
| Suporte | Somente permissões de leitura, incluindo Atividade Recente |
Ajuste a composição à operação da empresa: o cargo adequado é o que concede apenas o necessário.
Erros comuns
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| O usuário acessa o sistema e não vê conteúdo | Cargo sem permissões, ou usuário sem cargo | Abra Permissões no cargo e conceda o necessário |
| A alteração de permissão não teve efeito | Sessão anterior ainda aberta | Solicite ao usuário que saia e autentique novamente |
| O cargo Admin não pode ser salvo | O cargo padrão não é editável | Crie um cargo novo com a composição desejada |
| O diálogo de permissões não tem o botão Salvar | Falta a permissão access.manage | Solicite o ajuste do seu cargo |
| Usuários foram desconectados após uma edição | O alcance dos dados do cargo foi alterado | Situação esperada: eles precisam autenticar novamente |
Próximos passos
Com os cargos definidos, volte para Usuários e Perfis e atribua o cargo adequado a cada operador. As ações de criação, edição e atribuição ficam registradas em Atividade Recente.