Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt

Use this file to discover all available pages before exploring further.

The Shift Notes screen at /rh/staff-operations/shift-notes displays a date-navigable log of shift notes for recovery housing operations and allows staff to create new notes via a dialog.

​
Overview

The page loads shift notes via useShiftNotes, which queries the rh_shift_notes table joined to rh_residences, filtered by organization_id and ordered by shift_date and shift_time descending. The default filter sets shiftDate to today’s date using format(new Date(), 'yyyy-MM-dd'). A date navigator (previous/next day buttons and a “Today” shortcut) updates shiftDate in the filter state using addDays / subDays from date-fns. A residence select (from useResidences) and a shift-type select (day, evening, overnight) refine the table. The Create Shift Note button opens ShiftNoteDialog. Individual note rows link to /rh/staff-operations/shift-notes/:id.

​
Who it’s for

No route-level RequirePermission beyond the outer RHViewGuard, which requires RH_PERMISSIONS.DASHBOARD_VIEW (rh.dashboard.view). STAFF_OPERATIONS_VIEW (rh.staff-operations.view) and STAFF_OPERATIONS_CREATE (rh.staff-operations.create) exist in RH_PERMISSIONS but are not applied as route-level guards on this path.

​
Before you start

  • Hold rh.dashboard.view to access the RH module.
  • Identify the residence and shift type relevant to the note you want to review or create.

​
Steps

1

Open Shift Notes

Navigate to /rh/staff-operations/shift-notes. The table loads today’s shift notes by default, ordered by most recent shift first.
2

Navigate to a different date

Use the previous (chevron-left) and next (chevron-right) buttons to move to another day, or click Today to return to the current date.
3

Filter by residence or shift type

Select a specific residence from the residence dropdown or choose a shift type (Day, Evening, Overnight) to narrow the results. Select “All Residences” or “All Shifts” to clear each filter.
4

Review existing notes

Browse the filtered table for existing shift notes for the selected date and shift.
5

Create a new shift note

Click Create Shift Note. The ShiftNoteDialog opens. Complete the form fields and save. The table refreshes with the new entry.
6

View note details

Click a row to navigate to /rh/staff-operations/shift-notes/:id for the full shift note detail view.

​
Key concepts

The page stores shiftDate in local filter state as a yyyy-MM-dd string. The previous/next buttons use subDays / addDays from date-fns to compute the new date. The “Today” button resets to format(new Date(), 'yyyy-MM-dd').
The UI presents three shift types: day, evening, and overnight. These correspond to the shift_type column on rh_shift_notes. The semantic meaning within each program’s schedule should be confirmed with a subject-matter expert.
Residences are loaded via useResidences, which queries rh_residences scoped to the current organization. Selecting a residence sets residenceId in the filter, which maps to residence_id on rh_shift_notes.
The table is rendered by ShiftNotesTable with filters passed as props. The useShiftNotes hook is enabled only when organizationId is present, using useOrganization for tenant isolation.

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.
  • src/routes/rh.tsx
  • src/cores/rh/pages/ShiftNotesPage.tsx
  • src/cores/rh/hooks/useShiftNotes.ts
  • src/cores/rh/types/index.ts