# FHIR コードシステム

> 各 FHIR リソースタイプが使用するコードシステム: LOINC (測定および検査結果)、ICD-10 (病状)、ATC (医薬品)、UCUM (単位)、SNOMED CT (ライセンスフラグ経由)。

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

プラットフォームが保存するものと、Anpheros Daily (患者アプリ) が API を通じて書き込むものです。アプリケーションは FHIR で許可されている任意のコードシステムを使用できます。このページでは、プラットフォームが認識するもの (表示ルックアップ、IPS チェック、コンテキストエンジン) と、Anpheros 自体が使用するものを示します。最終更新日: 2026 年 9 月 22 日。

| リソース | 要素 | コードシステム | 備考 |
|---|---|---|---|
| Observation (バイタルサイン) | `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 (検査) | `code` | LOINC; LOINC が不明な場合はローカル `urn:anpheros:lab` | Anpheros Daily によってマッピング済み。基準範囲は `referenceRange`、ドキュメントは `derivedFrom` |
| Observation (症状) | `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 (調査、ウェルビーイング) | `code`, `component` | `urn:anpheros:wellbeing` (次元: 感情的 / 精神的 / 身体的) | 強度はコンポーネント `valueQuantity` `{score}` として、メモは `note` に格納 |
| Observation (活動、日次監視サマリー) | `code` | LOINC: 40443-4 安静時心拍数、8867-4 心拍数 (最小/平均/最大コンポーネント)、80404-7 HRV (RMSSD)、59408-5 SpO₂、41950-7 歩数、41981-2 エネルギー、93832-4 睡眠時間、93831-6 / 93830-8 睡眠段階 | `effectivePeriod` は 1 日をカバーし、カテゴリは `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`) | 服用またはスキップされた用量ごとに 1 つのリソース (`status` 完了 / 未実施) |
| Immunization | `vaccineCode` | ATC J07 (`http://www.whocc.no/atc`) または国内命名法; `vaccineCode.text` は常に保持 | IPS セクションには `occurrenceDateTime` が必要。用量には `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 日) ごとに 1 つ。`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` | |

## Identifiers and extensions

- Anpheros Daily のローカル識別子: `urn:anpheros:daily:{vital|medication|condition|episode|lab|symptom|document|weight|wellbeing|intake|immunization|allergy|health-day}`。
- Condition extension `daily-condition` (2026年9月25日): `kind` (illness / treatment / pregnancy / other), `color` (app palette key), `source`, `due_date` (pregnancy)。記述されたコードがない妊娠は、ICD-10 `Z33` を持ちます。
- Extensions は `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`、または ICD-10 コードが概念以上の範囲をカバーする場合 `broader`)、ラベル、および自由テキストで概念を見つけるために使用される一致用語です。

- 86 概念: 70 の症状と 16 の所見 (R70–R94)。症状は ICD-10 R00–R69 を使用し、WHO が症状を elsewhere で分類する場合は WHO コードを使用します: G47 睡眠障害、H53.2 複視、H53.8 視力ぼやけ (より広範)、H93.1 耳鳴り、K59.0 便秘、L29.9 かゆみ、M25.5 関節痛、M54 腰痛。
- すべてのコードと英語のタイトルは、2026年10月15日に WHO ICD-10 Version 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`) にもマッピングされます。疾患コード (headache → MB4D、8A8Z ではない) ではなく、第 21 章の症状コードが使用されます。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` はどのラベルが優先されるかを示します。
- 警告サイン: 14 概念に対する 32 アイテム。CDC および NIDDK のパブリックドメインページからそのまま引用され、各項目にはソース、`review: source_verified`、および「診断ではない」という注記が付いています。原因や疾患の関連はありません。すべての概念には、資格のある臨床医がリリースをレビューするまで `clinical_review: false` が付与されます。
- データは `app/terminology/symptoms/` (`concepts.csv`、`labels.csv`、`release.json`、ソース付き) に存在します。変更はレビューされたコミットと新しいリリース番号です。
- Anpheros Daily は、症状の Observation に ICD-10 の横に 2 番目のコーディングとして概念を追加します。
- リクエストとレスポンスを使用したウォークスルー: [Symptom data API](https://developers.anpheros.com/ja/guides/symptom-data-api)。

### FHIR 用語としての同じ概念 (2026年10月15日)

読み取り専用で、同じリリースから、同じ公開ルール (レビュー済みのラベルのみ) で提供されます。

| リソース | 読み取り | 注記 |
|---|---|---|
| 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` | display、designation、およびプロパティ付きの `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`、または ICD-10 コードが概念以上の範囲をカバーする場合 `wider` (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` コードは拒否されます)、`code.text` での患者の言葉、ICD-10 コードと一致する Anpheros 概念、subject = Patient、status final / amended / corrected / entered-in-error、effective[x] は `start` より早くない `effectivePeriod.end`、intensity は UCUM `{score}` 0–10。他のプロファイルと同様に、問題が報告され、書き込みは拒否されません。

## ライセンス

LOINC、ATC (WHO)、ICD-10 (WHO)、UCUM は、それぞれの公開ライセンスの下で使用されます。SNOMED CT には、国内または提携ライセンスが必要です。マッピングテーブルはコードと共に提供されますが、SNOMED コードは `TERMINOLOGY_SNOMED_ENABLED` がオンの場合にのみ書き込まれます（ルーマニアのライセンス待ち）。

異なるソースからのデータをこれらのコードシステムにマッピングする方法（単位、日付、検証を含む）：[医療データの正規化方法](https://developers.anpheros.com/ja/guides/normalize-medical-data)。

これらのコードシステムを検索する場所と、バンドルされたサブセットがカバーする内容：[医療用語 API](https://developers.anpheros.com/ja/guides/medical-terminology-api)。
