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

# Recovery Housing Compliance

> Monitor recovery housing compliance status, requirements, checklists, and audit activities from a central dashboard.

The Compliance dashboard is the central landing page for recovery housing compliance monitoring, accessible at `/rh/compliance`.

## Overview

The Compliance page displays a two-widget summary grid (Compliance Status and Compliance Deadlines) and three quick-navigation cards linking to Requirements, Checklists, and Audits sub-sections. An **Add Requirement** button opens an inline dialog for creating a new compliance requirement without leaving the dashboard.

## Who it's for

This route is protected by `RH_PERMISSIONS.DASHBOARD_VIEW` (`rh.dashboard.view`) via the outer `RHViewGuard`. There is no additional per-route permission gate on `/rh/compliance` itself.

## Before you start

* Your account must hold the `rh.dashboard.view` permission.
* An organization context must be active (the widgets query by `organization_id`).

## Steps

<Steps>
  <Step title="Open the Compliance dashboard">
    Navigate to **Recovery Housing → Compliance** or go directly to `/rh/compliance`. The page loads a two-column widget grid showing compliance status and upcoming deadlines.
  </Step>

  <Step title="Review status widgets">
    The **Compliance Status** widget summarizes current pass/fail/pending states. The **Compliance Deadlines** widget shows upcoming due dates for active requirements.
  </Step>

  <Step title="Navigate to a sub-section">
    Click one of the three quick-navigation cards — **Requirements**, **Checklists**, or **Audits** — to drill into that area.
  </Step>

  <Step title="Add a requirement inline">
    Click **Add Requirement** (top-right) to open the `ComplianceRequirementDialog` inline. Complete the dialog fields and save to create a new requirement without leaving the dashboard.
  </Step>
</Steps>

## Key concepts

| Term                 | Code identifier               | Meaning                                                   |
| -------------------- | ----------------------------- | --------------------------------------------------------- |
| Compliance Status    | `ComplianceStatusWidget`      | Aggregate pass/fail summary for active requirements       |
| Compliance Deadlines | `ComplianceDeadlinesWidget`   | Upcoming due dates across active requirements             |
| Requirements         | `/rh/compliance/requirements` | Individual compliance requirements managed in the RH core |
| Checklists           | `/rh/compliance/checklists`   | Actionable checklist records tied to requirements         |
| Audits               | `/rh/audits`                  | Scheduled audit activities linked to compliance tracking  |

## 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/ComplianceDashboardPage.tsx
  * src/cores/rh/components/dashboard/ComplianceStatusWidget.tsx
  * src/cores/rh/components/dashboard/ComplianceDeadlinesWidget.tsx
  * src/cores/rh/components/forms/ComplianceRequirementDialog.tsx
</Accordion>