🪪 Sprint 5.3 · MyKad NRIC + KKM eHIS Bridge · 16 Aug - 5 Sep 2027
← Hub ← Phase 5 SPRINT 5.3 · GOV BRIDGE

Sprint 5.3 · MyKad NRIC + KKM eHIS Bridge

Patients carry national health history in KKM systems. MediEco patients deserve continuity across that boundary. Sprint 5.3: MyKad smart-card identity verification, KKM eHIS read-write integration, cross-system patient record portability, government partnership groundwork.

1. 🎯 Sprint Summary

Sprint5.3 (MyKad NRIC + KKM eHIS Bridge)
Duration16 Aug - 5 Sep 2027 (3 weeks)
GoalMyKad smart-card identity (JPN) · KKM eHIS read (history fetch) + write (encounter post-back) · cross-system continuity · government partnership groundwork · 30%+ MediEco patients consent to link
Capacity5 FTE (2 BE + 1 FE + 0.5 prompt + 1 DevOps + 0.5 Compliance) + 0.5 Founder + 0.5 Doc Zam
Velocity target85 SP
Demo date5 Sep 2027

2. 🔄 Integration Flow

Patient ──MyKad──► JPN reader ──► Identity verified
                                       │
                                       ▼
                            ┌──────────────────────┐
                            │  Patient consents to │
                            │  link KKM eHIS       │
                            └──────┬───────────────┘
                                   │ Yes
                                   ▼
KKM eHIS ◄───── Fetch patient history ─── MediEco
   │                                        │
   ├── Allergies (FHIR AllergyIntolerance) ►│
   ├── Medications (FHIR MedicationStatement)│
   ├── Conditions (FHIR Condition)         ►│
   ├── Encounters (FHIR Encounter)         ►│
   └── Immunisations (FHIR Immunisation)   ►│
                                            │
                                            ▼
                              MediEco encounter happens
                                            │
                                            ▼
KKM eHIS ◄───── Post encounter back ────── MediEco
   ├── New encounter
   ├── New allergy (if any)
   └── New ADR (if any)

Audit log: every read + write logged · M9 verifies hash chain

3. 🚦 Pre-Sprint Gate Checklist

  • Sprint 5.2 demoed and signed off
  • JPN MyKad reader SDK procured · 5 readers per pilot tenant
  • KKM eHIS partnership agreement signed (sandbox + production access)
  • eHIS API specs reviewed · FHIR R4-aligned read + write
  • PDPA cross-system data sharing legal opinion obtained
  • Patient consent flow drafted (BM/EN/CN/TA · matches 5.2)
  • Government data residency requirements confirmed (must stay on Malaysian soil)
  • Audit log extension for cross-system events ready

4. 🧩 Sprint Scope

  • MyKad Reader Integration: JPN PKCS#11 SDK · USB reader · biometric verify · NRIC + name + DOB · session token
  • Identity Bridge: Map MyKad NRIC → MediEco patient record · auto-create or merge with existing
  • KKM eHIS Read API: Fetch FHIR bundle (Patient · Encounter · MedicationStatement · AllergyIntolerance · Condition · Immunisation) per consented patient
  • Pre-Consult Briefing Extension (M2): If linked, briefing surfaces "KKM eHIS history" section · last 5 encounters · all allergies · all active meds
  • KKM eHIS Write API: Post encounter back · new allergies · ADRs · immunisations · only on patient consent
  • Conflict Resolution: Merge MediEco vs eHIS data · timestamp-aware · doctor reviews disagreements
  • Patient Consent UI: Granular per-resource consent (read/write each type) · revocable · per-tenant scope
  • Cross-System Audit: Every read + write logged · NRIC + tenant + resource type + timestamp
  • Tenant Admin: eHIS link enable/disable per tenant · activity dashboard · error rate monitoring

5. 📅 Day-by-Day Plan (15 days)

D1Mon 16 Aug · Schema + JPN SDK Setup
DB migrations · MyKad SDK install · USB reader test bench · pilot tenant 1 hardware shipped.
D2Tue 17 Aug · MyKad Reader Integration
PKCS#11 binding · NRIC read · biometric (thumbprint) verify · session token issued.
D3Wed 18 Aug · Identity Bridge
MyKad NRIC → patient record matching · auto-create or merge · audit log.
D4Thu 19 Aug · Patient Consent UI
Multi-language consent flow (BM/EN/CN/TA) · per-resource toggles · revocable.
D5Fri 20 Aug · Mid-Demo + KKM Sandbox
MyKad reader live demo · KKM sandbox API first ping · auth flow established.
D6Mon 23 Aug · KKM eHIS Read API
Fetch FHIR bundle per consented patient · cache strategy · error handling.
D7Tue 24 Aug · Pre-Consult Briefing Extension
M2 briefing surfaces "KKM eHIS history" section · last 5 encounters · all allergies + active meds.
D8Wed 25 Aug · KKM eHIS Write API (Encounters)
Post-encounter write-back · only on consent · ack tracking · retry on failure.
D9Thu 26 Aug · Write API (Allergies + ADRs)
New allergy from M5 · new ADR from M6 · pushed to eHIS · audit logged.
D10Fri 27 Aug · Mid-Demo + Conflict Resolution
Conflict detection · doctor reviews disagreements · merge UI mockup.
D11Mon 30 Aug · Conflict Resolution UI
Doctor reviews · accept eHIS · accept MediEco · merge · audit log per decision.
D12Tue 31 Aug · Tenant Admin Panel
Per-tenant eHIS enable · activity dashboard · error rate · consent stats.
D13Wed 1 Sep · Cross-System Audit
Every read+write log · NRIC+tenant+resource+timestamp · M9 hash chain extension.
D14Thu 2 Sep · Hardening + Production Test (Doc Zam)
Doc Zam tenant flips on · 3 real patients link MyKad · history pulled · encounter pushed back · monitor 24h.
D15Fri 3 Sep · Demo Prep + Polish
Demo deck · 30%-target pathway · government partnership narrative.
+Mon 5 Sep · Sprint Demo + Retro
9am demo · 11am retro · 2pm 5.4 (DICOM) prep.

