Skip to main content

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.

The Event Details page displays the full record for one significant event and allows staff to open or update an associated investigation and add or edit corrective actions. Route: /rh/significant-events/:id

​
Overview

The page loads a significant event by id from rh_significant_events, joined with the event type, the linked episode (including resident profile and residence), and the associated investigation and its corrective actions. Three data-loading states are handled separately — event, investigation, and corrective actions — and error states for any of the three are displayed as a destructive alert. The page renders four primary sections:
  1. Event header — event type name (or date fallback), formatted event date, severity badge, status badge.
  2. Event Details card — episode number, residence name, and the user who reported the event.
  3. Description card — the event_details free-text field.
  4. Event Summary card — the event_summary field (shown only if present).
  5. Investigation card — current investigation status with findings text. Staff can start or edit an investigation via the InvestigationDialog.
  6. Corrective Actions card — list of actions linked to the investigation. The Add Action button is disabled until an investigation exists. Actions are opened for editing via InvestigationActionDialog.
Status workflow buttons in the Actions card allow progressing a finding through open → in_progress → resolved → closed.

​
Who it’s for

Requires the rh.dashboard.view permission (applied to all RH routes via RHViewGuard). No additional inner permission gate exists on this detail route. Creating new significant events requires rh.significant-events.create (enforced on the /rh/significant-events/new route).

​
Before you start

  • Locate the event from the Significant Events list at /rh/significant-events.
  • To start or edit an investigation, the event record must already exist. Investigation and corrective action entries are created from within this page.

​
Steps

1

Open the event record

From Recovery Housing → Significant Events, click a row to navigate to /rh/significant-events/<id>.
2

Review event details

Read the Event Details card (episode, residence, reporter) and the Description card. If an Event Summary is present, it appears below the description.
3

Start or update the investigation

Click Start Investigation (or Edit Investigation if one already exists) to open the investigation dialog. Fill in or update the findings and save.
4

Add corrective actions

Once an investigation exists, click Add Action in the Corrective Actions card. Enter the action description and target completion date.
5

Progress corrective action status

Click an existing corrective action row to open the action dialog and update its status. Use the workflow buttons (Mark In Progress, Mark Resolved, Close Finding) to advance the status.

​
Key concepts

  • Significant event — an incident or occurrence recorded against a resident episode that may require investigation and corrective follow-up.
  • Investigation — a structured record of findings linked to a significant event; one investigation per event.
  • Corrective action — a time-bound task linked to an investigation, tracked from open through in_progress, resolved, to closed.
  • Severity — displayed as a badge; values are stored in rh_significant_events.severity.
  • Event type — a lookup value from rh_significant_event_types that categorizes the nature of the event.

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.
  • src/routes/rh.tsx
  • src/cores/rh/pages/SignificantEventDetailPage.tsx
  • src/cores/rh/hooks/useSignificantEventDetail.ts
  • src/cores/rh/hooks/useInvestigation.ts
  • src/cores/rh/hooks/useInvestigationActions.ts