# Sağlık verisi birlikte çalışabilirliği

> Birlikte çalışabilirliğin teknik, sözdizimsel, anlamsal ve organizasyonel düzeyleri, Anpheros'un kullandığı standartlar (FHIR R4, IPS, SMART on FHIR, HL7 v2) ve köken bilgisinin (provenance) değiştirilen veriyi neden güvenilir kıldığı.

Source: https://developers.anpheros.com/tr/guides/interoperability

**Sağlık verisi birlikte çalışabilirliği, farklı sistemlerin — uygulamalar, klinikler, laboratuvarlar, hastaneler, yapay zeka hizmetleri — sağlık verilerini değiştirebilmesi ve elle yeniden yorumlamadan kullanabilmesidir.** Anpheros, her kaydı diğer sistemlerin zaten anladığı formatlarda (standart kod sistemleriyle HL7 FHIR R4) saklayarak, standart protokoller (FHIR REST, SMART on FHIR, International Patient Summary, HL7 v2 laboratuvar mesajları) aracılığıyla değiştirerek ve değiştirilen veriyi güvenilir kılan bağlamı koruyarak (kimin yazdığı, ne zaman ve kimin onayıyla) bu konuya yaklaşır.

## Dört düzeyde birlikte çalışabilirlik

| Düzey | Cevapladığı Soru | Anpheros Nasıl Ele Alıyor? |
|---|---|---|
| Teknik | Sistemler bağlanabilir mi? | HTTPS API'leri, OAuth 2.1, imzalı webhook'lar, Dart ve TypeScript SDK'ları |
| Sözdizimsel | Birbirlerinin verilerini ayrıştırabilirler mi? | HL7 FHIR R4 (4.0.1) kaynakları ve paketleri; laboratuvar sonuçları için CSV, HL7 v2 ORU^R01 ve JSON kabul edilir |
| Anlamsal | Aynı anlama mı geliyorlar? | Ölçümler ve sonuçlar için LOINC, durumlar için ICD-10, ilaçlar için ATC, birimler için UCUM; her kodun yanında orijinal metin saklanır |
| Kurumsal | Onu değiştirebilirler mi ve ona güvenebilirler mi? | uygulama başına hasta onayı, her yazma işleminde kaynak bilgisi, hastanın görebileceği bir erişim günlüğü |

Entegrasyon projelerinin çoğu, teknik düzeyde değil, anlamsal ve kurumsal düzeylerde başarısız olur. Yazma anında kodlama ve her değer için kaynak bilgisinin kaydedilmesi, bir kaynaktan gelen verilerin başka bir kaynakta kullanılabilir olmasını sağlar.

## Anpheros'un Kullandığı Standartlar

