Overview
In the Howspace Hub, Users, Roles, and Groups form a structure to define who can access content, what actions they're allowed to perform, and where those permissions apply.
Users
Users are people who have access to the Howspace Hub. Each user has a unique email, along with optional details such as first name, last name, phone number, age, and any additional information you might choose to store.
Users can also be assigned roles that allow them to enroll in trainings, and possibly manage other users or trainings. Trainings in the Hub could include, for example, learning courses or small events.
Roles
Hub roles define whether a user may view and manage trainings and users (and see users' completed trainings and qualifications). The hub owned can freely add roles and configure their permissions (viewing and editing trainings and users).
A role can apply to the entire Hub or it's possible that users are given a group-limited role, meaning the role permissions apply only to a given group.
A role can apply to the entire Hub:
A user with a "Manager" role but no group selection could be configured to manage and see all trainings (but maybe no visibility on users) across the entire Hub.
A user could have a "Lead Manager" role without a group which perhaps would give them permissions to view and manage all trainings and users across the Hub.
A user with role "Member" could have view access to trainings, but not necessarily see any users.
Users can have a group-limited role, meaning their permissions apply only to groups' resources:
A "Manager (role) at Sales Division (group)" could be configured to view only trainings (and possibly users if so configured) owned by the Sales Division group.
A "Member (role)" at "Coastal District (group)" could be given permissions to view users and their qualifications, as long as those users belong to the Coastal District group.
To summarize: a role can be configured to have privileges to view (or edit) trainings and users. The role applies to the whole hub, or can be limited to a given group (resources owned by that group).
Groups
Groups allow you to organize users into departments, regions, teams, or other meaningful categories.
When you add users to a group, you must always assign them a specific role within that group. You cannot add someone to a group without specifying their role.
Additionally, when trainings are created in the Hub, these trainings can be owned by one or more groups. Owning groups have permission to administrate and manage the training content. Note that training visibility and enrollment permissions are defined by roles, not groups.
For example, you might have a user named Sarah with the role "Admin (role) at Central District (group)" Because of this, she could manage trainings (and possibly users, if admin role so grants) owned by the Central District group but cannot manage trainings owned by other groups such as "Northern District" or "Coastal District."
However, you cannot simply add Sarah into the Central District group without assigning her a specific role—such as "Member at Central District" or "Admin at Central District." Her role in the group must always be defined.
Summary
Users are people, identified uniquely by their emails.
Roles determine what users can do and see within the Hub.
Groups organize users into meaningful categories and limit roles to specific contexts. Groups define ownership of trainings, controlling who can administrate or manage those trainings (and users), but roles determine who can view or enroll in them.