Encore OS — Documentation

Status: ✅ Complete
Spec: specs/pm/specs/PM-39-waitlist-management-priority-scoring.md
Last Updated: 2026-04-06

Purpose

Document cross-module contracts for waitlist entry, priority scoring, outreach, and promotion when provider capacity becomes available. PM-39 consumes upstream intake/scheduling events and coordinates with PM-38, PM-10, CE-28/29, and analytics (PM-41).

Inbound

Source	Mechanism	Payload (target)
PM-38	Event `no_suitable_provider` (or equivalent)	`organization_id`, `patient_id`, `screening_id`, `program_type`, scoring inputs
PM-10	Availability change (event or scheduled read)	Triggers re-match for ranked waitlist rows
PM-02	Insurance data	Expiry date for priority factor (read-only from PM perspective)

Outbound

Consumer	Mechanism	Notes
PM-38	Create appointment when slot matches	After successful re-match; remove or transition waitlist row
CE / notifications	SMS templates	TCPA consent; minimum necessary PHI
PM-41	Metrics / funnel stage	Waitlist counts, conversion, dwell time

Tenant isolation

All reads and writes scoped by organization_id; RLS on pm_waitlist_entries and pm_waitlist_outreach_log. Edge functions use org verification helpers per platform patterns.

CROSS_CORE_INTEGRATIONS.md (CE-28, CE-29 rows)
EVENT_CONTRACTS.md — register finalized event names when PM-38 contract is locked

Start Here

Module Engineering Snapshots

Canonical AI Governance

Architecture

Integrations

Development

Decision Guides

Database

Module Reference

Testing

Migration

Operations

Governance & Security

Platform Internals

Waitlist Management — Integration

Purpose

Inbound

Outbound

Tenant isolation

​Purpose

​Inbound

​Outbound

​Tenant isolation

​Related

Purpose

Inbound

Outbound

Tenant isolation

Related