Provider Directory Service — Epics
Service: provider-directory-service Epic prefix: PROVDIR-EPIC Last updated: 2026-04-17
Epics
PROVDIR-EPIC-01 — Practitioner profile lifecycle
| Field | Value |
|---|---|
| Issue type | Epic |
| Summary | Practitioner CRUD with multi-script names and national IDs |
| Status | To Do |
| Priority | Must |
| Labels | service:provider-directory-service, domain:provider, slice:S0 |
| Components | practitioner |
| Fix version | M0 |
| FR references | FR-PROVDIR-001..005 |
| Legacy FR refs | FR-PROV-001, FR-PROV-006, FR-PROV-007, FR-PROV-008 |
| Dependencies | IDENT-EPIC-01, TENANT-EPIC-01, FAC-EPIC-01 |
| Rollup status | Not started |
Business outcome: Every clinical action can be attributed to a registered practitioner with a validated professional identity.
Description: Create/read/update/deactivate Practitioner with multi-script names (ps, fa-AF, ar, en), national identifiers (AFG medical council, UAE DHA/DoH), specialties, telecoms. Suspension and reinstatement flows. FHIR Practitioner projection.
Stories: PROVDIR-US-001, PROVDIR-US-002, PROVDIR-US-003, PROVDIR-US-004
PROVDIR-EPIC-02 — Credential lifecycle & privilege gating
| Field | Value |
|---|---|
| Issue type | Epic |
| Summary | License & credential lifecycle with automatic privilege gating |
| Status | To Do |
| Priority | Must |
| Labels | service:provider-directory-service, domain:provider, slice:S1, safety |
| Components | credential, role |
| Fix version | M1 |
| FR references | FR-PROVDIR-006..010 |
| Legacy FR refs | FR-PROV-003, BR-PROV-001 |
| Dependencies | PROVDIR-EPIC-01 |
| Rollup status | Not started |
Business outcome: Guarantees no expired-license clinician holds ordering or prescribing privileges.
Description: Credential aggregate (license / certification / degree) with issuing authority, expiry, status. Nightly scanner emits 60/30/7-day expiring and D-day expired events. Automatic role demotion when required credential revoked or expired.
Stories: PROVDIR-US-005, PROVDIR-US-006, PROVDIR-US-007, PROVDIR-US-008
PROVDIR-EPIC-03 — Roles, privileges, and scope
| Field | Value |
|---|---|
| Issue type | Epic |
| Summary | Scoped role assignment and fine-grained privilege check endpoint |
| Status | To Do |
| Priority | Must |
| Labels | service:provider-directory-service, domain:provider, slice:S1 |
| Components | role, privilege |
| Fix version | M1 |
| FR references | FR-PROVDIR-011..013 |
| Legacy FR refs | FR-PROV-002, FR-PROV-010 |
| Dependencies | PROVDIR-EPIC-01, FAC-EPIC-05 |
| Rollup status | Not started |
Business outcome: Orders, prescriptions, lab, radiology can check privileges in real time.
Description: PractitionerRole scoped to HierarchyNode / HealthcareService. Internal privilege check endpoint p99 ≤ 30ms. Privilege source tracked (role vs credential).
Stories: PROVDIR-US-009, PROVDIR-US-010, PROVDIR-US-011
PROVDIR-EPIC-04 — Multi-script search & directory UX
| Field | Value |
|---|---|
| Issue type | Epic |
| Summary | Fuzzy cross-script search for providers |
| Status | To Do |
| Priority | Must |
| Labels | service:provider-directory-service, domain:search, slice:S0 |
| Components | search |
| Fix version | M0 |
| FR references | FR-PROVDIR-014 |
| Legacy FR refs | FR-PROV-004, FR-PROV-007, NFR-PROV-001 |
| Dependencies | PROVDIR-EPIC-01 |
| Rollup status | Not started |
Business outcome: Schedulers and clinicians find the right provider quickly across scripts.
Description: OpenSearch index with ICU transliteration; n-gram analyser; cross-script matching.
Stories: PROVDIR-US-012, PROVDIR-US-013
PROVDIR-EPIC-05 — Service endpoint registry & health
| Field | Value |
|---|---|
| Issue type | Epic |
| Summary | Endpoint catalog with periodic health probes |
| Status | To Do |
| Priority | Should |
| Labels | service:provider-directory-service, domain:interop, slice:S1 |
| Components | endpoint |
| Fix version | M1 |
| FR references | FR-PROVDIR-015..017 |
| Legacy FR refs | FR-PROV-005, FR-PROV-009 |
| Dependencies | INTEROP-EPIC-01 |
| Rollup status | Not started |
Business outcome: Partner systems can discover and monitor interop endpoints.
Description: Endpoint CRUD with auth method, periodic healthcheck, health state events.
Stories: PROVDIR-US-014, PROVDIR-US-015
PROVDIR-EPIC-06 — FHIR & HMIS interop
| Field | Value |
|---|---|
| Issue type | Epic |
| Summary | FHIR Practitioner/Role/HealthcareService/Endpoint projection |
| Status | To Do |
| Priority | Must |
| Labels | service:provider-directory-service, domain:interop, slice:S2 |
| Fix version | M2 |
| FR references | FR-PROVDIR-018 |
| Legacy FR refs | SPEC §6 |
| Dependencies | PROVDIR-EPIC-01..03, INTEROP-EPIC-01 |
| Rollup status | Not started |
Description: Full FHIR R4 CRUD with search parameters; HL7 v2 PV1/ORC alignment.
Stories: PROVDIR-US-016, PROVDIR-US-017
PROVDIR-EPIC-07 — Reliability & quality controls
| Field | Value |
|---|---|
| Issue type | Epic |
| Summary | SLIs/SLOs, coverage, chaos drills |
| Status | To Do |
| Priority | Must |
| Labels | service:provider-directory-service, domain:ops |
| Fix version | M1 |
| FR references | NFR-PROVDIR-001..004 |
| Legacy FR refs | NFR-PROV-001..004 |
| Rollup status | Not started |
Description: Dashboards, alerts, chaos drills, coverage gate.
Stories: PROVDIR-US-018, PROVDIR-US-019