Tanzania FHIR Facade Implementation Guide
0.1.0 - ci-build Tanzania

Tanzania FHIR Facade Implementation Guide, published by Speedykom GmbH. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/Speedykom/tz-fhir-facade-ig/ and changes regularly. See the Directory of published versions

## Home

Official URL: http://speedykom.org/tz-fhir-facade/ImplementationGuide/tz.fhir.facade.ig | Version: 0.1.0
Active as of 2025-11-20 | Computable Name: TzFhirFacadeIG

This Implementation Guide describes the Tanzania FHIR Facade, a standards-based interoperability layer designed to integrate legacy health systems with a national, modern FHIR R5 ecosystem.

> This guide is under active development. The content represents a continuous build based on the current GitHub branch and may change frequently.

### Overview

The Tanzania FHIR Facade provides:

- FHIR R5 profiles for PII, clinical, and administrative workflows
- Logical Models describing legacy data structures (e.g., CardDetails, ViralLoad, Encounters)
- StructureMaps supporting:
  - Legacy → FHIR R5 transformation
  - FHIR R5 → Legacy system transformation
- Terminology support via ConceptMaps and CodeSystems
- Reference examples for mediators, mapping workflows, and validation pipelines

The facade is designed to be used with:

- OpenHIM mediators
- Matchbox Mapping Engine
- A dedicated IG validation server
- Separation of PII and Clinical data using two HAPI FHIR R5 servers

### Content

This publication includes the full set of specifications, profiles, logical models, maps, examples, value sets, and code systems included in the Tanzania FHIR Facade.

The navigation menu at the top provides quick access to the sections of this guide. You may also use the Table of Contents which lists all pages.

### Download

You can download:

- The entire guide
- ​Definition resources in JSON, XML, Turtle, or CSV
- ​Example resources in JSON, XML, Turtle
- R5 NPM Package

The source code for this IG is available on GitHub.

### Cross Version Analysis

### Dependency Table

IG | Package | FHIR | Comment
--- | --- | --- | ---
Tanzania FHIR Facade Implementation Guide | tz.fhir.facade.ig#0.1.0 | R5 |
HL7 Terminology (THO) | hl7.terminology.r5#7.0.0 | R5 | Automatically added as a dependency - all IGs depend on HL7 Terminology
FHIR Extensions Pack | hl7.fhir.uv.extensions.r5#5.2.0 | R5 |
FHIR Tooling Extensions IG | hl7.fhir.uv.tools.r5#0.8.0 | R5 | for example references

Package hl7.fhir.uv.extensions.r5#5.2.0 This IG defines the global extensions - the ones defined for everyone. These extensions are always in scope wherever FHIR is being used (built Mon, Feb 10, 2025 21:45+1100+11:00)

Package hl7.fhir.uv.tools.r5#0.8.0 This IG defines the extensions that the tools use internally. Some of these extensions are content that are being evaluated for elevation into the main spec, and others are tooling concerns (built Tue, Aug 5, 2025 20:09+1000+10:00)

### Globals Table

There are no Global profiles defined

### IP Statements

No use of external IP (other than from the FHIR specification)

### Intellectual Property Considerations

This IG may reference content from external terminologies such as SNOMED CT, LOINC, and UCUM. These may require separate licensing. Implementers are responsible for ensuring compliance with all terminology licensing conditions.

### Disclaimer

This is a draft specification provided without warranty. The continuous build may contain incomplete or experimental content. Use at your own discretion.