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 Outcomes dashboard lives at /rh/outcomes and provides a summary view of outcome assessments, alumni activity, and scheduled reports for the current organization.

Overview

The dashboard fetches data from three hooks scoped to currentOrganization.id: useOutcomeSummary (reads rh_outcome_assessments), useAlumniSummary, and useReportsDue. Four summary cards display: Total Assessments with completion rate, Pending Assessments with missed count, Active Alumni with total engagements, and Reports Due. Below the cards are two rows of charts: Sobriety Trend, Outcome Success, and Alumni Engagement. A Quick Actions panel provides links to Assessments, Indicators, Alumni Directory, and Report Hub. Two action buttons in the header navigate to New Assessment (/rh/outcomes/assessments/new) and Create Report (/rh/reports/new). If any data hook returns an error, a destructive alert is displayed using sanitizeErrorMessage.

Who it’s for

Requires RH_PERMISSIONS.DASHBOARD_VIEW (rh.dashboard.view) via the parent RHViewGuard. No finer-grained permission gate is visible on this route in rh.tsx.

Before you start

Hold the rh.dashboard.view permission. Outcome assessment records must exist for summary cards to show non-zero values.

Steps

1

Navigate to Outcomes dashboard

Go to /rh/outcomes.
2

Review summary cards

Read the four summary cards for assessment counts, alumni activity, and reports due.
3

Review charts

Scroll to the chart section to view Sobriety Trend, Outcome Success, and Alumni Engagement charts.
4

Start a new assessment

Click “New Assessment” in the header to navigate to /rh/outcomes/assessments/new.
5

Create a report

Click “Create Report” in the header to navigate to /rh/reports/new.

Key concepts

If any of the three data hooks (useOutcomeSummary, useAlumniSummary, useReportsDue) returns an error, the entire page is replaced with a destructive alert titled “Error loading outcomes data”. The error message is sanitized via sanitizeErrorMessage before display.
While data is loading, summary card values are replaced with Skeleton placeholders. Charts receive an isLoading prop to render their own loading states.

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/OutcomesDashboardPage.tsx
  • src/cores/rh/hooks/useOutcomeSummary.ts