# FHIR code systems

> Какие кодовые системы использует каждый тип FHIR-ресурса: LOINC для измерений и лабораторных результатов, ICD-10 для состояний, ATC для медикаментов, UCUM для единиц измерения, а SNOMED CT — за лицензионным флагом.

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

Что платформа хранит и что Anpheros Daily (приложение для пациентов) записывает через API. Приложения могут использовать любую
кодовую систему, которую разрешает FHIR; на этой странице указано, какие из них платформа распознает (для поиска отображаемых значений,
проверок IPS, контекстного движка) и какие использует сам Anpheros. Последнее обновление: 22 сентября 2026 г.

| Resource | Element | Code systems | Notes |
|---|---|---|---|
| Observation (vital-signs) | `code` | LOINC (`http://loinc.org`) | 8867-4 частота сердечных сокращений, 85354-9 панель артериального давления (компоненты 8480-6 / 8462-4), 8310-5 температура тела, 2339-0 глюкоза, 29463-7 масса тела, 39156-5 ИМТ, 59408-5 SpO₂, 8302-2 рост |
| Observation (laboratory) | `code` | LOINC; локальная `urn:anpheros:lab`, когда LOINC неизвестен | сопоставлено Anpheros Daily; диапазон ссылок в `referenceRange`, документ в `derivedFrom` |
| Observation (symptom) | `code`, `category` | ICD-10 (`http://hl7.org/fhir/sid/icd-10`) глава R; категория `urn:anpheros:observation-category\|symptom`; SNOMED CT за флагом | свободный текст остается в `code.text`; интенсивность от 1 до 10 в `valueQuantity` (`{score}`). Ресурсы, записанные до 13 октября 2026 г., могут содержать систему HL7 `observation-category` с кодом `symptom`; фильтровать по коду (`category=symptom`), а не по системе. Записываются только симптомы, которые пациент сообщает как присутствующие, касающиеся себя |
| Observation (survey, wellbeing) | `code`, `component` | `urn:anpheros:wellbeing` (измерение: эмоциональное / психическое / физическое) | интенсивность как компонент `valueQuantity` `{score}`; примечание в `note` |
| Observation (activity, daily watch summaries) | `code` | LOINC: 40443-4 ЧСС в покое, 8867-4 ЧСС (компоненты мин/ср/макс), 80404-7 ВСР (RMSSD), 59408-5 SpO₂, 41950-7 шаги, 41981-2 энергия, 93832-4 продолжительность сна, 93831-6 / 93830-8 стадии сна | `effectivePeriod` охватывает день; категория `activity` |
| Condition | `code`, `severity`, `clinicalStatus` | ICD-10; SNOMED CT тяжесть (24484000 тяжелая, 6736007 умеренная, 255604002 легкая); `condition-clinical` | категория `problem-list-item` |
| MedicationStatement | `medicationCodeableConcept` | ATC (`http://www.whocc.no/atc`); `code.text` = название продукта | расширение `daily-medication` для полей, специфичных для приложения |
| MedicationAdministration | `medicationCodeableConcept`, `supportingInformation` | ATC; план лечения как `MedicationStatement/{id}` в `supportingInformation` (параметр поиска `statement`) | один ресурс на принятую или пропущенную дозу (`status` выполнено / не выполнено) |
| Immunization | `vaccineCode` | ATC J07 (`http://www.whocc.no/atc`) или национальная номенклатура; `vaccineCode.text` всегда сохраняется | `occurrenceDateTime` требуется для раздела IPS; `protocolApplied.doseNumberPositiveInt` для дозы |
| AllergyIntolerance | `code`, `reaction.manifestation`, `criticality` | SNOMED CT (за флагом) или только `code.text`; ATC для аллергии на лекарства | категория еда / лекарства / окружающая среда / биологическая |
| DocumentReference | `type` | типы документов LOINC (`DOC_KIND_LOINC` в `/v1`) | |
| Encounter | `class`, `type` | класс v3-ActCode; SNOMED CT тип, когда известен | `episodeOfCare` → EpisodeOfCare беременности / хронического заболевания / лечения |
| EpisodeOfCare | `type`, `diagnosis.condition` | `urn:anpheros:episode-type` (заболевание / лечение / беременность / другое); `diagnosis.condition` → Condition | один на состояние Anpheros Daily ("dosar", 25 сентября 2026 г.); `period` = начало → конец. Связанные ресурсы указывают на Condition: `Observation.focus`, `MedicationStatement.reasonReference`, `DocumentReference.context.related`, `Appointment.reasonReference` (поиск: `focus`, `reason-reference`, `related`, `condition`) |
| Appointment | `serviceType` | кодовая система `service-type` | |
| RelatedPerson | `relationship` | v3-RoleCode (MTH, FTH, CHILD, SPS, …) | |
| QuestionnaireResponse | `questionnaire` | канонические URL в разделе `https://anpheros.com/fhir/Questionnaire/` | |
| Basic | `code` | `urn:anpheros:basic` | запасной вариант; каждый код документируется здесь перед использованием |
| Provenance | `agent.type` | `provenance-participant-type` | |

