# Vysvetlenie pôvodu lekárskych údajov

> Čo záznam o pôvode obsahuje pri každom zápise do záznamu FHIR R4 — typ autora, osobu, organizáciu, zdrojový systém, verzie — ako ho nastaviť pomocou hlavičiek, ako ho čítať a ako označuje údaje poskytnuté modelom AI.

Source: https://developers.anpheros.com/sk/guides/medical-data-provenance

**Pôvod je záznam o tom, odkiaľ pochádza lekársky údaj: kto ho vytvoril, v mene ktorej organizácie, z ktorého systému, kedy a čo sa v každej verzii zmenilo.** V zázname, ktorý zhromažďuje údaje od pacientov, zariadení, kliník, laboratórií a AI, je pôvod to, čo robí hodnotu dôveryhodnou: údaj o krvnom tlaku zadaný doma a údaj nameraný na klinike vyzerajú bez neho identicky. V Anpheros každý zápis do záznamu HL7 FHIR R4 automaticky vytvorí FHIR `Provenance` zdroj. Táto stránka vysvetľuje, čo obsahuje, ako ho správne vyplniť a ako ho čítať.

## Prečo na pôvode záleží

- **Klinická dôvera.** Lekár váži laboratórny výsledok inak ako hodnotu, ktorú zadal pacient, alebo číslo, ktoré AI extrahovala z fotografie.
- **Bezpečnosť AI.** Model, ktorému je poskytnutý záznam, musí vedieť, ktoré položky sú fakty a ktoré sú poznámky napísané iným modelom. Bez označení ich považuje za rovnaké.
- **Opravy a spory.** Keď sa hodnota zmení, každý musí vedieť, aká bola predtým, kto ju zmenil a prečo.
- **Zodpovednosť.** Podľa GDPR a Európskeho priestoru pre zdravotné údaje musí organizácia vedieť preukázať, čo urobila so zdravotnými údajmi osoby.
- **Zdieľanie.** Keď pacient dovolí druhej klinike prečítať si jeho záznam, táto klinika musí vedieť, ktoré údaje prvá klinika zapísala.

## Čo Anpheros zaznamenáva pri každom zápise

| Otázka | Kde je to zaznamenané | Ako to nastavíte |
|---|---|---|
| Aký typ autora? | `agent.who.identifier` (typ autora) | `author_type` v `/v1`, alebo hlavička `X-Anpheros-Author-Type`: `patient`, `practitioner`, `device`, `import`, `ai` |
| Ktorá osoba? | `agent.who.reference` | `X-Anpheros-Author-Ref: Practitioner/<id>`, alebo `X-Anpheros-Acting-As` |
| Pre ktorú organizáciu? | `agent.onBehalfOf` | organizácia `PractitionerRole`, alebo `X-Anpheros-On-Behalf-Of: Organization/<id>` |
| Z ktorého systému? | `entity` s rolou `source` | `X-Anpheros-Source-System: <name>` |
| Ktorý záznam v danom systéme? | origin id | `X-Anpheros-Origin-Id: <id>` |
| Kedy a čo sa stalo? | `recorded`, `activity` (CREATE, UPDATE, DELETE) | automaticky |
| Ktorá verzia? | `target` odkazuje na `<Resource>/<id>/_history/<version>` | automaticky |

Ak neuvediete, kto je autorom, platforma zaznamená `import`. Nikdy nepredpokladá `patient`, pretože hodnota nesprávne pripísaná pacientovi je horšia ako hodnota úprimne označená ako importovaná.

## Zápis s úplnou pôvodnosťou

Kardiológ v klinike zaznamená srdcovú frekvenciu počas návštevy prostredníctvom softvéru kliniky:

```bash
curl -X POST https://platform.anpheros.com/fhir/R4/Observation -H "Authorization: Bearer $KEY" \
     -H "Content-Type: application/fhir+json" \
     -H "X-Anpheros-Author-Type: practitioner" \
     -H "X-Anpheros-Acting-As: PractitionerRole/$ROLE" \
     -H "X-Anpheros-Source-System: ccn-emr" \
     -d '{ "resourceType": "Observation", "status": "final", "code": {"coding": [{"system": "http://loinc.org", "code": "8867-4"}]}, … }'
```

Pôvodnosť, ktorú platforma zapíše:

```json
{"resourceType": "Provenance",
 "target": [{"reference": "Observation/8660eb7c-…/_history/1"}],
 "recorded": "2026-10-12T20:41:47.469000Z",
 "activity": {"coding": [{"system": "http://terminology.hl7.org/CodeSystem/v3-DataOperation", "code": "CREATE"}]},
 "agent": [{"type": {"coding": [{"system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type", "code": "author"}]},
            "who": {"reference": "PractitionerRole/e6d8c227-…",
                    "identifier": {"system": "https://anpheros.com/fhir/CodeSystem/author-type", "value": "practitioner"}},
            "onBehalfOf": {"reference": "Organization/c3a56a4b-…", "display": "Clinica Cardio Nord"}}],
 "entity": [{"role": "source", "what": {"identifier": {"system": "ccn-emr"}}}]}
```

Úloha lekára, jeho klinika, typ autora a zdrojový systém sú štandardne uvedené vo formáte FHIR. `PractitionerRole` musí existovať vo vašom adresári projektu a byť aktívny. Požiadavka pomenujúca praktického lekára niekoho iného je odmietnutá:

```json
{"resourceType": "OperationOutcome", "issue": [{"severity": "error", "code": "invalid",
  "diagnostics": "Unknown or inactive Practitioner in X-Anpheros-Acting-As."}]}
```

