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

Proveniența datelor medicale explicată

Ce înregistrează proveniența la fiecare scriere într-un dosar FHIR R4 — tip autor, persoană, organizație, sistem sursă, versiuni — cum să o setați cu headere, cum să o citiți și cum etichetează datele furnizate modelelor AI.

Proveniența este înregistrarea de unde provine o piesă de date medicale: cine a scris-o, în numele cărei organizații, din ce sistem, când și ce s-a schimbat în fiecare versiune. Într-o înregistrare care colectează date de la pacienți, dispozitive, clinici, laboratoare și AI, proveniența este ceea ce face o valoare demnă de încredere: o citire a tensiunii arteriale tastată acasă și una măsurată într-o clinică arată identic fără ea. În Anpheros, fiecare scriere pe o înregistrare HL7 FHIR R4 produce automat o resursă FHIR Provenance. Această pagină explică ce conține, cum să o completați corect și cum să o citiți.

De ce contează proveniența

Încredere clinică. Un medic cântărește un rezultat de laborator diferit de o valoare introdusă de pacient sau de un număr extras de o inteligență artificială dintr-o fotografie.
Siguranța AI. Un model căruia i se oferă un fișier trebuie să știe care elemente sunt fapte și care sunt note scrise de un alt model. Fără etichete, le tratează la fel.
Corecții și dispute. Când o valoare se modifică, toată lumea trebuie să știe care a fost valoarea anterioară, cine a modificat-o și de ce.
Responsabilitate. Conform GDPR și Spațiului European pentru Datele de Sănătate, o organizație trebuie să poată demonstra ce a făcut cu datele de sănătate ale unei persoane.
Partajare. Când un pacient permite unei a doua clinici să îi citească fișierul, acea clinică trebuie să știe ce date a scris prima clinică.

Ce înregistrează Anpheros la fiecare scriere

Întrebare	Unde este înregistrată	Cum o setați
Ce fel de autor?	`agent.who.identifier` (tip autor)	`author_type` în `/v1`, sau antetul `X-Anpheros-Author-Type`: `patient`, `practitioner`, `device`, `import`, `ai`
Ce persoană?	`agent.who.reference`	`X-Anpheros-Author-Ref: Practitioner/<id>`, sau `X-Anpheros-Acting-As`
Pentru ce organizație?	`agent.onBehalfOf`	organizația din `PractitionerRole`, sau `X-Anpheros-On-Behalf-Of: Organization/<id>`
Din ce sistem?	`entity` cu rolul `source`	`X-Anpheros-Source-System: <name>`
Ce înregistrare în acel sistem?	id origine	`X-Anpheros-Origin-Id: <id>`
Când și ce s-a întâmplat?	`recorded`, `activity` (CREATE, UPDATE, DELETE)	automat
Ce versiune?	`target` indică `<Resource>/<id>/_history/<version>`	automat

Dacă nu specificați cine este autorul, platforma înregistrează import. Nu presupune niciodată patient, deoarece o valoare atribuită greșit pacientului este mai rea decât una etichetată corect ca fiind importată.

O scriere cu proveniență completă

Un cardiolog dintr-o clinică înregistrează o frecvență cardiacă în timpul unei vizite, prin intermediul software-ului clinicii:

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

Provenance pe care platforma o scrie:

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

Rolul medicului, clinica sa, tipul autorului și sistemul sursă sunt toate acolo, în standardul FHIR. PractitionerRole trebuie să existe în directorul proiectului dvs. și să fie activ. O cerere care numește practicianul altei persoane este refuzată:

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

Configurarea directorului este acoperită în Cum să integrați sistemele clinice cu un backend FHIR.

Versiuni: nimic nu este suprascris silențios

Fiecare actualizare creează o nouă versiune a resursei și un nou Provenance pentru aceasta. După ce ritmul cardiac de mai sus este corectat de la 92 la 88:

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

returnează versiunea 2 (88) și versiunea 1 (92). Vizualizarea REST rezumă Provenance-ul fiecărei versiuni:

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}

Ștergerile sunt soft: o resursă ștearsă dispare din căutări, dar istoricul și Provenance-ul său rămân.

Citirea provenienței

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

Proveniența în contexte AI

API-ul de context poartă proveniența în fiecare element pe care îl oferă unui model, ca author_type și source. În formă text:

- 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ăsurătorile scrise cu author_type: ai nu apar niciodată printre aceste fapte. Ele sunt listate separat sub ai_notes și marcate ca neverificate, astfel încât un model să nu poată confunda o presupunere a unui model anterior cu o măsurătoare. Spuneți modelului ce înseamnă etichetele și cereți-i să le citeze; Cum să construiești o aplicație AI pentru sănătate cu un backend FHIR arată un prompt care face acest lucru.

Ce vede pacientul

Proveniența este, de asemenea, ceea ce vede pacientul. Înregistrarea sa arată cine a adăugat fiecare element, iar lista de conexiuni arată, pentru fiecare aplicație, cine a accesat ce, prin nume atunci când un practician acționa ("Dr. Ana Popescu · Clinica Cardio Nord a citit rezultatele dvs. de laborator"). Vezi Modelul de consimțământ și acces.

Reguli care fac proveniența utilă

Setați întotdeauna tipul autorului. Costă un câmp și este cea mai importantă etichetă din înregistrare.
Denumiți persoana când a scris-o o persoană. Folosiți X-Anpheros-Acting-As pentru personalul clinic.
Denumiți sistemul sursă și transmiteți ID-ul propriu al sursei ca ID de origine, atunci când există unul.
Corectați prin actualizare, niciodată prin ștergere și recreare. O actualizare păstrează legătura între valoarea veche și cea nouă.
Etichetați ieșirea AI ca ai, inclusiv valorile extrase de un model dintr-un document. Valorile derivate dintr-un document pot, de asemenea, să facă trimitere înapoi la acesta cu derived_from.

Întrebări frecvente

Ce este proveniența datelor în domeniul sănătății?

Originea și istoricul documentat al unei piese de date medicale: cine a creat-o sau a modificat-o, în numele cui, din ce sistem și când. În HL7 FHIR, aceasta este reprezentată de resursa Provenance, care indică versiunea exactă a resursei pe care o descrie.

Proveniența este același lucru cu un jurnal de audit?

Nu. Proveniența descrie datele: cine a scris fiecare versiune. Un jurnal de audit descrie accesul: cine a citit sau a scris ce, când, sub ce consimțământ. Anpheros păstrează ambele; pacientul vede jurnalul de acces pentru fiecare aplicație conectată la dosarul său.

Pot să scriu propriile resurse de Proveniență?

Anpheros scrie una pentru fiecare creare, actualizare și ștergere, deci în mod normal nu este necesar. Utilizați anteturile de mai sus pentru a o face precisă. O resursă de Proveniență furnizată de client trebuie să vizeze resurse ale unui singur pacient.

Conexe

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