# Kódové systémy FHIR

> Ktoré kódové systémy používa každý typ FHIR zdroja: LOINC pre merania a laboratórne výsledky, ICD-10 pre diagnózy, ATC pre lieky, UCUM pre jednotky a SNOMED CT za licenčnou vlajkou.

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

Čo platforma ukladá a čo Anpheros Daily (pacientska aplikácia) zapisuje cez API. Aplikácie môžu používať akýkoľvek kódový systém, ktorý FHIR umožňuje; táto stránka uvádza, ktoré platforma rozpoznáva (zobrazovanie vyhľadávania, kontroly IPS, kontextový engine) a ktoré používa samotný Anpheros. Posledná aktualizácia 22. septembra 2026.

| Zdroj | Element | Kódové systémy | Poznámky |
|---|---|---|---|
| Observation (vital-signs) | `code` | LOINC (`http://loinc.org`) | 8867-4 srdcová frekvencia, 85354-9 panel krvného tlaku (komponenty 8480-6 / 8462-4), 8310-5 telesná teplota, 2339-0 glukóza, 29463-7 telesná hmotnosť, 39156-5 BMI, 59408-5 SpO₂, 8302-2 výška |
| Observation (laboratory) | `code` | LOINC; lokálne `urn:anpheros:lab`, keď nie je známe LOINC | mapované Anpheros Daily; referenčný rozsah v `referenceRange`, dokument v `derivedFrom` |
| Observation (symptom) | `code`, `category` | ICD-10 (`http://hl7.org/fhir/sid/icd-10`) kapitola R; kategória `urn:anpheros:observation-category\|symptom`; SNOMED CT za vlajkou | voľný text zostáva v `code.text`; intenzita 1–10 v `valueQuantity` (`{score}`). Zdroje zapísané pred 13. októbrom 2026 môžu niesť systém HL7 `observation-category` s kódom `symptom`; filtrovať podľa kódu (`category=symptom`), nie podľa systému. Zapisujú sa iba symptómy, ktoré pacient hlási ako prítomné, týkajúce sa seba samého |
| Observation (survey, wellbeing) | `code`, `component` | `urn:anpheros:wellbeing` (dimenzia: emocionálna / mentálna / fyzická) | intenzita ako komponent `valueQuantity` `{score}`; poznámka v `note` |
| Observation (activity, daily watch summaries) | `code` | LOINC: 40443-4 pokojová TF, 8867-4 TF (min/avg/max komponenty), 80404-7 HRV (RMSSD), 59408-5 SpO₂, 41950-7 kroky, 41981-2 energia, 93832-4 dĺžka spánku, 93831-6 / 93830-8 fázy spánku | `effectivePeriod` pokrýva deň; kategória `activity` |
| Condition | `code`, `severity`, `clinicalStatus` | ICD-10; SNOMED CT závažnosť (24484000 závažná, 6736007 stredná, 255604002 mierna); `condition-clinical` | kategória `problem-list-item` |
| MedicationStatement | `medicationCodeableConcept` | ATC (`http://www.whocc.no/atc`); `code.text` = názov produktu | rozšírenie `daily-medication` pre polia špecifické pre aplikáciu |
| MedicationAdministration | `medicationCodeableConcept`, `supportingInformation` | ATC; liečebný plán ako `MedicationStatement/{id}` v `supportingInformation` (vyhľadávací parameter `statement`) | jeden zdroj na dávku užitú alebo vynechanú (`status` dokončené / nedokončené) |
| Immunization | `vaccineCode` | ATC J07 (`http://www.whocc.no/atc`) alebo národná nomenklatúra; `vaccineCode.text` vždy zachované | `occurrenceDateTime` potrebné pre sekciu IPS; `protocolApplied.doseNumberPositiveInt` pre dávku |
| AllergyIntolerance | `code`, `reaction.manifestation`, `criticality` | SNOMED CT (za vlajkou) alebo iba `code.text`; ATC pre alergie na lieky | kategória potraviny / lieky / prostredie / biologické |
| DocumentReference | `type` | typy dokumentov LOINC (`DOC_KIND_LOINC` v `/v1`) | |
| Encounter | `class`, `type` | trieda v3-ActCode; SNOMED CT typ, ak je známy | `episodeOfCare` → EpisodeOfCare tehotenstva / dlhodobej choroby / liečby |
| EpisodeOfCare | `type`, `diagnosis.condition` | `urn:anpheros:episode-type` (choroba / liečba / tehotenstvo / iné); `diagnosis.condition` → Condition | jeden na podmienku Anpheros Daily ("dosar", 25. septembra 2026); `period` = začiatok → koniec. Prepojené zdroje odkazujú na Condition: `Observation.focus`, `MedicationStatement.reasonReference`, `DocumentReference.context.related`, `Appointment.reasonReference` (vyhľadávanie: `focus`, `reason-reference`, `related`, `condition`) |
| Appointment | `serviceType` | kódový systém `service-type` | |
| RelatedPerson | `relationship` | v3-RoleCode (MTH, FTH, CHILD, SPS, …) | |
| QuestionnaireResponse | `questionnaire` | kanonické URL pod `https://anpheros.com/fhir/Questionnaire/` | |
| Basic | `code` | `urn:anpheros:basic` | únikový poklop; každý kód zdokumentovaný tu pred použitím |
| Provenance | `agent.type` | `provenance-participant-type` | |

