Skip to main content
Purpose: Configuration and administration guide for CL-27 Program Scheduling Templates.

Overview

This guide covers administrative tasks for program scheduling: template configuration, permission assignment, schedule definition schema, and billing code mapping.

Configuration

Program Type Minimums

Schedule Definition Schema

The schedule_definition JSONB column stores the weekly template:
  • day_of_week: 0 = Sunday, 1 = Monday, … 6 = Saturday
  • service_type: group | individual | peer_support
  • exceptions: Dates to skip during session generation

Permissions

Assign these permissions via the Admin → Permissions page:

CL-14 Integration

Group session auto-creation inserts into cl_group_sessions with custom_fields.program_schedule_id linking back to the template. Generated sessions appear in the Group Sessions list.

Troubleshooting

Sessions Not Generated

  • Verify the schedule has blocks with service_type: "group"
  • Check that the target dates are not listed in exceptions
  • Ensure the user has cl.program_schedules.edit permission

Compliance Shows Incorrect Data

  • Attendance summaries are computed from cl_program_attendance_summaries
  • Verify the enrollment period dates match the reporting period

  • User Guide: docs/cl/cl-27-program-scheduling-templates-user-guide.md
  • Specification: specs/cl/specs/CL-27-behavioral-health-program-scheduling-templates.md
  • Integration: docs/architecture/integrations/CL-27-behavioral-health-program-scheduling-templates-INTEGRATION.md

Last Updated: 2026-02-25