ICU EMR — HL7 FHIR CRUD API 規格

越南兒童醫院 ICU Phase 1。本規格定義 EMR 自有的 FHIR RESTful API：臨床端（醫師／護理師工作站、icu-vue 原型）讀寫資料的唯一介面。

版本與基線

項目 值
FHIR 版本 R4 (4.0.1)
交換格式 application/fhir+json（XML 不支援）
實作指引 不套用任何國家級 IG。以 base R4 ＋ 本院 StructureDefinition 擴充
規格版本 0.1.0（草案，未經院方核定）
對應原型 D:\越南兒童醫院\icu-vue
欄位來源 S01–S21／N01–N09 共 29 份規格的 1,209 個欄位定位

閱讀順序

文件 內容
01 · 設計原則與資料權威 三層架構、HIS 與 EMR 的權威分工、取得方式 → 寫入權限矩陣、缺值不補原則
02 · 資源對照 本地物件／原型實體 → FHIR 資源與元素；TDL 碼對照；本地擴充清單
03 · CRUD 與搜尋規格 通用互動、版本並行控制、搜尋參數、Bundle、分頁
04 · 業務規則與狀態機 可測試的不變式（BR-*）、三軸狀態機、劑次唯一性、交班承接
05 · 錯誤、安全與稽核 OperationOutcome、錯誤碼表、SMART scopes、AuditEvent、電子簽章
06 · HIS 整合對映 FHIR ↔ PrescriptionCreated / ServiceRequest* 事件、冪等、部分成功、狀態回推
capabilitystatement.json 機器可讀的能力宣告，可直接放在 /metadata
examples/ 代表性資源與互動範例
openapi/ Swagger／OpenAPI 文件（27 path／41 operation）。swagger.html 可直接雙擊開啟或整份寄給院方與 HIS 廠商

上面 01–06 是給實作者看的（以設計理由為軸），openapi/ 是給對方對帳用的（以端點為軸）。 兩者描述同一套設計，Swagger 的每個 operation 都嵌了該操作要通過的 BR-* 規則表。

本規格明確做了哪些決定

  1. FHIR API 是 EMR 的介面，不是 HIS 的介面。 HIS 仍是病人、就醫、檢驗結果、處方號的權威來源；EMR 透過 06 的整合層與之往來，臨床端不直接觸碰 HIS 契約。
  2. 醫囑的三個狀態軸不合併成一個 status。 臨床狀態、本地簽署狀態、HIS 傳輸狀態彼此獨立（見 04）。HIS 的 MedicationChangeStatus 1–5 都不代表已給藥。
  3. 缺值不補。 沒有來源就用 dataAbsentReason／省略元素，不送 0、不預設正常、不推定未執行。
  4. 不覆寫。 病歷更正、交班更正、醫師核對都是新增版本或新增 Provenance，原紀錄永遠保留。
  5. 未確定的編碼標為未定。 檢驗指標字典、I/O 項目、SBAR 文件類型碼在來源查不到對照，規格標記「待院方核定」，不自行指派 LOINC。

未決事項（需院方／FPT 確認）

編號 事項 影響
Q-01 院區時區是否固定 +07:00 所有 instant／dateTime 的寫入與比較
Q-02 檢驗指標（WBC/Na/K/Cr…）的 LOINC 或院內字典 Observation.code、趨勢比較、跨報告合併
Q-03 出入量項目對照 I/O 平衡計算是否可上線
Q-04 SBAR 交班文件的 Composition.type 代碼 交班文件檢索與歸檔
Q-05 repeatPeriod／priority 值域字典 送 HIS 前的阻擋條件
Q-06 部分成功（partial success）契約 ServiceRequestCreated 逐行對帳的補償邏輯