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

Sağlık Verisi Kökeni Açıklaması

Bir FHIR R4 kaydına yapılan her yazmada veri kökeni neleri kaydeder — yazar türü, kişi, kuruluş, kaynak sistem, sürümler — başlıklarla nasıl ayarlanır, nasıl okunur ve yapay zeka modellerine verilen verileri nasıl etiketlediği.

Köken bilgisi, bir tıbbi verinin nereden geldiğinin kaydıdır: kimin yazdığı, hangi kuruluş adına, hangi sistemden, ne zaman ve her sürümde nelerin değiştiği. Hastalar, cihazlar, klinikler, laboratuvarlar ve yapay zekadan veri toplayan bir kayıtta, köken bilgisi bir değeri güvenilir kılan şeydir: evde girilen bir tansiyon ölçümü ile bir klinikte ölçülen bir tansiyon ölçümü, köken bilgisi olmadan aynı görünür. Anpheros'ta bir HL7 FHIR R4 kaydına yapılan her yazma işlemi otomatik olarak bir FHIR Provenance kaynağı üretir. Bu sayfa, bunun neleri içerdiğini, nasıl doğru şekilde doldurulacağını ve nasıl okunacağını açıklar.

Provenans Neden Önemlidir?

Klinik Güven. Bir doktor, bir laboratuvar sonucunu, hastanın girdiği bir değeri veya bir yapay zekanın bir fotoğraftan çıkardığı bir sayıyı farklı değerlendirir.
Yapay Zeka Güvenliği. Bir kaydı alan bir modelin, hangi öğelerin gerçekler ve hangilerinin başka bir modelin yazdığı notlar olduğunu bilmesi gerekir. Etiketler olmadan hepsini aynı şekilde ele alır.
Düzeltmeler ve Anlaşmazlıklar. Bir değer değiştiğinde, herkesin daha önceki değeri, kimin değiştirdiğini ve neden değiştirdiğini bilmesi gerekir.
Hesap Verebilirlik. GDPR ve Avrupa Sağlık Veri Alanı kapsamında, bir kuruluşun bir kişinin sağlık verileriyle ne yaptığını gösterebilmesi gerekir.
Paylaşım. Bir hasta ikinci bir kliniğin kendi kaydını okumasına izin verdiğinde, o kliniğin ilk kliniğin yazdığı verileri bilmesi gerekir.

Anpheros her yazma işleminde ne kaydeder

Soru	Nerede kaydedilir	Nasıl ayarlarsınız
Ne tür yazar?	`agent.who.identifier` (yazar tipi)	`/v1` içinde `author_type` veya `X-Anpheros-Author-Type` başlığı: `patient`, `practitioner`, `device`, `import`, `ai`
Hangi kişi?	`agent.who.reference`	`X-Anpheros-Author-Ref: Practitioner/<id>` veya `X-Anpheros-Acting-As`
Hangi kuruluş için?	`agent.onBehalfOf`	`PractitionerRole`'ün kuruluşu veya `X-Anpheros-On-Behalf-Of: Organization/<id>`
Hangi sistemden?	`source` rolüyle `entity`	`X-Anpheros-Source-System: <name>`
O sistemdeki hangi kayıt?	origin id	`X-Anpheros-Origin-Id: <id>`
Ne zaman ve ne oldu?	`recorded`, `activity` (CREATE, UPDATE, DELETE)	otomatik
Hangi sürüm?	`target`, `<Resource>/<id>/_history/<version>`'yi işaret eder	otomatik

Yazarın kim olduğunu belirtmezseniz, platform import kaydeder. Asla patient varsaymaz, çünkü hastaya yanlış atfedilen bir değer, dürüstçe içe aktarıldığı etiketlenen bir değerden daha kötüdür.

Tam köken bilgisiyle yazma

Bir klinikteki kardiyolog, muayene sırasında kliniğin yazılımı aracılığıyla bir kalp atış hızı kaydeder:

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

Platformun yazdığı köken bilgisi:

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

Doktorun rolü, kliniği, yazar türü ve kaynak sistemi standart FHIR'da yer almaktadır. PractitionerRole projenizin dizininde bulunmalı ve aktif olmalıdır. Başka birinin uygulayıcısını adlandıran bir istek reddedilir:

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

