# Poieti HIS 介接上線清單

每家機構一份。憑證與金鑰另行處理，不寫在本清單。

## 端點與網路

- [ ] 院方測試端點 base URL（公開 HTTPS，不含查詢字串、連接埠或 IP 位址）：
- [ ] 院方正式端點 base URL：
- [ ] 驗證方式：簽章；是否另加 Bearer token
- [ ] 端點主機放行對外 HTTPS 443：`his-dev.poieti.com`（測試）、`his.poieti.com`（正式）
- [ ] 兩個主機排除於 TLS 檢查；或已將檢查用根憑證放入系統憑證庫
- [ ] 端點主機對外固定 IP 或網段（最多 32 筆）：

## 機構設定（提供給 Poieti）

- [ ] 送出的功能（例如入院護理評估、傷口紀錄、管路紀錄）
- [ ] 欄位對照工作表（每個功能各一份 CSV）
- [ ] HIS 病房代碼對照（Poieti 病房 → HIS 病房代碼）
- [ ] 員工編號對照（是否要求、每位使用者的院內員工編號）
- [ ] 病歷號、住院號格式；手圈條碼格式（若使用掃描）
- [ ] 是否開啟病房名單；名單涵蓋的病房；由 Poieti 讀取（間隔）或院方上傳
- [ ] 告警 webhook 網址（公開通知服務）
- [ ] 主控台帳號（院方資訊人員）

## 金鑰

- [ ] 測試：已收到 Poieti 交付的簽章金鑰，存放於只有端點服務帳號可讀之處
- [ ] 測試：機器金鑰以 `node poieti-his.mjs keygen` 產生，SHA-256 已交 Poieti，電話核對前 8 碼
- [ ] 測試：已以 keyPrefix 完成金鑰檔，權限只限端點服務帳號
- [ ] 正式：同上

## 院方端點

- [ ] 驗證 `X-Poieti-Signature`（300 秒時間窗、輪替期間兩個 `v1`），重現所有測試向量
- [ ] `POST /deliveries`：寫入與記下 deliveryId 在同一交易；只以 deliveryId 去重；重複時回原 hisRecordId
- [ ] 更正（correction）以 `supersedes.hisRecordId` 整筆取代
- [ ] 拒收以有代碼的 4xx（身分不符、住院已結帳、字元無法儲存、缺必填等）；401／403 只用於端點憑證問題
- [ ] `GET /deliveries/{deliveryId}`：未知回 404；排入佇列時回 202
- [ ] `GET /health`
- [ ] 附件：以機器金鑰下載，比對大小與 SHA-256 後才寫入
- [ ] 開啟病房名單時：`GET /census/wards/{wardCode}`、`POST /patients/search`

## 驗收（測試環境）

- [ ] `node poieti-his.mjs check` 對測試端點全部通過
- [ ] 推送、金鑰、名單驗收案例已與 Poieti 一起通過（docs.poieti.com「驗收」頁）
- [ ] 監控：端點錯誤與告警 webhook 會通知資訊人員

## 正式啟用

- [ ] 換上正式的簽章金鑰、機器金鑰與 `https://his.poieti.com`
- [ ] Poieti 設定正式端點並將機構切換為 `push`
- [ ] 第一筆紀錄已在 HIS 核對（病人、住院、欄位、附件、員工編號）
