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 Pass Details screen lives at /rh/passes/:id and displays the complete record for a single resident pass request.

​
Overview

The page fetches a single pass record by id URL parameter via usePassDetail, which queries rh_passes joined to rh_episodes, rh_resident_profiles, pf_profiles, and rh_residences. It renders four sections: Resident Information (resident name, episode number, residence), Pass Schedule (start datetime, expected return, actual return when present), Destination & Purpose (destination, contact phone, purpose), and Notes (combining return_notes, approval_notes, curfew_violation_notes, and phase_override_reason). When status === 'requested', a “Pending Approval” card shows “Approve” and “Deny” buttons. When status === 'approved' and actual_return_datetime is absent, a “Verify Return” card shows a “Record Return” button. A breadcrumb is set to Pass - <formatted start date>.

​
Who it’s for

Requires RH_PERMISSIONS.DASHBOARD_VIEW (rh.dashboard.view) via the parent RHViewGuard. No additional permission gate is on this route in rh.tsx.

​
Before you start

A pass record must exist. Navigate via the Passes list at /rh/passes or a deep-link with the pass UUID.

​
Steps

1

Navigate to a pass record

Open /rh/passes/:id directly or click a pass row from the Passes list at /rh/passes.
2

Review resident information

Check the resident name, episode number, and residence in the Resident Information card.
3

Review schedule

Verify the start datetime, expected return, and actual return (if recorded) in the Pass Schedule card.
4

Review destination and purpose

Read the destination address, contact phone, and purpose in the Destination & Purpose card.
5

Approve or deny (if pending)

If the pass status is requested, click “Approve” or “Deny” in the Pending Approval card.
6

Record return (if approved)

If the pass status is approved and no return has been recorded, click “Record Return” in the Verify Return card.

​
Key concepts

If the pass record does not exist or the query returns no data, the page displays “Pass not found” in centered muted text. No error is thrown to the user.
The Notes card combines four fields from the database: return_notes, approval_notes, curfew_violation_notes, and phase_override_reason. The card only renders when at least one of these fields is non-null.

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/PassDetailPage.tsx
  • src/cores/rh/hooks/usePassDetail.ts