The Outcomes dashboard lives atDocumentation 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/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 tocurrentOrganization.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
RequiresRH_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 therh.dashboard.view permission. Outcome assessment records must exist for summary cards to show non-zero values.
Steps
Review summary cards
Read the four summary cards for assessment counts, alumni activity, and reports due.
Review charts
Scroll to the chart section to view Sobriety Trend, Outcome Success, and Alumni Engagement charts.
Start a new assessment
Click “New Assessment” in the header to navigate to
/rh/outcomes/assessments/new.Key concepts
Error state
Error state
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.Loading state
Loading state
While data is loading, summary card values are replaced with
Skeleton placeholders. Charts receive an isLoading prop to render their own loading states.Related
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.
Documentation sources
Documentation sources
- src/routes/rh.tsx
- src/cores/rh/pages/OutcomesDashboardPage.tsx
- src/cores/rh/hooks/useOutcomeSummary.ts