# Interoperabilita zdravotnických dat

> Technické, syntaktické, sémantické a organizační úrovně interoperability, standardy, které Anpheros používá (FHIR R4, IPS, SMART on FHIR, HL7 v2) a proč původy činí vyměňovaná data důvěryhodnými.

Source: https://developers.anpheros.com/cs/guides/interoperability

**Interoperabilita zdravotnických dat je schopnost různých systémů — aplikací, klinik, laboratoří, nemocnic, služeb umělé inteligence — vyměňovat si zdravotnická data a používat je bez manuální reinterpretace.** Anpheros k ní přistupuje ukládáním každého záznamu ve formátech, kterým ostatní systémy již rozumí (HL7 FHIR R4 se standardními kódovými systémy), jeho výměnou prostřednictvím standardních protokolů (FHIR REST, SMART on FHIR, International Patient Summary, laboratorní zprávy HL7 v2) a zachováním kontextu, který činí vyměňovaná data důvěryhodnými: kdo je napsal, kdy a s čím souhlasem.

## Čtyři úrovně interoperability

| Úroveň | Na jakou otázku odpovídá | Jak Anpheros řeší |
|---|---|---|
| Technická | Mohou se systémy propojit? | HTTPS API, OAuth 2.1, podepsané webhuky, SDK v Dart a TypeScript |
| Syntaktická | Mohou si navzájem parsovat data? | HL7 FHIR R4 (4.0.1) zdroje a balíčky; CSV, HL7 v2 ORU^R01 a JSON přijímány pro laboratorní výsledky |
| Sémantická | Znamenají totéž? | LOINC pro měření a výsledky, ICD-10 pro diagnózy, ATC pro léky, UCUM pro jednotky; původní text uchován vedle každého kódu |
| Organizační | Mohou si je vyměňovat a mohou jim důvěřovat? | souhlas pacienta na aplikaci, původ u každého zápisu, log přístupu viditelný pacientovi |

Většina integračních projektů selhává na sémantické a organizační úrovni, nikoli na technické. Kódování v okamžiku zápisu a zaznamenávání původu pro každou hodnotu činí data z jednoho zdroje použitelnými v jiném.

## Standardy používané Anpheros

- **HL7 FHIR R4.** Každý záznam je tvořen FHIR zdroji — 26 typů — prohledávatelnými a verzovanými, s CapabilityStatement na `/fhir/R4/metadata`. [FHIR platforma](https://developers.anpheros.com/cs/guides/fhir)
- **International Patient Summary (IPS).** `Patient/{id}/$summary` vrací IPS dokument bundle, validovaný oficiálním HL7 validátorem proti `hl7.fhir.uv.ips#1.1.0` s 0 chybami. IPS je formát souhrnu určený pro přeshraniční péči v Evropě.
- **Pravidla pro laboratorní zprávy HL7 Europe.** Laboratorní výsledky jsou kontrolovány při zápisu; mezery jsou hlášeny v hlavičce odpovědi `Anpheros-Conformance` (dnes pouze poradní). `Observation/$validate?profile=eu-lab` provádí kontrolu na vyžádání.
- **SMART on FHIR.** Aplikace třetích stran přistupují k záznamu prostřednictvím OAuth 2.1 s PKCE a SMART v2 patient scopes; objevování na `/fhir/R4/.well-known/smart-configuration`. Testovací skupina standalone launch ze sady Inferno SMART App Launch STU2 prochází; EHR launch zatím není podporován.
- **HL7 v2.** Laboratorní výsledky přicházejí jako zprávy `ORU^R01`, stejně jako CSV nebo JSON, a stávají se z nich FHIR Observations. [Lab connector](https://developers.anpheros.com/cs/guides/lab-connector)
- **European Health Data Space.** FHIR R4 a IPS jsou formáty, na kterých EHDS staví pro souhrny pacientů a laboratorní výsledky; Anpheros je dodržuje. Toto je sladění formátů, nikoli certifikace.

## Výměnné vzory

1.  **Přístup aplikace se souhlasem** – aplikace požádá pacienta o rozsahy (scopes), čte a zapisuje záznam prostřednictvím FHIR nebo REST a přístup ztratí, jakmile jej pacient odvolá.
2.  **Výměna dokumentů** – záznam nebo jeho souhrn opouští systém jako FHIR bundle (`$everything`, `$summary`).
3.  **Příchozí výsledky** – laboratoře a kliniky zapisují do záznamu jménem své organizace; pacient vidí, kdo co zapsal.
4.  **Události** – odběratelé jsou informováni o tom, že se něco změnilo (pouze ID, nikdy klinický obsah) a čtou to, k čemu mají oprávnění.

## Provenance: interoperabilita, které můžete důvěřovat

Data, která cestují mezi systémy, ztrácejí svůj kontext, pokud s nimi necestuje i kontext. V Anpheros zaznamenává každá verze každého zdroje:

- **typ autora** — pacient, praktikující lékař, zařízení, import nebo AI;
- **organizaci**, jejímž jménem byl záznam vytvořen, a pokud je uveden, **praktikujícího lékaře**;
- **zdrojový systém** a jeho ID záznamu tam (`X-Anpheros-Source-System`, `X-Anpheros-Origin-Id`).

Hodnoty generované AI jsou takto označeny a při sestavování kontextu pro model jsou odděleny od klinických faktů.

## Identita napříč aplikacemi

Každá aplikace vidí svůj vlastní identifikátor pro stejnou osobu (párové ID), takže záznamy nemohou být korelovány mezi aplikacemi bez vědomí pacienta. Odkazy na osoby mimo rozsah aplikace jsou maskovány. Interoperabilita probíhá prostřednictvím souhlasu, nikoli prostřednictvím sdílených identifikátorů.

## Související

- [Jak normalizovat lékařská data](https://developers.anpheros.com/cs/guides/normalize-medical-data): kódy, jednotky, data, duplicity, validace
- [Vysvětlení původu lékařských dat](https://developers.anpheros.com/cs/guides/medical-data-provenance): kdo co napsal a jak to zaznamenat
- [Jak integrovat klinické systémy s FHIR backendem](https://developers.anpheros.com/cs/guides/integrate-clinic-systems-fhir): podrobný návod pro klinické EMR
- [Jak importovat laboratorní výsledky do FHIR záznamu](https://developers.anpheros.com/cs/guides/import-lab-results-fhir): podrobný návod s CSV a HL7 v2
- [FHIR platforma](https://developers.anpheros.com/cs/guides/fhir)
- [Integrace ve zdravotnictví](https://developers.anpheros.com/cs/guides/healthcare-integrations)
- [FHIR kódové systémy](https://developers.anpheros.com/cs/guides/fhir-code-systems)
- [API pro zdravotnictví](https://developers.anpheros.com/cs/guides/healthcare-api)
- [Infrastruktura lékařských dat](https://developers.anpheros.com/cs/guides/medical-data-infrastructure)
- [DICOM vs FHIR](https://developers.anpheros.com/cs/guides/dicom-vs-fhir): obrazová data a klinická data a jejich propojení
- [API pro laboratorní výsledky](https://developers.anpheros.com/cs/guides/lab-results-api): HL7 v2 a FHIR pro laboratorní výsledky
- [FHIR vs HL7 v2](https://developers.anpheros.com/cs/guides/fhir-vs-hl7-v2): porovnání zpráv a zdrojů
- [Evropský prostor pro zdravotní data (EHDS) pro vývojáře](https://developers.anpheros.com/cs/guides/ehds-for-developers)