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.

Spec: CL-34-drug-testing-uds-workflow
Status: ✅ Complete
Last Updated: 2026-03-03

Overview

CL-34 (UDS Workflow) integrates with CL-09 (lab orders/results), CL-21 (OTP/MOUD), CL-04 (progress notes), CL-11 (Part 2 consent), CL-33 (court compliance), and PM-07 (billing). This document records integration contracts and platform layer usage.

Integration Points (from Spec)

DependencyIntegration TypePurpose
CL-09Data / pipelineUDS order extends or references lab order concept; result ingestion may use same lab result pipeline with UDS-specific mapping
CL-21 (OTP)Events / PlatformOverdue UDS escalation; publish overdue alerts via PF-10; align cl_moud_monitoring_events.due_by with UDS due dates; Phase 3: OTP 8/year reporting
CL-04DataCounseling note may be progress note linked to UDS interpretation
CL-11RLS / consentPart 2 consent gates display of UDS results
CL-33Events / dataCourt-reportable results create or link to court compliance event
PM-07API / dataBilling codes and encounter linkage for UDS charges
PF-01, PF-02, PF-30PlatformOrganizations, RBAC, permissions

Event Contracts (Planned)

To be added when events are defined (e.g. UDS result received, court-reportable result flagged, MOUD unexpected negative alert).

API Contracts (Planned)

To be added for PM-07 charge/encounter linkage and any CL-21/CL-33 APIs consumed.

Platform Integration Layer

  • PF-10 (Notifications): Overdue UDS alerts per CL-21 FR-4.
  • PF-30 (Permissions): Permission keys for UDS orders/results (e.g. cl.uds_orders.create, cl.uds_results.view).
  • @/platform/scheduling: Encounter context for encounter_id on orders and billing.
  • @/platform/types: Shared encounter/billing types as applicable.

Cross-Core Matrix

FromToContract / Mechanism
CL-34PM-07Encounter-linked UDS charges (CPT/G-codes); document in API_CONTRACTS when implemented
CL-34CL-21Overdue UDS events; MOUD unexpected negative alerts
CL-34CL-33Court-reportable result → court compliance event
Update CROSS_CORE_INTEGRATIONS.md when CL-34 implementation adds concrete events/APIs.

References