Guias - Cargos

O que é

A tela Cargos/Funções concentra todos os cargos disponíveis para a equipe de guias da agência - por exemplo, Guia de Turismo, Coordenador, Motorista ou Assistente. Cada item da lista mostra o icone do cargo, o nome, a posicao na ordem (#1, #2...), um selo Ativo ou Inativo e a contagem de guias atualmente vinculados aquele cargo.

O usuário normalmente chega aqui pelo menu Configurações > Cargos quando precisa cadastrar um cargo novo antes de incluir um guia, reorganizar a ordem em que os cargos aparecem nas telas de cadastro, desativar uma função que não e mais usada ou conferir quantos guias estao vinculados a cada cargo antes de excluir.

Como usar

1. Va em Configurações > Cargos no sidebar (URL /admin/cargos).
2. Use a barra de filtros para encontrar o cargo desejado:
   • Buscar por nome... - digita parte do nome do cargo e pressiona Enter para filtrar.
   • Status - escolhe entre Todos os status, Ativos ou Inativos.
   • O botao Limpar filtros aparece na propria barra quando algum filtro esta aplicado.
3. Para criar um cargo novo, clique em Novo Cargo no canto superior direito do cabecalho. O botao so aparece para quem tem a permissão de criar os guias.
4. Para alterar a ordem dos cargos, use as setas de Mover para cima e Mover para baixo a esquerda do icone de cada linha. A ordem e salva automaticamente e define a relevancia (cargo no topo aparece primeiro nas telas de cadastro de guia).
5. Para agir sobre um cargo especifico, clique no dropdown de ações (icone de tres pontos) na ponta direita da linha:
   • Editar - abre o formulario de edição daquele cargo.
   • Desativar / Ativar - alterna o status sem sair da página.
   • Excluir - abre o modal de confirmação.

Casos especiais

Lista vazia (nenhum cargo cadastrado)

Quando ainda não existe nenhum cargo, a página mostra o estado vazio com o icone de maleta, o titulo Nenhum cargo cadastrado, a frase Comece cadastrando o primeiro cargo e um botao Cadastrar primeiro cargo que leva direto ao formulario de criação.

Excluir cargo com guias vinculados

Se o cargo tem guias atrelados, o modal de exclusão lista ate 20 guias afetados (com link para o cadastro de cada um). Confirmar a exclusão desvincula automaticamente esses guias (o campo cargo_id deles fica nulo) antes de apagar o cargo. Se o cargo não tem guias vinculados, o modal pede apenas a confirmação simples.

Reordenar cargos

A ordem manual define o campo relevancia: o primeiro item da lista recebe a maior relevancia e cai para baixo nos demais. Após cada clique nas setas, a página recarrega para refletir a nova ordem. Os cargos ja são listados por relevancia decrescente por padrão.

Cargo inativo

Um cargo desativado continua aparecendo na listagem com o selo vermelho Inativo e mantem os guias ja vinculados, mas deixa de aparecer como opção no formulario de cadastro/edição de guias. Para reativar, use Ativar no dropdown de ações da linha.

Erros comuns e como resolver

• "Não e possível excluir um cargo que possui guias vinculados." - Causa: foi feita uma tentativa de exclusão direta sem confirmar o desvinculo dos guias. Solucao: refaca a exclusão pelo dropdown Excluir da linha - o modal lista os guias e ao confirmar faz o desvinculo automático antes de apagar.
• Lista não filtra ao digitar na busca - Causa: a busca exige enviar o formulario (Enter ou clicar fora do campo). Solucao: pressione Enter no campo Buscar por nome... para aplicar.
• Botoes de mover (setas) não aparecem - Causa: o usuário logado não tem a permissão de editar os guias. Solucao: peca ao Proprietario para conceder a permissão no perfil de acesso.

Onde encontrar

• URL: /admin/cargos
• Caminho no menu: Configurações > Cargos
• Permissão necessária: ver os guias (para visualizar) - criar os guias, editar os guias e excluir os guias controlam as ações
• Módulo necessário: nenhum

Veja também

• Cadastrar Cargo
• Editar Cargo
• Cadastrar Guia
• Lista de Guias