Provider Directory Service — Sync Contract
Status: populated Owner: TBD Last updated: 2026-04-17 Companion: 16 Offline & Sync
1. Offline posture
Provider directory is reference data for clinical workflows. Edge (field clinic) nodes need read access to the providers who work at that site, but must not author new practitioners or credentials offline.
2. Per-aggregate policy
| Aggregate | Policy | Rationale |
|---|---|---|
| Practitioner | server_authoritative | Identity-adjacent; creation requires admin |
| Credential | server_authoritative | Legal / regulatory record |
| PractitionerRole | server_authoritative | Authorisation-affecting |
| HealthcareService | server_authoritative | |
| ServiceEndpoint | server_authoritative | Network configuration |
3. Edge replication
Edge nodes pull a read-only projection filtered by facility node subtree:
- practitioners with active role at
node ∈ edge_subtree - credentials summary (expiry date, status)
- healthcare services for that node
Refresh via /internal/edge/snapshot?nodeId= + subscription to provider_directory.* events.
4. Conflict rules
N/A — server-authoritative. Edge write attempts returned 409 EDGE_READ_ONLY.
5. Cache staleness window
24h TTL for edge cache; after that, UI shows stale banner and re-fetches when reconnecting.