De Novo Orthopedics
問診前 — 醫師操作手冊
Blog/

問診前 — 醫師操作手冊

iRehab 問診前功能的醫師端操作指南。列印 QR 海報、看診前清單怎麼讀、三個結案鍵怎麼選、代號救回漏接病歷、常見問答六題。為什麼我們做這個功能：讓你多花時間在病人身上，不是鍵盤上。

irehabuser-manualpreconsultdoctorclinical-workflow

為什麼寫這份手冊

iRehab 的「問診前」功能背後有一個設計原則：AI 不是替醫師寫作文，是把時間還給你。當病人走進診間坐下，電腦上已經有一份結構化摘要，你不用花五分鐘問基本資料 — 你可以把那五分鐘用在摸、敲、聽、看病人身上。更完整的設計哲學見 診前簡報：當病人答不出「是肌腱還是神經」。

這份手冊是給實際用這個功能的醫師的操作指南。可印貼診間桌上。

開始之前：第一次設定（把你的問卷上線）

下面的日常流程（從下面第一節起）假設你的問卷已經上線。如果你是第一次設定，先走完這 6 步，大約 15 分鐘，其中幾步由 De Novo 幫你開通。

我們刻意讓你先試做、再決定：你會先以病人視角把問卷填過一次（或先審一次草稿），覺得對了才正式啟用。不用先簽約、先付費。

  1. 取得帳號（邀請制）。 iRehab 採邀請制。聯繫 De Novo 團隊，我們用你的 email 開通醫師帳號，寄一個「註冊邀請連結」給你。若你的科別有客製問卷（例如婦產科把婦科、產科、泌尿婦科三張併成一張），我們會先給你一個確認頁逐題過目，你的決定整理好回傳，我們定稿（通常來回 1–2 次微調）。
  2. 註冊醫師帳號。 收到邀請連結後點開，到 doctor.denovortho.com/#/register 填資料（email 要和邀請一致、科別照實填）。⚠️ 一定要用邀請連結，單獨開註冊頁會缺邀請碼。
  3. 確認你的問卷（Composer）。 登入 Doctor PWA，打開「問卷編輯器（Composer）」，逐欄確認題目跟你定稿的版本一致。
  4. 在「派發中心」產生 QR。 確認無誤後，到「派發中心」把問卷產生 QR Code，印出來貼診間或櫃台。（一張海報可重複使用，不必每天重印；詳見下面第一節。）
  5. 自己先試填一次（dogfood）。 拿手機掃自己的 QR，以病人身分把問卷從頭填一次。這是上線前最後一道檢查，你會看到病人實際的填答體驗。
  6. 回「看診前」分頁看成品。 你剛才的試填約 30 秒後會出現在「看診前」清單，點開就是醫師會收到的結構化摘要。看到它、覺得對了，就完成了；日常使用照下面第一節起。

設定好之後，每天的流程很簡單：病人掃海報 QR 填問卷、你在「看診前」清單一眼讀完（詳見下面第一、二節）。

一、看診前準備：到派發中心產生 QR 海報

  1. 打開 Doctor PWA（doctor.denovortho.com），登入
  2. 切到「派發中心」分頁
  3. 找到你科別的問卷範本，點「產生海報 QR」
  4. 點「列印 A4 海報」開預覽，按「列印」或存 PDF
提醒：
  • 建議用診所桌機列印，版面最乾淨。iPhone 的 Safari 有時印出來會跑版，若只能用手機先存成 PDF 再列印
  • 一張海報可重複使用（預設可用 200 次或 60 天），用量達上限或過期會自動失效，隨時可重新產生或撤銷
  • 海報貼候診區或報到櫃台最顯眼位置。有病患不會掃，助理可以幫忙

二、看診前清單怎麼讀

