Permissions
Who performs this action
Super Admin / Admin — grants permissions to TC · WC · Security Guard
I. Overview
The Permissions feature allows Super Admins and Admins to grant access to Dock Management functions for individual staff members on the OnWheel web portal. There are 3 target groups:
| Target | Functions that can be granted |
|---|---|
| Transport Coordinator (TC) | Dock Registration · Appointment List (Transport) |
| Warehouse Coordinator (WC) | Warehouse Configuration · Appointment List (Warehouse) · Dock Dispatch |
| Security Guard | Gate In Management (Register + Gate In) and/or Gate Out Management (Gate Out) |
note
Only Super Admins and Admins can manage permissions on the OnWheel web portal. Staff cannot grant permissions to themselves.
II. How to Assign Permissions
2.1. Steps
| Step | Action |
|---|---|
| 1. Access user management | Navigate to the staff management page on the OnWheel web portal. |
| 2. Find the employee | Search for the employee_id by name or phone number. |
| 3. Open permissions pop-up | Click on the employee → select Edit / Permissions. |
| 4. Tick the checkboxes | Tick the checkboxes corresponding to the functions to grant (see details below). |
| 5. Save | Click 'Save' / 'Confirm' to apply the changes. |
Important Notes
- Each employee can be granted multiple permissions at once (e.g., both TC and WC).
- Permissions take effect immediately after saving — the employee sees the corresponding menu upon next login.
- Unticking a permission immediately disables that feature, including any buttons on screen.
III. Permission Details by Role
3.1. Transport Coordinator (TC)
| Permission | Description |
|---|---|
| Dock Registration | Shows the 'Register' button on the Order Management screen. TC can register docks for any warehouse with at least 1 configured dock within their partner scope. |
| Appointment List (Transport) | Shows the 'Appointment List' screen. TC can view, monitor, receive notifications, cancel, and edit their own appointments (subject to allowed statuses). |
TC Warehouse Scope
TC can select any warehouse that has at least 1 configured dock, within the partner scope of that employee_id. Not restricted to a specific store_id.
3.2. Warehouse Coordinator (WC)
| Permission | Description |
|---|---|
| Warehouse Configuration (Dock & Check-in) | Shows the 'Warehouse Configuration' screen. WC can only create and configure docks belonging to their assigned warehouse (store_id). Cannot configure other warehouses. |
| Appointment List (Warehouse) | Shows the 'Appointment List' screen. WC can view, monitor, receive notifications, and cancel (by status) appointments where appointment_warehouse_id = their store_id. |
| Dock Dispatch | Shows the 'Dock Dispatch' screen. WC can only dispatch operations for docks in their assigned warehouse (store_id). |
WC Warehouse Scope
WC can only see and manage data for the warehouse assigned to their store_id. Data from other warehouses is not displayed. If a TC changes the warehouse to one outside WC's scope, the appointment will appear greyed out (disabled) in WC's view.
3.3. Security Guard
| Permission | Description |
|---|---|
| Gate In Management (tick Gate In) | Enables the 'Register' and 'Gate In' buttons on the Gate Management screen. Allows recording vehicle arrival and confirming gate entry. |
| Gate Out Management (tick Gate Out) | Enables the 'Gate Out' button on the Gate Management screen. Allows confirming vehicle departure from the warehouse. |
Independent Gate Permissions
Gate In and Gate Out are 2 independent permissions — either or both can be ticked:
- Only Gate In ticked: Guard can only perform Register + Gate In, CANNOT perform Gate Out.
- Only Gate Out ticked: Guard can only perform Gate Out, CANNOT perform Register + Gate In.
- Both unticked: All buttons on the Gate Management screen are disabled.
IV. Consolidated Permission Matrix
Summary of all features and roles:
| Feature / Screen | TC | WC | Security Guard | Admin |
|---|---|---|---|---|
| Dock Registration | ✅ | — | — | ✅ |
| Appointment List (Transport) | ✅ | — | — | ✅ |
| Appointment List (Warehouse) | — | ✅ | — | ✅ |
| Warehouse Configuration (dock & check-in) | — | ✅ | — | ✅ |
| Dock Dispatch | — | ✅ | — | ✅ |
| Gate In Management (Register + Gate In) | — | — | ✅ (if ticked) | ✅ |
| Gate Out Management (Gate Out) | — | — | ✅ (if ticked) | ✅ |
Matrix Notes
- ✅ = Can be granted (Admin must tick)
- — = Not applicable for this role
- Admin/Super Admin can perform all roles.
- One employee can have multiple roles if Admin ticks all required permissions.
V. Common Troubleshooting Scenarios
| Scenario | Resolution |
|---|---|
| Employee cannot see the 'Appointment List' screen | Check if 'Appointment List (Transport)' or 'Appointment List (Warehouse)' has been ticked. If not → tick and save. |
| Security guard cannot see 'Register' or 'Gate In' button | Check if 'Gate In Management' has been ticked. If not → tick and save. Employee must log in again. |
| Security guard cannot see 'Gate Out' button | Check if 'Gate Out Management' has been ticked. If not → tick and save. |
| WC cannot see appointments for a specific warehouse | WC can only see the warehouse whose store_id matches their account. Verify the store_id assigned to the employee_id is correct. |
| TC cannot select a warehouse when registering a dock | That warehouse may not have a configured dock yet. Ask WC to configure at least 1 dock before TC can register. |
| One employee needs to be both TC and WC | Tick all TC and WC permissions for that employee_id. The system supports multiple simultaneous roles. |