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

Vysvětlení původu zdravotnických dat

Co zaznamenává původ při každém zápisu do FHIR R4 záznamu — typ autora, osoba, organizace, zdrojový systém, verze — jak jej nastavit pomocí hlaviček, jak jej číst a jak označuje data poskytnutá AI modelům.

Původ je záznam o tom, odkud pochází kus lékařských dat: kdo jej zapsal, jménem které organizace, z jakého systému, kdy a co se změnilo v každé verzi. V záznamu, který shromažďuje data od pacientů, zařízení, klinik, laboratoří a AI, je původ tím, co činí hodnotu důvěryhodnou: hodnota krevního tlaku zadaná doma a hodnota naměřená na klinice vypadají bez něj identicky. V Anpherosu každý zápis do záznamu HL7 FHIR R4 automaticky vytváří FHIR Provenance zdroj. Tato stránka vysvětluje, co obsahuje, jak jej správně vyplnit a jak jej číst.

Proč na původu dat záleží

Klinická důvěra. Lékař posuzuje laboratorní výsledek jinak než hodnotu zadanou pacientem nebo číslo extrahované AI z fotografie.
Bezpečnost AI. Model, kterému je předán záznam, musí vědět, které položky jsou fakta a které jsou poznámky napsané jiným modelem. Bez označení je považuje za stejné.
Opravy a spory. Když se hodnota změní, všichni musí vědět, jaká byla předtím, kdo ji změnil a proč.
Odpovědnost. Podle GDPR a European Health Data Space musí organizace být schopna prokázat, co s osobními zdravotními údaji pacienta provedla.
Sdílení. Když pacient dovolí druhé klinice přečíst si jeho záznam, tato klinika musí vědět, které údaje napsala první klinika.

Co Anpheros zaznamenává při každém zápisu

Otázka	Kde je zaznamenáno	Jak ji nastavit
Jaký typ autora?	`agent.who.identifier` (typ autora)	`author_type` v `/v1`, nebo hlavička `X-Anpheros-Author-Type`: `patient`, `practitioner`, `device`, `import`, `ai`
Která osoba?	`agent.who.reference`	`X-Anpheros-Author-Ref: Practitioner/<id>`, nebo `X-Anpheros-Acting-As`
Pro kterou organizaci?	`agent.onBehalfOf`	organizace `PractitionerRole`, nebo `X-Anpheros-On-Behalf-Of: Organization/<id>`
Z jakého systému?	`entity` s rolí `source`	`X-Anpheros-Source-System: <name>`
Jaký záznam v daném systému?	origin id	`X-Anpheros-Origin-Id: <id>`
Kdy a co se stalo?	`recorded`, `activity` (CREATE, UPDATE, DELETE)	automaticky
Která verze?	`target` odkazuje na `<Resource>/<id>/_history/<version>`	automaticky

Pokud neuvedete, kdo je autorem, platforma zaznamená import. Nikdy nepředpokládá patient, protože hodnota nesprávně připsaná pacientovi je horší než hodnota poctivě označená jako importovaná.

Zápis s plnou historií původu

Kardiolog na klinice zaznamená srdeční frekvenci během návštěvy prostřednictvím softwaru 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"}]}, … }'

Historie původu, kterou 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"}}}]}

Role lékaře, jeho klinika, typ autora a zdrojový systém jsou zde uvedeny ve standardním formátu FHIR. PractitionerRole musí existovat ve vašem projektovém adresáři a být aktivní. Požadavek pojmenovávající praktického lékaře někoho jiného je zamítnut:

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

Nastavení adresáře je popsáno v Jak integrovat klinické systémy s FHIR backendem.

Verze: nic není tiše přepsáno

Každá aktualizace vytvoří novou verzi zdroje a nový záznam Provenance pro ni. Po opravě srdeční frekvence z 92 na 88:

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

vrátí verzi 2 (88) a verzi 1 (92). Pohled REST shrnuje Provenance každé verze:

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}

Smazání jsou měkká: smazaný zdroj zmizí z vyhledávání, ale jeho historie a Provenance zůstávají.

Čtení původu

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

Provenience v kontextech AI

API kontextu přenáší provenienci do každé položky, kterou poskytuje modelu, jako author_type a source. V textové podobě:

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

Měření zapsaná pomocí author_type: ai se nikdy neobjeví mezi těmito fakty. Jsou uvedena samostatně pod ai_notes a označena jako neověřená, takže model nemůže zaměnit odhad předchozího modelu za měření. Řekněte modelu, co štítky znamenají, a požádejte ho, aby na ně odkazoval; Jak vytvořit zdravotnickou aplikaci s umělou inteligencí a backendem FHIR ukazuje příklad promptu, který to dělá.

Co vidí pacient

Provenance je také to, co vidí pacient. Jeho záznam ukazuje, kdo přidal každou položku, a jeho seznam připojení ukazuje, pro každou aplikaci, kdo co přístupoval, jménem, když praktikující jednal ("Dr. Ana Popescu · Clinica Cardio Nord si přečetl vaše laboratorní výsledky"). Viz Model souhlasu a přístupu.

Pravidla, která činí původ užitečným

Vždy nastavte typ autora. Stojí to jedno pole a je to nejdůležitější označení v záznamu.
Uveďte jméno osoby, pokud ji napsala osoba. Použijte X-Anpheros-Acting-As pro klinický personál.
Uveďte název zdrojového systému a předejte vlastní ID zdroje jako ID původu, pokud existuje.
Opravujte aktualizací, nikdy mazáním a opětovným vytvářením. Aktualizace zachovává spojení mezi starou a novou hodnotou.
Označte výstup AI jako ai, včetně hodnot, které model extrahoval z dokumentu. Hodnoty odvozené z dokumentu mohou také odkazovat zpět na něj pomocí derived_from.

Často kladené dotazy

Co jsou data o původu v oblasti zdravotnictví?

Zdokumentovaný původ a historie dat o zdravotním stavu: kdo je vytvořil nebo změnil, jménem koho, z jakého systému a kdy. V HL7 FHIR je reprezentován zdrojem Provenance, který odkazuje na přesnou verzi zdroje, který popisuje.

Je původ totéž co auditní záznam?

Ne. Původ popisuje data: kdo napsal každou verzi. Auditní záznam popisuje přístup: kdo co kdy přečetl nebo zapsal, pod jakým souhlasem. Anpheros uchovává obojí; pacient vidí záznam o přístupu pro každou aplikaci připojenou k jeho záznamu.

Mohu si vytvořit vlastní zdroje původu?

Anpheros vytváří jeden pro každý create, update a delete, takže obvykle nemusíte. Použijte výše uvedené hlavičky, aby byly přesné. Původ dodaný klientem musí cílit na zdroje jednoho pacienta.

Související

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