# Az orvosi adatok eredetének magyarázata

> Mi az eredet (provenance) minden FHIR R4 rekordba történő írásnál – szerző típusa, személy, szervezet, forrásrendszer, verziók – hogyan állítható be fejlécsekkel, hogyan olvasható, és hogyan címkézi az AI modelleknek adott adatokat.

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

**Az eredet (provenance) az orvosi adatok származási helyének nyilvántartása: ki írta, melyik szervezet nevében, melyik rendszerből, mikor, és mi változott minden egyes verzióban.** Egy olyan rekordban, amely betegektől, eszközöktől, klinikáktól, laboratóriumoktól és AI-tól gyűjt adatokat, az eredet az, ami megbízhatóvá teszi az értéket: anélkül egy otthon beírt vérnyomásérték és egy klinikán mért vérnyomásérték azonosnak tűnik. Az Anpherosban minden HL7 FHIR R4 rekordba történő írás automatikusan létrehoz egy FHIR `Provenance` erőforrást. Ez az oldal elmagyarázza, mit tartalmaz, hogyan kell helyesen kitölteni és hogyan kell olvasni.

## Miért fontos a származás (provenance)

- **Klinikai bizalom.** Egy orvos eltérő súlyt tulajdonít egy laboreredménynek, egy páciens által bevitt értéknek vagy egy mesterséges intelligencia által egy fotóból kivont számnak.
- **Mesterséges intelligencia biztonság.** Egy rekordot kapott modellnek tudnia kell, mely elemek tények és melyek más modellek által írt jegyzetek. Címkék nélkül mindent egyformán kezel.
- **Javítások és viták.** Amikor egy érték megváltozik, mindenkinek tudnia kell, mi volt korábban, ki változtatta meg és miért.
- **Számonkérhetőség.** A GDPR és az Európai Egészségügyi Adattér (European Health Data Space) keretein belül egy szervezetnek képesnek kell lennie kimutatni, mit tett egy személy egészségügyi adataival.
- **Megosztás.** Amikor egy páciens engedélyezi egy második klinikának a rekordjának olvasását, annak a klinikának tudnia kell, mely adatokat az első klinika írt.

## Mit rögzít az Anpheros minden írásnál

| Kérdés | Hol rögzítve | Hogyan állíthatja be |
|---|---|---|
| Milyen típusú szerző? | `agent.who.identifier` (szerző típusa) | `author_type` a `/v1`-ben, vagy `X-Anpheros-Author-Type` fejléc: `patient`, `practitioner`, `device`, `import`, `ai` |
| Melyik személy? | `agent.who.reference` | `X-Anpheros-Author-Ref: Practitioner/<id>`, vagy `X-Anpheros-Acting-As` |
| Melyik szervezet számára? | `agent.onBehalfOf` | a `PractitionerRole` szervezete, vagy `X-Anpheros-On-Behalf-Of: Organization/<id>` |
| Melyik rendszerből? | `entity` `source` szerepkörrel | `X-Anpheros-Source-System: <name>` |
| Melyik rekord abban a rendszerben? | origin id | `X-Anpheros-Origin-Id: <id>` |
| Mikor, és mi történt? | `recorded`, `activity` (CREATE, UPDATE, DELETE) | automatikus |
| Melyik verzió? | `target` mutat a `<Resource>/<id>/_history/<version>`-re | automatikus |

Ha nem adja meg, ki a szerző, a platform `import` rögzít. Soha nem feltételezi `patient`, mert egy betegnek tévesen tulajdonított érték rosszabb, mint egy becsületesen importáltként megjelölt érték.

## Teljes származási adattal írás

Egy kardiológus egy klinikán rögzít egy pulzusszámot egy látogatás során, a klinika szoftverén keresztül:

```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"}]}, … }'
```

A platform által írt származási adatok:

```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"}}}]}
```

Az orvos szerepe, a klinikájuk, a szerző típusa és a forrásrendszer mind szerepelnek a standard FHIR formátumban. A `PractitionerRole`-nek léteznie kell a projekt könyvtárában és aktívnak kell lennie. Egy más személy gyakorlóját megnevező kérés elutasításra kerül:

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

