Interoperable National Digital Health Platform for Uganda — FHIR R4 backbone with offline-first PWA, supply ledger, and DPPA-aligned governance
# HealthSync Uganda
> **Interoperable National Digital Health Platform**
> Patient records · Supply-chain visibility · FHIR-based exchange · Offline-first
HealthSync Uganda is a prototype starter for a national digital health backbone designed for adoption by the Ministry of Health of Uganda. It links citizens' health records to the National Identification Number (NIN), exposes a FHIR R4 exchange layer for interoperability with existing systems (DHIS2, eHMIS, OpenMRS), and gives the Ministry real-time visibility into the medical supply chain — all while remaining usable on low-bandwidth and intermittently-connected devices.
Built for the **Uganda National Innovator Registry**, showcased at the **Government Systems Prototype Showcase, 25 June 2026**.
---
## Why this prototype
| Concern of the Ministry | How HealthSync answers it |
| --- | --- |
| Fragmented patient data across 6,937+ facilities | One canonical, NIN-linked patient record exposed via FHIR R4 |
| Drug stock-outs detected weeks late | Live facility-level inventory ledger with low-stock & expiry alerts |
| Poor connectivity in rural districts | Offline-first PWA; mutations queued and synced when online |
| Existing investment in DHIS2 / OpenMRS / eHMIS | Adapter layer with circuit-breaker isolation — never breaks legacy |
| Citizens' privacy & consent | Explicit consent records; immutable audit trail on every access |
| Vendor lock-in | Open standards (FHIR R4, OAuth2/OIDC, OpenTelemetry); open-source stack |
---
## Architecture at a glance
```
┌───────────────────────────────────────────────────────────────────────┐
│ CITIZEN / WORKER / ADMIN │
│ Next.js 16 (App Router · Server Components · PWA · Offline) │
└───────────────────────────────────────────────────────────────────────┘
│ HTTPS / mTLS
▼
┌───────────────────────────────────────────────────────────────────────┐
│ FastAPI Gateway …