Skip to main content
The /rh/med-audits route renders MedStorageAuditsPage, which lists medication storage audit records from rh_med_storage_audits and provides a dialog to create new audits.

​
Overview

The route /rh/med-audits is wrapped by the outer RHViewGuard, which requires rh.dashboard.view. The page renders a search input and a compliance-status filter (All Statuses, Compliant, Non-Compliant, Corrective Action Needed). Audit records are loaded by MedStorageAuditsTable (which consumes useMedStorageAudits) and sorted by audit date descending. Clicking New Audit opens MedStorageAuditDialog for inline creation. Clicking an audit row navigates to /rh/med-audits/:id for the detail view.

​
Who it’s for

Outer guard: RH_PERMISSIONS.DASHBOARD_VIEW (rh.dashboard.view), applied by RHViewGuard. RH_PERMISSIONS.MED_AUDITS_CREATE (rh.med-audits.create) exists in the permissions constants but is not applied as a gate on the New Audit button in the current component.

​
Before you start

  • Hold rh.dashboard.view to access the page.

​
Steps

1

Open Med Audits

Navigate to /rh/med-audits. The page loads all medication storage audit records for your organization, sorted by audit date descending.
2

Filter by compliance status

Use the Compliance Status dropdown to show only Compliant, Non-Compliant, or Corrective Action Needed records.
3

Open an audit record

Click any row in the audit table to open the detail view at /rh/med-audits/:id.
4

Create a new audit

Click New Audit to open the creation dialog. Complete the form and submit to add a new audit record.

​
Key concepts

​
Viewing a med audit

The /rh/med-audits/:id route renders MedStorageAuditDetailPage, which loads a single medication storage audit record from rh_med_storage_audits via useMedStorageAuditDetail. The route is wrapped by the outer RHViewGuard (rh.dashboard.view). The page extracts the :id URL parameter and passes it to useMedStorageAuditDetail, which queries rh_med_storage_audits joined to rh_residences. The page displays two cards side-by-side: Audit Information (residence name, audit date, auditor, follow-up required, follow-up date) and Compliance Status (current status badge with icon). If findings text is present, a Findings card is shown. If corrective actions exist, an additional Corrective Actions Required card renders each action as a bulleted list. A Back to Medication Audits button navigates to /rh/med-audits. No additional per-record permission check is present in the component. Navigate from /rh/med-audits by clicking an audit row, or use a direct URL with a known audit ID.
1

Open an audit record

Navigate to /rh/med-audits and click an audit row, or go directly to /rh/med-audits/:id with a known ID. The page loads the audit record.
2

Review audit information

The Audit Information card shows the residence, audit date, auditor, and follow-up requirements.
3

Review compliance status

The Compliance Status card displays the current status badge: Compliant, Non-Compliant, or Corrective Action Needed.
4

Review findings and corrective actions

If findings text is recorded, it appears in the Findings card. If corrective actions are required, each action is listed in the Corrective Actions Required card with a warning border.
5

Return to the audit list

Click Back to Medication Audits to return to /rh/med-audits.

​
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/MedStorageAuditsPage.tsx
  • src/cores/rh/pages/MedStorageAuditDetailPage.tsx
  • src/cores/rh/hooks/useMedStorageAudits.ts
  • src/cores/rh/hooks/useMedStorageAuditDetail.ts