Immunizations Service — Epics
Service: immunizations-service Epic prefix: IMMUN-EPIC Last updated: 2026-04-18
Epics
IMMUN-EPIC-01 — Immunization recording and history
| Field | Value |
|---|---|
| Issue type | Epic |
| Summary | Deliver immunization recording, refusal, historical import, and correction |
| Status | In Progress |
| Priority | Must |
| Labels | service:immunizations, domain:clinical, slice:S0 |
| Components | immunization-records |
| Fix version | M0 |
| FR references | FR-IMMUN-001, FR-IMMUN-002, FR-IMMUN-013 |
| Legacy FR refs | FR-IMM-001, FR-IMM-002, FR-IMM-013 (CLIN-IMM v1.0) |
| Dependencies | REG-EPIC-01 (patient identity) |
| Rollup status | Partial |
Business outcome: Vaccination staff can record administered doses, refusals, and historical records with contraindication checking; a complete immunization history is available for each patient.
Description: Core dose recording (completed, not-done, entered-in-error) with CVX vaccine codes. Refusal capture with coded reason. Historical import from paper records or external EMR. Contraindication check on every administration attempt. Optimistic locking on amendments. Outbox events emitted for all state changes.
Stories: IMMUN-US-001, IMMUN-US-002
IMMUN-EPIC-02 — Forecast, defaulter tracking, and EPI schedule
| Field | Value |
|---|---|
| Issue type | Epic |
| Summary | Deliver EPI schedule-driven forecasting and defaulter identification |
| Status | In Progress |
| Priority | Must |
| Labels | service:immunizations, domain:clinical, slice:S0 |
| Components | forecast, defaulters |
| Fix version | M0 |
| FR references | FR-IMMUN-003, FR-IMMUN-010 |
| Legacy FR refs | FR-IMM-003, FR-IMM-010 (CLIN-IMM v1.0) |
| Dependencies | IMMUN-EPIC-01 |
| Rollup status | Partial |
Business outcome: Clinicians and vaccination officers have accurate next-due dates for every patient, and defaulters are automatically identified for outreach.
Description:
Deterministic forecast engine consumes Afghanistan EPI schedule. Forecast refreshed on every record create/correct. forecastStatus per antigen: due, overdue, immune, contraindicated, complete, not-yet-due. Defaulter list queryable by facility and antigen. IMMUNIZATIONS.forecast.updated event emitted.
Stories: IMMUN-US-003
IMMUN-EPIC-03 — National registry integration and export
| Field | Value |
|---|---|
| Issue type | Epic |
| Summary | Deliver bidirectional national registry sync and FHIR export |
| Status | To Do |
| Priority | Should |
| Labels | service:immunizations, domain:clinical, slice:S2 |
| Components | registry-sync, FHIR |
| Fix version | M2 |
| FR references | FR-IMMUN-004, FR-IMMUN-005, FR-IMMUN-011, FR-IMMUN-012 |
| Legacy FR refs | FR-IMM-004, FR-IMM-005, FR-IMM-011, FR-IMM-012 |
| Dependencies | IMMUN-EPIC-01, INTEROP-EPIC-01 |
| Rollup status | Not started |
Business outcome: Afghanistan national immunization registry stays synchronized with facility records; FHIR Immunization/Recommendation/Evaluation resources available for external consumers.
Description: Async outbox → interop-service → HL7 VXU dispatch to national registry. Bidirectional: inbound registry records imported as historical. FHIR R4 read+search surface for Immunization, ImmunizationRecommendation, ImmunizationEvaluation. FHIR CapabilityStatement published.
Stories: IMMUN-US-004
IMMUN-EPIC-04 — Coverage analytics and digital certificates
| Field | Value |
|---|---|
| Issue type | Epic |
| Summary | Deliver population coverage reports and signed digital vaccination certificates |
| Status | To Do |
| Priority | Should |
| Labels | service:immunizations, domain:clinical, slice:S2 |
| Components | coverage, certificates |
| Fix version | M2 |
| FR references | FR-IMMUN-014, FR-IMMUN-015 |
| Legacy FR refs | FR-IMM-014, FR-IMM-015 |
| Dependencies | IMMUN-EPIC-01, IMMUN-EPIC-02 |
| Rollup status | Not started |
Business outcome: District health officers have real-time coverage dashboards; patients can present digital vaccination certificates.
Description: Materialized views for coverage by antigen, facility, and age group. Coverage reporting API. Digital certificate endpoint generating signed JWT with QR payload. Key rotation process for certificate signing.
Stories: IMMUN-US-005
IMMUN-ENH-EPIC-01 — Advanced immunization intelligence
| Field | Value |
|---|---|
| Issue type | Epic |
| Summary | Deliver AI-assisted defaulter prioritisation and anomaly detection |
| Status | To Do |
| Priority | Could |
| Labels | service:immunizations, domain:clinical, slice:S3 |
| Components | ai, analytics |
| Fix version | M4 |
| FR references | FR-IMMUN-ENH-001, FR-IMMUN-ENH-002 |
| Legacy FR refs | — |
| Dependencies | IMMUN-EPIC-02, IMMUN-EPIC-04, AI-GATEWAY-EPIC-01 |
| Rollup status | Not started |
Business outcome: Vaccination teams prioritise outreach to highest-risk defaulters; anomalous coverage drops trigger automated alerts.
Description: AI risk-score model (via ai-gateway-service) ranks defaulters by outreach priority. Coverage anomaly detection using rolling baseline. All AI outputs advisory only; human confirmation required before outreach dispatch.
Stories: IMMUN-ENH-US-001