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 /rh/admissions/new route renders AdmissionWizardPage, which presents a multi-step guided wizard for admitting a new resident into a recovery housing program.

​
Overview

The route /rh/admissions/new is wrapped by the outer RHViewGuard, which requires rh.dashboard.view. On load, AdmissionWizardPage calls useWizardMode('rh') to determine whether to render the legacy hardcoded wizard (ResidentAdmissionWizard) or the platform’s configurable ModuleWizardRenderer. The hardcoded wizard has six steps: Basic Information, Program Selection, Bed Assignment, Documentation, Emergency Contacts, and Review & Submit. The wizard state is managed by useResidentAdmissionWizard, which supports draft persistence via useAdmissionDraft. On successful submission, a success toast is shown and the user is navigated to /rh/episodes/:residentId. Pressing the exit button navigates to /rh/episodes.

​
Who it’s for

Outer guard: RH_PERMISSIONS.DASHBOARD_VIEW (rh.dashboard.view), applied by RHViewGuard. No additional inner RequirePermission wraps this specific route in src/routes/rh.tsx.

​
Before you start

  • Hold rh.dashboard.view to access the page.
  • Ensure the resident’s program, bed, and emergency contact information are available before starting.

​
Steps

1

Open the admission wizard

Navigate to /rh/admissions/new. The wizard loads; a skeleton is shown while the wizard mode is determined.
2

Enter basic information

On the Basic Information step, enter the resident’s identifying details.
3

Select a program

On the Program Selection step, choose the recovery housing program the resident will enroll in.
4

Assign a bed

On the Bed Assignment step, select an available bed in the chosen residence.
5

Add documentation

On the Documentation step, upload or record required admission documents.
6

Add emergency contacts

On the Emergency Contacts step, enter at least one emergency contact for the resident.
7

Review and submit

On the Review & Submit step, confirm all data and click Submit. A success toast confirms admission; the app navigates to the new episode record at /rh/episodes/:residentId.

​
Key concepts

TermMeaning
Wizard modehardcoded (default) or configurable (platform-driven, when enabled)
Draft persistenceWizard data is auto-saved via useAdmissionDraft
EpisodeThe housing stay record created on admission; navigated to on completion

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/AdmissionWizardPage.tsx
  • src/cores/rh/components/wizards/ResidentAdmissionWizard.tsx
  • src/cores/rh/hooks/useResidentAdmissionWizard.ts