Public release from ruodoo-project: 19.0 - 2026-05-31 21:19:12 UTC

base_user_role/readme/CONFIGURE.md

@@ -0,0 +1,22 @@
+To configure this module, you need to go to *Settings / Users / Roles*,
+and create a new role. From there, you can add groups to compose your
+role, and then associate users to it.
+
+You can also define default roles for a new user by editing the user
+called "Default User".
+
+Roles:
+
+![](/OCA/server-backend/16.0/base_user_role/static/description/roles.png)
+
+Add groups:
+
+![](/OCA/server-backend/16.0/base_user_role/static/description/role_groups.png)
+
+Add users (with dates or not):
+
+![](/OCA/server-backend/16.0/base_user_role/static/description/role_users.png)
+
+Instead of creating roles from scratch, it is possible to create a role
+based on the groups of an existing user: select or open the user and
+choose "Create role from user" in the action menu.

base_user_role/readme/CONTRIBUTORS.md

@@ -0,0 +1,15 @@
+- Sébastien Alix \<<sebastien.alix@camptocamp.com>\>
+- Duc, Dao Dong \<<duc.dd@komit-consulting.com>\>
+  (<https://komit-consulting.com>)
+- Jean-Charles Drubay \<<jc@komit-consulting.com>\>
+  (<https://komit-consulting.com>)
+- Alan Ramos \<<alan.ramos@jarsa.com.mx>\> (<https://www.jarsa.com.mx>)
+- Harald Panten \<<harald.panten@sygel.es>\>
+- Kevin Khao \<<kevin.khao@akretion.com>\>
+- Tatiana Deribina \<<tatiana.deribina@sprintit.fi>\>
+  (<https://sprintit.fi>)
+- Guillem Casassas \<<guillem.casassas@forgeflow.com>\>
+- Guillaume Pothier \<<gpothier@caligrafix.cl>\>
+
+Do not contact contributors directly about support or help with
+technical issues.

base_user_role/readme/CREDITS.md

@@ -0,0 +1,5 @@
+## Images
+
+- Oxygen Team:
+  [Icon](http://www.iconarchive.com/show/oxygen-icons-by-oxygen-icons.org/Actions-user-group-new-icon.html)
+  (LGPL)

base_user_role/readme/DESCRIPTION.md

@@ -0,0 +1,22 @@
+This module was written to extend the standard functionality regarding
+users and groups management. It helps creating well-defined user roles
+and associating them to users.
+
+It can become very hard to maintain a large number of user profiles over
+time, juggling with many technical groups. For this purpose, this module
+will help you to:
+
+> - define functional roles by aggregating low-level groups,
+> - set user accounts with the predefined roles (roles are cumulative),
+> - update groups of all relevant user accounts (all at once),
+> - ensure that user accounts will have the groups defined in their
+>   roles (nothing more, nothing less). In other words, you can not set
+>   groups manually on a user as long as there is roles configured on
+>   it,
+> - activate/deactivate roles depending on the date (useful to plan
+>   holidays, etc)
+> - get a quick overview of roles and the related user accounts.
+
+That way you make clear the different responsabilities within a company,
+and are able to add and update user accounts in a scalable and reliable
+way.

base_user_role/readme/USAGE.md

@@ -0,0 +1,5 @@
+To use this module, you need to:
+
+1.  Go to Configuration / Users / Users choose user and set Roles:
+
+![image](/OCA/server-backend/base_user_role/static/description/user_form.png)