6. 📦 Deliverables

FRItemSP
FR-5.3.1MyKad PKCS#11 reader integration8
FR-5.3.2NRIC + biometric verify · session token5
FR-5.3.3Identity bridge · auto-create/merge5
FR-5.3.4Patient consent UI (4 languages)5
FR-5.3.5KKM eHIS read API · FHIR bundle8
FR-5.3.6Pre-consult briefing eHIS section (M2)5
FR-5.3.7KKM eHIS write API (encounters)8
FR-5.3.8Write API (allergies + ADRs)5
FR-5.3.9Conflict resolution UI8
FR-5.3.10Tenant admin eHIS panel5
FR-5.3.11Cross-system audit + M9 extension5
FR-5.3.12Production rollout · 3 patients linked5
FR-5.3.13Compliance pack update (eHIS · PDPA)5
FR-5.3.14Pen-test light · cross-system surface3
TOTAL85 SP

7. 👥 Team Capacity

RoleAllocationFocus
Eng Lead / BE1.0 FTEKKM eHIS API · auth · audit
BE Dev 3 (KKM specialist)1.0 FTEFHIR bundle handling · conflict logic · write-back
FE Dev1.0 FTEConsent UI · conflict resolution · tenant admin
Prompt Eng0.5 FTEBriefing prompt extension · history summarisation
DevOps1.0 FTEReader hardware · KKM API ops · data residency
Compliance Lead0.5 FTEeHIS PDPA · cross-system audit · doc pack update
Founder0.5 FTEJPN + KKM partnership · government relationships
Doc Zam0.5 FTEConflict resolution UX · clinical sign-off
QA0.5 FTEEnd-to-end MyKad → eHIS → MediEco · audit verification

8. 🔔 Sprint Ceremonies

  • Mon 16 Aug 9am — Sprint Planning (90 min)
  • Daily 9am — Standup (15 min)
  • Fri 20 Aug + Fri 27 Aug 4pm — Mid-sprint demos (45 min each)
  • Wed 1 Sep 4pm — Compliance + audit review (60 min)
  • Mon 5 Sep 9am — Sprint Demo (60 min)
  • Mon 5 Sep 11am — Sprint Retro (60 min)

9. 🩺 Sign-off Items

  • MyKad reader integration legally compliant (JPN approval)
  • KKM eHIS API integration sandbox-passed + production-tested
  • Patient consent flow legally + clinically defensible · 4 languages
  • Conflict resolution UX clinically appropriate
  • Cross-system audit log complete · every read + write captured
  • PDPA + government data residency verified
  • Compliance pack updated · external consultant review
  • 3 real patients linked successfully on production
  • Final demo (5 Sep) — written sign-off

10. 🎬 Demo Agenda — 5 Sep 9am (60 min)

TimeSegment
0-5Recap · government partnership narrative · 30%-target
5-15Live MyKad insert + biometric · identity verified · merge with existing patient
15-25Patient consent · 4 languages · per-resource toggle
25-35KKM eHIS history pulled · briefing surfaces · doctor sees
35-45Conflict resolution · MediEco vs eHIS allergy mismatch · doctor reconciles
45-55Encounter complete · post-back to KKM eHIS · ack received · audit logged
55-60Doc Zam + Compliance Lead sign-off · 5.4 prep

11. 🛡️ Contingency

RiskTriggerResponse
JPN SDK approval delaySDK access slowManual MyKad reading via SC reader open SDK · escalate to JPN partnership
KKM API instabilitySandbox unstableCache last-known-good · queue writes · retry · alert ops
FHIR bundle malformedSchema driftValidator pre-pull · fallback to raw JSON · escalate to KKM ops
Conflict resolution complexEdge cases not modeledDoctor manual override always available · iterate post-launch
Adoption slow (< 10%)Patients reluctantPatient education · "save your record" benefit · per-tenant flag
Government partnership stallsApproval delayShip sandbox-only first · production access incremental · MOU progressively