A könyvtár beállítása a [Hogyan integrálhatók a klinikai rendszerek FHIR háttérrendszerrel](https://developers.anpheros.com/hu/guides/integrate-clinic-systems-fhir) részben található.

## Verziók: semmi sem íródik felül csendben

Minden frissítés létrehoz egy új verziót az erőforrásból és egy új Provenance-t hozzá. Miután a fenti pulzusszám 92-ről 88-ra lett javítva:

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

visszaadja a 2-es verziót (88) és az 1-es verziót (92). A REST nézet összefoglalja az egyes verziók Provenance-ét:

```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}
```

A törlések lágyak: a törölt erőforrás eltűnik a keresésekből, de a története és a Provenance-e megmarad.

## Provenance olvasása

```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}
```

## Provenance AI kontextusokban

A [context API](https://developers.anpheros.com/hu/guides/llm-healthcare-data) a származási adatokat minden modellnek átadott elembe beépíti, mint `author_type` és `source`. Szöveges formában:

```
- 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]
```

A `author_type: ai`-al írt mérések soha nem jelennek meg ezek között a tények között. Külön listázódnak a `ai_notes` alatt, és nem ellenőrzöttként vannak megjelölve, így a modell nem tévesztheti össze egy korábbi modell becslését egy méréssel. Mondja el a modellnek, mit jelentenek a címkék, és kérje meg, hogy hivatkozzon rájuk; a [Hogyan építsünk AI egészségügyi alkalmazást FHIR backenddel](https://developers.anpheros.com/hu/guides/build-ai-healthcare-app) című cikk bemutat egy ilyen promptot.

## Mit lát a páciens

A származás (provenance) az is, amit a páciens lát. A rekordjuk megmutatja, ki adta hozzá az egyes tételeket, és a kapcsolataik listája megmutatja, hogy az egyes alkalmazások esetében ki, mit, és mikor ért el, amikor egy egészségügyi szakember járt el ("Dr. Ana Popescu · Clinica Cardio Nord elolvasta a laboreredményeit"). Lásd: [Hozzájárulási és hozzáférési modell](https://developers.anpheros.com/hu/guides/consent).

## A provenance hasznosságát biztosító szabályok

1. **Mindig állítsa be a szerző típusát.** Ez egy mezőt igényel, és ez a legfontosabb címke a rekordban.
2. **Nevezze meg a személyt, ha egy személy írta.** Használja a `X-Anpheros-Acting-As` azonosítót a klinikai személyzet számára.
3. **Nevezze meg a forrásrendszert**, és adja át a forrás saját azonosítóját az origin id-ként, ha van ilyen.
4. **Javítson frissítéssel, soha ne törléssel és újralétrehozással.** A frissítés megőrzi a kapcsolatot a régi és az új érték között.
5. **Címkézze az AI kimenetet `ai`-ként**, beleértve azokat az értékeket is, amelyeket egy modell extrahált egy dokumentumból. A dokumentumból származó értékek is mutathatnak vissza rá a `derived_from` segítségével.

## Gyakran ismételt kérdések

### Mi az adat-eredet (data provenance) az egészségügyben?
Egy egészségügyi adat darabjának dokumentált eredete és története: ki hozta létre vagy változtatta meg, kinek a nevében, melyik rendszerből és mikor. Az HL7 FHIR szabványban ezt a `Provenance` erőforrás képviseli, amely pontosan arra az erőforrás-verzióra mutat, amelyet leír.

### Az eredet (provenance) ugyanaz, mint az audit napló?
Nem. Az eredet az adatot írja le: ki írta az egyes verziókat. Az audit napló a hozzáférést írja le: ki mit, mikor, milyen hozzájárulással olvasott vagy írt. Az Anpheros mindkettőt megőrzi; a páciens látja a hozzáférési naplót minden, a rekordjához csatlakoztatott alkalmazáshoz.

### Írhatok saját Eredet (Provenance) erőforrásokat?
Az Anpheros minden létrehozás, frissítés és törlés esetén ír egyet, így Önnek általában nincs szüksége rá. A fenti fejlécet használja a pontosság érdekében. Ügyfél által megadott Eredet (Provenance) erőforrásnak egyetlen páciens erőforrásaira kell irányulnia.

## Kapcsolódó

- [Hozzájárulási és hozzáférési modell](https://developers.anpheros.com/hu/guides/consent)
- [Klinikai rendszerek integrálása FHIR backenddel](https://developers.anpheros.com/hu/guides/integrate-clinic-systems-fhir)
- [Orvosi adatok normalizálása](https://developers.anpheros.com/hu/guides/normalize-medical-data)
- [Egészségügyi adatok interoperabilitása](https://developers.anpheros.com/hu/guides/interoperability)
- [Biztonság, adatvédelem és adattárolás helye](https://developers.anpheros.com/hu/guides/security)