Visão geral
O módulo Papéis e permissões define papéis (conjuntos de permissões) e ajustes por usuário. As permissões efetivas de alguém são: as do papel mais concessões menos revogações. É possível criar papéis sem precisar de deploy.
Conceitos-chave
- Capability: cada permissão corresponde a uma feature real (ex.:
finance.view). - Papel: agrupamento de capabilities.
- Assinatura tem permissão PRÓPRIA: Gerenciar a assinatura (
subscription.manage) nasce só com Administrador e Dona(o) da clínica. Não é apêndice de Configurações de propósito — quem cuida do dia a dia não é necessariamente quem decide o que a clínica PAGA. - Grant/Revoke: exceções por usuário.
- Modelos: pontos de partida por função — pré-marcam as permissões típicas e você ajusta antes de criar.
- Preview: mostra o menu resultante enquanto você marca, lendo a mesma lista que a navegação usa.
Como usar
Abra Configurações → Papéis e permissões.
Comece de um modelo (Recepcionista, Auxiliar clínico, Financeiro…) ou duplique um papel parecido.
Marque as permissões — use a busca e confira no preview quais telas o papel vai enxergar. Módulo desligado na unidade nem entra na conta: a prévia mostra o menu de verdade, e diz quantas telas ficaram de fora por isso.
Ajuste exceções por usuário quando necessário.
Casos de uso
- Papel de recepção: operacional sem acesso ao financeiro.
- Exceção: dar
finance.viewa uma pessoa específica.
Boas práticas
Integrações
Os papéis são atribuídos em Usuários; as ações sensíveis aparecem na Auditoria.
Permissões
Gerenciar papéis e permissões (roles.manage).
Dúvidas frequentes
- Posso criar papéis sem deploy?
Sim — o mapa papel→permissões é dinâmico (banco).