病人掃完 QR 填完表，大約 30 秒內會出現在你的「看診前」清單。每張卡片顯示：

  1. 姓名 + 出生年 + 性別（若是幼兒會看到「XX 歲 X 個月」）
  2. 主訴一句話（病人自填，原文保留不翻譯）
  3. VAS 疼痛分數 0–10
  4. 感覺類型小標籤（痛 / 麻 / 無力 / 多種 / 其他）
  5. 紅色警示條（若病人填的症狀組合需要多注意 — 你優先看）
  6. ⚠️ 手動加入 小標籤（代表是用代號從別的醫師清單拉回來的，看診時要多問幾句）

展開卡片會看到完整的問診摘要草稿，系統給你兩種格式：

  • 電報體摘要 — 一鍵複製貼到 HIS 的 S 欄（R't knee、B/L、F/M/N）
  • 通順段落 — 寫 IRB 報告或轉診單用

三、看診中決策樹

每位病人看完診按一個結案鍵。三個選項：

結案鍵系統接下來會做什麼
追蹤中（保守治療）病人進 iRehab 追蹤清單；回診前 3 天自動推送 VAS + GROC 問卷
手術或復健建立正式照護紀錄；你選方案（TKA、THA、肩膀、一般復健）
結案（不需追蹤）紀錄保留 180 天供未來查閱；系統不再推任何通知給病人

每個按鍵都會先跳一個確認視窗，列出「系統接下來會做什麼」，你確認無誤再送出。

四、手動加入代號

何時用：
  • 你的看診前清單是空的，但病人堅持他填好了
  • 病人拿代號 PC-XXXXXX 過來
  • 你代別的醫師看診（病人掃的是別的醫師的 QR）
  • 跨診間幫忙看
操作：
  1. 點看診前清單右上「⊕ 手動加入」
  2. 在 PC- [ _ _ _ _ _ _ ] 輸入病人報的 6 碼（大小寫都可，從 LINE 貼整段也行 — 系統會自動清理）
  3. 送出 → 病歷拉進你的清單，卡片會出現「⚠️ 手動加入」小標籤
  4. 若原本建立的是別的醫師，卡片會多一行「原醫師：XXX」— 提醒你這不是你本來的病人，看診時多問幾句

限制： 同一醫院內才能查得到。不同醫院互看不到。

五、常見問答

問：病人說「我填好了」但我的看診前清單沒看到怎麼辦？ 答：先確認時間 — 送出到出現約 30 秒。還是沒有，請他報代號 PC-XXXXXX，走第四節手動加入。

問：代號有 O 和 0 看不清楚怎麼辦？ 答：系統產生的代號不包含容易混淆的字元（不會有 O / 0 / I / 1）。病人報給你的一定不會混淆。

問：我代 X 醫師看診，他的看診前清單怎麼辦？ 答：你用第四節手動加入代號把病人拉進你自己的清單，卡片會標示「原醫師 X」。看完診照常結案，這次的照護紀錄會正確掛在你名下（因為你才是實際看診的人）。

問：病人填一半跑了怎麼辦？ 答：記錄停留在「未送出」狀態，不會進看診前清單。若病人下次回來從同一支手機重掃同一 QR，系統會讓他從中斷點繼續。

問：不小心按了「結案」但其實要追蹤怎麼救？ 答：結案後紀錄仍保留 180 天。點那筆病歷右上「重新開啟」→ 再選「追蹤中」或「手術或復健」— 會建立新的照護紀錄，原結案會標示「已撤回」。

問：紅色警示條代表什麼？ 答：代表病人填的內容符合系統預設的需要多注意的症狀組合（例：「無力 + 加重 + 持續」）。不是系統在下診斷，只是提醒你在問診時順便確認這些警訊症狀。是否真的緊急仍由你決定。

六、AI 翻譯（選用）— 自備 Gemini 金鑰 BYOK

選用功能，不啟用完全不影響平常用；只是病人用其他語言填主訴時，你會看到原文但沒有自動翻譯。這是 BYoAI 設計（Bring-your-own-AI）：醫師用自己的 Gemini API 額度，成本自負（雖然極低），iRehab 伺服器本身不保留任何 LLM 回應。

