# FHIR kódrendszerek

> Mely kódrendszereket használja az egyes FHIR erőforrástípusok: LOINC mérésekhez és laboreredményekhez, ICD-10 állapotokhoz, ATC gyógyszerekhez, UCUM egységekhez, és SNOMED CT licencköteles módon.

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

Amit a platform tárol, és amit az Anpheros Daily (a betegalkalmazás) az API-n keresztül ír. Az alkalmazások bármilyen
FHIR által megengedett kódrendszert használhatnak; ez az oldal felsorolja, melyeket a platform felismer (megjelenítési keresés,
IPS ellenőrzések, kontextus-motor), és melyeket az Anpheros maga használ. Utolsó frissítés: 2026. szeptember 22.

| Erőforrás | Elem | Kódrendszerek | Megjegyzések |
|---|---|---|---|
| Observation (vital-signs) | `code` | LOINC (`http://loinc.org`) | 8867-4 pulzus, 85354-9 vérnyomás panel (8480-6 / 8462-4 komponensek), 8310-5 testhőmérséklet, 2339-0 glükóz, 29463-7 testtömeg, 39156-5 BMI, 59408-5 SpO₂, 8302-2 magasság |
| Observation (laboratory) | `code` | LOINC; helyi `urn:anpheros:lab`, ha nincs ismert LOINC | az Anpheros Daily által leképezve; referenciatartomány a `referenceRange`-ben, dokumentum a `derivedFrom`-ban |
| Observation (symptom) | `code`, `category` | ICD-10 (`http://hl7.org/fhir/sid/icd-10`) R fejezet; kategória `urn:anpheros:observation-category\|symptom`; SNOMED CT licencköteles módon | a szabad szöveg a `code.text`-ben marad; intenzitás 1–10 a `valueQuantity`-ben (`{score}`). A 2026. október 13. előtt írt erőforrások tartalmazhatják a HL7 `observation-category` rendszert a `symptom` kóddal; szűrés kód (`category=symptom`) alapján, nem rendszer alapján. Csak a beteg által jelenlévőnek jelentett tünetek kerülnek rögzítésre önmagával kapcsolatban. |
| Observation (survey, wellbeing) | `code`, `component` | `urn:anpheros:wellbeing` (dimenzió: érzelmi / mentális / fizikai) | intenzitás komponensként `valueQuantity` `{score}`; megjegyzés a `note`-ben |
| Observation (activity, daily watch summaries) | `code` | LOINC: 40443-4 nyugalmi pulzus, 8867-4 pulzus (min/átlag/max komponensek), 80404-7 HRV (RMSSD), 59408-5 SpO₂, 41950-7 lépésszám, 41981-2 energia, 93832-4 alvásidőtartam, 93831-6 / 93830-8 alvási fázisok | `effectivePeriod` lefedi a napot; kategória `activity` |
| Condition | `code`, `severity`, `clinicalStatus` | ICD-10; SNOMED CT súlyosság (24484000 súlyos, 6736007 mérsékelt, 255604002 enyhe); `condition-clinical` | kategória `problem-list-item` |
| MedicationStatement | `medicationCodeableConcept` | ATC (`http://www.whocc.no/atc`); `code.text` = terméknév | kiterjesztés `daily-medication` alkalmazás-specifikus mezőkhöz |
| MedicationAdministration | `medicationCodeableConcept`, `supportingInformation` | ATC; a kezelési terv mint `MedicationStatement/{id}` a `supportingInformation`-ban (keresési paraméter `statement`) | egy erőforrás dózisonként, amit bevettek vagy kihagytak (`status` teljesítve / nem történt meg) |
| Immunization | `vaccineCode` | ATC J07 (`http://www.whocc.no/atc`) vagy a nemzeti nómenklatúra; `vaccineCode.text` mindig megőrizve | `occurrenceDateTime` szükséges az IPS szakaszhoz; `protocolApplied.doseNumberPositiveInt` a dózishoz |
| AllergyIntolerance | `code`, `reaction.manifestation`, `criticality` | SNOMED CT (licencköteles módon) vagy csak `code.text`; ATC gyógyszerallergiákhoz | kategória étel / gyógyszer / környezet / biológiai |
| DocumentReference | `type` | LOINC dokumentumfajták (`DOC_KIND_LOINC` a `/v1`-ben) | |
| Encounter | `class`, `type` | v3-ActCode osztály; SNOMED CT típus, ha ismert | `episodeOfCare` → a terhesség / krónikus betegség / kezelés EpisodeOfCare-je |
| EpisodeOfCare | `type`, `diagnosis.condition` | `urn:anpheros:episode-type` (betegség / kezelés / terhesség / egyéb); `diagnosis.condition` → a Condition | egy az Anpheros Daily állapotokhoz ("dosar", 2026. szeptember 25.); `period` = kezdete → vége. Kapcsolt erőforrások a Condition-re mutatnak: `Observation.focus`, `MedicationStatement.reasonReference`, `DocumentReference.context.related`, `Appointment.reasonReference` (keresés: `focus`, `reason-reference`, `related`, `condition`) |
| Appointment | `serviceType` | `service-type` kódrendszer | |
| RelatedPerson | `relationship` | v3-RoleCode (MTH, FTH, CHILD, SPS, …) | |
| QuestionnaireResponse | `questionnaire` | kanonikus URL-ek a `https://anpheros.com/fhir/Questionnaire/` alatt | |
| Basic | `code` | `urn:anpheros:basic` | menekülőút; minden itt dokumentált kód használat előtt |
| Provenance | `agent.type` | `provenance-participant-type` | |

