# Infraštruktúra digitálneho zdravotného záznamu

> Infraštruktúra, ktorú digitálny zdravotný záznam potrebuje — štruktúra, história, dokumenty, izolácia, súhlas, audit, výmena — a prečo je oddelená od aplikácie pre pacienta.

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

**Digitálny zdravotný záznam potrebuje dve odlišné veci: aplikáciu pre pacienta, ktorú ľudia používajú každý deň, a infraštruktúru pod ňou, ktorá záznam ukladá, chráni a zdieľa.** Anpheros poskytuje druhú časť: úložisko, verzovanie, identitu, súhlas, audit a výmenu záznamu prostredníctvom API. Aplikáciou pre pacienta môže byť Anpheros Daily alebo aplikácia, ktorú si vytvoríte vy.

## Aplikácia verzus infraštruktúra

| | Aplikácia orientovaná na pacienta | Infraštruktúra lekárskych údajov |
|---|---|---|
| Čo to je | obrazovky, notifikácie, pripomienky, grafy, asistent | samotný záznam a pravidlá okolo neho |
| Často sa mení | áno — dizajn, funkcie, platformy | zriedka — musí zostať stabilná a kompatibilná |
| Príklady práce | denník symptómov, pripomienka na lieky, rodinný kalendár | FHIR úložisko, história verzií, súhlas, pôvod, audit, import laboratórnych výsledkov, webhooks |
| V Anpheros | Anpheros Daily (Android, macOS, web) | Anpheros Platform (`platform.anpheros.com`) |

Ich oddelenie umožňuje, aby záznam prežil akúkoľvek jednotlivú aplikáciu a mohol byť zdieľaný medzi viacerými. Anpheros Daily dodržiava toto rozdelenie: to, čo ľudia zaznamenajú v aplikácii, sa zapisuje na platformu prostredníctvom toho istého verejného API, ktoré používa akákoľvek iná aplikácia, takže je k dispozícii — so súhlasom pacienta — iným aplikáciám vo forme FHIR.

## Čo musí infraštruktúra poskytovať

### Štruktúra
Záznam je užitočný len vtedy, ak mu iný softvér rozumie. Anpheros ho ukladá ako zdroje HL7 FHIR R4 — 26 typov — so štandardnými kódmi (LOINC, ICD-10, ATC, UCUM) a uchováva pôvodný text vedľa každého kódu. [FHIR platforma](https://developers.anpheros.com/sk/guides/fhir)

### História
Lekárske údaje sa opravujú, nie prepisujú. Každá aktualizácia vytvorí novú verziu, čitateľnú cez `/fhir/R4/{type}/{id}/_history`; podmienené aktualizácie pomocou `If-Match` zabraňujú prepísaniu údajov dvoma zapisovateľmi (neaktuálna verzia odpovie `412`).

### Dokumenty
Skenované dokumenty a PDF sú uložené ako `DocumentReference` s pôvodným súborom: nahrané cez platformu alebo priamo do úložiska, potom finalizované pomocou kontrolného súčtu SHA-256 a veľkosti. Po finalizácii sa pôvodný súbor nedá zmeniť; hodnoty z neho extrahované naň odkazujú (`derived_from`). Súbory sú uložené v úložisku EÚ šifrovanom kľúčom spravovaným zákazníkom, pričom každý súbor má maximálne 25 MiB.

### Identita a izolácia
Každá aplikácia pracuje v rámci projektu a vidí iba svojich vlastných pacientov (plus tých, ktorí jej udelili prístup), pod svojimi vlastnými párovými identifikátormi. Záznam mimo jej dosahu pre ňu neexistuje (`404`).

### Súhlas
Pacient udelí aplikácii prístup na určité obdobie (30–365 dní), na konkrétne typy zdrojov a akcie, voliteľne obmedzené na kategóriu. Udelenia sú zrkadlené ako zdroje FHIR `Consent` a môžu byť kedykoľvek odvolané. [Model súhlasu a prístupu](https://developers.anpheros.com/sk/guides/consent)

### Pôvod a audit
Každý zápis zaznamenáva, kto ho vykonal (pacient, lekár, zariadenie, import alebo AI), pre ktorú organizáciu a z ktorého systému. Každé čítanie je zaznamenané a zobrazené pacientovi podľa aplikácie.

### Výmena
Záznam je možné exportovať ako celok (`Patient/$everything`), zhrnúť vo formáte International Patient Summary (`Patient/$summary`), prijímať z laboratórií (CSV, HL7 v2 ORU^R01, JSON) a sledovať prostredníctvom podpísaných webhookov. [Integrácie v zdravotníctve](https://developers.anpheros.com/sk/guides/healthcare-integrations)

### Rezidencia a vymazanie
Údaje sú uložené a spracované v Európskej únii. Vymazanie pacienta vymaže všetky zdroje záznamu.

## Vytvorenie vlastnej aplikácie pre pacienta

Ak vyvíjate aplikačnú vrstvu, môžete sa sústrediť na používateľskú skúsenosť a použiť Anpheros na záznamy:

1. vytvorte pacienta pre každého používateľa (`POST /v1/patients`) alebo požiadajte existujúceho používateľa Anpheros o súhlas;
2. zapisujte záznamy používateľa (`/v1/patients/{id}/observations`, `/conditions`, `/medications`, `/documents`);
3. čítajte ich späť ako zoznamy alebo časovú os (`/v1/patients/{id}/timeline`);
4. prihláste sa na odber webhookov na obnovenie obrazoviek, keď laboratórium alebo klinika niečo pridá.

Kompletný návod nájdete v časti [Vytvorenie zdravotníckej aplikácie](https://developers.anpheros.com/sk/guides/build-a-healthcare-app).

## Súvisiace

- [Zdravotný záznam pacienta](https://developers.anpheros.com/sk/guides/patient-medical-record)
- [Backend a databáza zdravotnej aplikácie](https://developers.anpheros.com/sk/guides/medical-app-backend)
- [Bezpečnosť, ochrana súkromia a lokalita údajov](https://developers.anpheros.com/sk/guides/security)
- [Infraštruktúra zdravotných údajov](https://developers.anpheros.com/sk/guides/medical-data-infrastructure)