- **HL7 FHIR R4.** Her kayıt, `/fhir/R4/metadata`'deki bir CapabilityStatement ile aranabilir ve sürümlendirilebilir 26 tür FHIR kaynağından oluşur. [FHIR platformu](https://developers.anpheros.com/tr/guides/fhir)
- **International Patient Summary (IPS).** `Patient/{id}/$summary`, `hl7.fhir.uv.ips#1.1.0`'e karşı resmi HL7 doğrulayıcısı ile 0 hata ile doğrulanmış bir IPS belge paketi döndürür. IPS, Avrupa'da sınır ötesi bakım için tasarlanmış özet formatıdır.
- **HL7 Europe laboratuvar rapor kuralları.** Laboratuvar sonuçları yazılırken kontrol edilir; boşluklar `Anpheros-Conformance` yanıt başlığında bildirilir (şu anda tavsiye niteliğinde). `Observation/$validate?profile=eu-lab`, kontrolü isteğe bağlı olarak çalıştırır.
- **SMART on FHIR.** Üçüncü taraf uygulamalar, PKCE ve SMART v2 hasta kapsamları ile OAuth 2.1 aracılığıyla bir kayda ulaşır; keşif `/fhir/R4/.well-known/smart-configuration`'da. Inferno SMART App Launch STU2 paketinin bağımsız başlatma test grubu geçer; EHR başlatma henüz desteklenmemektedir.
- **HL7 v2.** Laboratuvar sonuçları `ORU^R01` mesajları ile CSV veya JSON olarak gelir ve FHIR Observations haline gelir. [Laboratuvar bağlayıcısı](https://developers.anpheros.com/tr/guides/lab-connector)
- **European Health Data Space.** FHIR R4 ve IPS, EHDS'nin hasta özetleri ve laboratuvar sonuçları için güvendiği formatlardır; Anpheros bunlara uyar. Bu, formatlarla uyumdur, sertifikasyon değildir.

## Değişim Kalıpları

1. **Onaylanmış Uygulama Erişimi** — bir uygulama hastadan kapsamları ister, kaydı FHIR veya REST üzerinden okur ve yazar ve hasta erişimi iptal ettiğinde erişimi kaybeder.
2. **Belge Değişimi** — kayıt veya özeti, bir FHIR paketi (`$everything`, `$summary`) olarak çıkar.
3. **Gelen Sonuçlar** — laboratuvarlar ve klinikler, kendi kuruluşları adına kayda yazar; hasta kimin ne yazdığını görür.
4. **Olaylar** — abonelere bir şeylerin değiştiği bildirilir (yalnızca kimlikler, asla klinik içerik değil) ve izin verilenleri okurlar.

## Provenance: Güvenebileceğiniz Birlikte Çalışabilirlik

Sistemler arasında seyahat eden veriler, bağlamı da birlikte seyahat etmediği sürece bağlamını kaybeder. Anpheros'ta her kaynağın her sürümü şunları kaydeder:

- **yazar türü** — hasta, uygulayıcı, cihaz, içe aktarma veya yapay zeka;
- yazıldığı **kuruluş** ve adı geçtiğinde **uygulayıcı**;
- **kaynak sistem** ve oradaki kaydın kimliği (`X-Anpheros-Source-System`, `X-Anpheros-Origin-Id`).

Yapay zeka tarafından üretilen değerler bu şekilde etiketlenir ve bir model için bağlam oluşturulduğunda klinik gerçeklerden ayrı tutulur.

## Uygulamalar Arası Kimlik

Her uygulama, aynı kişi için kendi tanımlayıcısını görür (eşli kimlikler), böylece kayıtlar hastanın bilgisi olmadan uygulamalar arasında ilişkilendirilemez. Bir uygulamanın kapsamı dışındaki kişilere yapılan başvurular maskelenir. Birlikte çalışabilirlik, paylaşılan tanımlayıcılar aracılığıyla değil, onay yoluyla gerçekleşir.

## İlgili Konular

- [Tıbbi verileri normalleştirme](https://developers.anpheros.com/tr/guides/normalize-medical-data): kodlar, birimler, tarihler, tekrarlar, doğrulama
- [Tıbbi veri kökeni (provenance) açıklaması](https://developers.anpheros.com/tr/guides/medical-data-provenance): kim neyi yazdı ve bunu nasıl kaydedersiniz
- [Klinik sistemleri bir FHIR arka ucuyla entegre etme](https://developers.anpheros.com/tr/guides/integrate-clinic-systems-fhir): klinik EMR'ler için adım adım öğretici
- [Laboratuvar sonuçlarını bir FHIR kaydına aktarma](https://developers.anpheros.com/tr/guides/import-lab-results-fhir): CSV ve HL7 v2 ile adım adım öğretici
- [FHIR platformu](https://developers.anpheros.com/tr/guides/fhir)
- [Sağlık entegrasyonları](https://developers.anpheros.com/tr/guides/healthcare-integrations)
- [FHIR kod sistemleri](https://developers.anpheros.com/tr/guides/fhir-code-systems)
- [Sağlık API'si](https://developers.anpheros.com/tr/guides/healthcare-api)
- [Tıbbi veri altyapısı](https://developers.anpheros.com/tr/guides/medical-data-infrastructure)
- [DICOM vs FHIR](https://developers.anpheros.com/tr/guides/dicom-vs-fhir): görüntüleme verileri ve klinik veriler ve bunların nasıl bağlandığı
- [Laboratuvar sonuçları API'si](https://developers.anpheros.com/tr/guides/lab-results-api): laboratuvar sonuçları için HL7 v2 ve FHIR
- [FHIR vs HL7 v2](https://developers.anpheros.com/tr/guides/fhir-vs-hl7-v2): mesajlar ve kaynaklar karşılaştırması
- [Geliştiriciler için Avrupa Sağlık Veri Alanı (EHDS)](https://developers.anpheros.com/tr/guides/ehds-for-developers)