Painel AdminTecnicoAtualizado em 30 de out. de 2026

Usuários papéis e permissões

Como o Master cria usuários e monta a matriz de permissões e o que cada permissão global libera

O que e?

São duas telas do grupo Administração, restritas ao papel Master: Usuários e Roles. Em Usuários o Master cria as contas do cliente e atribui um papel (o role) a cada uma. Em Roles ele monta a matriz de permissões daquele papel.

Cada usuário tem um papel, não vários.

O mesmo grupo tem a tela Contas de e-mail, que segue a permissão do próprio recurso e tem artigo próprio.

Como funciona?

Usuários

A tela lista, busca por nome, e-mail ou role, cria, edita e desativa ou ativa usuários. Na criação entram nome, e-mail, senha (mínimo de seis caracteres) e role. Na edição mudam o nome e o role — o e-mail não muda, e a tela avisa isso ao lado do campo. Desativar tira o acesso da pessoa ao painel.

Troca de senha de outro usuário. O botão Trocar senha aparece só na própria linha do usuário. A exceção é a sessão de acesso da equipe Premify, em que ele aparece em todas. Isso não é limitação da tela: o servidor recusa a troca de senha de outra conta.

A conta de suporte é protegida. A conta que nasce junto com um cliente novo não se inativa, não se exclui, e nem o papel nem o e-mail dela mudam. Na lista ela mostra o selo "Conta de suporte" ao lado do nome, não tem o botão Desativar, e o formulário de edição trava o role com a dica "O papel da conta de suporte não muda." São travas de tela; quem impede de fato é o servidor.

O role pode ser criado direto do formulário do usuário, pelo botão Adicionar role: o mesmo formulário de role abre, grava e já seleciona o role novo no usuário, sem perder o que estava sendo preenchido.

Roles e a matriz de permissões

O nível do papel não vale mais. O acesso vem da matriz: para cada recurso do painel, as ações Ler, Criar, Editar e Excluir, com um atalho para marcar ou desmarcar todos. O catálogo de recursos é fixo e somente leitura.

Além da matriz, há quatro permissões globais:

Vê dados sensíveis: sem ela, CPF, telefone e e-mail saem mascarados nas telas e nas exportações de Gerenciar e da Base.
Aprovar notas: é a permissão que libera aprovar, reprovar e reabrir posições na fila de apuração. Ela não é a permissão de editar posições premiadas — são coisas diferentes.
Aprovar financeiro: o checkbox existe e o valor é gravado, mas nenhuma ação do painel confere essa permissão ainda; a etapa de pagamento não tem tela.
Exportar dados: libera as exportações em CSV e a tela de Relatórios.

Duas relações entre permissões que explicam quase toda dúvida de acesso:

Ler alguns recursos inclui ler campanhas. Doze recursos têm suas telas presas ao carregamento de uma campanha — Participantes, Ganhadores, Posições premiadas, Produtos, Prêmios, Lojas, Formulário, Hotsite, Conteúdo, Vídeos, Gamificação e Portal. Ler qualquer um deles exige também ler Campanhas. Quem marca de fato é o servidor: salvar a matriz com ler Campanhas desmarcado junto de um desses recursos devolve a matriz com ler Campanhas marcado, sem erro nem mensagem. Na tela, quando algum desses recursos está com Ler marcado, a caixa Ler de Campanhas aparece marcada, desabilitada e com a nota de que as telas dos outros recursos carregam a campanha para abrir; desmarcar o último desses recursos solta a trava.

Exportar dados é independente de ver dados sensíveis. Quem exporta sem poder ver dados sensíveis recebe o arquivo de Gerenciar com os dados pessoais mascarados. A exceção são os relatórios da tela Relatórios, que saem sem mascaramento — lá a global de exportar dados é o controle.

A matriz é substituída por inteiro ao salvar: o que vai na tela é o que fica.

Desativar um role tira o acesso associado dos usuários que o usam; há ação para ativar de novo.

Recurso novo: Portal

A aba Portal da campanha usa um recurso próprio na matriz, o Portal, com ler e editar. Ele não reaproveita a permissão de editar campanhas. Os roles que já existiam não ganham esse recurso sozinhos: para que um operador veja e edite a aba Portal, o Master precisa marcar o recurso Portal no role dele.

O Master

O Master nasce sem linhas na matriz. Em alguns pontos do painel ele passa sem a permissão correspondente — a edição do cadastro de participante é um exemplo, e a tela aplica o mesmo critério para mostrar o botão. O grupo Administração (Usuários e Roles) é restrito a ele, e as ações de envio de convite da Base também.

Como explicar ao cliente?

Quem monta os acessos é o Master do cadastro do cliente. Seis orientações que resolvem a maioria dos tíquetes:

Cada pessoa tem um papel. Para dar um acesso diferente a alguém, o caminho é um role novo, não uma exceção na conta.

Se o cliente marcou ler em Participantes, Ganhadores, Posições premiadas, Produtos, Prêmios, Lojas, Formulário, Hotsite, Conteúdo, Vídeos, Gamificação ou Portal, a tela vai marcar e travar ler Campanhas junto. Isso é proposital: essas telas não abrem sem carregar uma campanha.

Aprovar na fila de apuração não vem da permissão de editar posições premiadas. Vem da permissão global Aprovar notas. É a troca mais comum.

