ICU EMR — HL7 FHIR CRUD API 規格
2026-10-01 決定：前後端之間的傳輸格式改走「扁平記錄 JSON」，不用 FHIR。 後端自建、傳扁平記錄；FHIR 留給日後對外交換（用 fhirfox 式規則表轉換）。現行規格見 10 · 傳輸格式：扁平記錄 JSON（現行）、10a · 記錄欄位與端點（產生） 與側欄第一個 Swagger（
/flat/）；來源在icu-care-vue/api/model.mjs。本頁以下的 FHIR 規格保留作對外交換的目標格式與覆蓋查核。
越南兒童醫院 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（草案，未經院方核定）；2026-09-20 補 Condition／Goal／Communication／Practitioner／List／PlanDefinition 與 ICD-10、頻率、分類三個 ValueSet（02 §2.9a） |
| 對應原型 | D:\越南兒童醫院\icu-vue |
| 欄位來源 | S01–S21／N01–N09 共 29 份規格的 1,209 個欄位定位 |
閱讀順序
| 文件 | 內容 |
|---|---|
| 00 · 給後端的對齊說明 | 十分鐘讀完。 給後端的第一份：我們要的 FHIR 模式是什麼／不是什麼、三層分離、五個具體例子、分工與待回覆事項 |
| 01 · 設計原則與資料權威 | 三層架構、HIS 與 EMR 的權威分工、取得方式 → 寫入權限矩陣、缺值不補原則 |
| 02 · 資源對照 | 本地物件／原型實體 → FHIR 資源與元素；TDL 碼對照；本地擴充清單 |
| 03 · CRUD 與搜尋規格 | 通用互動、版本並行控制、搜尋參數、Bundle、分頁 |
| 04 · 業務規則與狀態機 | 可測試的不變式（BR-*）、三軸狀態機、劑次唯一性、交班承接 |
| 05 · 錯誤、安全與稽核 | OperationOutcome、錯誤碼表、SMART scopes、AuditEvent、電子簽章 |
| 06 · HIS 整合對映 | FHIR ↔ PrescriptionCreated / ServiceRequest* 事件、冪等、部分成功、狀態回推 |
| 07 · 後端實作指南 | 不用 HAPI，怎麼在自建資料表上做出這套 API。 儲存策略與 DDL、SQL 對照、搜尋參數翻成 WHERE、樂觀鎖、Bundle transaction、Vue 端呼叫、後端自測清單 |
| capabilitystatement.json | 機器可讀的能力宣告，可直接放在 /metadata |
| examples/ | 代表性資源與互動範例 |
fhir-server/（專案資料夾） |
可執行的參考實作（Express ＋ SQLite）。npm start 後打開演練台，就能把一日流程整條跑完；51 個規格對照測試可直接對著後端自己的實作跑 |
| openapi/ | Swagger／OpenAPI 文件（27 path／41 operation）。swagger.html 可直接雙擊開啟或整份寄給院方與 HIS 廠商 |
後端第一次拿到這份資料夾：先看 00 對齊，再看 07 動手，其餘按需查。
01–06 以設計理由為軸，openapi/ 以端點為軸（對帳用）。
兩者描述同一套設計，Swagger 的每個 operation 都嵌了該操作要通過的 BR-* 規則表。
本規格明確做了哪些決定
- FHIR API 是 EMR 的介面，不是 HIS 的介面。 HIS 仍是病人、就醫、檢驗結果、處方號的權威來源；EMR 透過
06的整合層與之往來，臨床端不直接觸碰 HIS 契約。 - 醫囑的三個狀態軸不合併成一個
status。 臨床狀態、本地簽署狀態、HIS 傳輸狀態彼此獨立（見 04）。HIS 的MedicationChangeStatus1–5 都不代表已給藥。 - 缺值不補。 沒有來源就用
dataAbsentReason／省略元素，不送 0、不預設正常、不推定未執行。 - 不覆寫。 病歷更正、交班更正、醫師核對都是新增版本或新增
Provenance，原紀錄永遠保留。 - 未確定的編碼標為未定。 檢驗指標字典、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 逐行對帳的補償邏輯 |