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.

Feature ID: CL-14
Status: 📝 Planned
Spec Reference: CL-14-group-therapy-documentation.md
Last Updated: 2026-02-21

​
Overview

CL-14 defines group therapy session creation, attendance tracking, and individual member documentation (individual response, goal progress). It depends on CL-01 (patient chart), CL-03 (treatment goals), CL-11 (42 CFR Part 2 consent for SUD groups), PM-04 (group session scheduling), and PM-07 (group billing / HQ modifier at charge capture). Integration with PM-04 and PM-07 is documented in CL-PM-GROUP-SESSIONS. Part 2 consent integration is documented in CL-11-consent-management-42cfr-part2-INTEGRATION.md.

​
Integration Points (from Spec)

DependencyPatternPurpose
CL-01 (Patient Chart)InternalGroup attendance surfaced on patient chart
CL-03 (Treatment Planning)InternalGoal progress from group participation
CL-11 (Part 2 Consent)Platform / APISUD groups: verify consent before displaying/documenting SUD content; cl_check_sud_consent(chart_id, 'group_attendance', auth.uid()) (3-argument SECURITY DEFINER)
PM-04 (Group Scheduling)Platform LayerGroup session scheduling; cl_group_sessions.schedule_id links to PM-04 via Platform Integration Layer. See CL-PM-GROUP-SESSIONS.
PM-07 (Billing)Event / Datacl_group_session_documented event published on session completion; HQ modifier calculated at charge capture from participant count; no billing columns in CL-14 (see spec Errata E-1).

​
API / Data Contracts

  • CL-11 consent check: Before displaying SUD group lists/details or opening individual documentation, call backend helper (e.g. SECURITY DEFINER cl_check_sud_consent(chart_id, auth.uid())) to verify active Part 2 consent or exception. Failure: hide/omit SUD groups or surface “consent required” / block save per CL-11 contract.
  • PM-04 / schedule_id: Read-only reference from cl_group_sessions.schedule_id to PM-04 group schedule via Platform Integration Layer; no direct FK. See CL-PM-GROUP-SESSIONS for ownership and field mapping.

​
Event Contracts

  • Event: cl_group_session_documented — published by CL-14 when session status transitions to completed. Consumed by PM-07 for charge capture with HQ modifier. Payload defined in CL-PM-GROUP-SESSIONS. Registered in src/platform/events/types.ts and seeded in fw_workflow_events.

​
Security and RLS

  • All CL-14 tables use organization_id; RLS via SECURITY DEFINER helpers; UPDATE policies include WITH CHECK (§5.2.4). PHI columns (individual_response, goal_progress_notes) restricted by org and role; SUD groups enforce Part 2 consent via application layer and CL-11.