新增 ICD-10 快查頁:關鍵字/代碼語意搜尋 + 獨立錯誤回報¶

背景¶

現有系統的 ICD-10 編碼是外傷導向的 predict pipeline(Stage1 抽取 → faceted 檢索 → Stage3 排序),只服務創傷病歷。臨床上常需要一個獨立查詢工具:直接輸入關鍵字(中/英/代碼)就能查任意 ICD-10(含內科 E/I/R 等章),且完全不影響外傷流程。

本工作新增一個獨立的「ICD-10 快查」分頁,重用後端既有的全碼向量庫(73,681 筆),不動 facet、不動 ICD_PIPELINE、不動 predict_icd10。

變更內容¶

後端¶

• 新增 POST /search_icd10:hybrid 檢索 —— 輸入像代碼(如 S02.5、R04)走全碼表前綴精確比對;否則重用 RAGService.search_codes() 做多語語意檢索。公開端點(比照 predict_icd10)。
• 新增獨立回報資料表 icd10_search_feedback(query / 結果快照 / 預期碼 / 分類 / 備註),刻意與外傷 icd10_feedback 分開,避免污染外傷編碼改善迴圈的輸入資料。
• 新增 POST /search-feedback(需登入)與 GET /admin/search-feedback(admin 檢視,方便日後 debug 搜尋品質)。
• 未更動 rag_service.py、predict_icd10、facet 資料或 ICD_PIPELINE 旗標。

前端¶

• 新增 Icd10SearchPage.tsx:搜尋框 + 結果表(中英對照、代碼可點擊複製、標示「代碼/語意」命中)。
• page.tsx 右上角新增「外傷病歷 / ICD-10 快查」視圖切換;外傷表單保持掛載僅隱藏,切換不丟失未儲存的表單狀態。
• 快查頁新增錯誤回報:勾選問題類型(預期碼沒出現/排序太後/無關/查無/縮寫同義詞/其他)、填預期代碼、寫備註,連同查詢字串與當下結果快照送出。

驗收標準¶

• 右上角切到「ICD-10 快查」可查詢;實測:S02.5→代碼前綴命中、chest pain→R07.9 胸痛、糖尿病→E10/E11 系列、空字串→空結果。
• 外傷病歷流程不受影響(predict_icd10、facet、ICD_PIPELINE 皆未動;搜尋無退步)。
• icd10_search_feedback 表於啟動時自動建立、欄位正確;/search-feedback、/admin/search-feedback 皆需認證(未帶 token 回 401)。
• ORM 寫入驗證通過(insert+rollback 無欄位/約束問題)。
• 前端 tsc --noEmit 零型別錯誤。

已知限制 / 後續¶

• 向量檢索準確度有限:醫學縮寫(DKA/OHCA/COPD)因不在 ICD 描述文字中而查不到;部分全名查詢(結膜炎/中耳炎/Epistaxis/STEMI)排序偏差。
• 改善路線已規劃並記錄:L1 hybrid lexical(關鍵字+向量合併)、L2 縮寫/同義詞對照表(+ 測試表,AI 輔助生成、醫師審)、L3 升級 embedding 模型。本次先交付查詢頁與回報機制,改善迭代另案處理。