# FHIR 代码系统

> 每个 FHIR 资源类型使用的代码系统：LOINC 用于测量和实验室结果，ICD-10 用于病症，ATC 用于药物，UCUM 用于单位，SNOMED CT 需要许可证。

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

平台存储的内容以及 Anpheros Daily（患者应用程序）通过 API 写入的内容。应用程序可以使用 FHIR 允许的任何代码系统；此页面说明了平台识别（显示查找、IPS 检查、上下文引擎）哪些代码系统以及 Anpheros 本身使用哪些代码系统。最后更新日期：2026 年 9 月 22 日。

| 资源 | 元素 | 代码系统 | 备注 |
|---|---|---|---|
| Observation (vital-signs) | `code` | LOINC (`http://loinc.org`) | 8867-4 心率，85354-9 血压面板（8480-6 / 8462-4 组件），8310-5 体温，2339-0 葡萄糖，29463-7 体重，39156-5 BMI，59408-5 SpO₂，8302-2 身高 |
| Observation (laboratory) | `code` | LOINC；未知 LOINC 时使用本地 `urn:anpheros:lab` | 由 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}`)。2026 年 10 月 13 日之前写入的资源可能包含 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 HRV (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”，2026 年 9 月 25 日）一个；`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` | `https://anpheros.com/fhir/Questionnaire/` 下的规范 URL | |
| 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}`。
- Condition 扩展 `daily-condition`（2026 年 9 月 25 日）：`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 版，2026 年 10 月 16 日)

`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，以及在 WHO 将症状分类到其他地方时，使用 WHO 代码：G47 睡眠问题，H53.2 复视，H53.8 视力模糊 (更广泛)，H93.1 耳鸣，K59.0 便秘，L29.9 瘙痒，M25.5 关节痛，M54 背痛。
- 所有代码和英文标题均于 2026 年 10 月 15 日与 WHO ICD-10 2019 版浏览器进行了核对，包括其包含和排除说明；`icd10.display` 是 WHO 标题。
- 每个概念还映射到 **ICD-11 MMS 2025-01** (`icd11`：代码、WHO 标题、等效性 `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)；所有偏离 WHO ICD-10 → ICD-11 映射表的条目均列在 `release.json` (`icd11_departures`) 中。使用 `?icd11=MB4D` 或 `?body_system=digestive` 进行筛选。
- 标签带有 `review` 状态：`source` (官方 WHO 英文标题)，`in_use` (Anpheros Daily 使用的罗马尼亚语标签和匹配词) 或 `ai_reviewed` (19 种语言的通俗标签：通过 AI 辅助逐项与 WHO 标题进行审查的机器翻译，**非**由临床医生或专业医学翻译进行)。`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 在症状 Observation 中将该概念作为 ICD-10 的第二个编码添加。
- 请求和响应的演练：[Symptom data API](https://developers.anpheros.com/zh/guides/symptom-data-api)。

### 与 FHIR 术语相同的概念 (2026 年 10 月 15 日)

只读，来自同一发布版本，具有相同的发布规则 (仅审查过的标签)：

| 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` 直至临床审查；属性 `kind`, `status`, `icd10`, `icd11`, `body_system`；罗马尼亚语标签、匹配词和通俗标签作为 designation |
| CodeSystem/$lookup | `GET /fhir/R4/CodeSystem/$lookup?system=https://anpheros.com/fhir/CodeSystem/symptom&code=SYM-0047&displayLanguage=ro` | `Parameters` 附带 display、designations 和 properties |
| 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` |

**Profile `anpheros-symptom`** (`POST /fhir/R4/Observation/$validate?profile=anpheros-symptom`, canonical `https://anpheros.com/fhir/StructureDefinition/anpheros-symptom-observation`)：category `urn:anpheros:observation-category|symptom` (HL7 `observation-category` 代码被拒绝)，person's words in `code.text`，与 ICD-10 代码一致的 Anpheros 概念，subject = Patient，status final / amended / corrected / entered-in-error，effective[x] with `effectivePeriod.end` not before `start`，intensity as UCUM `{score}` 0–10。与其他 profile 一样，它报告问题并且不拒绝写入。

## 许可证

LOINC、ATC (WHO)、ICD-10 (WHO) 和 UCUM 在其公共许可证下使用。SNOMED CT 需要国家或附属许可证：映射表随代码一起提供，但 SNOMED 代码仅在 `TERMINOLOGY_SNOMED_ENABLED` 开启时写入（待罗马尼亚许可证）。

如何将来自不同源的数据映射到这些代码系统，包括单位、日期和验证：[如何规范化医疗数据](https://developers.anpheros.com/zh/guides/normalize-medical-data)。

在哪里查找这些代码系统，以及捆绑的子集涵盖了哪些内容：[医学术语 API](https://developers.anpheros.com/zh/guides/medical-terminology-api)。