## Azonosítók és kiterjesztések

- Az Anpheros Daily sorok helyi azonosítói: `urn:anpheros:daily:{vital|medication|condition|episode|lab|symptom|document|weight|wellbeing|intake|immunization|allergy|health-day}`.
- Feltétel kiterjesztés `daily-condition` (2026. szeptember 25.): `kind` (betegség / kezelés / terhesség / egyéb), `color` (app színpaletta kulcs), `source`, `due_date` (terhesség). Az írásbeli kód nélküli terhesség ICD-10 `Z33` kódot kap.
- A kiterjesztések a `https://anpheros.com/fhir/StructureDefinition/daily-*` alatt találhatók (`daily-medication`, `daily-symptom`, `daily-condition`, …).
- A mértékegységek mindenhol UCUM (`http://unitsofmeasure.org`) formátumban vannak, ahol mennyiséget írunk.

## Tünetkoncepciók (2026.10.2-es kiadás, 2026. október 16.)

`GET /v1/terminology/symptoms?q=&icd10=&kind=symptom|finding|all&lang=&limit=&offset=` és
`GET /v1/terminology/symptoms/{concept_id}` az Anpheros tünetkoncepciókat szolgálják: stabil azonosító
(`SYM-0001`…, soha nem használható újra; rendszer `https://anpheros.com/fhir/CodeSystem/symptom`), az ICD-10 megfeleltetés annak
ekvivalenciájával (`equivalent`, vagy `broader`, ha az ICD-10 kód többet fed le, mint a koncepció), a címkék és a
találati kifejezések, amelyeket a koncepció szabad szövegben való megtalálására használnak.

- 86 koncepció: 70 tünet és 16 lelet (R70–R94). A tünetek az ICD-10 R00–R69 kódokat használják, és ahol a WHO
  a tünetet máshová sorolja be, ott a WHO kódját: G47 alvási problémák, H53.2 kettős látás, H53.8 homályos látás
  (tágabb), H93.1 fülzúgás, K59.0 székrekedés, L29.9 viszketés, M25.5 ízületi fájdalom, M54 hátfájás.
- Minden kódot és angol címet ellenőriztek a WHO ICD-10 2019. évi böngészőjével 2026. október 15-én, beleértve
  annak beillesztési és kizárási megjegyzéseit; `icd10.display` a WHO címe.
- Minden koncepció megfeleltethető a **ICD-11 MMS 2025-01** kódnak is (`icd11`: kód, WHO cím, ekvivalencia
  `equivalent | wider | narrower | inexact`) and to a **body system** (`body_system`: the ICD-11 chapter 21 block of that code, e.g. `nervous`,
  `digestive`). A 21. fejezet tünetkódját használják a betegségkód helyett (fejfájás → MB4D, nem 8A8Z); minden
  eltérés a WHO ICD-10 → ICD-11 megfeleltetési táblától a `release.json`-ben van felsorolva (`icd11_departures`). Szűrés a
  `?icd11=MB4D` vagy `?body_system=digestive` segítségével.
