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 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.

​
Overview

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).

​
Who it’s for

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

​
Before you start

  • Hold the rh.dashboard.view permission to access any RH route.
  • A referral record with the target ID must exist and belong to the current organization.

​
Steps

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

TermMeaning
agency_nameName of the organization receiving the referral.
referral_typeCategory of the referral: housing, employment, healthcare, social_services, or other.
statusCurrent referral status: sent, accepted, completed, or declined.
contact_nameName of the specific contact person at the agency.
discharge_plan_idForeign key linking this referral to a discharge plan (may be empty).
episode_idForeign key linking the referral to a resident episode.

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