# Інфраструктура цифрового медичного запису

> Інфраструктура, яка потрібна цифровому медичному запису — структура, історія, документи, ізоляція, згода, аудит, обмін — і чому вона відокремлена від додатка для пацієнтів.

Source: https://developers.anpheros.com/uk/guides/digital-medical-record

**Цифровий медичний запис потребує двох різних речей: додатка для пацієнтів, яким люди користуються щодня, та інфраструктури під ним, яка зберігає, захищає та надає доступ до запису.** Anpheros надає останнє: зберігання, версіонування, ідентифікацію, згоду, аудит та обмін записом через API. Додатком для пацієнтів може бути Anpheros Daily або той, який ви створите.

## Застосунок проти інфраструктури

| | Застосунок для пацієнтів | Інфраструктура медичних даних |
|---|---|---|
| Що це | екрани, сповіщення, нагадування, діаграми, помічник | сам запис та правила навколо нього |
| Часто змінюється | так — дизайн, функції, платформи | рідко — має залишатися стабільним і сумісним |
| Приклади роботи | щоденник симптомів, нагадування про ліки, сімейний календар | сховище FHIR, історія версій, згода, походження, аудит, імпорт лабораторних даних, вебхуки |
| В Anpheros | Anpheros Daily (Android, macOS, web) | Anpheros Platform (`platform.anpheros.com`) |

Розділення їх дозволяє запису залишатися актуальним довше за будь-який окремий застосунок і бути доступним для спільного використання між кількома. Anpheros Daily дотримується цього розділення: те, що люди записують у застосунку, записується на платформу через той самий публічний API, який використовує будь-який інший застосунок, тому воно доступне — за згодою пацієнта — іншим застосункам у тій самій формі FHIR.

## Що має надавати інфраструктура

### Структура
Запис корисний лише тоді, коли інше програмне забезпечення може його зрозуміти. Anpheros зберігає його як ресурси HL7 FHIR R4 — 26 типів — зі стандартними кодами (LOINC, ICD-10, ATC, UCUM) і зберігає оригінальний текст поруч із кожним кодом. [Платформа FHIR](https://developers.anpheros.com/uk/guides/fhir)

### Історія
Медичні дані виправляються, а не перезаписуються. Кожне оновлення створює нову версію, яку можна прочитати через `/fhir/R4/{type}/{id}/_history`; умовні оновлення з `If-Match` запобігають перезапису даних двома користувачами одночасно (застаріла версія відповідає `412`).

### Документи
Скани та PDF-файли зберігаються як `DocumentReference` з оригінальним файлом: завантажені через платформу або безпосередньо до сховища, а потім фіналізовані за допомогою контрольної суми SHA-256 та розміру. Після фіналізації оригінал не може бути змінений; значення, витягнуті з нього, вказують назад на нього (`derived_from`). Файли зберігаються у сховищі ЄС, зашифрованому ключем, керованим клієнтом, розміром до 25 МіБ кожен.

### Ідентичність та ізоляція
Кожна програма працює в межах проєкту і бачить лише своїх пацієнтів (плюс тих, хто надав їй доступ) під власними парними ідентифікаторами. Запис поза межами її досяжності для неї не існує (`404`).

### Згода
Пацієнт надає програмі доступ на певний період (30–365 днів) до конкретних типів ресурсів та дій, опціонально обмежених категорією. Надання доступу відображаються як ресурси FHIR `Consent` і можуть бути відкликані в будь-який час. [Модель згоди та доступу](https://developers.anpheros.com/uk/guides/consent)

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

### Обмін
Запис може бути експортований повністю (`Patient/$everything`), узагальнений у форматі Міжнародного резюме пацієнта (International Patient Summary) (`Patient/$summary`), отримувати дані з лабораторій (CSV, HL7 v2 ORU^R01, JSON) та відстежуватися через підписані вебхуки. [Інтеграції в охороні здоров'я](https://developers.anpheros.com/uk/guides/healthcare-integrations)

### Резиденція та видалення
Дані зберігаються та обробляються в Європейському Союзі. Видалення пацієнта видаляє кожен ресурс запису.

## Створення власної програми для пацієнтів

Якщо ви створюєте прикладну частину, ви можете зосередитися на користувацькому досвіді, а Anpheros використовувати для записів:

1. створіть пацієнта для кожного користувача (`POST /v1/patients`) або попросіть існуючого користувача Anpheros надати згоду;
2. запишіть те, що записує користувач (`/v1/patients/{id}/observations`, `/conditions`, `/medications`, `/documents`);
3. прочитайте це назад у вигляді списків або хронології (`/v1/patients/{id}/timeline`);
4. підпишіться на вебхуки, щоб оновлювати екрани, коли лабораторія або клініка щось додає.

Повний посібник доступний за посиланням [Створення медичного додатку](https://developers.anpheros.com/uk/guides/build-a-healthcare-app).

## Пов'язане

- [Медична карта пацієнта](https://developers.anpheros.com/uk/guides/patient-medical-record)
- [Бекенд та база даних медичного застосунку](https://developers.anpheros.com/uk/guides/medical-app-backend)
- [Безпека, конфіденційність та місцезнаходження даних](https://developers.anpheros.com/uk/guides/security)
- [Інфраструктура медичних даних](https://developers.anpheros.com/uk/guides/medical-data-infrastructure)
