# Kódy systémů FHIR

> Které kódy systémů používá každý typ zdroje FHIR: LOINC pro měření a laboratorní výsledky, ICD-10 pro stavy, ATC pro léky, UCUM jednotky a SNOMED CT za licenční vlajkou.

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

Co platforma ukládá a co Anpheros Daily (pacientská aplikace) zapisuje prostřednictvím API. Aplikace mohou používat jakýkoli kódový systém, který FHIR umožňuje; tato stránka uvádí, které platforma rozpoznává (zobrazení vyhledávání, kontroly IPS, kontextový engine) a které používá Anpheros sám. Poslední aktualizace 22. září 2026.

| Zdroj | Prvek | Kódy systémů | Poznámky |
|---|---|---|---|
| Observation (vital-signs) | `code` | LOINC (`http://loinc.org`) | 8867-4 srdeční frekvence, 85354-9 panel krevního tlaku (8480-6 / 8462-4 složky), 8310-5 tělesná teplota, 2339-0 glukóza, 29463-7 tělesná hmotnost, 39156-5 BMI, 59408-5 SpO₂, 8302-2 výška |
| Observation (laboratory) | `code` | LOINC; lokální `urn:anpheros:lab`, pokud není znám LOINC | mapováno 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; kategorie `urn:anpheros:observation-category\|symptom`; SNOMED CT za vlajkou | volný text zůstává v `code.text`; intenzita 1–10 v `valueQuantity` (`{score}`). Zdroje zapsané před 13. říjnem 2026 mohou obsahovat systém HL7 `observation-category` s kódem `symptom`; filtrujte podle kódu (`category=symptom`), nikoli podle systému. Zapisují se pouze symptomy, které pacient hlásí jako přítomné, týkající se sebe sama |
| Observation (survey, wellbeing) | `code`, `component` | `urn:anpheros:wellbeing` (dimenze: emoční / duševní / fyzická) | intenzita jako složka `valueQuantity` `{score}`; poznámka v `note` |
| Observation (activity, daily watch summaries) | `code` | LOINC: 40443-4 klidová srdeční frekvence, 8867-4 srdeční frekvence (min/průměr/max složky), 80404-7 HRV (RMSSD), 59408-5 SpO₂, 41950-7 kroky, 41981-2 energie, 93832-4 délka spánku, 93831-6 / 93830-8 fáze spánku | `effectivePeriod` pokrývá den; kategorie `activity` |
| Condition | `code`, `severity`, `clinicalStatus` | ICD-10; SNOMED CT závažnost (24484000 těžká, 6736007 střední, 255604002 mírná); `condition-clinical` | kategorie `problem-list-item` |
| MedicationStatement | `medicationCodeableConcept` | ATC (`http://www.whocc.no/atc`); `code.text` = název produktu | rozšíření `daily-medication` pro pole specifická pro aplikaci |
| MedicationAdministration | `medicationCodeableConcept`, `supportingInformation` | ATC; léčebný plán jako `MedicationStatement/{id}` v `supportingInformation` (vyhledávací parametr `statement`) | jeden zdroj na podanou nebo vynechanou dávku (`status` dokončeno / nedokončeno) |
| Immunization | `vaccineCode` | ATC J07 (`http://www.whocc.no/atc`) nebo národní nomenklatura; `vaccineCode.text` vždy zachováno | `occurrenceDateTime` požadováno pro sekci IPS; `protocolApplied.doseNumberPositiveInt` pro dávku |
| AllergyIntolerance | `code`, `reaction.manifestation`, `criticality` | SNOMED CT (za vlajkou) nebo pouze `code.text`; ATC pro alergie na léky | kategorie potraviny / léky / prostředí / biologické |
| DocumentReference | `type` | typy dokumentů LOINC (`DOC_KIND_LOINC` v `/v1`) | |
| Encounter | `class`, `type` | třída v3-ActCode; SNOMED CT typ, pokud je znám | `episodeOfCare` → EpisodeOfCare těhotenství / dlouhodobé nemoci / léčby |
| EpisodeOfCare | `type`, `diagnosis.condition` | `urn:anpheros:episode-type` (nemoc / léčba / těhotenství / jiné); `diagnosis.condition` → Condition | jeden na stav Anpheros Daily ("dosar", 25. září 2026); `period` = začátek → konec. Propojené zdroje odkazují na Condition: `Observation.focus`, `MedicationStatement.reasonReference`, `DocumentReference.context.related`, `Appointment.reasonReference` (vyhledávání: `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ý zde před použitím |
| Provenance | `agent.type` | `provenance-participant-type` | |

## Identifikátory a rozšíření

- Lokální identifikátory řádků Anpheros Daily: `urn:anpheros:daily:{vital|medication|condition|episode|lab|symptom|document|weight|wellbeing|intake|immunization|allergy|health-day}`.
- Rozšíření pro stav `daily-condition` (25 Sep 2026): `kind` (nemoc / léčba / těhotenství / jiné), `color` (klíč palety aplikací), `source`, `due_date` (těhotenství). Těhotenství bez zapsaného kódu nese ICD-10 `Z33`.
- Rozšíření se nacházejí pod `https://anpheros.com/fhir/StructureDefinition/daily-*` (`daily-medication`, `daily-symptom`, `daily-condition`, …).
- Jednotky jsou UCUM (`http://unitsofmeasure.org`) všude tam, kde je zapsána hodnota.

## Koncepty symptomů (verze 2026.10.2, 16. října 2026)

`GET /v1/terminology/symptoms?q=&icd10=&kind=symptom|finding|all&lang=&limit=&offset=` a `GET /v1/terminology/symptoms/{concept_id}` slouží konceptům symptomů Anpheros: stabilní identifikátor (`SYM-0001`…, nikdy znovu použitý; systém `https://anpheros.com/fhir/CodeSystem/symptom`), mapování ICD-10 s jeho ekvivalencí (`equivalent`, nebo `broader`, když kód ICD-10 pokrývá více než koncept), popisky a vyhledávací termíny používané k nalezení konceptu v běžném textu.

- 86 konceptů: 70 symptomů a 16 nálezů (R70–R94). Symptomy používají ICD-10 R00–R69 a tam, kde WHO klasifikuje symptom jinde, kód WHO: G47 problémy se spánkem, H53.2 dvojité vidění, H53.8 rozmazané vidění (širší), H93.1 tinnitus, K59.0 zácpa, L29.9 svědění, M25.5 bolest kloubů, M54 bolest zad.
- Každý kód a anglický název byl 15. října 2026 zkontrolován proti prohlížeči WHO ICD-10 Verze 2019, včetně jeho poznámek o zahrnutí a vyloučení; `icd10.display` je název WHO.
- Každý koncept je také mapován na **ICD-11 MMS 2025-01** (`icd11`: kód, název WHO, ekvivalence `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žívá se kód symptomu z kapitoly 21 namísto kódu nemoci (bolest hlavy → MB4D, nikoli 8A8Z); každé odchylka od mapovací tabulky WHO ICD-10 → ICD-11 je uvedena v `release.json` (`icd11_departures`). Filtrujte pomocí `?icd11=MB4D` nebo `?body_system=digestive`.
- Popisky nesou status `review`: `source` (oficiální anglický název WHO), `in_use` (rumunské popisky a vyhledávací termíny, které Anpheros Daily používá) nebo `ai_reviewed` (laické popisky v 19 jazycích: strojové překlady revidované termín po termínu proti názvům WHO s pomocí AI, **nikoli** lékařem nebo profesionálním lékařským překladatelem). `display` je preferovaný popisek v `lang`, jinak laický popisek, jinak angličtina; `display_lang` říká který.
- Varovné příznaky: 32 položek pro 14 konceptů, citováno slovo od slova ze stránek CDC a NIDDK ve veřejné doméně, každá s uvedením zdroje, `review: source_verified` a poznámkou "není diagnóza". Žádné příčiny ani asociace s onemocněním. Každý koncept nese `clinical_review: false`, dokud vydání nezkontroluje kvalifikovaný lékař.
- Data se nacházejí v `app/terminology/symptoms/` (`concepts.csv`, `labels.csv`, `release.json` se zdroji); změna je revidovaný commit a nové číslo vydání.
- Anpheros Daily přidává koncept jako druhé kódování vedle ICD-10 na symptom Observations.
- Návod s požadavky a odpověďmi: [Symptom data API](https://developers.anpheros.com/cs/guides/symptom-data-api).

### Stejné koncepty jako terminologie FHIR (15. října 2026)

Pouze pro čtení, ze stejného vydání, se stejným pravidlem publikace (pouze revidované popisky):

| 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` do klinické revize; vlastnosti `kind`, `status`, `icd10`, `icd11`, `body_system`; rumunské popisky, vyhledávací termíny a laické popisky jako označení |
| CodeSystem/$lookup | `GET /fhir/R4/CodeSystem/$lookup?system=https://anpheros.com/fhir/CodeSystem/symptom&code=SYM-0047&displayLanguage=ro` | `Parameters` s displejem, označeními a vlastnostmi |
| ValueSet | `GET /fhir/R4/ValueSet/anpheros-symptoms`, `GET /fhir/R4/ValueSet/$expand?url=https://anpheros.com/fhir/ValueSet/anpheros-symptoms&filter=&displayLanguage=&count=&offset=` | aktivní symptomy (nálezy vyloučeny) |
| ConceptMap | `GET /fhir/R4/ConceptMap/anpheros-symptom-to-icd10` | `equivalent`, nebo `wider`, když kód ICD-10 pokrývá více než 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` nebo `inexact` |

**Profil `anpheros-symptom`** (`POST /fhir/R4/Observation/$validate?profile=anpheros-symptom`, kanonický `https://anpheros.com/fhir/StructureDefinition/anpheros-symptom-observation`): kategorie `urn:anpheros:observation-category|symptom` (kód HL7 `observation-category` je zamítnut), slova osoby v `code.text`, koncept Anpheros v souladu s kódem ICD-10, předmět = Patient, status final / amended / corrected / entered-in-error, effective[x] s `effectivePeriod.end` ne dříve než `start`, intenzita jako UCUM `{score}` 0–10. Stejně jako ostatní profily hlásí problémy a neodmítá zápisy.

## Licence

LOINC, ATC (WHO), ICD-10 (WHO) a UCUM jsou používány pod jejich veřejnými licencemi. SNOMED CT vyžaduje
národní nebo přidruženou licenci: mapovací tabulky jsou dodávány s kódem, ale SNOMED kódy jsou zapisovány pouze tehdy, když je `TERMINOLOGY_SNOMED_ENABLED` zapnuto (čeká se na licenci pro Rumunsko).

Jak mapovat data z různých zdrojů do těchto kódových systémů, s jednotkami, daty a validací: [Jak normalizovat lékařská data](https://developers.anpheros.com/cs/guides/normalize-medical-data).

Kde hledat tyto kódové systémy a co pokrývá přiložená podmnožina: [API pro lékařskou terminologii](https://developers.anpheros.com/cs/guides/medical-terminology-api).