Skip to main content
The path /rh/admissions is not registered as a standalone route in src/routes/rh.tsx. The only admission-related route in the RH router is /rh/admissions/new, which renders the AdmissionWizardPage component.

​
Overview

The route /rh/admissions has no registered <Route> element in src/routes/rh.tsx. The RH router provides /rh/admissions/new, which launches the AdmissionWizardPage wizard to create a new resident admission. After wizard completion, the application navigates to /rh/episodes/:residentId. Users seeking a list of admissions should navigate to /rh/episodes.

​
Who it’s for

Access follows your organization’s role and module configuration. The /rh/admissions/new wizard path is protected by the outer RHViewGuard, which requires RH_PERMISSIONS.DASHBOARD_VIEW (rh.dashboard.view).

​
Before you start

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

​
Steps

1

Navigate to the new admission wizard

Go to /rh/admissions/new to start the resident admission wizard. The /rh/admissions path itself is not a registered screen.

​
Creating an admission

The /rh/admissions/new route renders AdmissionWizardPage, which presents a multi-step guided wizard for admitting a new resident into a recovery housing program. 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. 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.
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. Residences and beds are filtered to those that match the resident’s gender. Residences using a gender_specific_floors model are included for any gender; beds with a gender_restriction of any are always assignable. If a residence has beds but none match the resident’s gender, the step shows a notice prompting you to try another 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

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