HL7 Czech Health information exchange Implementation Guide
0.0.1 - ci-build
HL7 Czech Health information exchange Implementation Guide
0.0.1 - ci-build
HL7 Czech Health information exchange Implementation Guide, published by HL7 Czech Republic. This guide is not an authorized publication; it is the continuous build for version 0.0.1 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7-cz/HIE/ and changes regularly. See the Directory of published versions
Tato implementační specifikace se zaměřuje na národní implementaci profilu MHD (Mobile access to Health Documents) v prostředí akreditovaných afinitních domén (AAfD) a centrálních služeb elektronického zdravotnictví (EZ) vycházející z národního Standard Akreditovaných afinitních domén
Následující schéma ilustruje základní architekturu řešení a vzájemné vztahy mezi systémy:
Obr. 1: Schéma základní infrastruktury
Systém publikující zdravotnickou dokumentaci (ZD)
Primární systém poskytovatele, který prostřednictvím MHD a souvisejících rozhraní publikuje dokumenty a metadata.
Centrální služby EZ
Poskytují registr identit (KRP), registr oprávnění, číselníky a terminologie, časová razítka a auditní služby. Zajišťují také směrování a federaci dotazů mezi jednotlivými AAfD pomocí identifikátoru HCID.
AAfD publikující a konzumenta
Doménové komponenty, které zajišťují příjem a vyhledávání dokumentů, ověřování identity a oprávnění, notifikace a audit.
Systém konzumenta ZD
Aplikace uživatele (např. klinický systém nebo portál), která na základě autorizace vyhledává a stahuje dokumenty, případně přijímá notifikace o nových záznamech.
Schéma ukazuje podporované transakce IHE (ITI-65, ITI-66, ITI-67, ITI-68, DSUBm/ITI-112, RESTful ATNA/ITI-20) i národní rozhraní EZ (např. registr oprávnění, časová autorita, číselníky). Tato architektura tvoří základ pro interoperabilní sdílení zdravotnické dokumentace v České republice.
Národní specifikace MHD pro Českou republiku vyžaduje podporu transakcí ITI-65, ITI-66, ITI-67 a ITI-68 pro sdílení zdravotnických dokumentů v rámci Akreditovaných afinitních domén (AAfD). ITI-66 je v českém kontextu povinná pro mezidoménové vyhledávání (HCID).
PZS v AAfD-B zadá dotaz (ITI-66/67) na dokument pacienta, domácí AAfD na základě HCID rozešle požadavek do sousedních AAfD (včetně AAfD-A) a agreguje výsledky. Z obdržených metadat si PZS vybere konkrétní záznam a přes ITI-68 je směrován požadavek na repozitář v AAfD-A, odkud je dokument bezpečně stažen. Všechny kroky jsou autentizovány pomocí IUA a auditovány přes RESTful ATNA.
Pokud je v AAfD publikován nový dokument, systém prostřednictvím profilu DSUBm (ITI-112) odešle notifikaci registrovanému poskytovateli zdravotních služeb (PZS), který si tuto událost předem přihlásil. Notifikace obsahuje základní metadata (např. identifikátor pacienta RID, typ dokumentu, odkaz na DocumentReference), aby PZS věděl, že je k dispozici nový záznam. Následně může PZS podle potřeby spustit vyhledání a stažení dokumentu standardními transakcemi MHD (ITI-66 až 68).
Pokud zdravotnický pracovník potřebuje opravit nebo zneplatnit dokument, jeho primární systém odešle požadavek na změnu. V prostředí AAfD se to řeší obvykle publikací nové verze dokumentu a zneplatněním původního záznamu, zatímco Dočasné úložiště pro tento účel nabízí služby Změna/Zneplatnění zásilky (PUT). Tím je zajištěno, že uživatelé vždy pracují s aktuálními a validními metadaty i obsahem.
| Aktér | Role | Hlavní transakce |
|---|---|---|
| Document Source | Publikuje dokumenty a metadata do AAfD | ITI-65 Provide Document Bundle |
| Document Consumer | Vyhledává a stahuje dokumenty | ITI-66 Find, ITI-67 Find References, ITI-68 Retrieve |
| Document Responder | Odpovídá na vyhledávací dotazy a vrací metadata | ITI-66, ITI-67 |
| Document Recipient | Přijímá publikované dokumenty do repozitáře | ITI-65 |
| Notification Recipient | Přijímá notifikace o nových dokumentech | DSUBm / ITI-112 |
| Aktér | Povinné seskupen | Poznámka |
|---|---|---|
| Document Source | IUA Authorization Client, ATNA Secure Node / Secure Application, ATNA Audit Creator | Publikace dokumentů vyžaduje mTLS, přístupový token a audit |
| Document Consumer | IUA Authorization Client, ATNA Secure Node / Secure Application, ATNA Audit Creator | Vyhledávání a stahování vyžaduje mTLS, přístupový token a audit |
| Document Responder (Registry) | IUA Resource Server, ATNA Secure Node, ATNA Audit Creator | Odpovědi na dotazy vyžadují validaci tokenu a audit. Přístupové tokeny vydává centrální autorizační server EZ; AAfD vydává tokeny pouze při výměně tokenu pro komunikaci mezi AAfD (RFC 8693). |
| Document Recipient (Repository) | Document Registry, IUA Resource Server, ATNA Secure Node, ATNA Audit Creator | Ukládání dokumentů v AAfD, evidence metadat, validace tokenu a audit |
| Notification Recipient | IUA Resource Server, ATNA Secure Node / Secure Application, ATNA Audit Creator | Příjem notifikací o nových dokumentech |
Všichni aktéři AAfD musí také využívat centrální služby EZ: Kmenové registry (identifikátor pacienta RID), Registr oprávnění, Terminologický server, Časová autorita.
Domácí akreditovaná afinitní doména (AAfD) přijme vyhledávací dotaz ITI-66 obsahující jednoznačný identifikátor pacienta (RID). Na základě HCID indexu identifikuje relevantní partnerské AAfD a distribuuje jim odpovídající dotazy. Následně provede agregaci navrácených záznamů typu DocumentReference a zprostředkuje uživateli ucelený seznam výsledků. V případě volby konkrétního záznamu směruje požadavek ITI-68 Retrieve Document na repozitář příslušné AAfD, z níž dokument pochází.
Veškerá komunikace probíhá protokolem TLS 1.3 (minimálně TLS 1.2 se silnými šifrovacími sadami) se vzájemnou autentizací uzlů (mTLS) dle ATNA [ITI-19] s certifikáty vydanými certifikační autoritou MZČR. Současně se v každém požadavku předává přístupový token dle profilu IUA (OAuth 2.0 / JWT) vydaný centrálním autorizačním serverem EZ ([ITI-71], [ITI-72]); mezi AAfD se token získává výměnou dle RFC 8693. Každá transakce je auditována prostřednictvím profilu RESTful ATNA (ITI-20) včetně identity uzlů a údajů z přístupového tokenu. Podrobnosti uvádějí bezpečnostní kapitoly jednotlivých transakcí (např. ITI-65) a ITI-20. Identita pacienta a oprávnění zdravotnického pracovníka se ověřují proti Kmenovému registru pacientů (KRPZS/KRP)a Registru práv a mandátů (RO).
Pro hodnoty klasifikace, typů a formátů dokumentů se využívají číselníky a kódové systémy publikované na Terminologickém serveru elektronického zdravotnictví. Jednoznačná identifikace pacienta je v rámci transakcí zajištěna prostřednictvím RID z Kmenového registru pacientů (KRP).