# Papéis de usuário

> Reúne grupos de acesso em papéis, como vendedor, comprador ou analista financeiro, e atribui esses papéis aos usuários. Módulo base_user_role no Odoo 18.

Fonte: https://docs.kmee.com.br/odoo/18.0/modulos/administracao/base-user-role/

- Módulo `base_user_role`
- Origem: OCA
- Licença LGPL-3
- Odoo 18.0

Reúne grupos de acesso em papéis, como vendedor, comprador ou analista financeiro, e atribui esses papéis aos usuários. Quando o papel muda, os acessos de todos os usuários ligados a ele são atualizados de uma vez, e pessoas da mesma função ficam com as mesmas permissões. Vale no Brasil como está, pois é um recurso de administração de acessos sem regra fiscal.

## Quando usar

- Padronizar os acessos por função e garantir que todos da mesma função tenham as mesmas permissões.
- Alterar de uma vez as permissões de uma equipe inteira.
- Conceder um acesso por tempo limitado, como uma substituição durante férias, com as datas de início e fim do papel.
- Criar um papel a partir de um usuário que já tem os acessos corretos.
- Ter uma visão única de cada papel e dos usuários ligados a ele.

## Como configurar

1. Abra Definições -> Usuários e Empresas -> Roles e clique em Novo.
2. Dê um nome ao papel e, na aba Grupos, adicione os grupos de acesso que ele concede.
3. Na aba Usuários, inclua os usuários, um a um ou pelo botão Adicionar Vários Usuários, e informe as datas A partir de e Para quando o acesso for temporário.
4. Também é possível atribuir papéis pelo cadastro do usuário, na aba Roles.
5. Para partir de um usuário que já tem os acessos certos, selecione-o na lista de usuários e use Ação -> Create role from user.
6. No formulário de um grupo de acesso, a ação Criar Papel monta um papel com os grupos escolhidos.
7. Para definir os papéis que todo novo usuário recebe, edite o usuário arquivado Default User e atribua os papéis a ele.

## Cuidados

- Os papéis são cumulativos, e quando o usuário tem algum papel ativo os grupos dele passam a ser exatamente os dos papéis. Grupos marcados à mão na aba Permissões de Acesso são refeitos ao salvar, e o formulário avisa sobre isso.
- Papéis com datas são ligados e desligados por uma tarefa agendada que roda a cada 3 horas.
- Só usuários com o direito de administrar permissões de acesso gerenciam papéis.

## Código e fontes

- Código-fonte: [OCA/server-backend](https://github.com/OCA/server-backend)
- [Documentação do módulo na OCA (18.0)](https://github.com/OCA/server-backend/tree/18.0/base_user_role)