什麼情況需要啟用

  • 你診間常遇到非中文母語病人（越南、印尼、日韓、英語…）
  • 想要按一鍵就把病人填的外文主訴翻成你看得懂的語言

啟用步驟（5 分鐘）

Step 1 — 去 Google AI Studio 拿一把金鑰

  1. 瀏覽器打開 https://aistudio.google.com/app/apikey
  2. 用你的 Google 帳號登入（建議用私人帳號，不要用醫院給的帳號）
  3. 按「Create API key」→ 系統產生一串 AIza... 開頭的字
  4. 先不要關分頁，複製這串字

Step 2 — 確認 billing 啟用（非常重要）

  • 點剛剛建立的 key 右邊 → 或左欄「Billing」→ 把 billing 打開
  • 就算只用免費額度，Google 也要求這個 project 先掛上信用卡才會給正常 quota
  • 沒掛 billing 的話，連註冊都會失敗（會收到「配額用完」錯誤）

Step 3 — 在 Doctor PWA 裡註冊金鑰

  1. 底部切到「✨ AI」分頁（不是個人；BYOK 設定從 Profile 搬到 AI 分頁）
  2. 找到「BYOK Gemini 金鑰」卡片
  3. 點「啟用並輸入金鑰」
  4. 看完用途說明 → 繼續
  5. 勾齊三個同意選項（資料會送到 Google、院方允許、Google 端處理 iRehab 不負責）→ 繼續
  6. 貼上 AIza... → 按「儲存金鑰」
  7. 成功會看到綠燈「已設定（可用）」

常見註冊錯誤

錯誤訊息為什麼怎麼辦
格式不正確複製貼上有多空白或少字重新複製完整的 AIza... 再貼
金鑰失效或被撤銷金鑰真的被刪了或權限限制回 aistudio 重新產一把
配額用完，稍後再試Google 端 quota 觸發等 1–2 分鐘、確認 billing 掛好、或換一把新 key
Google 回應異常Google 端回應格式異常等 1 分鐘再試；若連續失敗找工程師
服務暫時不穩iRehab 後端 KMS 暫時不能用等 1 分鐘再試
嘗試太多次一小時內超過 20 次註冊等 1 小時

啟用後怎麼用

看診前清單展開病人卡片 → Path B 區塊會多一個「翻譯主訴」按鈕（若病人主訴語系 ≠ 你的 UI 語系才顯示）。按下去會把主訴送到你自己的 Gemini API，秒回一行中文翻譯顯示在卡片上。

重點：

  • 這個翻譯是輔助閱讀，不會覆蓋 HIS 的 S 欄；S 欄仍貼原本的電報體
  • 病人原文 100% 保留在病歷裡，不動、不摘要、不改寫
  • 你按一次就翻一次 — 不自動觸發，你決定什麼時候要翻

安全保證（醫院 IT 可能會問的答案）

  • 金鑰從不離開你的瀏覽器 + iRehab 後端，不會進 log / 錯誤訊息 / 客服系統
  • 後端儲存是 Google KMS 雙層加密（envelope encryption），連 iRehab 工程師也無法直接讀取
  • 任何一次金鑰解密都會寫 Google Cloud Audit Log（異常使用可追蹤）
  • iRehab 伺服器不保留任何 LLM 回應內容；翻譯結果只在你的瀏覽器端顯示
  • 你隨時可以在 AI 分頁按「移除金鑰」，後端的加密 secret 會立即刪除
  • 歷史使用紀錄不會被刪（保留稽核用途）

醫院 IT 問你時的說法

  • 資料走 HTTPS 送到 Google Gemini API（generativelanguage.googleapis.com）
  • 每次送的只有「病人主訴文字」，不含姓名、身分證、病歷號
  • Google 那端的留存政策：走商業 API 路徑，不拿來訓練模型（有合約保證）
  • 若院方政策禁止，請 IT 通知科主任，我們會在後台幫該機構整院關閉此功能