ADR 0017 — Integration adapters behind a uniform port with sandbox fixtures

Status: Accepted · Date: 2026-07-23

Decision

integration-service exposes one adapter port per capability (PatientDirectory, ScheduleSync, ChartWriteBack, DocumentPush, CodeCatalog, InsuranceEstimate, EmailDelivery, SMSDelivery, SignatureProvider). Adapters: abeldent (interface + mapping + contract tests against recorded sandbox fixtures — real endpoints blocked on vendor agreement, documented in docs/integrations/abeldent.md), smtp, twilio-shaped sms (config-driven, no invented vendor routes), builtin-signature. Credentials resolve from OpenBao at call time; webhooks verify HMAC signatures + replay windows; all sync work is idempotent (sync_items unique keys), retried with backoff, and dead-lettered with reconciliation reports.