# Інтероперабельність медичних даних

> Технічні, синтаксичні, семантичні та організаційні рівні інтероперабельності, стандарти, які використовує Anpheros (FHIR R4, IPS, SMART on FHIR, HL7 v2), та чому походження робить обмінені дані надійними.

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

**Інтероперабельність медичних даних — це здатність різних систем — додатків, клінік, лабораторій, лікарень, сервісів ШІ — обмінюватися медичними даними та використовувати їх без ручного повторного тлумачення.** Anpheros підходить до цього шляхом зберігання кожного запису у форматах, які інші системи вже розуміють (HL7 FHIR R4 зі стандартними кодовими системами), шляхом обміну ним через стандартні протоколи (FHIR REST, SMART on FHIR, International Patient Summary, лабораторні повідомлення HL7 v2) та шляхом збереження контексту, який робить обмінені дані надійними: хто їх написав, коли і за чиєю згодою.

## Чотири рівні інтероперабельності

| Рівень | На яке питання він відповідає | Як Anpheros це вирішує |
|---|---|---|
| Технічний | Чи можуть системи підключитися? | HTTPS API, OAuth 2.1, підписані вебхуки, SDK на Dart та TypeScript |
| Синтаксичний | Чи можуть вони розбирати дані один одного? | Ресурси та бандли HL7 FHIR R4 (4.0.1); CSV, HL7 v2 ORU^R01 та JSON приймаються для лабораторних результатів |
| Семантичний | Чи означають вони одне й те саме? | LOINC для вимірювань та результатів, ICD-10 для станів, ATC для медикаментів, UCUM для одиниць вимірювання; оригінальний текст зберігається поруч із кожним кодом |
| Організаційний | Чи можуть вони обмінюватися цими даними, і чи можна їм довіряти? | згода пацієнта на додаток, походження кожного запису, журнал доступу, видимий пацієнту |

Більшість проєктів інтеграції зазнають невдачі на семантичному та організаційному рівнях, а не на технічному. Кодування під час запису та запис походження для кожного значення роблять дані з одного джерела придатними для використання в іншому.

## Стандарти, що використовуються Anpheros

- **HL7 FHIR R4.** Кожен запис складається з ресурсів FHIR — 26 типів — з можливістю пошуку та версіонування, з CapabilityStatement за адресою `/fhir/R4/metadata`. [Платформа FHIR](https://developers.anpheros.com/uk/guides/fhir)
- **International Patient Summary (IPS).** `Patient/{id}/$summary` повертає пакет документів IPS, валідований офіційним валідатором HL7 відповідно до `hl7.fhir.uv.ips#1.1.0` з 0 помилками. IPS — це формат резюме, призначений для транскордонної допомоги в Європі.
- **Правила звітності лабораторій HL7 Europe.** Результати лабораторних досліджень перевіряються під час запису; прогалини повідомляються в заголовку відповіді `Anpheros-Conformance` (сьогодні в режимі консультації). `Observation/$validate?profile=eu-lab` виконує перевірку на вимогу.
- **SMART on FHIR.** Сторонні додатки отримують доступ до запису через OAuth 2.1 з PKCE та областями дії пацієнтів SMART v2; інформація для відкриття за адресою `/fhir/R4/.well-known/smart-configuration`. Тестова група запуску автономних додатків з набору Inferno SMART App Launch STU2 проходить успішно; запуск EHR поки що не підтримується.
- **HL7 v2.** Результати лабораторних досліджень надходять як повідомлення `ORU^R01`, а також у форматах CSV або JSON, і перетворюються на FHIR Observations. [Лабораторний конектор](https://developers.anpheros.com/uk/guides/lab-connector)
- **European Health Data Space.** FHIR R4 та IPS — це формати, на які спирається EHDS для резюме пацієнтів та результатів лабораторних досліджень; Anpheros дотримується їх. Це узгодження форматів, а не сертифікація.

## Шаблони обміну

1. **Доступ програми за згодою** — програма запитує у пацієнта дозволи (scopes), читає та записує дані запису через FHIR або REST, і втрачає доступ, коли пацієнт його відкликає.
2. **Обмін документами** — запис або його резюме передається як FHIR-пакет (`$everything`, `$summary`).
3. **Вхідні результати** — лабораторії та клініки записують дані до запису від імені своєї організації; пацієнт бачить, хто що записав.
4. **Події** — підписникам повідомляється про зміни (тільки ідентифікатори, ніколи клінічний вміст), і вони читають те, на що мають дозвіл.

## Provenance: взаємодія, якій можна довіряти

Дані, що передаються між системами, втрачають свій контекст, якщо цей контекст не передається разом з ними. В Anpheros кожна версія кожного ресурсу записує:

- **тип автора** — пацієнт, практикуючий лікар, пристрій, імпорт або ШІ;
- **організацію**, від імені якої він був написаний, і, якщо вказано, **практикуючого лікаря**;
- **вихідну систему** та її ідентифікатор запису (`X-Anpheros-Source-System`, `X-Anpheros-Origin-Id`).

Значення, згенеровані ШІ, позначаються як такі і відокремлюються від клінічних фактів при побудові контексту для моделі.

## Ідентичність між додатками

Кожен додаток бачить власний ідентифікатор для тієї ж особи (парні ідентифікатори), тому записи не можуть бути корельовані між додатками за спиною пацієнта. Посилання на осіб поза межами дії додатка маскуються. Взаємодія відбувається через згоду, а не через спільні ідентифікатори.

## Пов'язане

- [Як нормалізувати медичні дані](https://developers.anpheros.com/uk/guides/normalize-medical-data): коди, одиниці вимірювання, дати, дублікати, валідація
- [Пояснення походження медичних даних](https://developers.anpheros.com/uk/guides/medical-data-provenance): хто що написав і як це записати
- [Як інтегрувати клінічні системи з FHIR бекендом](https://developers.anpheros.com/uk/guides/integrate-clinic-systems-fhir): покроковий посібник для клінічних EMR
- [Як імпортувати лабораторні результати до FHIR запису](https://developers.anpheros.com/uk/guides/import-lab-results-fhir): покроковий посібник з CSV та HL7 v2
- [FHIR платформа](https://developers.anpheros.com/uk/guides/fhir)
- [Інтеграції в галузі охорони здоров'я](https://developers.anpheros.com/uk/guides/healthcare-integrations)
- [FHIR кодові системи](https://developers.anpheros.com/uk/guides/fhir-code-systems)
- [API для охорони здоров'я](https://developers.anpheros.com/uk/guides/healthcare-api)
- [Інфраструктура медичних даних](https://developers.anpheros.com/uk/guides/medical-data-infrastructure)
- [DICOM проти FHIR](https://developers.anpheros.com/uk/guides/dicom-vs-fhir): дані зображень та клінічні дані, і як вони пов'язані
- [API лабораторних результатів](https://developers.anpheros.com/uk/guides/lab-results-api): HL7 v2 та FHIR для лабораторних результатів
- [FHIR проти HL7 v2](https://developers.anpheros.com/uk/guides/fhir-vs-hl7-v2): порівняння повідомлень та ресурсів
- [Європейський простір даних охорони здоров'я (EHDS) для розробників](https://developers.anpheros.com/uk/guides/ehds-for-developers)