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 Report Significant Event screen is at /rh/significant-events/new and renders the SignificantEventReportingWizardPage component. It hosts a 3-step guided wizard (SignificantEventReportingWizard) that collects event classification, people and narrative, and review data before submitting a new record to rh_significant_events.

​
Overview

The page accepts an optional episodeId query parameter (?episodeId=<uuid>) and passes it to the wizard. The wizard uses WizardShell with a timeline layout and three steps:
  1. Event Classification — requires event_type_id, severity, and occurred_at (date/time).
  2. People & Narrative — requires narrative (event summary) and immediate_actions_taken.
  3. Review & Submit — displays collected data for review before final submission.
On submit, useSignificantEventMutation.createEvent writes to rh_significant_events with status: "submitted". On success, the browser navigates to /rh/significant-events/:eventId. On exit, the browser navigates to /rh/significant-events.

​
Who it’s for

This route requires RH_PERMISSIONS.SIGNIFICANT_EVENTS_CREATE (rh.significant-events.create) enforced by a RequirePermission wrapper. The outer RHViewGuard also requires RH_PERMISSIONS.DASHBOARD_VIEW (rh.dashboard.view).

​
Before you start

  • Hold both rh.dashboard.view and rh.significant-events.create permissions.
  • Have the episodeId of the affected resident episode available. The wizard blocks submission without it.

​
Steps

1

Start the wizard

Navigate to /rh/significant-events/new (optionally with ?episodeId=<uuid>). The wizard opens on Step 1: Event Classification.
2

Step 1 — Event Classification

Select the event type (event_type_id), severity, and the date and time the event occurred (occurred_at). Optionally enter a location. All three required fields must be populated to advance.
3

Step 2 — People and Narrative

Enter the narrative description of the event and the immediate actions taken. Both fields are required. Optionally enter witness names and the name of the person who reported the event.
4

Step 3 — Review and Submit

Review all collected data. Click “Submit event” to write the record. On success, the browser navigates to the new event detail page.
5

Exit the wizard (optional)

Click the Exit control at any step to discard changes and return to /rh/significant-events.

​
Key concepts

TermMeaning
event_type_idForeign key to the significant event type lookup (SME: confirm available types).
severitySeverity classification of the event (SME: confirm allowed values and definitions).
occurred_atDate and time the event occurred, stored as event_date.
narrativeFree-text summary of what occurred, stored as event_summary.
immediate_actions_takenFree-text description of actions taken immediately after the event.
witness_infoJSON object storing witness names if provided.
involved_partiesJSON object storing the name of the reporting person if provided.

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/SignificantEventReportingWizardPage.tsx
  • src/cores/rh/components/wizards/significant-event-reporting/SignificantEventReportingWizard.tsx