## Identifikátory a rozšírenia

- Lokálne identifikátory riadkov Anpheros Daily: `urn:anpheros:daily:{vital|medication|condition|episode|lab|symptom|document|weight|wellbeing|intake|immunization|allergy|health-day}`.
- Rozšírenie pre stav `daily-condition` (25 Sep 2026): `kind` (choroba / liečba / tehotenstvo / iné), `color` (kľúč palety aplikácie), `source`, `due_date` (tehotenstvo). Tehotenstvo bez písomného kódu nesie ICD-10 `Z33`.
- Rozšírenia sa nachádzajú pod `https://anpheros.com/fhir/StructureDefinition/daily-*` (`daily-medication`, `daily-symptom`, `daily-condition`, …).
- Jednotky sú UCUM (`http://unitsofmeasure.org`) všade tam, kde je napísané množstvo.

## Koncepty symptómov (verzia 2026.10.2, 16. októbra 2026)

`GET /v1/terminology/symptoms?q=&icd10=&kind=symptom|finding|all&lang=&limit=&offset=` a `GET /v1/terminology/symptoms/{concept_id}` slúžia konceptom symptómov Anpheros: stabilný identifikátor (`SYM-0001`…, nikdy sa nepoužije znovu; systém `https://anpheros.com/fhir/CodeSystem/symptom`), mapovanie ICD-10 s jeho ekvivalenciou (`equivalent`, alebo `broader`, keď kód ICD-10 pokrýva viac ako koncept), štítky a zodpovedajúce výrazy použité na nájdenie konceptu v voľnom texte.

