Papéis e Permissões

A tela Papéis e Permissões é onde você define, com precisão, o que cada pessoa da sua equipe pode ver e fazer dentro do Painel Admin. Em vez de escolher entre alguns poucos "cargos" fixos, você monta perfis sob medida — marcando exatamente as permissões que aquela função precisa, nada mais.

Para acessar, vá em Configurações > Papéis no menu lateral.

Isto define o que a pessoa pode fazer — quem ela é, você define em Usuários

Esta página controla os perfis disponíveis e as permissões de cada um. Para vincular um perfil a uma pessoa específica (nome, e-mail, senha), veja Gerenciamento de Usuários.

1. Os dois perfis reservados

Dois perfis já vêm prontos no sistema e não podem ser apagados nem renomeados: Administrador, que tem acesso a tudo automaticamente, e Usuário, exclusivo dos seus clientes finais no Painel do Cliente. O comportamento completo de cada um está descrito em Gerenciamento de Usuários › Entendendo os Perfis de Acesso.

Na lista de papéis, eles aparecem destacados com a marca "· Role do sistema", e ao abrir o Administrador para edição você verá as permissões dele, mas não poderá alterá-las — elas são sempre a lista completa, atualizada automaticamente sempre que uma nova função é lançada no sistema.

2. Criando um perfil personalizado

Clique no botão azul "Criar" e preencha:

• Nome: como o perfil vai aparecer na lista (ex: "Vendedor", "Financeiro", "Suporte Nível 1").
• Permissões: logo abaixo, uma seção recolhível para cada área do sistema (Clientes, Viagens, Financeiro, Fornecedores, etc.), cada uma com as ações disponíveis para aquela área — normalmente Visualizar, Criar, Editar e Excluir, mas algumas áreas têm ações próprias (por exemplo, Viagens também tem Publicar e Exportar; Financeiro tem Estornar; Clientes também tem Visualizar clientes excluídos e Restaurar clientes excluídos, usadas para consultar e trazer de volta um cliente arquivado).

Marque apenas as ações que aquela função realmente precisa e clique em "Criar" para salvar.

3. Como as permissões funcionam

Cada ação dentro de uma seção é independente — conceder Visualizar não concede automaticamente Criar, Editar, Excluir ou qualquer outra ação daquela área. Se a pessoa precisa apenas consultar algo, marque só Visualizar.

Visualizar não é só para "ver a lista"

Algumas telas precisam apenas consultar dados de outra área para funcionar — por exemplo, para criar uma Viagem é preciso poder escolher Clientes e Fornecedores já cadastrados nos campos de seleção, mesmo que a pessoa não tenha permissão para criar ou editar Clientes/Fornecedores diretamente. Por isso vale sempre conferir, ao montar um perfil, se as áreas relacionadas têm ao menos a permissão de Visualizar marcada — sem isso, os campos de seleção podem aparecer vazios.

Na prática da interface: os botões de Criar, Editar e Excluir só aparecem para quem tem a permissão correspondente — se a pessoa não pode excluir Clientes, o botão de excluir simplesmente não aparece pra ela naquela tela. Isso é só uma questão de deixar a tela mais limpa e evitar confusão: mesmo que alguém tente forçar uma dessas ações por fora da tela (por exemplo, manipulando uma requisição), o sistema bloqueia a ação do mesmo jeito nos bastidores.

4. Permissões sensíveis

Algumas seções concedem acesso a configurações críticas do sistema — credenciais, chaves de API, dados financeiros ou controle de acesso de outras pessoas. Para essas, a tela exibe um aviso logo abaixo do título da seção:

⚠ Permissões sensíveis — dão acesso a configurações críticas do sistema. Conceda-as apenas a usuários de confiança.

Hoje, as seções marcadas dessa forma são:

• Gateways de Pagamento — tokens e chaves de API das suas integrações de cobrança.
• Tokens de API — chaves de acesso à API do sistema.
• Contas de E-mail — inclui a senha das contas de envio configuradas.
• Usuários — quem pode criar, editar e remover o acesso de outras pessoas.
• Papéis — quem pode alterar o que cada perfil pode fazer.
• Financeiro / Pedidos — inclui a permissão de estornar transações.
• Comissões a Receber — dados financeiros de comissões previstas e recebidas de fornecedores/parceiros, ligadas às suas Propostas.
• Assinatura — inclui a permissão de alterar ou cancelar o plano contratado com o Avoei.

Esse aviso é apenas um alerta visual para te ajudar a decidir com mais cuidado a quem conceder essas permissões — ele não muda o que a permissão faz nem impede que ela seja concedida.

5. Editando ou excluindo um perfil

Para editar, clique no ícone de lápis ao lado do perfil e ajuste o nome ou as permissões marcadas (perfis reservados não podem ser renomeados nem ter as permissões alteradas).

Para excluir, use o ícone de lixeira. Um perfil só pode ser excluído se:

• não for um dos dois perfis reservados (Administrador/Usuário); e
• não houver nenhum usuário vinculado a ele no momento — se houver, primeiro edite esses usuários em Usuários e atribua outro perfil a eles.

6. Atribuindo um perfil a alguém

Perfis são atribuídos na tela de Usuários, no campo Perfil, seja ao criar um novo acesso ou ao editar um já existente.