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

# Waitlist Management — Integration

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

**Status:** ✅ Complete\
**Spec:** [specs/pm/specs/PM-39-waitlist-management-priority-scoring.md](../../../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.

## Related

* [CROSS\_CORE\_INTEGRATIONS.md](./CROSS_CORE_INTEGRATIONS.md) (CE-28, CE-29 rows)
* [EVENT\_CONTRACTS.md](./EVENT_CONTRACTS.md) — register finalized event names when PM-38 contract is locked