SNOMED CT 服務模組 (SNOMED Service)¶

模組概述¶

SNOMED CT 服務模組整合 SNOMED CT International 版術語，提供概念搜尋、概念詳情、關聯（階層與屬性）查詢，以及 SNOMED ↔ ICD-10 對應。SNOMED CT 是目前涵蓋面最廣的臨床術語系統，本模組讓系統能以標準概念表達臨床語意並與 ICD-10 互通。

以中英文關鍵字搜尋 SNOMED CT 概念，回傳 concept ID、FSN（完整指定名稱）與 preferred term。支援語意 / 混合搜尋（需可用的嵌入端點，於管理後台 整合 → 模型端點 設定，並先由 snomed_embed 回填向量），無嵌入時退回關鍵字。

以 concept ID 取得單一概念的完整資訊，包含： - FSN 與 preferred term - 祖先（ancestors）：沿 is-a 階層往上的概念與深度。 - 子概念（children）：直接子代概念。

取得某概念的所有關聯，依關聯類型（relationship type）分組，列出每個屬性的目標概念，例如 finding site、associated morphology 等。

雙向對應： - mode="icd"：輸入 ICD-10 碼（例如 E11.9），回傳對應的 SNOMED 概念。 - mode="snomed"：輸入 SNOMED concept ID（例如 44054006），回傳對應的 ICD-10 對照。

資料來源：SNOMED CT International RF2（SnomedCT_InternationalRF2_PRODUCTION_*.zip），於管理後台 醫療術語 → SNOMED CT 上傳並匯入（來源角色 snomed_ct，匯入階段 snomed_import）（資料量大，約 5–15 分鐘）。匯入時另保留 inactive concept 與 inactive／inactive concept 的英文描述（snomed.inactive_concepts、snomed.inactive_descriptions）、各元件首次發佈日（取自 RF2 Full 檔）及版本（snomed.editions），供 FHIR validator 以 tx.fhir.org 所用版本判定：inactive concept 為 warning、未知碼與 inactive 描述當 display 為 error。這些表不影響 SNOMED 查詢工具（仍只看 active concept）。歷史關聯（SAME AS / REPLACED BY …，snomed.historical_associations）則讓 inactive concept 能指向現行概念。
資料庫：snomed schema，含 concepts、descriptions、relationships、icd10_map、historical_associations 與 concept_embeddings。
術語瀏覽：模組頁的「資料預覽」分頁提供概念關聯圖（is-a 上下位、屬性關聯、ICD-10 對應；inactive concept 另顯示其歷史關聯），後端為 /admin/api/terminology/snomed/*（concept、children、search）。
可用性閘門：snomed.concepts 需達門檻（10 萬筆）才會註冊對應工具，否則自動降級。