Cadastro de papel de acesso
O papel é o conjunto de permissões atribuído a um usuário dentro da empresa. Cada pessoa tem um único papel por empresa.
Onde fica
Menu lateral → Configuração → Permissões.
Quem pode manter
roles.view— ver os papéis e a matriz.roles.managesensível — criar e editar.
Papéis modelo do sistema
| Papel | Descrição exibida na tela |
|---|---|
| Admin | Acesso total à empresa (modelo de sistema, não editável). |
| Operador de Acesso | Valida vouchers na portaria. |
| Operador de Caixa (PDV) | Opera o PDV. |
| Operador de Vendas | Vende e consulta catálogo e contatos. |
Modelos não são editáveis — duplique
Para personalizar, crie um papel novo a partir do modelo mais próximo e ajuste as permissões da cópia. Isso preserva os modelos como referência para futuras contratações.
Campos
| Campo | Obrigatório | Descrição | Formato ou exemplo |
|---|---|---|---|
| Nome do papel | sim | Como o papel aparece na seleção do usuário. | “Recepção” |
| Descrição | não | Explica para que serve o papel. | “Atende o balcão e valida entrada.” |
| Matriz de permissões | sim (na prática) | Marcação, permissão a permissão, do que o papel libera. | Lista agrupada por área |
A matriz é montada automaticamente a partir do catálogo de permissões do sistema — permissões novas aparecem sozinhas na tela. As sensíveis ficam destacadas para supervisão.
O que acontece ao salvar
- O papel passa a estar disponível na seleção do cadastro de usuário.
- Usuários que já têm esse papel passam a valer pelas novas permissões imediatamente.
- O menu lateral desses usuários muda na próxima carga da tela.
Combinações que exigem atenção
| Função | Permissões que devem andar juntas |
|---|---|
| Operador de balcão | pos.operate + pos.manage_cash — sem a segunda, ele não abre caixa e não vende. |
| Balcão que também valida entrada | pos.operate + checkin.operate |
| Quem cadastra catálogo | attractions.manage + occurrences.manage + passports.manage |
| Quem define preços | passports.manage_rules (separada de passports.manage) |
| Quem acompanha resultados | reports.view + as permissões de cada relatório desejado |
Boas práticas
- Um papel por função real da operação, não por pessoa.
- Deixe as permissões sensíveis fora dos papéis operacionais e libere por PIN de supervisor quando fizer sentido.
- Descreva o papel: seis meses depois, ninguém lembra por que ele foi criado.
- Depois de criar, teste com um usuário real — o menu revela rapidamente o que faltou.