Roles & Permissions (RBAC)
WildTrack360 implements a Role-Based Access Control (RBAC) system combined with Species-Based Access Control (SBAC) to ensure users only see and manage what's relevant to their responsibilities.
Overview
The RBAC system controls:
- Which pages and features a user can access
- Which animals a user can view and manage
- Which administrative actions a user can perform
- Which species groups a carer is qualified to handle
Roles
Admin
Full access to all system features and data.
| Capability | Access |
|---|---|
| View all animals | Yes |
| Edit any animal | Yes |
| Manage users and roles | Yes |
| View audit logs | Yes |
| Compliance checklist | Yes |
| Generate reports | Yes |
| Manage species groups | Yes |
| Organisation settings | Yes |
Admins are automatically treated as eligible carers for all species groups, meaning they can be assigned to any animal without needing explicit species group assignments.
Coordinator
Manages carers and animals within their assigned species groups.
| Capability | Access |
|---|---|
| View animals in assigned species groups | Yes |
| Edit animals in assigned species groups | Yes |
| Assign carers to animals | Yes |
| Manage species group assignments for carers | Yes |
| View audit logs | No |
| Organisation settings | No |
Carer
Day-to-day animal care within assigned species groups.
| Capability | Access |
|---|---|
| View animals in assigned species groups | Yes |
| Add records to assigned animals | Yes |
| Edit own profile | Yes |
| Manage other users | No |
| Access admin panel | No |
Species-Based Access Control (SBAC)
SBAC works alongside RBAC to filter data based on species group assignments.
How It Works
- An admin or coordinator assigns one or more species groups to a carer (e.g., "Macropods", "Raptors", "Reptiles")
- The carer can only view and manage animals belonging to their assigned species groups
- When assigning a carer to an animal, the system only shows carers who are eligible for that animal's species group
- Admins bypass SBAC and can access all animals regardless of species group
Species Group Assignment
Species groups are assigned using a clickable badge picker interface:
- Each species group appears as a toggleable badge
- Click a badge to add or remove the group from a carer's assignments
- Changes are saved immediately
- Only Coordinators and Admins can modify species group assignments
Role Assignment
Initial Setup
When a user first signs into WildTrack360, they are directed to a role provisioning page where they select their intended role. This self-service step creates their initial role record.
Changing Roles
Admins can change any user's role from the Admin Panel > Carer Profiles section:
- Navigate to the user's profile
- Select the new role from the role dropdown
- The change takes effect immediately
After assigning someone the CARER role, the system redirects to the Carer Profiles tab so you can immediately configure their species group access.
Role Migration
For organisations upgrading from an earlier version of WildTrack360 (before RBAC was introduced), a role migration page is available to assign roles to all existing Clerk users.
UI Guards
The interface adapts based on the user's role:
- Navigation: Menu items are shown or hidden based on role
- Pages: Attempting to access an unauthorised page redirects the user to their home dashboard
- Actions: Buttons and forms for unauthorised actions are not rendered
- API: All server-side endpoints independently verify role permissions, regardless of what the UI shows
Best Practices
- Assign the minimum role needed for each user's responsibilities
- Use species group assignments to limit carer access to the animals they're qualified to handle
- Regularly review role assignments from the admin panel
- Admins should be limited to organisation leaders who need full system oversight