The Assignments screen atDocumentation Index
Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
Use this file to discover all available pages before exploring further.
/rh/staff-operations/assignments lists all staff assignments to residences within the current organization and provides filters by residence, staff role, active status, and a primary-assignment toggle.
Overview
The page loads residence options viauseResidences for the filter dropdown. The StaffAssignmentsTable component renders assignment rows filtered by the locally-managed StaffAssignmentFilters state. Filter options include a residence selector (all residences from useResidences), a role selector with values housing_tech, house_manager, program_manager, peer_pss, and other, an active-status selector (active / inactive / all), and a Primary Only switch that sets isPrimary on the filter. The Add Assignment button opens the StaffAssignmentDialog. The page wraps in MobilePullToRefresh; pulling to refresh invalidates the ['rh', 'staff-assignments', organizationId] query key.
Who it’s for
No route-levelRequirePermission beyond the outer RHViewGuard, which requires RH_PERMISSIONS.DASHBOARD_VIEW (rh.dashboard.view). The code comments reference RH_PERMISSIONS.STAFF_OPERATIONS_VIEW and STAFF_OPERATIONS_CREATE but these are not applied as a <Route>-level guard on this path.
Before you start
- Hold
rh.dashboard.viewto access the RH module.
Steps
Open the Assignments list
Navigate to
/rh/staff-operations/assignments. The StaffAssignmentsTable loads for the current organization.Filter by residence
Use the Residence dropdown to show assignments for a specific residence, or leave as “All Residences”.
Filter by role
Use the Role dropdown to filter by
Housing Tech, House Manager, Program Manager, Peer PSS, or Other.Filter by active status
Use the Status dropdown to show only
Active, only Inactive, or all assignments.Show primary assignments only
Toggle the Primary Only switch to filter to assignments where
is_primary is true.Add a new assignment
Click Add Assignment in the page header. The
StaffAssignmentDialog opens. Complete the form and save.Key concepts
Staff role values
Staff role values
The role filter uses the following values from the
StaffRole type: housing_tech (Housing Tech), house_manager (House Manager), program_manager (Program Manager), peer_pss (Peer PSS), other (Other).Pull-to-refresh
Pull-to-refresh
On mobile, pulling down calls
queryClient.invalidateQueries with key ['rh', 'staff-assignments', organizationId], triggering a live refetch.Related
Recovery Housing
Recovery Housing references and overview.
Governance & parity
Documentation coverage and governance.
This page documents shipped product behavior. It is not medical, legal, or
billing advice. Verify against your organization’s policies and applicable
regulations before using it for clinical, compliance, or billing decisions.
Protected health information (PHI) shown in the product is governed by your
tenant’s access controls and is never exposed in this documentation.
Documentation sources
Documentation sources
- src/routes/rh.tsx
- src/cores/rh/pages/StaffAssignmentsPage.tsx