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 Follow-Ups page lists all post-discharge follow-up schedules for the organization, tabbed by overdue, upcoming, and completed status, with search and status filter controls. Route: /rh/follow-ups

​
Overview

The page uses useFollowUpSchedulesDue(30) to load schedules due within the next 30 days, along with already-overdue and completed records for the organization. Results are then filtered client-side by the search input and status dropdown. The page is divided into three tabs:
TabSchedules shown
OverdueStatus is not completed and scheduled_date is in the past. A red count badge appears when overdue items exist.
UpcomingStatus is not completed and scheduled_date is today or in the future.
CompletedStatus is completed.
Each tab renders a FollowUpSchedulesTable. Clicking a row navigates to /rh/follow-ups/:id. Search matches against the timepoint and notes fields (case-insensitive). The status filter allows narrowing by: scheduled, in_progress, completed, or cancelled.

​
Who it’s for

Requires the rh.dashboard.view permission (applied to all RH routes via RHViewGuard). No additional inner permission gate exists on this route.

​
Before you start

  • Follow-up schedules are created from within episode discharge planning. If no schedules appear, confirm that discharge planning has been completed for the relevant episodes.
  • Use the Overdue tab as the primary triage view for schedules requiring immediate action.

​
Steps

1

Open Follow-Ups

Navigate to Recovery Housing → Follow-Ups (/rh/follow-ups). The page opens on the Overdue tab by default.
2

Triage overdue schedules

Review the Overdue tab. The red badge on the tab label indicates the count of schedules past their scheduled date that are not yet completed.
3

Filter by status or search

Use the search input (searches timepoint and notes text) or the status dropdown to narrow the list across any tab.
4

Switch to Upcoming or Completed tabs

Click Upcoming to see schedules not yet due, or Completed to review finished follow-ups.
5

Open a schedule record

Click any row to navigate to the Follow-Up Details page at /rh/follow-ups/<id> where you can log a contact or edit the schedule.

​
Key concepts

  • Follow-up schedule — a record in rh_follow_up_schedules that defines a planned post-discharge contact point for a resident episode.
  • Timepoint — a label on the schedule indicating the stage after discharge (e.g., 30_day). Searchable in the filter bar.
  • Overdue — a schedule whose scheduled_date is in the past and whose status is not completed or cancelled.
  • Status filter — filters across scheduled, in_progress, completed, and cancelled values.

Recovery Housing

Governance & parity

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/discharge/FollowUpsPage.tsx
  • src/cores/rh/hooks/discharge/useFollowUpSchedules.ts