Skip to main content
The Referrals screen is at /rh/referrals and renders the ReferralsPage component. It displays all discharge referrals for the current organization via the useReferrals hook, with client-side filtering by search term, referral type, and status.

​
Overview

The page loads all referrals via useReferrals() and applies three client-side filters before passing results to ReferralsTable:
  • Search — matches agency_name or contact_name (case-insensitive, partial match).
  • Type filter — selects by referral_type: housing, employment, healthcare, social_services, or other.
  • Status filter — selects by status: sent, accepted, completed, or declined.
Clicking a row in the table navigates to /rh/referrals/:id.

​
Who it’s for

The outer RHViewGuard requires RH_PERMISSIONS.DASHBOARD_VIEW (rh.dashboard.view). The /rh/referrals route carries no additional permission gate beyond the guard.

​
Before you start

  • Hold the rh.dashboard.view permission to access any RH route.

​
Steps

1

Navigate to Referrals

Go to /rh/referrals. The ReferralsTable loads all referrals for the current organization.
2

Filter the list (optional)

Use the search box to filter by agency or contact name. Use the Type or Status dropdowns to narrow by referral type or status.
3

Open a referral record

Click a row. The browser navigates to /rh/referrals/:id to show the Referral Details screen.

​
Key concepts

​
Viewing a referral

The Referral Details screen is at /rh/referrals/:id and renders the ReferralDetailPage component. It displays a single referral record from the rh_referrals table (accessed via the useReferrals hook) and allows inline status updates and editing via ReferralDialog. The page resolves the referral by matching the :id path parameter against the results of useReferrals(). The header shows the agency_name, referral_type, and current status badges. A status dropdown (sent, accepted, completed, declined) calls useReferralMutation.update on change, with a toast notification on success or failure. The Edit button opens the ReferralDialog pre-populated with all editable fields. Two cards are displayed:
  • Referral Details — referral type, date, status (inline dropdown), and notes.
  • Contact Information — agency name, contact person, phone (clickable tel: link), and email (clickable mailto: link).
The outer RHViewGuard requires rh.dashboard.view; no additional gate exists on this route. A referral record with the target ID must exist and belong to the current organization.
1

Navigate to the Referrals list

Go to /rh/referrals. All referrals for the current organization are listed in the ReferralsTable.
2

Open a referral record

Click a row in the Referrals table. The browser navigates to /rh/referrals/:id.
3

Review referral details

The Referral Details card shows type, date, current status, and any notes.
4

Update referral status

Use the status dropdown in the Referral Details card to change the status. The update is saved immediately via useReferralMutation.update and a toast confirms success.
5

Contact the agency

The Contact Information card provides clickable phone and email links if contact_phone and contact_email are populated.
6

Edit the referral (optional)

Click “Edit” to open the ReferralDialog and modify any field, then submit to save.
7

Return to the list

Click the back arrow button to navigate back to /rh/referrals.

​
Key concepts

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/discharge/ReferralsPage.tsx
  • src/cores/rh/pages/discharge/ReferralDetailPage.tsx
  • src/cores/rh/hooks/discharge/index.ts