# FHIR kod sistemleri

> Her bir FHIR kaynak türünün kullandığı kod sistemleri: ölçümler ve laboratuvar sonuçları için LOINC, durumlar için ICD-10, ilaçlar için ATC, birimler için UCUM ve lisans bayrağının arkasında SNOMED CT.

Source: https://developers.anpheros.com/tr/guides/fhir-code-systems

Platformun sakladığı ve Anpheros Daily (hasta uygulaması) API aracılığıyla yazdığı şeyler. Uygulamalar FHIR'ın izin verdiği herhangi bir kod sistemini kullanabilir; bu sayfa platformun hangilerini tanıdığını (görüntüleme araması, IPS kontrolleri, bağlam motoru) ve Anpheros'un kendisinin hangilerini kullandığını belirtir. Son güncelleme 22 Eylül 2026.

| Kaynak | Öğe | Kod Sistemleri | Notlar |
|---|---|---|---|
| Observation (vital-signs) | `code` | LOINC (`http://loinc.org`) | 8867-4 kalp atış hızı, 85354-9 kan basıncı paneli (8480-6 / 8462-4 bileşenleri), 8310-5 vücut sıcaklığı, 2339-0 glukoz, 29463-7 vücut ağırlığı, 39156-5 VKİ, 59408-5 SpO₂, 8302-2 boy |
| Observation (laboratory) | `code` | LOINC; LOINC bilinmediğinde yerel `urn:anpheros:lab` | Anpheros Daily tarafından eşleştirildi; referans aralığı `referenceRange`'te, belge `derivedFrom`'da |
| Observation (symptom) | `code`, `category` | ICD-10 (`http://hl7.org/fhir/sid/icd-10`) bölüm R; kategori `urn:anpheros:observation-category\|symptom`; bayrağın arkasında SNOMED CT | serbest metin `code.text`'de kalır; yoğunluk 1–10 `valueQuantity`'de (`{score}`). 13 Ekim 2026'dan önce yazılan kaynaklar HL7 `observation-category` sistemini `symptom` koduyla taşıyabilir; koda (`category=symptom`) göre filtreleyin, sisteme göre değil. Yalnızca hastanın kendisiyle ilgili olarak mevcut olduğunu bildirdiği semptomlar yazılır |
| Observation (survey, wellbeing) | `code`, `component` | `urn:anpheros:wellbeing` (boyut: duygusal / zihinsel / fiziksel) | yoğunluk bileşen olarak `valueQuantity` `{score}`; not `note`'de |
| Observation (activity, daily watch summaries) | `code` | LOINC: 40443-4 dinlenme nabzı, 8867-4 nabız (min/ort/maks bileşenleri), 80404-7 HRV (RMSSD), 59408-5 SpO₂, 41950-7 adım, 41981-2 enerji, 93832-4 uyku süresi, 93831-6 / 93830-8 uyku evreleri | `effectivePeriod` günü kapsar; kategori `activity` |
| Condition | `code`, `severity`, `clinicalStatus` | ICD-10; SNOMED CT şiddeti (24484000 şiddetli, 6736007 orta, 255604002 hafif); `condition-clinical` | kategori `problem-list-item` |
| MedicationStatement | `medicationCodeableConcept` | ATC (`http://www.whocc.no/atc`); `code.text` = ürün adı | uygulama özel alanları için uzantı `daily-medication` |
| MedicationAdministration | `medicationCodeableConcept`, `supportingInformation` | ATC; tedavi planı `MedicationStatement/{id}` olarak `supportingInformation`'de (arama parametresi `statement`) | alınan veya atlanan her doz için bir kaynak (`status` tamamlandı / yapılmadı) |
| Immunization | `vaccineCode` | ATC J07 (`http://www.whocc.no/atc`) veya ulusal adlandırma; `vaccineCode.text` her zaman saklanır | IPS bölümü için `occurrenceDateTime` gereklidir; doz için `protocolApplied.doseNumberPositiveInt` |
| AllergyIntolerance | `code`, `reaction.manifestation`, `criticality` | SNOMED CT (bayrağın arkasında) veya yalnızca `code.text`; ilaç alerjileri için ATC | kategori gıda / ilaç / çevre / biyolojik |
| DocumentReference | `type` | LOINC belge türleri (`DOC_KIND_LOINC` `/v1`'de) | |
| Encounter | `class`, `type` | v3-ActCode sınıfı; biliniyorsa SNOMED CT türü | `episodeOfCare` → bir gebelik / uzun süreli hastalık / tedavinin EpisodeOfCare'i |
| EpisodeOfCare | `type`, `diagnosis.condition` | `urn:anpheros:episode-type` (hastalık / tedavi / gebelik / diğer); `diagnosis.condition` → Condition | Anpheros Daily durumu başına bir ("dosar", 25 Eyl 2026); `period` = başlangıç → bitiş. Bağlantılı kaynaklar Condition'a işaret eder: `Observation.focus`, `MedicationStatement.reasonReference`, `DocumentReference.context.related`, `Appointment.reasonReference` (arama: `focus`, `reason-reference`, `related`, `condition`) |
| Appointment | `serviceType` | `service-type` kod sistemi | |
| RelatedPerson | `relationship` | v3-RoleCode (MTH, FTH, CHILD, SPS, …) | |
| QuestionnaireResponse | `questionnaire` | `https://anpheros.com/fhir/Questionnaire/` altındaki kanonik URL'ler | |
| Basic | `code` | `urn:anpheros:basic` | kaçış kapağı; kullanımdan önce burada belgelenen her kod |
| Provenance | `agent.type` | `provenance-participant-type` | |

## Tanımlayıcılar ve Uzantılar

- Anpheros Daily satırlarının yerel tanımlayıcıları: `urn:anpheros:daily:{vital|medication|condition|episode|lab|symptom|document|weight|wellbeing|intake|immunization|allergy|health-day}`.
- Durum uzantısı `daily-condition` (25 Eyl 2026): `kind` (hastalık / tedavi / gebelik / diğer), `color` (uygulama paleti anahtarı), `source`, `due_date` (gebelik). Yazılı bir kodu olmayan bir gebelik, ICD-10 `Z33` taşır.
- Uzantılar `https://anpheros.com/fhir/StructureDefinition/daily-*` altında yaşar (`daily-medication`, `daily-symptom`, `daily-condition`, …).
- Bir miktar yazılan her yerde birimler UCUM (`http://unitsofmeasure.org`) olarak kullanılır.

## Semptom Kavramları (sürüm 2026.10.2, 16 Ekim 2026)

`GET /v1/terminology/symptoms?q=&icd10=&kind=symptom|finding|all&lang=&limit=&offset=` ve `GET /v1/terminology/symptoms/{concept_id}`, Anpheros semptom kavramlarına hizmet eder: kararlı bir tanımlayıcı (`SYM-0001`…, asla yeniden kullanılmaz; sistem `https://anpheros.com/fhir/CodeSystem/symptom`), eşdeğerliği ile ICD-10 eşlemesi (`equivalent` veya ICD-10 kodu kavramdan daha fazlasını kapsadığında `broader`), etiketler ve serbest metinde kavramı bulmak için kullanılan eşleşme terimleri.

- 86 kavram: 70 semptom ve 16 bulgu (R70–R94). Semptomlar ICD-10 R00–R69'u ve, WHO'nun semptomu başka bir yerde sınıflandırdığı durumlarda, WHO kodunu kullanır: G47 uyku sorunları, H53.2 çift görme, H53.8 bulanık görme (daha geniş), H93.1 kulak çınlaması, K59.0 kabızlık, L29.9 kaşıntı, M25.5 eklem ağrısı, M54 sırt ağrısı.
- Her kod ve İngilizce başlık, 15 Ekim 2026 tarihinde WHO ICD-10 Sürüm 2019 tarayıcısı ile, dahil etme ve hariç tutma notları dahil olmak üzere kontrol edildi; `icd10.display` WHO başlığıdır.
- Her kavram ayrıca **ICD-11 MMS 2025-01** ile eşlenir (`icd11`: kod, WHO başlığı, eşdeğerlik `eşdeğer | daha geniş | daha dar | tam olmayan`) and to a **body system** (`vücut_sistemi`: the ICD-11 chapter 21 block of that code, e.g. `sinir`, `digestive`). Hastalık kodu yerine 21. bölüm semptom kodu kullanılır (baş ağrısı → MB4D, 8A8Z değil); WHO ICD-10 → ICD-11 eşleme tablosundan her sapma `release.json`'de (`icd11_departures`) listelenir. `?icd11=MB4D` veya `?body_system=digestive` ile filtreleyin.
- Etiketler bir `review` durumuna sahiptir: `source` (resmi WHO İngilizce başlığı), `in_use` (Anpheros Daily'nin kullandığı Rumence etiketler ve eşleşme terimleri) veya `ai_reviewed` (19 dilde halk etiketleri: makine çevirileri, AI yardımıyla WHO başlıklarına karşı terim terim incelendi, bir klinisyen veya profesyonel tıbbi çevirmen tarafından **değil**). `display`, `lang`'de tercih edilen etikettir, aksi takdirde halk etiketi, aksi takdirde İngilizce; `display_lang` hangisi olduğunu belirtir.
- Uyarı işaretleri: 14 kavram için 32 öğe, CDC ve NIDDK kamu malı sayfalarından kelimesi kelimesine alıntılanmış, her biri kaynağı, `review: source_verified` ve teşhis-değildir notu ile. Neden veya durum ilişkisi yok. Nitelikli bir klinisyen sürümü gözden geçirene kadar her kavram `clinical_review: false` taşır.
- Veriler `app/terminology/symptoms/`'de (`concepts.csv`, `labels.csv`, `release.json` kaynaklarla) bulunur; bir değişiklik incelenmiş bir commit ve yeni bir sürüm numarasıdır.
- Anpheros Daily, semptom Gözlemlerinde ICD-10'un yanında ikinci bir kodlama olarak kavramı ekler.
- İstekler ve yanıtlarla adım adım inceleme: [Semptom Veri API'si](https://developers.anpheros.com/tr/guides/symptom-data-api).

### FHIR terminolojisi olarak aynı kavramlar (15 Ekim 2026)

Salt okunur, aynı sürümden, aynı yayın kuralıyla (yalnızca incelenmiş etiketler):

| Kaynak | Okuma | Notlar |
|---|---|---|
| CodeSystem | `GET /fhir/R4/CodeSystem/anpheros-symptom`, `GET /fhir/R4/CodeSystem?url=https://anpheros.com/fhir/CodeSystem/symptom` | `content: complete`, klinik olarak incelenene kadar `status: draft`; özellikler `kind`, `status`, `icd10`, `icd11`, `body_system`; Rumence etiketler, eşleşme terimleri ve halk etiketleri gösterimler olarak |
| CodeSystem/$lookup | `GET /fhir/R4/CodeSystem/$lookup?system=https://anpheros.com/fhir/CodeSystem/symptom&code=SYM-0047&displayLanguage=ro` | `Parameters` görüntü, gösterimler ve özelliklerle |
| ValueSet | `GET /fhir/R4/ValueSet/anpheros-symptoms`, `GET /fhir/R4/ValueSet/$expand?url=https://anpheros.com/fhir/ValueSet/anpheros-symptoms&filter=&displayLanguage=&count=&offset=` | aktif semptomlar (bulgular hariç) |
| ConceptMap | `GET /fhir/R4/ConceptMap/anpheros-symptom-to-icd10` | `equivalent` veya ICD-10 kodu kavramdan daha fazlasını kapsadığında `wider` (H53.8) |
| ConceptMap | `GET /fhir/R4/ConceptMap/anpheros-symptom-to-icd11` | ICD-11 MMS 2025-01 (`http://id.who.int/icd/release/11/mms`), `equivalent`, `wider`, `narrower` veya `inexact` ile |

**Profil `anpheros-symptom`** (`POST /fhir/R4/Observation/$validate?profile=anpheros-symptom`, kanonik `https://anpheros.com/fhir/StructureDefinition/anpheros-symptom-observation`): kategori `urn:anpheros:observation-category|symptom` (HL7 `observation-category` kodu reddedilir), kişinin kelimeleri `code.text`'te, ICD-10 koduna uygun Anpheros kavramı, konu = Hasta, durum son / değiştirilmiş / düzeltilmiş / hata girilmiş, etkili[x] `effectivePeriod.end`'dan önce değil `start`, yoğunluk UCUM `{score}` 0–10 olarak. Diğer profiller gibi sorunları bildirir ve yazmaları reddetmez.

## Lisanslar

LOINC, ATC (WHO), ICD-10 (WHO) ve UCUM, kamu lisansları altında kullanılmaktadır. SNOMED CT,
ulusal veya bağlı kuruluş lisansı gerektirir: eşleme tabloları kodla birlikte gelir, ancak SNOMED kodları yalnızca `TERMINOLOGY_SNOMED_ENABLED` açık olduğunda (Romanya için lisans bekleniyor) yazılır.

Farklı kaynaklardan gelen verileri bu kod sistemlerine, birimlere, tarihlere ve doğrulamaya nasıl eşleyeceğiniz: [Tıbbi verileri normalleştirme](https://developers.anpheros.com/tr/guides/normalize-medical-data).

Bu kod sistemlerine nereden bakılacağı ve paketlenmiş alt kümenin neleri kapsadığı: [Tıbbi terminoloji API](https://developers.anpheros.com/tr/guides/medical-terminology-api).