SMART on FHIR 技術文件

本頁面提供 ThTxGNN SMART App 的技術規格，供開發者和 IT 人員參考。

技術規格

SMART on FHIR 配置

項目 值
FHIR 版本 R4
Client ID thtxgnn-smart-app
Launch URI /smart/launch.html
Redirect URI /smart/app.html
授權方式 OAuth 2.0 with PKCE

請求的權限範圍（Scopes） 

launch
patient/MedicationRequest.read
patient/MedicationStatement.read
openid
fhirUser

藥物映射流程

EHR MedicationRequest
1. 提取 RxCUI
RxNorm 藥物代碼
2. RxNorm API
取得藥物成分名
3. 名稱正規化
移除鹽類後綴、同義詞對照
4. Fuse.js 模糊比對
比對 ThTxGNN 資料庫
顯示老藥新用候選

FHIR API

ThTxGNN 提供靜態 FHIR API，讓其他系統可以查詢藥物預測資料。

端點

端點 說明
/fhir/metadata CapabilityStatement
/fhir/MedicationKnowledge/{id}.json 單一藥物資源
/fhir/Bundle/all-predictions.json 全部預測結果

範例 

# 取得 Warfarin 的藥物知識資源
curl https://thtxgnn.yao.care/fhir/MedicationKnowledge/warfarin.json

測試環境

使用 SMART Health IT Launcher 測試

  1. 前往 SMART Launcher
  2. 設定：
    • Launch Type: Provider EHR Launch
    • FHIR Version: R4
    • App Launch URL: https://thtxgnn.yao.care/smart/launch.html
  3. 選擇測試病患
  4. 點擊 Launch 開始測試

支援的 EHR 系統

理論上支援所有符合 SMART on FHIR R4 標準的 EHR 系統，包括：

  • Epic
  • Cerner (Oracle Health)
  • Allscripts
  • 其他 FHIR R4 相容系統

隱私與安全

  • 無資料儲存：應用程式不會在伺服器端儲存任何病患資料
  • 純前端處理：所有資料處理都在瀏覽器中進行
  • PKCE 保護：使用 OAuth 2.0 PKCE 流程確保授權安全
  • 最小權限：只請求必要的讀取權限

詳細資訊請參閱 隱私權政策

相關連結