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

# Admissions

> No standalone list screen exists at /rh/admissions — the path is not registered as a route; use /rh/admissions/new to launch the resident admission wizard.

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

<Steps>
  <Step title="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.
  </Step>
</Steps>

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

<Steps>
  <Step title="Open the admission wizard">
    Navigate to `/rh/admissions/new`. The wizard loads; a skeleton is shown while the wizard mode is determined.
  </Step>

  <Step title="Enter basic information">
    On the **Basic Information** step, enter the resident's identifying details.
  </Step>

  <Step title="Select a program">
    On the **Program Selection** step, choose the recovery housing program the resident will enroll in.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Add documentation">
    On the **Documentation** step, upload or record required admission documents.
  </Step>

  <Step title="Add emergency contacts">
    On the **Emergency Contacts** step, enter at least one emergency contact for the resident.
  </Step>

  <Step title="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`.
  </Step>
</Steps>

### Key concepts

| Term              | Meaning                                                                                                                                                                                                                                               |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Wizard mode       | `hardcoded` (default) or `configurable` (platform-driven, when enabled)                                                                                                                                                                               |
| Gender filtering  | Bed Assignment filters residences by `gender_model` (`co_ed`, `male_only`, `female_only`, `gender_specific_floors`) and beds by `gender_restriction` (`male`, `female`, `any`). Residents with gender `other` or `prefer_not_to_say` see all options. |
| Draft persistence | Wizard data is auto-saved via `useAdmissionDraft`                                                                                                                                                                                                     |
| Episode           | The housing stay record created on admission; navigated to on completion                                                                                                                                                                              |

## Related

<Columns cols={2}>
  <Card title="Recovery Housing" icon="house" href="/rh/references">
    Recovery Housing references and overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index">
    Documentation coverage and governance.
  </Card>
</Columns>

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

<Accordion title="Documentation sources">
  * src/routes/rh.tsx
  * src/cores/rh/pages/AdmissionWizardPage.tsx
  * src/cores/rh/components/wizards/ResidentAdmissionWizard.tsx
  * src/cores/rh/hooks/useResidentAdmissionWizard.ts
</Accordion>