🏥 SMART on FHIR 使用指南

ThTxGNN SMART App 可以從電子病歷系統（EHR）讀取病患用藥，自動查詢老藥新用候選。本指南提供兩種使用方式：獨立測試模式（推薦初學者）與 SMART Launcher 測試。

🎉 已上架 SMART App Gallery

ThTxGNN SMART App 已正式上架至 SMART Health IT App Gallery，這是全球最大的 SMART on FHIR 應用程式目錄，收錄經過審核的醫療健康應用程式。

ThTxGNN App Icon
thtxgnn-smart-app
藥提醒科技有限公司

Query drug repurposing candidates for patient medications using TxGNN knowledge graph predictions.

SMART App FHIR R4 Patients & Clinicians
前往 SMART App Gallery 查看 ↗
ThTxGNN SMART App Gallery 頁面

App 詳細頁面

App 規格

項目 內容
Application Type SMART App
FHIR Compatibility R4
Designed for Patients & Clinicians
Platform Web
Pricing Free / Open Source
Privacy Policy https://thtxgnn.yao.care/privacy-policy/

🏥 歡迎醫療機構整合測試

若貴院的 EHR 系統支援 SMART on FHIR，歡迎使用以下方式進行整合測試。我們提供兩種測試模式，讓您的 IT 團隊可以快速驗證連接。

🎯
方式一：獨立測試模式

不需要 EHR 連線，直接輸入藥物名稱測試功能

快速體驗
🔗
方式二：SMART Launcher 測試

完整測試 OAuth 授權流程與 EHR 整合

IT 整合驗證

方式一：獨立測試模式

獨立測試模式讓您不需要連接 EHR 系統，直接輸入藥物名稱即可測試 ThTxGNN 的藥物映射與老藥新用查詢功能。

步驟 1：開啟獨立測試頁面

點擊下方按鈕開啟獨立測試頁面：

💡 點擊「直接查看 L1 範例」會自動載入 Famotidine、Docetaxel、Paclitaxel 三個 L1 證據等級藥物並顯示查詢結果

頁面載入後，您會看到：

T
ThTxGNN SMART App
獨立測試模式
已載入的 L1 範例藥物：
Famotidine Docetaxel Paclitaxel

步驟 2：查看或新增藥物

使用「直接查看 L1 範例」連結開啟時，系統會自動載入三個 L1 證據等級藥物。您也可以手動新增其他藥物：

輸入類型 範例
英文學名 Famotidine, Docetaxel, Paclitaxel
中文名稱 法莫替丁, 多西他賽
RxCUI 代碼 855332, 1161611
💡 提示：建議使用英文學名以獲得最佳比對結果

步驟 3：查看老藥新用候選

點擊「查詢」按鈕後，系統會：

  1. 藥物名稱映射：將輸入的名稱比對到 ThTxGNN 資料庫
  2. 查詢預測結果：找出該藥物的老藥新用候選適應症
  3. 顯示證據等級：每個預測標示 L1-L5 證據等級

結果會自動顯示，例如 Famotidine：

Famotidine L1
原適應症：住院病人伴隨有病理性胃酸分泌過高之症狀，頑固性十二指腸潰瘍...
老藥新用候選：
duodenogastric reflux (99.99) duodenal obstruction (99.99) peptic ulcer perforation (99.98) ... 更多

方式二：SMART Launcher 測試

SMART Launcher 是官方提供的測試工具，可以模擬 EHR 系統啟動 SMART App 的完整流程，包含 OAuth 2.0 授權。

步驟 1：前往 SMART Launcher

點擊下方連結開啟已預先設定好的 SMART Launcher：

🚀 前往 SMART Launcher（已設定好）↗

💡 連結已自動設定 Launch URL，只需選擇病患即可開始測試

步驟 2：選擇測試病患

開啟後，Launch URL 已自動設定完成。接下來：

  1. 展開 Select Patient(s) 區塊
  2. 使用篩選條件找到有用藥記錄的病患：
    • Conditions: 選擇有慢性病（如 Hypertension）的病患
    • Medications: 確認病患有用藥記錄
⚠️ 注意：SMART Launcher 使用 Synthea 合成資料（美國藥品），部分藥物可能無法與 ThTxGNN 資料庫（泰國健保藥品）完全匹配。
💡 推薦測試藥物：以下藥物在 ThTxGNN 有 L1 等級預測，且可能出現在美國測試資料中：
  • Famotidine（胃酸抑制劑）
  • Vitamin E（維生素補充劑）
  • Isosorbide dinitrate（心絞痛用藥）

步驟 3：啟動並授權

  1. 點擊 Launch 按鈕
  2. 頁面會跳轉到 ThTxGNN SMART App
  3. 如果出現授權頁面，點擊 Authorize 授權存取
  4. 系統會自動讀取病患用藥並顯示老藥新用候選

流程比較

比較項目 🎯 獨立測試模式 🔗 SMART Launcher
需要連線 ❌ 不需要 ✅ 需要
OAuth 授權 ❌ 不測試 ✅ 完整測試
藥物來源 手動輸入 EHR 自動讀取
藥物匹配率 ✅ 高（可指定） ⚠️ 低（美國藥品）
適合對象 一般使用者 開發者 / IT 人員

常見問題

為什麼有些藥物顯示「無法匹配」？

ThTxGNN 資料庫以泰國健保藥品為主，而 SMART Launcher 使用的是美國 Synthea 合成資料。部分藥物名稱不同或泰國未核准，因此無法匹配。

解決方案：使用獨立測試模式，直接輸入 ThTxGNN 資料庫中的藥物名稱。

如何在正式 EHR 系統中使用？

請聯繫您的 EHR 系統管理員，提供以下資訊進行配置：

項目 值
Launch URL https://thtxgnn.yao.care/smart/launch.html
Redirect URI https://thtxgnn.yao.care/smart/app.html
Client ID thtxgnn-smart-app
Scopes launch patient/MedicationRequest.read openid fhirUser

病患資料安全嗎？

是的。ThTxGNN SMART App：

  • 不儲存任何病患資料
  • 所有處理都在瀏覽器端進行
  • 使用 PKCE 保護 OAuth 流程
  • 只請求最小必要權限

技術文件

需要更詳細的技術規格？請參考：

📚 SMART on FHIR 技術文件
免責聲明
本網站內容僅供研究參考，不能取代專業醫療建議。所有藥物再利用預測結果需經過臨床驗證才能應用。如有健康問題，請諮詢合格醫療人員。