Nastavenie adresára je popísané v časti [Ako integrovať klinické systémy s FHIR backendom](https://developers.anpheros.com/sk/guides/integrate-clinic-systems-fhir).

## Verzie: nič sa potichu neprepíše

Každá aktualizácia vytvorí novú verziu zdroja a nový Provenance pre ňu. Po oprave srdcovej frekvencie z 92 na 88:

```bash
curl https://platform.anpheros.com/fhir/R4/Observation/$OBS/_history -H "Authorization: Bearer $KEY"
```

vráti verziu 2 (88) a verziu 1 (92). Pohľad REST sumarizuje Provenance každej verzie:

```bash
curl https://platform.anpheros.com/v1/patients/$PID/provenance/Observation/$OBS -H "Authorization: Bearer $KEY"
```

```json
{"data": [
  {"version": 1, "activity": "CREATE", "recorded": "2026-10-12T20:41:47.469000Z", "author_type": "practitioner", "author": "PractitionerRole/e6d8c227-…", "source_system": "ccn-emr", "fhir": "Provenance/6ed91529-…"},
  {"version": 2, "activity": "UPDATE", "recorded": "2026-10-12T20:41:47.500000Z", "author_type": "practitioner", "fhir": "Provenance/3fbf270f-…"}],
 "total": 2}
```

Vymazania sú mäkké: vymazaný zdroj zmizne z vyhľadávaní, ale jeho história a Provenance zostanú.

## Čítanie pôvodu dát

```bash
# who wrote this resource (all versions)
GET /fhir/R4/Provenance?target=Observation/{id}
# everything a practitioner recorded
GET /fhir/R4/Provenance?agent=PractitionerRole/{id}
# the same, summarised, per resource
GET /v1/patients/{pid}/provenance/Observation/{id}
```

## Proveniencia v kontextoch AI

[API kontextu](https://developers.anpheros.com/sk/guides/llm-healthcare-data) prenáša provenienciu do každej položky, ktorú poskytne modelu, ako `author_type` a `source`. V textovej forme:

```
- Type 2 diabetes mellitus (E11), active, onset 2024-10-15 [import/anpheros-sandbox]
- Metformin 1000 mg 1 tablet twice daily with meals, active [patient/anpheros-sandbox]
- Glucose [Mass/volume] in Blood: 2026-09-16: 140.0 mg/dL [device/anpheros-sandbox]
```

Merania zapísané pomocou `author_type: ai` sa nikdy neobjavia medzi týmito faktami. Sú uvedené samostatne pod `ai_notes` a označené ako neoverené, takže model si nemôže pomýliť predchádzajúci odhad modelu s meraním. Povedzte modelu, čo znamenajú štítky, a požiadajte ho, aby ich citoval; [Ako vytvoriť AI zdravotnícku aplikáciu s FHIR backendom](https://developers.anpheros.com/sk/guides/build-ai-healthcare-app) ukazuje príklad výzvy, ktorá to robí.

## Čo vidí pacient

Pôvod je tiež to, čo vidí pacient. Jeho záznam zobrazuje, kto pridal každú položku, a jeho zoznam pripojení zobrazuje pre každú aplikáciu, kto k čomu pristupoval, podľa mena, keď konal lekár ("Dr. Ana Popescu · Clinica Cardio Nord si prečítal vaše laboratórne výsledky"). Pozri [Model súhlasu a prístupu](https://developers.anpheros.com/sk/guides/consent).

## Pravidlá, ktoré robia pôvod užitočným

1. **Vždy nastavte typ autora.** Stojí to jedno pole a je to najdôležitejší štítok v zázname.
2. **Pomenujte osobu, keď ju napísala osoba.** Použite `X-Anpheros-Acting-As` pre klinický personál.
3. **Pomenujte zdrojový systém** a preneste vlastné ID zdroja ako ID pôvodu, ak existuje.
4. **Opravujte aktualizáciou, nikdy mazaním a opätovným vytvorením.** Aktualizácia zachováva prepojenie medzi starou a novou hodnotou.
5. **Označte výstup AI ako `ai`**, vrátane hodnôt, ktoré model extrahoval z dokumentu. Hodnoty odvodené z dokumentu môžu naň tiež odkazovať pomocou `derived_from`.

## Často kladené otázky

### Čo je to pôvod dát v zdravotníctve?
Dokumentovaný pôvod a história zdravotníckych údajov: kto ich vytvoril alebo zmenil, v mene koho, z akého systému a kedy. V HL7 FHIR je reprezentovaný zdrojom `Provenance`, ktorý odkazuje na presnú verziu zdroja, ktorý popisuje.

### Je pôvod rovnaký ako auditný záznam?
Nie. Pôvod popisuje dáta: kto napísal každú verziu. Auditný záznam popisuje prístup: kto čítal alebo písal čo, kedy, pod akým súhlasom. Anpheros uchováva oboje; pacient vidí záznam o prístupe pre každú aplikáciu pripojenú k jeho záznamu.

### Môžem si vytvoriť vlastné zdroje Pôvodu?
Anpheros vytvára jeden pre každý create, update a delete, takže zvyčajne nemusíte. Použite hlavičky uvedené vyššie na spresnenie. Pôvod dodaný klientom musí smerovať na zdroje jedného pacienta.

## Súvisiace

- [Model súhlasu a prístupu](https://developers.anpheros.com/sk/guides/consent)
- [Ako integrovať klinické systémy s FHIR backendom](https://developers.anpheros.com/sk/guides/integrate-clinic-systems-fhir)
- [Ako normalizovať lekárske údaje](https://developers.anpheros.com/sk/guides/normalize-medical-data)
- [Interoperabilita zdravotníckych údajov](https://developers.anpheros.com/sk/guides/interoperability)
- [Bezpečnosť, ochrana súkromia a lokalita údajov](https://developers.anpheros.com/sk/guides/security)