## Идентификаторы и расширения

- Локальные идентификаторы строк Anpheros Daily: `urn:anpheros:daily:{vital|medication|condition|episode|lab|symptom|document|weight|wellbeing|intake|immunization|allergy|health-day}`.
- Расширение для состояния `daily-condition` (25 сен 2026): `kind` (болезнь / лечение / беременность / другое), `color` (ключ цветовой палитры приложения), `source`, `due_date` (беременность). Беременность без письменного кода несет ICD-10 `Z33`.
- Расширения находятся в `https://anpheros.com/fhir/StructureDefinition/daily-*` (`daily-medication`, `daily-symptom`, `daily-condition`, …).
- Единицы измерения — UCUM (`http://unitsofmeasure.org`) везде, где указано количество.

## Концепции симптомов (релиз 2026.10.2, 16 октября 2026 г.)

`GET /v1/terminology/symptoms?q=&icd10=&kind=symptom|finding|all&lang=&limit=&offset=` и `GET /v1/terminology/symptoms/{concept_id}` служат концепциями симптомов Anpheros: стабильный идентификатор (`SYM-0001`…, никогда не повторяется; система `https://anpheros.com/fhir/CodeSystem/symptom`), сопоставление ICD-10 с его эквивалентностью (`equivalent` или `broader`, когда код ICD-10 охватывает больше, чем концепция), метки и термины для поиска концепции в свободном тексте.

