Speedykom/tz-fhir-ig

About This repository contains the official FHIR Implementation Guide (IG) used by the Tanzania FHIR Façade to transform legacy health system data into standardized FHIR R5 resources. # **Tanzania FHIR Facade – Implementation Guide (IG)** This repository contains the official **FHIR Implementation Guide (IG)** used by the **Tanzania FHIR Facade** to transform and validate legacy health system data (NHIF, ZHSF, EMR/LIS, etc.) into standard **FHIR R5** resources. This IG provides: * **Logical Models** describing legacy data structures * **StructureMaps** for transforming legacy → FHIR (and optional FHIR → legacy) * **ConceptMaps** for terminology mapping * **FHIR Profiles / Constraints** (where needed) * **Examples** for testing and validation * A ready-to-use **package.tgz** consumed by **Matchbox** and the Facade mediators This IG is automatically published through the HL7 **FHIR CI Build Server**, allowing the Facade’s Matchbox service to load it dynamically. --- ## **Online IG Publication** After installation of the **FHIR IG Builder** GitHub App, the IG is automatically built and published here: ``` build.fhir.org ``` Matchbox loads the IG package from: ``` build.fhir.org ``` This `package.tgz` is the only required artifact for the Facade mapping engine. --- ## **Purpose** The Tanzania FHIR Facade uses this IG as its authoritative mapping and validation layer to: * Translate legacy data into FHIR R5 using StructureMaps * Apply terminology mappings using ConceptMaps * Validate transformed resources against profiles and logical models * Support both clinical (EHR) and administrative (PII) data flows * Ensure interoperability and consistency across all legacy systems * Enable NHIF/ZHSF developers to contribute mappings collaboratively The Facade architecture relies on this IG to guarantee predictable, reusable, and well-defined data transformations. --- ## 📁 **Repository Structure** ``` . ├── input/ │ ├── models/ # Logical Models (FHIR Shorthand - .fsh) │ ├── maps/ # StructureMap (.fml / .map) file …