專案

一般

配置概況

任務 #13394

由 Sam Wang 於 28 天 前更新

## 需由前端介接（App / 站點團隊）： 
 需<span style="background-color:#fdecea; color:#e74c3c; border:1px solid #e74c3c; padding:2px 6px; border-radius:4px;">原廠提供整合文件或相關 需原廠提供整合文件或相關 SDK / 藍牙協定</span> 藍牙協定 與 FORA MD6 連線配對 讀出 6 項生化數據。 

 ## 1. 泰博科技 FORA MD6 (4172AB) 六合一檢測項目真相與系統對應 

 ### (1) 說明書官方定義之「六合一 (6-in-1)」真確項目 

 根據原廠說明書封面與目錄第 1 頁定義（衛部醫器製字第006453號），FORA MD6 為**多功能血液生化檢驗儀**，其六合一指的是 **6 種血液生化檢驗指標**（非傳統血壓計）： 

 ``` 
 【FORA MD6 六大檢測指標】 
  ├── 1. 血糖 (Blood Glucose, BG) 
  ├── 2. 血酮 (β-Ketone / β-OHB) 
  ├── 3. 尿酸 (Uric Acid, UA) 
  ├── 4. 總膽固醇 (Total Cholesterol, TCHOL) 
  ├── 5. 血紅素 (Hemoglobin, HB) 
  └── 6. 紅血球容積比 (Hematocrit, HCT) 
 ``` 

 > 💡 **試片運作模式說明**： 
 > - **單測血糖試片**：輸出 `血糖 (BG)` 
 > - **3合1 複合試片**：單次採血同時輸出 `血糖 (BG)` + `血容比 (HCT)` + `血紅素 (HB)` 
 > - **血酮試片**：輸出 `血酮 (β-Ketone)` 
 > - **尿酸試片**：輸出 `尿酸 (UA)` 
 > - **總膽固醇試片**：輸出 `總膽固醇 (TCHOL)` 

 --- 

 ### (2) 六項指標與本系統現有 API / Enum 對應矩陣 

 | FORA MD6 指標 | 單位 | 系統目前支援狀態 | 推薦主要 API 端點 | 全家寶備用端點 | 
 | :--- | :---: | :---: | :--- | :--- | 
 | **1. 血糖 (BG)** | mg/dL | ✅ **完全支援** (`BloodSugar = 2`) | `POST /api/measurement-management/v2/blood-sugar` | `POST /api/telecare/InsGlucose` | 
 | **2. 尿酸 (UA)** | mg/dL | ✅ **完全支援** (`UricAcid = 12`) | `POST /api/measurement-management` (Type: 12) | `POST /api/telecare/InsUricAcid` | 
 | **3. 總膽固醇 (TCHOL)** | mg/dL | ✅ **完全支援** (`TotalCholesterol = 13`) | `POST /api/measurement-management` (Type: 13) | `POST /api/telecare/InsCholesterol` | 
 | **4. 血酮 (Ketone)** | mmol/L | ⚠️ **需擴充 Enum** (`Ketone = 18`) | `POST /api/measurement-management` (Type: 18) | 無 | 
 | **5. 血紅素 (HB)** | g/dL | ⚠️ **需擴充 Enum** (`Hemoglobin = 19`) | `POST /api/measurement-management` (Type: 19) | 無 | 
 | **6. 紅血球容積比 (HCT)**| % | ⚠️ **需擴充 Enum** (`Hematocrit = 20`) | `POST /api/measurement-management` (Type: 20) | 無 | 

 --- 

 ### (3) 前端上傳 API 範例 (供前端 App / 站點開發參考) 

 #### 範例 1：上傳【血糖】 (專用 v2 端點) 
 * **端點**：`POST /api/measurement-management/v2/blood-sugar` 
 * **Request Body**： 
 ```json 
 { 
   "measurementDateTime": "2026-08-26T15:30:00.000+08:00", 
   "userId": 105, 
   "terminalType": "App", 
   "isBluetooth": true, 
   "ac": 110, 
   "body": 0 
 } 
 ``` 

 #### 範例 2：上傳【3合1 複合試片】(血糖 + 血容比 + 血紅素 一次上傳) 
 * **端點**：`POST /api/measurement-management` 
 * **Request Body**： 
 ```json 
 { 
   "userId": 105, 
   "date": "2026-08-26T15:30:00.000+08:00", 
   "terminalType": "App", 
   "isBluetooth": true, 
   "source": "Device", 
   "items": [ 
     { "type": 2, "code": "BG", "value": 110.0 }, 
     { "type": 19, "code": "HB", "value": 14.2 }, 
     { "type": 20, "code": "HCT", "value": 43.5 } 
   ] 
 } 
 ``` 

 #### 範例 3：上傳【血酮 (β-Ketone)】 
 * **端點**：`POST /api/measurement-management` 
 * **Request Body**： 
 ```json 
 { 
   "userId": 105, 
   "date": "2026-08-26T15:30:00.000+08:00", 
   "terminalType": "App", 
   "isBluetooth": true, 
   "source": "Device", 
   "items": [ 
     { "type": 18, "code": "KETONE", "value": 0.4 } 
   ] 
 } 
 ``` 

 #### 範例 4：上傳【尿酸】與【總膽固醇】 
 * **端點**：`POST /api/measurement-management` 
 * **Request Body (尿酸)**： 
 ```json 
 { 
   "userId": 105, 
   "date": "2026-08-26T15:30:00.000+08:00", 
   "terminalType": "App", 
   "isBluetooth": true, 
   "source": "Device", 
   "items": [ 
     { "type": 12, "code": "UA", "value": 6.8 } 
   ] 
 } 
 ```

返回