FHIR Condition / Medication 工具 (FHIR Tools)¶

此類別工具將本地端的 ICD-10 診斷與台灣 FDA 藥品資料，轉換為 FHIR R4 Condition / Medication / MedicationKnowledge 資源，並提供基本驗證。進階的剖面 / 術語層級授權與驗證，請見 FHIR IG 工具。

維護模式：Condition 工具跟隨 icd 模組、Medication 工具跟隨 drug 模組。管理後台把該模組切到維護模式時，呼叫會立即回傳 isError 結果，錯誤碼 MODULE_MAINTENANCE（error.message 英文、error.message_zh 正體中文，error.module 為模組鍵），約 5 秒內生效；工具仍留在 tools/list 中。詳見 API 參考。

query_fhir_condition¶

由 ICD-10 診斷產生 FHIR R4 Condition 資源。

參數¶

參數名	型別	必填	說明	範例
`icd_code`	string	否	直接指定 ICD-10-CM 碼（路徑 A，支援全部欄位；與 `diagnosis_keyword` 擇一）	`"E11.9"`
`diagnosis_keyword`	string	否	診斷關鍵字（中英文），先搜尋 ICD 碼再產生資源（路徑 B；同時給兩者時以關鍵字為準）	`"第二型糖尿病"`
`patient_id`	string	否	連結的 Patient 參照，預設空字串	`"patient-001"`
`clinical_status`	string	否	`active`（預設）/ `inactive` / `resolved` / `remission`	`"resolved"`
`verification_status`	string	否	`confirmed`（預設）/ `provisional` / `differential` / `refuted`	`"provisional"`
`category`	string	否	`encounter-diagnosis`（預設）/ `problem-list-item`	`"problem-list-item"`
`severity`	string	否	嚴重程度	`"moderate"`
`onset_date`	string	否	發病日期	`"2026-01-15"`
`recorded_date`	string	否	記錄日期	`"2026-02-01"`
`additional_notes`	string	否	補充註記，寫入 `Condition.note`	`"追蹤中"`

icd_code 與 diagnosis_keyword 至少要給一個；兩者皆省略時回傳 {"error": "Provide either icd_code or diagnosis_keyword"}。路徑 B（關鍵字）只套用 patient_id、clinical_status、verification_status、severity，其餘欄位（category、日期、註記）只在路徑 A 生效。

用途¶

自動將 ICD-10-CM 碼映射至 Condition.code.coding，填入標準 system URI（http://hl7.org/fhir/sid/icd-10-cm）與疾病名稱，並依上述參數填入 clinicalStatus、verificationStatus、category、subject 等屬性。

validate_fhir_condition¶

驗證 FHIR Condition 資源的基本結構。

參數¶

參數名	型別	必填	說明
`condition_json`	string	是	待驗證的 Condition JSON 字串

回傳格式¶

{ "valid": true, "errors": [], "warnings": [] }

與 validate_fhir_medication 不同，這個工具的回傳沒有 resource_type，但多一個 warnings 陣列（例如缺少建議欄位時）。valid 只看 errors 是否為空，warnings 不影響判定。

query_fhir_medication¶

由台灣 FDA 藥品產生 FHIR R4 Medication 或 MedicationKnowledge 資源。

參數¶

參數名	型別	必填	說明	範例
`keyword`	string	否	藥品關鍵字，先搜尋再產生資源（路徑 B；與 `license_id` 擇一）	`"普拿疼"`
`license_id`	string	否	許可證字號（路徑 A；同時給兩者時以許可證字號為準）	`"衛署藥製字第000480號"`
`resource_type`	string	否	`Medication`（預設）或 `MedicationKnowledge`	`"MedicationKnowledge"`

用途¶

編碼採用 TFDA 許可證字號 CodeSystem（https://mcp.fda.gov.tw/fhir/CodeSystem/tfda-license-id），並帶入成分資訊。資源只由正規化的 TFDA 資料產生，不使用 RxNorm。

validate_fhir_medication¶

驗證 FHIR Medication 資源的基本結構。

參數¶

參數名	型別	必填	說明
`medication_json`	string	是	待驗證的 Medication JSON 字串

回傳格式¶

{ "valid": true, "resource_type": "Medication", "errors": [] }

這兩個驗證工具僅做基本結構與必填欄位檢查。需要剖面一致性（IG conformance）驗證時，請改用 fhir_validate_resource / fhir_validate_bundle。