Ethiopia FHIR Validation Sandbox

Central conformance testing for FHIR against the Ethiopia Base IG (et.fhir.core). One HAPI server (storage + $validate engine), a gateway as the single entrypoint, an always-on conformance interceptor, and a Karate test harness.

Live status

HAPI /fhir/metadata Interceptor /intercept IGs loaded core · surveillance · hiv Actor simulator → core (ETBase) ↗ surveillance ↗ hiv ↗ test fixtures IG ↗

Architecture

Actor simulator EHR / lab / dispenser External system (live, step 11) Gateway entrypoint · routes /fhir/{Type}/$validate raw validation /intercept (proxy) validate + record + forward /fhir/* → storage HAPI FHIR storage + $validate engine IGs loaded (rules) et.fhir.core et.fhir.surveillance et.fhir.hiv … more as published

IGs & how testing works

IGs loaded = the rules
et.fhir.core (ETBase), et.fhir.surveillance, et.fhir.hiv — and more as Ethiopia publishes them. Loaded into HAPI; a resource's meta.profile picks which one it's validated against (hiv → surveillance → core).
et.fhir.core.test = the data
A separate fixture IG of curated valid examples (built in CI, published to Pages). The intentionally-invalid negative fixtures live with the harness as raw JSON, since SUSHI can't build invalid examples into an IG. The non-live battery validates both.
Non-live battery (regression)
harness/run-tests.sh POSTs each fixture to $validate and asserts good→0 / bad→errors. Runs anywhere against any server: SHR_URL=https://sandbox.fhir.et/fhir ./run-tests.sh.
Live session (onboarding)
Point a real system or the simulator at /intercept — every POST is validated against its ET profile, recorded, and forwarded. Verdicts feed the session dashboard + auditor. The interceptor is a Karate mock; the batch + auditor are Karate test runs.

The 12-step run-of-show

Tools & resources

Tutorial →
How to validate resources/bundles, use the interceptor, and run a session.
 Actor simulator →
Send Patient/Encounter/MedicationDispense bundles through the interceptor; see the verdict.
 Postman collection ⤓
$validate, POST with/without validation, interceptor. Import + set baseUrl.
 HAPI CapabilityStatement ↗
The FHIR server metadata (storage + validation engine).
 ETBase — core IG ↗
The Ethiopia Base IG (et.fhir.core) dev build the sandbox validates against.
 et.fhir.core.test ↗
Paired test-fixture IG (CI + Pages) — the batch battery's data.