Dizinin kurulumu, FHIR arka ucuyla klinik sistemleri nasıl entegre edilir bölümünde ele alınmaktadır.

Sürümler: Hiçbir şey sessizce üzerine yazılmaz

Her güncelleme, kaynak için yeni bir sürüm ve yeni bir Provenance oluşturur. Yukarıdaki kalp atış hızı 92'den 88'e düzeltildikten sonra:

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

sürüm 2'yi (88) ve sürüm 1'i (92) döndürür. REST görünümü, her sürümün Provenance'ını özetler:

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}

Silmeler yumuşaktır: silinen bir kaynak aramalarda kaybolur, ancak geçmişi ve Provenance'ı kalır.

Provenans Okuma

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

Yapay Zeka Bağlamlarında Kaynak Bilgisi (Provenance)

Bağlam API'si, her öğeye author_type ve source olarak kaynak bilgisini bir model için taşır. Metin biçiminde:

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

author_type: ai ile yazılan ölçümler bu gerçekler arasında asla görünmez. Bunlar ai_notes altında ayrı olarak listelenir ve doğrulanmamış olarak işaretlenir, böylece bir model önceki bir modelin tahminini bir ölçüm olarak karıştırmaz. Modele etiketlerin ne anlama geldiğini söyleyin ve bunları alıntılamasını isteyin; FHIR arka ucu ile bir yapay zeka sağlık uygulaması oluşturma bunu yapan bir komut istemi gösterir.

Hastanın Gördükleri

Provenance (Köken Bilgisi) aynı zamanda hastanın gördüğü şeydir. Kaydı, her bir öğeyi kimin eklediğini gösterir ve bağlantılar listesi, her bir uygulama için, bir uygulayıcı hareket halindeyken (örneğin, "Dr. Ana Popescu · Clinica Cardio Nord laboratuvar sonuçlarınızı okudu") kimin neye eriştiğini isimle gösterir. Onay ve Erişim Modeli bölümüne bakınız.

Provenance'ı Kullanışlı Hale Getiren Kurallar

Her zaman yazar türünü ayarlayın. Bir alan tutar ve kayıttaki en önemli etikettir.
Bir kişi yazdığında kişinin adını belirtin. Klinik personel için X-Anpheros-Acting-As kullanın.
Kaynak sistemi adlandırın ve varsa kaynağın kendi kimliğini origin id olarak iletin.
Silip yeniden oluşturarak değil, güncelleyerek düzeltin. Bir güncelleme, eski ve yeni değer arasındaki bağlantıyı korur.
Yapay zeka çıktısını ai olarak etiketleyin, bir modelin belgeden çıkardığı değerler dahil. Bir belgeden türetilen değerler, derived_from ile ona geri işaret edebilir.

Sıkça Sorulan Sorular

Sağlık verisi köken bilgisi (provenance) nedir?

Bir sağlık verisi parçasının belgelenmiş kökeni ve geçmişi: kimin, kimin adına, hangi sistemden ve ne zaman oluşturduğu veya değiştirdiği. HL7 FHIR'da, tanımladığı kaynağın tam sürümünü gösteren Provenance kaynağı ile temsil edilir.

Köken bilgisi (provenance) denetim günlüğü (audit log) ile aynı mı?

Hayır. Köken bilgisi veriyi tanımlar: her sürümü kimin yazdığı. Denetim günlüğü ise erişimi tanımlar: kimin, neyi, ne zaman, hangi onay ile okuduğu veya yazdığı. Anpheros her ikisini de tutar; hasta, kaydına bağlı her uygulama için erişim günlüğünü görür.

Kendi Köken Bilgisi (Provenance) kaynaklarımı yazabilir miyim?

Anpheros her oluşturma, güncelleme ve silme işlemi için bir tane yazar, bu nedenle normalde yazmanıza gerek yoktur. Daha kesin hale getirmek için yukarıdaki başlıkları kullanın. İstemci tarafından sağlanan bir Köken Bilgisi (Provenance), yalnızca tek bir hastanın kaynaklarını hedeflemelidir.

İlgili Konular

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