Official URL: http://smart.who.int/ips-pilgrimage/ImplementationGuide/smart.who.int.ips-pilgrimage | Version: 2.1.0 |
| Draft | Computable Name: SMART_WHO_INT_IPS_Pilgrimage |
One pilgrim and the people around him, eight moments, one pilgrimage season. Follow the people first; the technology is what makes each hand-off possible.
This Implementation Guide is intended to support the utilization of verifiable International Patient Summary (IPS) documents during pilgrimage, leveraging WHO Global Digital Health Certification Network (GDHCN) global public health infrastructure.
Eight moments that matter
Before anyone travels, Onesa's signing keys and code systems reach the trust network, so a Taifafeki clinic can trust and read an Onesan record months later.
Kamal is found fit to travel, hears who can see his Pilgrimage Health Record and for how long, and agrees on his wallet to share it.
Onesa's HIE turns Kamal's care history into a signed patient summary and puts the link to it in his wallet as a QR code.
Dizzy in the heat of Nalemi, Kamal is brought to the pilgrimage health facility by Salmah and shows his QR code at registration.
Nurse Reem scans the code and enters the passcode; the EMR checks the signature with Onesa's key from GDHCN.
The EMR retrieves Kamal's summary from Onesa; Dr Faisal sees the insulin and the penicillin allergy before he treats him.
Kamal is brought in unconscious with no one to show his code; Dr Hafiz gives his pilgrimage registration number and the facility reaches his summary through it.
The user scenarios of this guide told as one pilgrim’s story, step by step along the overview of key process flows (the numbered steps 1–5 and A–B of the figure below). Click a picture to walk through that moment in the journeys viewer, which names who takes part, what in this guide specifies it, and the policy question it raises.
Every person in this story, and both countries, are fictional. Kamal comes
from Onesa (code XXK) and goes on pilgrimage in Taifafeki (code XXR): two
fictional countries shared with the SMART Trust demo,
whose codes are ISO 3166-1 user-assigned codes, so they never name a real country.
The steps follow this guide’s real
Malaysian reference implementation,
Malaysia’s Hajj Health Card, as a policy precedent.
Each numbered flow in the figure names its moment above, and each moment has its own ArchiMate view.
The people
| Person | Who they are | Generic persona |
|---|---|---|
| Kamal | 61, from Tanavu, Onesa, going on pilgrimage for the first time. Has type 2 diabetes and high blood pressure; takes insulin and two tablets a day; allergic to penicillin. Carries one phone. | Pilgrim |
| Salmah | Kamal’s wife, travelling with him. Speaks for him when he cannot. | Accompanying family member (not yet a persona here) |
| Dr Aisyah | General practitioner in Tanavu, empanelled by the national pilgrimage authority for pre-pilgrimage health examinations. | Counsellor |
| Dr Hafiz | Doctor of the Onesan pilgrimage medical team, travelling with the pilgrims. | Accompanying Clinician from Origin Country |
| Nurse Reem | Registration nurse at a pilgrimage health facility in Nalemi. | Host Country Health Worker |
| Dr Faisal | Emergency physician at the same facility. | Host Country Health Worker |
And the systems: Kamal’s national health wallet (Origin Country Wallet), Onesa’s health information exchange (Origin Country HIE), the facility’s EMR (Host Country EMR), and WHO GDHCN, the trust network both countries take part in.
What the story shows the guide still needs
- Business processes for P0 (keys and terminologies), P2 (assembling the IPS) and P6 (break the glass).
- The two pilgrim forms named in P1, and a page for the pilgrim and counsellor actors: their actor files exist but no page includes them.
- One passcode policy (P4), stated once.
- An account of access back to the home country (P5, P7), and of language (P5).
- Example patients that are pilgrims: today’s examples are a resident of the Netherlands.
- The data dictionary, decision logic, indicators and functional requirements, which are still placeholders.
Summary
This implementation guide includes a machine-readable representation of WHO guidelines for verifiable IPS during pilgrimage. It explicitly encodes computer-interoperable logic, including data models, terminologies, and logic expressions, in a computable language to support implementation of IPS during pilgrimage usage scenario. This Implementation Guide leverages the WHO Global Digital Health Certification Network (GDHCN).
The guide is part of the WHO SMART Guidelines approach to support countries to integrate WHO global health and data recommendations into digital systems accurately and consistently. It defines a series of FHIR Resources, Profiles, Extensions, and Terminology.
Supporting guidance, recommendations, resources, and standards are included in the Bibliography and Dependencies.
Eligible Participants may request to join through the The Letter of Application
About this implementation guide
This implementation guide is broken into the following levels of knowledge representation:
- Home - contains references to the guidance, guidelines, policies and recommendations underpinning this implementation guide.
- Business Requirements - contains the requirements for this implementation guide including the definition of key concepts, use cases, and a data dictionary.
- Data Models and Exchange - contains the data models and data exchange protocols with actors and transactions defined.
- Deployment Guidance - contains relevant technical specifications and guidance, testing resources, reference implementation materials, and supporting guidance for adaptation to local contexts.
This guide assumes use of the following resources:
- MHD Folder
- IPS Patient
- IPS Immunization
- For a complete listing of the artifacts defined in this implementation guide, refer to the Artifact Index.
- A complete offline copy of this implementation guide can be found on the Downloads page.
- This guide utilizes the International Patient Summary(IPS) as a base for defining immunizations and expects that most data captured will be presented in conformance with the resources defined as part of that implementation guide.
- This Implementation Guide makes use of Clinical Quality Language for the decision support artifacts including the PlanDefinitions and Measures. They are used to express how a calculation should occur and can be used with a CQL engine in order to process the decision or indicator directly from the applicable FHIR resources. Links to this specification, the FHIR Clinical Practice Guidelines Specification, and other helpful resources can be found in the Support dropdown.
Disclaimer
The specification herewith documented is a demo working specification and may not be used for any implementation purposes. This draft is provided without warranty of completeness or consistency and the official publication supersedes this draft. No liability can be inferred from the use or misuse of this specification or its consequences.
IP statements
⟦not rendered: ip-statements.xhtml⟧ — the IG Publisher renders it from a source this build does not hold; no renderer was given to this build.
Cross-version analysis
⟦not rendered: cross-version-analysis.xhtml⟧ — the IG Publisher renders it from a source this build does not hold; no renderer was given to this build.
Dependencies
| IG | Package | FHIR | Comment |
|---|---|---|---|
| hl7.terminology.r4 | hl7.terminology.r4#7.5.0 | not in the package cache this build read, so what it depends on is not shown | |
| hl7.fhir.uv.extensions.r4 | hl7.fhir.uv.extensions.r4#5.4.0 | not in the package cache this build read, so what it depends on is not shown | |
| smart.who.int.base | smart.who.int.base#0.1.0 | not in the package cache this build read, so what it depends on is not shown | |
| ihe.iti.mcsd | ihe.iti.mcsd#3.8.0 | not in the package cache this build read, so what it depends on is not shown | |
| hl7.fhir.uv.ips | hl7.fhir.uv.ips#1.1.0 | not in the package cache this build read, so what it depends on is not shown | |
| hl7.fhir.uv.sdc | hl7.fhir.uv.sdc#3.0.0 | not in the package cache this build read, so what it depends on is not shown | |
| hl7.fhir.uv.cpg | hl7.fhir.uv.cpg#2.0.0 | not in the package cache this build read, so what it depends on is not shown | |
| ihe.iti.pcf | ihe.iti.pcf#1.1.0 | not in the package cache this build read, so what it depends on is not shown | |
| ihe.iti.mhd | ihe.iti.mhd#4.2.2 | not in the package cache this build read, so what it depends on is not shown |
Globals
There are no Global profiles defined.