- A címkék `review` státusszal rendelkeznek: `source` (a hivatalos WHO angol címe), `in_use` (a román címkék és
  találati kifejezések, amelyeket az Anpheros Daily használ) vagy `ai_reviewed` (laikus címkék 19 nyelven: gépi
  fordítások, amelyeket szóról szóra ellenőriztek a WHO címeivel, AI segítséggel, **nem** orvos vagy
  professzionális orvosi fordító által). `display` a preferált címke a `lang`-ben, egyébként a laikus címke,
  egyébként az angol; `display_lang` megmondja, melyik.
- Figyelmeztető jelek: 32 tétel 14 koncepcióhoz, szó szerint idézve a CDC és az NIDDK közkincs oldalakról, mindegyik
  forrásával, `review: source_verified` és egy nem-diagnózis megjegyzéssel. Nincsenek okok vagy állapotasszociációk. Minden koncepció
  visel `clinical_review: false`-t, amíg egy képzett orvos át nem tekinti a kiadást.
- Az adatok a `app/terminology/symptoms/`-ben találhatók (`concepts.csv`, `labels.csv`, `release.json` forrásokkal); a változás egy áttekintett commit és egy
  új kiadási szám.
- Az Anpheros Daily a koncepciót másodlagos kódolásként adja hozzá az ICD-10 mellett a tünetmegfigyeléseken.
- Áttekintés kérésekkel és válaszokkal: [Tünetadatok API](https://developers.anpheros.com/hu/guides/symptom-data-api).

### Ugyanazok a koncepciók FHIR terminológiaként (2026. október 15.)

Csak olvasható, ugyanabból a kiadásból, ugyanazzal a publikációs szabállyal (csak áttekintett címkék):

| Resource | Read | Notes |
|---|---|---|
| CodeSystem | `GET /fhir/R4/CodeSystem/anpheros-symptom`, `GET /fhir/R4/CodeSystem?url=https://anpheros.com/fhir/CodeSystem/symptom` | `content: complete`, `status: draft` amíg klinikailag át nem tekintik; tulajdonságok `kind`, `status`, `icd10`, `icd11`, `body_system`; román címkék, találati kifejezések és a laikus címkék megnevezésekként |
| CodeSystem/$lookup | `GET /fhir/R4/CodeSystem/$lookup?system=https://anpheros.com/fhir/CodeSystem/symptom&code=SYM-0047&displayLanguage=ro` | `Parameters` kijelzéssel, megnevezésekkel és tulajdonságokkal |
| ValueSet | `GET /fhir/R4/ValueSet/anpheros-symptoms`, `GET /fhir/R4/ValueSet/$expand?url=https://anpheros.com/fhir/ValueSet/anpheros-symptoms&filter=&displayLanguage=&count=&offset=` | aktív tünetek (leletek kizárva) |
| ConceptMap | `GET /fhir/R4/ConceptMap/anpheros-symptom-to-icd10` | `equivalent`, vagy `wider`, ha az ICD-10 kód többet fed le, mint a koncepció (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` vagy `inexact`-el |

**Profil `anpheros-symptom`** (`POST /fhir/R4/Observation/$validate?profile=anpheros-symptom`, kanonikus
`https://anpheros.com/fhir/StructureDefinition/anpheros-symptom-observation`): kategória
`urn:anpheros:observation-category|symptom` (a HL7 `observation-category` kód elutasításra kerül), a személy szavai a `code.text`-ben, az Anpheros koncepció az ICD-10 kódnak
megfelelően, alany = Patient, státusz final / amended / corrected / entered-in-error, effective[x] `effectivePeriod.end`-tal nem
korábban, mint `start`, intenzitás UCUM `{score}` 0–10. Mint a többi profil, ez is jelent problémákat és nem
utasítja el a beírásokat.

## Licences

LOINC, ATC (WHO), ICD-10 (WHO) és UCUM nyilvános licencük alatt használatosak. A SNOMED CT nemzeti vagy társult licencet igényel: a leképezési táblák a kóddal együtt érkeznek, de a SNOMED kódok csak akkor íródnak ki, ha a `TERMINOLOGY_SNOMED_ENABLED` be van kapcsolva (a romániai licenc függőben).

Hogyan lehet adatokat különböző forrásokból ezekre a kódrendszerekre leképezni, egységekkel, dátumokkal és validálással: [Orvosi adatok normalizálása](https://developers.anpheros.com/hu/guides/normalize-medical-data).

Hol lehet ezeket a kódrendszereket megkeresni, és mit fed le a mellékelt részhalmaz: [Medical terminology API](https://developers.anpheros.com/hu/guides/medical-terminology-api).