Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

Egészségügyi adatok eredete (provenance) magyarázata

Mi rögzít eredetet minden írásnál a FHIR R4 rekordba – szerző típusa, személy, szervezet, forrásrendszer, verziók – hogyan állítsuk be fejlécsekkel, hogyan olvassuk el, és hogyan címkézi az AI modelleknek adott adatokat.

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:

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:

{"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:

{"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 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:

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:

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

{"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

# 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 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 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.

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

Mindig állítsa be a szerző típusát. Ez egy mezőt igényel, és ez a legfontosabb címke a rekordban.
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.
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.
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.
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ó

Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card