Usuários - Perfis de Acesso e Permissões

O que é

Os Perfis de Acesso (também chamados de papéis ou roles) são conjuntos de permissões que controlam o que cada usuário da sua empresa pode ver e fazer no Viagilize. Em vez de configurar permissões usuário por usuário, você define um perfil uma única vez e atribui a quantos usuários quiser; quando um perfil muda, todos os usuários vinculados passam a operar com as novas regras imediatamente.

Você chega aqui ao perceber que precisa criar um cargo novo (por exemplo, "Apoio Operacional" ou "Suporte SAC") que não se encaixa nos sete perfis de sistema, ou ao querer ajustar o que um perfil padrão pode acessar - por exemplo, dar permissão de relatórios financeiros para um Gerente.

Como usar

Acessar a listagem

1. No menu lateral vá em Sistema > Perfis de Acesso.
2. A tela mostra todos os perfis existentes; perfis criados pela plataforma exibem a etiqueta roxa Sistema ao lado do nome.
3. Cada linha mostra a contagem de usuários vinculados e a contagem de permissões ativas (já descontando módulos de módulos não contratados).

Criar um perfil customizado

1. Clique em Novo Perfil no canto superior direito.
2. Em Informações do Perfil preencha:
   • Nome do Perfil - obrigatório, único na sua empresa (ex: "Supervisor").
   • Descrição - opcional, até 500 caracteres, ajuda a equipe a identificar a finalidade do perfil.
3. Na seção Permissões marque pelo menos uma permissão. Use os atalhos:
   • Selecionar tudo (canto superior direito) - marca todas as permissões visíveis.
   • Limpar - desmarca tudo.
   • Marcar tudo / Desmarcar dentro do cartão de cada módulo - alterna o módulo inteiro.
4. Finalize escolhendo uma das três opções no rodapé:
   • Criar Perfil - salva e volta para a listagem.
   • Criar e continuar editando - salva e abre o perfil em edição.
   • Criar e adicionar outro - salva e abre um novo formulário em branco.

Editar um perfil existente

1. Na listagem, clique no dropdown de ações da linha e escolha Editar.
2. Se houver usuários vinculados, aparece um aviso amarelo no topo informando a quantidade - qualquer mudança nas permissões afeta todos eles imediatamente.
3. Ajuste nome, descrição e permissões e clique em Salvar (ou em Salvar e continuar editando para permanecer na tela).

Duplicar um perfil

1. No dropdown de ações da linha, clique em Duplicar.
2. O sistema cria uma cópia com o sufixo " (Cópia)" no nome, replicando todas as permissões do perfil original, e abre o novo perfil em edição para você ajustar nome e ajustes finos.

Excluir um perfil

1. No dropdown de ações, clique em Excluir (opção em vermelho).
2. No modal de confirmação digite a palavra EXCLUIR em maiúsculas para liberar o botão.
3. Confirme. A operação é definitiva.

Casos especiais

Perfis de Sistema não podem ser excluídos

Os sete perfis criados automaticamente - Proprietário, Gerente, Atendente, Financeiro, Operacional, Vendedor CRM e Gerente CRM - têm o campo is_system ativo e a opção Excluir nem aparece no dropdown. Você pode, no entanto, editar livremente as permissões de cada um para adaptar ao seu negócio.

Resumo dos perfis padrão e sua intenção original:

Perfil	Descrição
Proprietário	Acesso total a todos os módulos e módulos
Gerente	Gestão geral, sem acessar Usuários e Perfis
Atendente	Atendimento ao cliente e operação de reservas
Financeiro	Lançamentos, contas e relatórios financeiros
Operacional	Guias, transportes, veículos, motoristas e fornecedores
Vendedor CRM	Operação do funil de vendas (leads e oportunidades próprios)
Gerente CRM	CRM completo, com relatórios e visão de todos os vendedores

Perfil com usuários vinculados não pode ser excluído

Se houver pelo menos um usuário com o perfil, o modal de confirmação fica bloqueado e o sistema retorna a mensagem "Não é possível excluir. Existem X usuário(s) com este perfil.". Antes de excluir, edite cada usuário e troque o perfil dele em Sistema > Usuários.

Permissões de módulos só aparecem quando o módulo está contratado

A listagem e os formulários ocultam automaticamente as permissões dos módulos CRM, WhatsApp, Contratos Digitais, Ingressos, Gestão Financeira, Hospedagem, Fidelidade, Passeios / Experiências e Chatbot WhatsApp quando você não tem o módulo ativo. A contagem de permissões na listagem usa essa mesma regra, então o número exibido pode ser menor que o total real do perfil - basta contratar o módulo para os checkboxes correspondentes voltarem a aparecer.

Primeiro acesso à página gera os perfis padrão automaticamente

Se você nunca abriu esta tela, ao entrar pela primeira vez o sistema executa o seeder e cria os sete perfis de sistema antes de renderizar a lista. Não é necessário rodar nenhum comando manualmente.

Erros comuns e como resolver

• "O nome do perfil é obrigatório." - Causa: o campo Nome ficou em branco. Solução: informe um nome único antes de salvar.
• "Já existe um perfil com este nome." - Causa: outro perfil da sua empresa já usa esse nome (a comparação é exata). Solução: escolha um nome diferente; lembre-se de que duplicatas geradas pelo botão Duplicar vêm com sufixo " (Cópia)" justamente para evitar este conflito.
• "Selecione pelo menos uma permissão." - Causa: o formulário foi enviado sem nenhum checkbox marcado. Solução: marque ao menos uma permissão, ou use o atalho Selecionar tudo e refine depois.
• "Não é possível excluir um perfil de sistema." - Causa: tentativa de excluir um perfil com etiqueta Sistema. Solução: edite as permissões em vez de excluir; perfis de sistema são protegidos para garantir que o RBAC base nunca quebre.
• "Não é possível excluir. Existem X usuário(s) com este perfil." - Causa: o perfil ainda está atribuído a usuários ativos. Solução: vá em Sistema > Usuários, troque o perfil de cada usuário afetado e tente excluir novamente.

Onde encontrar

• URL: /admin/roles
• Caminho no menu: Sistema > Perfis de Acesso
• Permissões necessárias: ver os usuários (ver), criar os usuários (criar e duplicar), editar os usuários (editar) e excluir os usuários (excluir)
• Módulo necessário: nenhum (módulo nativo da plataforma)

Veja também

• Gestão de Usuários do Sistema
• Cadastrar Novo Usuário
• Editar e Desativar Usuários