Quem precisa baixar CSV precisa da permissão global Exportar dados. Se a pessoa também precisa ver os dados pessoais sem máscara nas telas de Gerenciar, precisa da global Vê dados sensíveis — são duas permissões separadas.

Recurso novo não entra sozinho nos roles antigos. Quando uma tela nova aparece, como a aba Portal da campanha, o Master marca o recurso dela no role de quem vai usar.

A conta de suporte não se desativa nem muda de papel. Ela existe para a Premify poder atender o cliente, e a tela sinaliza isso com um selo.

Possiveis falhas, causas e solucoes

Falha: o usuário não consegue aprovar na fila de apuração mesmo com permissão de editar posições premiadas.
Possivel causa: aprovar, reprovar e reabrir seguem a permissão global Aprovar notas, e não a permissão do recurso Posições premiadas.
Como orientar: oriente o Master a marcar a permissão global Aprovar notas no role daquele usuário.
Quando escalar: se a permissão global estiver marcada e as ações continuarem indisponíveis, abrir issue no Jira (projeto DEV) com as evidências.

Falha: a caixa Ler de Campanhas aparece marcada e desabilitada e o Master não consegue desmarcar.
Possivel causa: algum recurso cuja tela depende de carregar uma campanha está com Ler marcado. Ler qualquer um deles exige ler Campanhas.
Como orientar: explique a dependência. Para soltar a trava, desmarque o Ler dos recursos que dependem de campanha. A própria tela mostra a nota com o motivo.
Quando escalar: não é falha.

Falha: o operador não vê a aba Portal da campanha.
Possivel causa: o role dele não tem o recurso Portal marcado. É um recurso novo, que não vem marcado nos roles antigos e não depende da permissão de editar campanhas.
Como orientar: oriente o Master a abrir Roles, editar o role do operador e marcar Ler e Editar no recurso Portal.
Quando escalar: se o recurso estiver marcado e a aba continuar ausente depois de sair e entrar de novo, abrir issue no Jira (projeto DEV) com as evidências.

Falha: o botão de trocar a senha de outro usuário não aparece.
Possivel causa: a troca de senha só aparece na própria linha do usuário. O servidor recusa a troca de senha de outra conta.
Como orientar: oriente o usuário a trocar a própria senha no Meu perfil ou a usar o esqueci minha senha na tela de entrar.
Quando escalar: se for necessário redefinir a senha de uma conta sem acesso e o fluxo de esqueci minha senha não resolver, abrir issue no Jira (projeto DEV) com as evidências e o caso.

Falha: não dá para desativar a conta de suporte.
Possivel causa: a conta de suporte é protegida e não se inativa, não se exclui e não muda de papel nem de e-mail.
Como orientar: explique que a conta existe para a Premify poder atender o cliente e que a proteção é do servidor, não só da tela.
Quando escalar: não é falha.

Falha: o CSV exportado veio com os dados pessoais mascarados.
Possivel causa: o role tem a permissão global Exportar dados mas não tem a Vê dados sensíveis. As duas são independentes nas exportações de Gerenciar.
Como orientar: oriente o Master a marcar também a permissão global Vê dados sensíveis no role, se o usuário precisar dos dados sem máscara.
Quando escalar: se as duas permissões estiverem marcadas e o arquivo continuar mascarado, abrir issue no Jira (projeto DEV) com as evidências.

Falha: o checkbox Aprovar financeiro foi marcado e nada mudou.
Possivel causa: essa permissão é gravada, mas nenhuma ação do painel a confere ainda. A etapa de pagamento não tem tela.
Como orientar: explique que a permissão está reservada e não libera ação nenhuma hoje.
Quando escalar: não é falha.

Falha: o usuário perdeu acesso a uma tela depois de o Master salvar a matriz.
Possivel causa: a matriz é substituída por inteiro ao salvar. O que estava na tela é o que ficou gravado.
Como orientar: reabra o role, confira as caixas que faltaram e salve de novo. Lembre que salvar sempre grava a matriz completa.
Quando escalar: se a matriz salva não corresponder ao que estava marcado na tela, abrir issue no Jira (projeto DEV) com as evidências.

Exemplo de resposta pronta

Olá! Os acessos ficam no grupo Administração, nas telas Usuários e Roles, e são restritos ao Master do seu cadastro. Cada usuário tem um role, e é no role que você monta a matriz: para cada recurso do painel, as ações de ler, criar, editar e excluir, mais quatro permissões gerais. Três dicas que resolvem a maioria das dúvidas: a liberação para aprovar na fila de apuração vem da permissão geral Aprovar notas, e não da permissão de editar posições premiadas; quem precisa baixar CSV precisa da permissão geral Exportar dados — e, se também precisar ver CPF e e-mail sem máscara nas telas de Gerenciar, da permissão Vê dados sensíveis, que é separada; e recurso novo, como o Portal da campanha, não entra sozinho nos roles que já existiam, então é preciso marcá-lo no role de quem vai usar.

Quando escalar?

Acione o time de desenvolvimento urgentemente e abra issue no Jira (projeto DEV) com as evidências quando a matriz salva não corresponder ao que foi marcado na tela, quando um usuário com a permissão correta continuar sem acesso, quando alguém tiver acesso a uma tela que a matriz dele não concede, quando uma conta ficar sem conseguir entrar ou quando o problema impedir o cliente de operar a campanha. Anexe prints, o nome do role, o e-mail do usuário e a mensagem exibida.