The Finding Details page displays the full record for one audit finding — including category, severity, corrective action plan, deadline tracking, and parent audit information — and provides inline status workflow buttons. Route: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.
/rh/audits/:auditId/findings/:id
Overview
The page loads a finding byid from rh_audit_findings, joined with the parent rh_audit_schedules record (which itself includes the associated residence). Two params are used: auditId (for the back-navigation link) and id (for the finding query).
The page renders the following sections:
| Section | Content |
|---|---|
| Header | Finding category breadcrumb label, severity badge, status badge, Edit button |
| Finding Details card | Category, severity, status, regulatory reference (if present) |
| Parent Audit card | Audit name, type, date, residence (or “Organization-wide”) |
| Full Description card | finding_description free text |
| Corrective Action Plan card | corrective_action_plan text (shown only if present) |
| Deadline Tracking card | Corrective action deadline date and days remaining/overdue indicator (shown only if present) |
| Actions card | Status workflow buttons (context-sensitive: Mark In Progress, Mark Resolved, Close Finding) |
AuditFindingDialog for inline editing. Status transitions are persisted via useAuditFindingMutation.
Who it’s for
Requires therh.dashboard.view permission (applied to all RH routes via RHViewGuard). No additional inner permission gate exists on this route.
Before you start
- Navigate here from the parent audit detail page (
/rh/audits/:auditId) by clicking a finding row. - To progress the finding status, the previous status step must be current (e.g., finding must be
opento mark in-progress).
Steps
Open the finding
From Recovery Housing → Audits, open a parent audit schedule, then click a finding to navigate to
/rh/audits/<auditId>/findings/<id>.Review finding details
Read the Finding Details card for category, severity, current status, and any regulatory reference. Check the Parent Audit card to confirm the audit context and residence scope.
Review the full description and corrective action plan
Scroll to Full Description and, if present, Corrective Action Plan to understand what was identified and what remediation is planned.
Check the deadline
If a corrective action deadline is set, the Deadline Tracking card shows the date and a color-coded days-remaining indicator.
Progress the finding status
Use the workflow buttons in the Actions card: Mark In Progress (from
open), Mark Resolved (from in_progress), or Close Finding (from resolved). A success toast confirms the update.Key concepts
- Audit finding — a discrete observation or deficiency identified during an audit, recorded in
rh_audit_findings. - Finding category — a label classifying the area of the finding (e.g., documentation, safety). Stored as
finding_category. - Corrective action plan — a free-text field describing the planned remediation steps.
- Corrective action deadline — the date by which corrective action must be completed; overdue status is surfaced visually.
- Regulatory reference — an optional free-text field linking the finding to an external standard or citation.
Related
Recovery Housing
Governance & parity
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.
Documentation sources
Documentation sources
- src/routes/rh.tsx
- src/cores/rh/pages/AuditFindingDetailPage.tsx
- src/cores/rh/hooks/useAuditFindingDetail.ts
- src/cores/rh/hooks/useAuditFindingMutation.ts