Skip to main content
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)

​
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.