SMART on FHIR 使用ガイド
JpTxGNN SMART App は、電子カルテシステム（EHR）から患者の用薬を読み取り、ドラッグリポジショニング候補を自動検索できます。本ガイドでは 2 つの使用方法を説明します：スタンドアロンテストモード（初心者向け）と SMART Launcher テスト。
🏥 医療機関との統合テスト歓迎
貴院の EHR システムが SMART on FHIR をサポートしている場合、以下の方法で統合テストを行えます。IT チームが接続を迅速に検証できるよう、2 つのテストモードを提供しています。
EHR 接続不要、医薬品名を直接入力して機能をテスト
クイック体験完全な OAuth 認証フローと EHR 統合をテスト
IT 統合検証方法 1：スタンドアロンテストモード
スタンドアロンテストモードでは、EHR システムに接続せずに、医薬品名を直接入力して JpTxGNN の医薬品マッピングとドラッグリポジショニング検索機能をテストできます。
ステップ 1：スタンドアロンテストページを開く
下のボタンをクリックしてスタンドアロンテストページを開きます：
ステップ 2：医薬品を表示または追加
「サンプルで直接表示」リンクで開くと、システムが自動的にサンプル医薬品をロードします。他の医薬品を手動で追加することもできます：
| 入力タイプ | 例 |
|---|---|
| 英語学名 | Famotidine, Omeprazole, Metformin |
| 日本語名 | ファモチジン, オメプラゾール |
| RxCUI コード | 855332, 1161611 |
ステップ 3：ドラッグリポジショニング候補を表示
「検索」ボタンをクリックすると、システムは：
- 医薬品名マッピング：入力名を JpTxGNN データベースとマッチング
- 予測結果検索：その医薬品のドラッグリポジショニング候補適応症を検索
- スコア表示：各予測にスコア（信頼度）を表示
方法 2：SMART Launcher テスト
SMART Launcher は、EHR システムが SMART App を起動する完全なフローをシミュレートする公式テストツールで、OAuth 2.0 認証を含みます。
ステップ 1：SMART Launcher に移動
下のリンクをクリックして、事前設定済みの SMART Launcher を開きます：
🚀 SMART Launcher に移動（設定済み）↗ステップ 2：テスト患者を選択
開いた後、Launch URL は自動設定されています。次に：
- Select Patient(s) セクションを展開
- フィルター条件を使用して用薬記録のある患者を検索
ステップ 3：起動と認証
- Launch ボタンをクリック
- ページが JpTxGNN SMART App にリダイレクト
- 認証ページが表示されたら Authorize をクリック
- システムが自動的に患者の用薬を読み取り、ドラッグリポジショニング候補を表示
フロー比較
| 比較項目 | 🎯 スタンドアロンモード | 🔗 SMART Launcher |
|---|---|---|
| 接続必要 | ❌ 不要 | ✅ 必要 |
| OAuth 認証 | ❌ テストなし | ✅ 完全テスト |
| 医薬品ソース | 手動入力 | EHR 自動読み取り |
| マッチング率 | ✅ 高（指定可能） | ⚠️ 低（米国医薬品） |
| 対象者 | 一般ユーザー | 開発者 / IT 担当者 |
よくある質問
一部の医薬品が「マッチ不可」と表示されるのはなぜですか？
JpTxGNN データベースは主に日本医療用医薬品を対象としていますが、SMART Launcher は米国 Synthea 合成データを使用しています。一部の医薬品名が異なるか、日本で未承認のため、マッチできない場合があります。
解決策：スタンドアロンテストモードを使用し、JpTxGNN データベース内の医薬品名を直接入力してください。
正式な EHR システムでの使用方法は？
EHR システム管理者に連絡し、以下の情報を提供して設定してください：
| 項目 | 値 |
|---|---|
| Launch URL | https://jptxgnn.yao.care/smart/launch.html |
| Redirect URI | https://jptxgnn.yao.care/smart/app.html |
| Client ID | jptxgnn-smart-app |
| Scopes | launch patient/MedicationRequest.read openid fhirUser |
患者データは安全ですか？
はい。JpTxGNN SMART App は：
- 患者データを保存しません
- すべての処理はブラウザ側で行われます
- PKCE で OAuth フローを保護
- 最小限の権限のみを要求
技術文書
より詳細な技術仕様が必要な場合は、以下を参照してください：
本ウェブサイトのコンテンツは研究参考のみを目的としており、専門的な医療アドバイスに代わるものではありません。すべてのドラッグリポジショニング予測結果は、臨床検証を経て初めて適用できます。健康上の問題がある場合は、資格のある医療専門家にご相談ください。