專案

一般

配置概況

動作

任務 #11532

進行中

GX-中醫藥大學策略聯盟醫院-2026系統階段 - 任務 #11404: 調整功能 2026/3/30 提交版本

功能 #11537: 生理量測欄位調整

[全家寶設備]串接項目

由 Judy Fan 於 16 天 前加入. 於 9 天 前更新.

狀態:
實作中
優先權:
正常速度
被分派者:
開始日期:
2026/03/12
完成日期:
2026/03/20 (逾期7 天)
完成百分比:

0%

預估工時:
使用工時:

概述

串接文件如附件

API欄位代表意思:
合作計畫代號→社群(院區)
服務單位編碼/名稱→單位
服務站編碼/名稱→站
硬體型號→不是需要的資訊

※量測點的區域:
社群(院區)->單位->站

※區域參數(e.g.):
A -> A1 ->001

###心電圖
MeasurementResult 欄位表示方式:

  1. 參數1-9→靜態量測
  2. 參數10-12→動態量測

MeasurementResult 欄位全家寶畫面


檔案

由 Judy Fan 於 16 天 前更新

由 Judy Fan 於 16 天 前更新

由 Judy Fan 於 15 天 前更新

  • 父層議題 設定為 #11537

由 Sam Wang 於 13 天 前更新

注意

尚待廠商介接測試

  1. 提供廠商登入帳密: chilinemd/chilinemd168(或是廠商提供我來建立)

  2. 請廠商提供: AES KEY

使用者與設備運用並接入我方系統流程還是要了解清楚,對於系統數據目前採既有方式,此部分有可能異動,儲存資料與設計有可能變更。

appsettings.json

{
    "AppSettings": {
        "TelecareConfig": {
            "IsEnabled": false,  // 啟用支援全家寶端點
            "AesKey": "",
            "EcgBasePath": "\\\\192.168.2.1\\share\\ECG\\",   // 儲存解碼得到JPG進行儲存
           "EcgRelativeBase": "ecg"
       }
    }
}

EcgBasePath: 是給後端程式看的「真實物理門牌」(例如:\NAS\ECG_Storage\)。
EcgRelativeBase: 是給前端與 API 校驗用的「虛擬分類代碼」(例如:ecg)。

全家寶量測數據接收端點 (POST)

1. 核心量測端點

量測類別 API 端點 (URL 路徑) 關鍵數據欄位
血壓 POST /api/telecare/InsBP 收縮壓 (SBP)、舒張壓 (DBP)、脈搏 (P)
血糖 POST /api/telecare/InsGlucose 血糖值 (AC/PC/NM)、體重 (BODY)
心電圖 (ECG) POST /api/telecare/InsECG MeasurementEcgRecords
血氧/呼吸/心率 POST /api/telecare/InsS68 血氧 (BO)、呼吸率 (RR)、心率 (HR)
體溫 POST /api/telecare/InsTemp 體溫 (TMP)

2. 其他生理量測端點

量測類別 API 端點 (URL 路徑) 關鍵數據欄位
體脂/基礎健康 POST /api/telecare/InsBodyFat 體脂率 (BFP)、肌肉量 (MUSL)、骨量 (BONE) 等
尿酸 POST /api/telecare/InsUricAcid 尿酸值 (UA)
總膽固醇 POST /api/telecare/InsCholesterol 總膽固醇 (TC)
腰圍 POST /api/telecare/InsWaist 腰圍 (WC)
每日步數 POST /api/telecare/InsDailyStep 總步數 (STP)

3. 資源輔助端點

功能 API 端點 (URL 路徑) 方法 描述
ECG 圖片調取 /api/telecare/ecg-image GET 透過相對路徑從 NAS 讀取並顯示心電圖 JPG

附註:

  • 列表查詢 API:/api/measurement-record/list 已整合上述所有數據(含 ECG 虛擬紀錄)。
  • 列表查詢 API:/api/v2/health-measure-info/typelist 已整合上述所有數據(含 ECG 虛擬紀錄)。

4. API 端點與數據代碼對照表 (MeasurementRecords)

除 ECG 儲存於獨立資料表 MeasurementEcgRecords 外,其餘數據均儲存於 [MeasurementRecords]表中:

功能名稱 API 端點 (POST) 數據代碼 (Code) 備註
血壓量測 /api/telecare/InsBP SBP, DBP, P 收縮壓、舒張壓、脈搏
血糖量測 /api/telecare/InsGlucose AC, PC, NM GluType 映射,其餘為 NM
身高體重 BMI /api/telecare/InsUserBody BMI 可使用 /InsWeight 副本端點
心電圖 (ECG) /api/telecare/InsECG (獨立資料表) 儲存至 MeasurementEcgRecords
體脂肪量測 /api/telecare/InsBodyFat BFP 體脂率
血氧量測 /api/telecare/InsS68 BO, PR, RR 血氧、脈率、呼吸率 (取平均值)
體溫量測 /api/telecare/InsTemp TMP 體溫 (取陣列第一筆)
總膽固醇 /api/telecare/InsCholesterol TC
腰圍量測 /api/telecare/InsWaist WC
尿酸量測 /api/telecare/InsUricAcid UA
每日步數 /api/telecare/InsDailyStep STP

由 Sam Wang 於 13 天 前更新

  • 完成百分比0 變更為 50

由 Sam Wang 於 13 天 前更新

  • 狀態新建立 變更為 實作中

由 Sam Wang 於 13 天 前更新

  • 完成百分比0 變更為 50

由 Sam Wang 於 12 天 前更新

全家寶測試 Host (不包含量測項目位址 "/Insxxx")

https://weigong-healthcare-api.dev.viuto-aiot.com/api/telecare/

新增/修改功能 (feature)

  • [行事曆]開放內容與待辦事項給衛生局(HealthAdm)身分。

修正 (fix)

  • [全家寶]修正全域授權過濾權限衝突,確保 [AllowAnonymous] 端點能正確進入。

內部改進 (Internal)

  • [全家寶]重構 API 異常回應代碼,全面採用 Dtos.Common.ErrorCodes 標準值。
  • [全家寶]端點日誌紀錄,包含請求內容 (Payload)、身分驗證結果與處理進度。

由 Judy Fan 於 12 天 前更新

  • 完成日期 設定為 2026/03/20

由 Sam Wang 於 10 天 前更新

[Fix] 修復全家寶 Telecare API (InsS68/InsTemp/InsEcg) 資料接收與屬性映射異常

目前取得ECG 如下

心電圖
尚有以下資訊

參數 項目 描述
HR 每分鐘心跳數率 (單位 bpm)
QRS QRS duration (單位 ms)
ST ST level (單位 mm)
PR PR interval (單位 ms)
QT QT interval (單位 ms)
QTc QTc interval (單位 ms)
SeverityLevel嚴重程度 A:正常
B:異常
C:無法判讀
MeasurementResult 心電量測結果 靜態量測:
1: 波形未見異常
2: 疑似心跳稍快
3: 疑似心跳過快
5: 疑似心跳
6: 疑似心跳過緩
7: 疑似心室早發性收縮
8: 疑似心跳期間不規則
9: 雜訊過多或訊號太弱,無法分析動態量測
10: 心律未見異
11: 疑似心律異常
12: 雜訊過多或訊號太弱,無法分析
動作

匯出至 Atom PDF