Skip to main content
The /rh/settings route renders RHSettingsPage, which loads and saves the organization’s RH module settings from the rh_module_settings table via the useRHModuleSettings hook.

​
Overview

The route /rh/settings is protected by RH_PERMISSIONS.SETTINGS_ADMIN (rh.settings.admin) inside the outer RHViewGuard (rh.dashboard.view). On load, useRHModuleSettings queries rh_module_settings filtered by organization_id; settings are seeded by migration and updated via an UPDATE mutation (no INSERT on read). The page renders RHSettingsForm with five tabs: General, Phases, Compliance, Integrations, and Wizards. A guided tour is available via the Help button; it can also be launched by appending ?tour=rh-settings-tour to the URL. Changes are saved with the Save button and trigger a toast notification on success or failure.

​
Who it’s for

RH_PERMISSIONS.SETTINGS_ADMIN (rh.settings.admin), enforced by an inner RequirePermission wrapper. Users without this permission cannot access this route even if they hold rh.dashboard.view.

​
Before you start

  • Hold rh.settings.admin to access and save settings.
  • Settings are per-organization. Ensure you are operating in the correct organization context.

​
Steps

1

Open Housing Settings

Navigate to /rh/settings. The page loads your organization’s current Recovery Housing configuration.
2

Configure general settings

On the General tab, set the Default Stay Duration (days) and Discharge Planning Initiation (days before discharge to start planning).
3

Configure program phase durations

On the Phases tab, set the expected duration (days) for each program phase (phases 1–4).
4

Configure compliance thresholds

On the Compliance tab, set license expiry warning lead time, minimum attendance percentage, curfew grace period, outcome follow-up intervals, and audit response time targets by severity.
5

Configure integrations

On the Integrations tab, toggle connections to the Finance & Revenue (FA) and Human Resources (HR) modules.
6

Configure wizards

On the Wizards tab, adjust wizard behavior settings.
7

Save changes

Click Save at the bottom of the form. A success toast confirms the settings were persisted; an error toast is shown if the update fails.

​
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/RHSettingsPage.tsx
  • src/cores/rh/components/RHSettingsForm.tsx
  • src/cores/rh/hooks/useRHModuleSettings.ts