- 86 konceptov: 70 symptómov a 16 nálezov (R70–R94). Symptómy používajú ICD-10 R00–R69 a tam, kde WHO klasifikuje symptóm inak, kód WHO: G47 problémy so spánkom, H53.2 dvojité videnie, H53.8 rozmazané videnie (širšie), H93.1 tinnitus, K59.0 zápcha, L29.9 svrbenie, M25.5 bolesť kĺbov, M54 bolesť chrbta.
- Každý kód a anglický názov bol skontrolovaný proti prehliadaču WHO ICD-10 Verzia 2019 dňa 15. októbra 2026, vrátane jeho poznámok o zahrnutí a vylúčení; `icd10.display` je názov WHO.
- Každý koncept sa tiež mapuje na **ICD-11 MMS 2025-01** (`icd11`: kód, názov WHO, 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`). Používa sa kód symptómu z kapitoly 21 namiesto kódu choroby (bolesť hlavy → MB4D, nie 8A8Z); každá odchýlka od mapovacej tabuľky WHO ICD-10 → ICD-11 je uvedená v `release.json` (`icd11_departures`). Filtrujte pomocou `?icd11=MB4D` alebo `?body_system=digestive`.
- Štítky nesú stav `review`: `source` (oficiálny anglický názov WHO), `in_use` (rumunské štítky a zodpovedajúce výrazy, ktoré Anpheros Daily používa) alebo `ai_reviewed` (laické štítky v 19 jazykoch: strojové preklady skontrolované termín po termíne oproti názvom WHO s pomocou AI, **nie** lekárom alebo profesionálnym lekárskym prekladateľom). `display` je preferovaný štítok v `lang`, inak laický štítok, inak anglický; `display_lang` uvádza ktorý.
- Varovné príznaky: 32 položiek pre 14 konceptov, citovaných slovo od slova zo stránok CDC a NIDDK vo verejnej doméne, každá so svojím zdrojom, `review: source_verified` a poznámkou „nie je to diagnóza“. Žiadne príčiny ani asociácie s ochoreniami. Každý koncept nesie `clinical_review: false`, kým vydanie skontroluje kvalifikovaný lekár.
- Dáta sa nachádzajú v `app/terminology/symptoms/` (`concepts.csv`, `labels.csv`, `release.json` so zdrojmi); zmena je skontrolovaný commit a nové číslo vydania.
- Anpheros Daily pridáva koncept ako druhé kódovanie vedľa ICD-10 pri pozorovaniach symptómov.
- Prehľad s požiadavkami a odpoveďami: [API dát symptómov](https://developers.anpheros.com/sk/guides/symptom-data-api).

### Rovnaké koncepty ako terminológia FHIR (15. októbra 2026)

Iba na čítanie, z rovnakého vydania, s rovnakým pravidlom publikovania (iba skontrolované štítky):

| Zdroj | Čítanie | Poznámky |
|---|---|---|
| CodeSystem | `GET /fhir/R4/CodeSystem/anpheros-symptom`, `GET /fhir/R4/CodeSystem?url=https://anpheros.com/fhir/CodeSystem/symptom` | `content: complete`, `status: draft` do klinickej kontroly; vlastnosti `kind`, `status`, `icd10`, `icd11`, `body_system`; rumunské štítky, zodpovedajúce výrazy a laické štítky ako označenia |
| CodeSystem/$lookup | `GET /fhir/R4/CodeSystem/$lookup?system=https://anpheros.com/fhir/CodeSystem/symptom&code=SYM-0047&displayLanguage=ro` | `Parameters` s displejom, označeniami a vlastnosťami |
| 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ívne symptómy (nálezy vylúčené) |
| ConceptMap | `GET /fhir/R4/ConceptMap/anpheros-symptom-to-icd10` | `equivalent`, alebo `wider`, keď kód ICD-10 pokrýva viac ako koncept (H53.8) |
| ConceptMap | `GET /fhir/R4/ConceptMap/anpheros-symptom-to-icd11` | ICD-11 MMS 2025-01 (`http://id.who.int/icd/release/11/mms`), s `equivalent`, `wider`, `narrower` alebo `inexact` |

**Profil `anpheros-symptom`** (`POST /fhir/R4/Observation/$validate?profile=anpheros-symptom`, kanonický `https://anpheros.com/fhir/StructureDefinition/anpheros-symptom-observation`): kategória `urn:anpheros:observation-category|symptom` (kód HL7 `observation-category` je zamietnutý), slová osoby v `code.text`, koncept Anpheros v súlade s kódom ICD-10, subjekt = Patient, stav final / amended / corrected / entered-in-error, effective[x] s `effectivePeriod.end` nie skôr ako `start`, intenzita ako UCUM `{score}` 0–10. Rovnako ako ostatné profily hlási problémy a neodmieta zápisy.

## Licencie

LOINC, ATC (WHO), ICD-10 (WHO) a UCUM sa používajú podľa ich verejných licencií. SNOMED CT vyžaduje
národnú alebo pridruženú licenciu: mapovacie tabuľky sa dodávajú s kódom, ale kódy SNOMED sa zapisujú iba vtedy, keď je zapnuté `TERMINOLOGY_SNOMED_ENABLED` (čaká sa na licenciu pre Rumunsko).

Ako namapovať dáta z rôznych zdrojov do týchto kódových systémov, s jednotkami, dátumami a validáciou: [Ako normalizovať lekárske dáta](https://developers.anpheros.com/sk/guides/normalize-medical-data).

Kde vyhľadať tieto kódové systémy a čo pokrýva priložená podmnožina: [API lekárskej terminológie](https://developers.anpheros.com/sk/guides/medical-terminology-api).