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

Vysvetlenie pôvodu zdravotníckych údajov

Čo zaznamenáva pôvod pri každom zápise do FHIR R4 záznamu — typ autora, osoba, organizácia, zdrojový systém, verzie — ako ho nastaviť pomocou hlavičiek, ako ho prečítať a ako označuje údaje poskytnuté modelom AI.

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:

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:

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

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

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:

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:

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}

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

Čítanie pôvodu dát

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

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

Vždy nastavte typ autora. Stojí to jedno pole a je to najdôležitejší štítok v zázname.
Pomenujte osobu, keď ju napísala osoba. Použite X-Anpheros-Acting-As pre klinický personál.
Pomenujte zdrojový systém a preneste vlastné ID zdroja ako ID pôvodu, ak existuje.
Opravujte aktualizáciou, nikdy mazaním a opätovným vytvorením. Aktualizácia zachováva prepojenie medzi starou a novou hodnotou.
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

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