healthcare-emr-patterns

醫療EMR開發模式

建置電子病歷（EMR）與電子健康紀錄（EHR）系統的模式。以病人安全、臨床準確性及醫護人員效率為優先。

使用時機

• 建置病人就診流程（主訴、檢查、診斷、處方）
• 實作臨床筆記（結構化 + 自由文字 + 語音轉文字）
• 設計處方/藥物模組，包含藥物交互作用檢查
• 整合臨床決策支援系統（CDSS）
• 建置檢驗結果顯示，並標示參考範圍
• 實作臨床資料的稽核軌跡
• 設計醫療無障礙介面，用於臨床資料輸入

運作方式

病人安全優先

每個設計決策都必須評估：「這是否可能傷害病人？」

• 藥物交互作用必須發出警示，不能默默通過
• 異常檢驗值必須以視覺標記
• 危急生命徵象必須觸發升級流程
• 任何臨床資料修改都必須有稽核軌跡

單頁就診流程

臨床就診應在單一頁面上垂直流動，無需切換分頁：

病人標題（固定 — 始終可見）
├── 基本資料、過敏史、目前用藥
│
就診流程（垂直捲動）
├── 1. 主訴（結構化範本 + 自由文字）
├── 2. 現在病史
├── 3. 身體檢查（依系統）
├── 4. 生命徵象（自動觸發臨床評分）
├── 5. 診斷（ICD-10/SNOMED 搜尋）
├── 6. 藥物（藥物資料庫 + 交互作用檢查）
├── 7. 檢查（檢驗/放射科醫囑）
├── 8. 計畫與追蹤
└── 9. 簽署 / 鎖定 / 列印

智慧範本系統

interface ClinicalTemplate {
  id: string;
  name: string;             // 例如 "胸痛"
  chips: string[];          // 可點擊的症狀標籤
  requiredFields: string[]; // 必填資料點
  redFlags: string[];       // 觸發不可關閉的警示
  icdSuggestions: string[]; // 預先對應的診斷碼
}

任何範本中的紅旗標記都必須觸發可見且不可關閉的警示 — 不能使用快訊通知。

藥物安全模式

使用者選擇藥物
  → 檢查目前用藥是否有交互作用
  → 檢查就診用藥是否有交互作用
  → 檢查病人過敏史
  → 根據體重/年齡/腎功能驗證劑量
  → 若為**危急**交互作用：**封鎖**開藥
  → 臨床醫師必須記錄原因才能越過封鎖
  → 若為**重大**交互作用：顯示警告，要求確認
  → 將所有警示及越過原因記錄在稽核軌跡中

危急交互作用預設封鎖開藥。臨床醫師必須明確越過，並在稽核軌跡中記錄原因。系統絕不允許危急交互作用默默通過。

鎖定就診模式

一旦臨床就診被簽署：

• 不允許編輯 — 只能新增附錄（一個獨立的連結紀錄）
• 原始紀錄與附錄都會出現在病人時間軸上
• 稽核軌跡記錄誰簽署、何時簽署，以及任何附錄紀錄

臨床資料的UI模式

生命徵象顯示： 目前數值搭配正常範圍標示（綠/黃/紅），與前次比較的趨勢箭頭，自動計算臨床評分（NEWS2, qSOFA），內嵌升級指引。

檢驗結果顯示： 正常範圍標示，與前次數值比較，危急值以不可關閉的警示顯示，採集/分析時間戳，待處理醫囑及預計完成時間。

處方PDF： 一鍵生成，包含病人基本資料、過敏史、診斷、藥物詳細資訊（學名+商品名、劑量、途徑、頻率、療程）、臨床醫師簽章欄位。

醫療無障礙

醫療UI的要求比一般網頁應用更嚴格：

• 最小對比度4.5:1（WCAG AA）— 臨床醫師在各種光線下工作
• 大型觸控目標（最小44x44px）— 適用於戴手套或匆忙操作
• 鍵盤導航 — 供快速輸入資料的進階使用者
• 不使用僅以顏色表示的指標 — 顏色必須搭配文字/圖示（色盲臨床醫師）
• 所有表單欄位需有螢幕閱讀器標籤
• 臨床警示不得自動消失 — 臨床醫師必須主動確認

反模式

• 將臨床資料儲存在瀏覽器的localStorage
• 藥物交互作用檢查時無聲失敗
• 對危急臨床警示使用可關閉的快訊
• 以分頁為基礎的就診UI，導致臨床流程碎片化
• 允許編輯已簽署/鎖定的就診紀錄
• 顯示臨床資料卻沒有稽核軌跡
• 對臨床資料結構使用 any 型別

範例

範例1：病人就診流程

醫師開啟病人 #4521 的就診
  → 固定標題顯示：「Rajesh M, 58歲男, 過敏：盤尼西林, 目前用藥：Metformin 500mg」
  → 主訴：選擇「胸痛」範本
    → 點擊標籤：「胸骨下」、「向左臂輻射」、「壓迫性」
    → 紅旗標記「壓迫性胸骨下胸痛」觸發不可關閉的警示
  → 檢查：心血管系統 — 「S1 S2正常，無心雜音」
  → 生命徵象：HR 110, BP 90/60, SpO2 94%
    → NEWS2自動計算：分數8，風險高，顯示升級警示
  → 診斷：搜尋「ACS」→ 選擇 ICD-10 I21.9
  → 藥物：選擇 Aspirin 300mg
    → CDSS檢查與Metformin的交互作用：無交互作用
  → 簽署就診 → 鎖定，從此只能新增附錄

範例2：藥物安全流程

醫師為病人 #4521 開立 Warfarin
  → CDSS偵測到：Warfarin + Aspirin = 危急交互作用
  → UI：紅色不可關閉的模態視窗封鎖開藥
  → 醫師點擊「輸入原因以越過」
  → 輸入：「效益大於風險 — 已監控INR方案」
  → 越過原因 + 警示儲存在稽核軌跡中
  → 處方繼續，並記錄越過原因

範例3：鎖定就診 + 附錄

就診 #E-2024-0891 由 Dr. Shah 於14:30簽署
  → 所有欄位鎖定 — 無編輯按鈕可見
  → 「新增附錄」按鈕可用
  → Dr. Shah點擊附錄，新增：「檢驗結果已收到 — Troponin升高」
  → 新紀錄 E-2024-0891-A1 連結至原始紀錄
  → 時間軸顯示兩者：原始就診 + 附錄，附時間戳