- 86 концепций: 70 симптомов и 16 признаков (R70–R94). Симптомы используют ICD-10 R00–R69 и, где ВОЗ классифицирует симптом иначе, код ВОЗ: G47 проблемы со сном, H53.2 двоение в глазах, H53.8 нечеткое зрение (более широкое), H93.1 шум в ушах, K59.0 запор, L29.9 зуд, M25.5 боль в суставах, M54 боль в спине.
- Каждый код и английское название были проверены по браузеру ВОЗ ICD-10 Версия 2019 от 15 октября 2026 г., включая примечания о включении и исключении; `icd10.display` — это название ВОЗ.
- Каждая концепция также сопоставляется с **ICD-11 MMS 2025-01** (`icd11`: код, название ВОЗ, эквивалентность `equivalent | wider | narrower | inexact`) and to a **body system** (`body_system`: the ICD-11 chapter 21 block of that code, e.g. `nervous`, `digestive`). Используется код симптома из главы 21, а не код заболевания (головная боль → MB4D, а не 8A8Z); каждое отклонение от таблицы сопоставления ВОЗ ICD-10 → ICD-11 перечислено в `release.json` (`icd11_departures`). Фильтруйте с помощью `?icd11=MB4D` или `?body_system=digestive`.
- Метки имеют статус `review`: `source` (официальное английское название ВОЗ), `in_use` (румынские метки и термины для поиска, используемые Anpheros Daily) или `ai_reviewed` (обычные метки на 19 языках: машинные переводы, проверенные термин за термином по названиям ВОЗ с помощью ИИ, **не** врачом или профессиональным медицинским переводчиком). `display` — предпочтительная метка в `lang`, иначе обычная метка, иначе английская; `display_lang` указывает, какая именно.
- Предупреждающие знаки: 32 элемента для 14 концепций, дословно цитируемые со страниц CDC и NIDDK, находящихся в общественном достоянии, каждый с указанием источника, `review: source_verified` и примечанием "не является диагнозом". Нет причин или ассоциаций с заболеваниями. Каждая концепция несет `clinical_review: false` до тех пор, пока квалифицированный врач не проверит релиз.
- Данные находятся в `app/terminology/symptoms/` (`concepts.csv`, `labels.csv`, `release.json` с источниками); изменение — это проверенный коммит и новый номер релиза.
- Anpheros Daily добавляет концепцию в качестве второго кодирования рядом с ICD-10 в наблюдениях за симптомами.
- Пошаговое руководство с запросами и ответами: [API данных о симптомах](https://developers.anpheros.com/ru/guides/symptom-data-api).

### Те же концепции в виде терминологии FHIR (15 октября 2026 г.)

Только для чтения, из того же релиза, с тем же правилом публикации (только проверенные метки):

| Ресурс | Чтение | Примечания |
|---|---|---|
| CodeSystem | `GET /fhir/R4/CodeSystem/anpheros-symptom`, `GET /fhir/R4/CodeSystem?url=https://anpheros.com/fhir/CodeSystem/symptom` | `content: complete`, `status: draft` до клинической проверки; свойства `kind`, `status`, `icd10`, `icd11`, `body_system`; румынские метки, термины для поиска и обычные метки в качестве обозначений |
| CodeSystem/$lookup | `GET /fhir/R4/CodeSystem/$lookup?system=https://anpheros.com/fhir/CodeSystem/symptom&code=SYM-0047&displayLanguage=ro` | `Parameters` с отображением, обозначениями и свойствами |
| ValueSet | `GET /fhir/R4/ValueSet/anpheros-symptoms`, `GET /fhir/R4/ValueSet/$expand?url=https://anpheros.com/fhir/ValueSet/anpheros-symptoms&filter=&displayLanguage=&count=&offset=` | активные симптомы (признаки исключены) |
| ConceptMap | `GET /fhir/R4/ConceptMap/anpheros-symptom-to-icd10` | `equivalent` или `wider`, когда код ICD-10 охватывает больше, чем концепция (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` или `inexact` |

**Профиль `anpheros-symptom`** (`POST /fhir/R4/Observation/$validate?profile=anpheros-symptom`, канонический `https://anpheros.com/fhir/StructureDefinition/anpheros-symptom-observation`): категория `urn:anpheros:observation-category|symptom` (код HL7 `observation-category` отклоняется), слова человека в `code.text`, концепция Anpheros, соответствующая коду ICD-10, субъект = Patient, статус final / amended / corrected / entered-in-error, effective[x] с `effectivePeriod.end` не ранее `start`, интенсивность как UCUM `{score}` 0–10. Как и другие профили, он сообщает об ошибках и не отклоняет записи.

## Лицензии

LOINC, ATC (WHO), ICD-10 (WHO) и UCUM используются в соответствии с их публичными лицензиями. SNOMED CT требует национальной или партнерской лицензии: таблицы сопоставления поставляются с кодом, но коды SNOMED записываются только при включенном `TERMINOLOGY_SNOMED_ENABLED` (в ожидании лицензии для Румынии).

Как сопоставить данные из различных источников с этими кодовыми системами, включая единицы измерения, даты и валидацию: [Как нормализовать медицинские данные](https://developers.anpheros.com/ru/guides/normalize-medical-data).

Где искать эти кодовые системы и что покрывает входящий в комплект набор: [API медицинской терминологии](https://developers.anpheros.com/ru/guides/medical-terminology-api).