The Group Outcomes screen (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.
/cl/group-sessions/outcomes) displays aggregated metrics for group therapy sessions including completion rates, attendance rates, and a breakdown by group type.
Overview
The page renders viaGroupOutcomeDashboard (re-exported by GroupOutcomeDashboardPage.tsx) using the useGroupOutcomeMetrics hook. The hook queries cl_group_sessions and cl_group_attendance for the current organization, with optional date range filters. Four summary stat cards display: Total Sessions, Completion Rate (%), Attendance Rate (%), and Average Participants. When a By Group Type breakdown is available, a table lists each group_type with session count, completed sessions, total attendance records, present count, and calculated rate. Date range inputs (From / To) are rendered above the stat cards; changing either value re-runs the query with updated filters.
Who it’s for
Requires permissioncl.group_sessions.view.
Before you start
- You must hold
cl.group_sessions.view. - An organization must be selected;
useGroupOutcomeMetricsreturns empty metrics withoutorganization_id.
Steps
Open Group Outcomes
Navigate to
/cl/group-sessions/outcomes. All-time metrics for the organization load immediately.Apply a date range filter
Enter a From date, a To date, or both using the date inputs above the stat cards. The hook re-fetches automatically when either value changes.
Read the summary stat cards
The four cards show: Total Sessions (count from
cl_group_sessions), Completion Rate (completed sessions / total × 100), Attendance Rate (present-equivalent records / total attendance records × 100), and Avg Participants (total attendance records / total sessions, rounded).Key concepts
Present-equivalent attendance
Present-equivalent attendance
The hook counts
attendance_status values of present, late, and early_departure as present when computing attendance rate and the group-type present count.Empty / zero state
Empty / zero state
When no sessions exist for the selected date range, the hook returns zero values for all metrics and an empty
byGroupType object. The stat cards render 0 and 0%; the By Group Type table is hidden.Error state
Error state
On query failure, a sanitized error message is displayed with an AlertCircle icon and a Retry link (page reload).
Loading state
Loading state
Four skeleton cards replace the stat cards while the query is in flight.
Related
Clinical
Overview of the Clinical core.
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/cl.tsx
- src/cores/cl/pages/GroupOutcomeDashboardPage.tsx
- src/cores/cl/components/group-therapy/GroupOutcomeDashboard.tsx
- src/cores/cl/hooks/useGroupOutcomeMetrics.ts