# 後台療程日誌留言同步事件說明

**文件編號**：HM-2026-0609-001
**製作日期**：2026 年 6 月 10 日
**對應 Redmine 編號**：[Bug] #1327
**文件版本**：v1.1
**本次檢查耗時**：**3.5 小時**（收件＋重現＋log 分析＋程式碼 review＋ticket 撰寫）
**預估修復工時**：**10.5 小時**（細項見第六節）

---

## 一、事件概述

2026 年 6 月 9 日，接獲 MIA 營養師反映：於 2026 年 6 月 8 日當天，後台療程日誌中部分個案的營養師留言，於當日晚間查看時出現「未留存／被清空」的現象，與營養師當日實際操作的紀錄不一致。

經內部初步比對 6 月 8 日當日的系統操作紀錄後，**此現象與後台療程日誌的「單一欄位更新」流程有關**。為避免類似情況再次發生，本團隊將同步啟動系統端的優化作業。

---

## 二、涉及範圍

| 項目 | 內容 |
|---|---|
| 發生日期 | 2026 年 6 月 8 日（一日） |
| 反映人員 | 莊美玲 營養師 |
| 涉及個案代號 | A2604025、A2605041（均為系統內部代號，記錄於 `ss3a_member.line_name` 欄位） |
| 影響範圍 | 限當日後台療程日誌留言欄位的顯示與儲存一致性，**不涉及個案個資外洩** |
| 影響等級 | 內部運作層級，**未影響對個案之服務提供、預約、結帳**等對外功能 |

---

## 三、現象描述

6 月 8 日當日，營養師在後台「療程日誌」進行留言時，系統**單一欄位**（例如：飲食、飲水、運動、體重血壓、睡眠、排便）更新後，其他未異動欄位在**部分情境下可能未正確保留**既有留言，導致畫面上看起來留言「消失」。

經比對日內系統操作紀錄，**同日其他個案的留言功能操作皆正常**，因此本事件並非全面性系統故障，而是發生在特定操作組合下的個案現象。

---

## 四、原因初判（內部技術小結）

經內部團隊檢視後台更新流程，初步歸納出三項待強化的處理邏輯：

1. **單欄位更新時的相鄰欄位保護機制**
   - 目前流程在「僅更新某一類留言」時，對於其他未送出的欄位保護略嫌不足，
     容易在跨欄位比對時造成既有內容被覆蓋。
2. **當日記錄尚未建立時的寫入處理**
   - 當營養師在「該日尚無任何紀錄」的情況下留言，系統未對「實際寫入筆數」做明確回報，
     可能導致畫面顯示成功，但資料庫未有對應的更新。
3. **留言提示狀態的同步**
   - 「有新留言」的提示狀態，在部分流程中可能會在前述情境下被提前標記，
     與實際資料狀態產生落差。

> 以上均屬**可由系統端補強的流程設計**，並非外部攻擊、資料刪除或硬體異常所致。

---

## 五、預計改善方向

為提供更穩定的後台使用體驗，預計進行以下系統優化：

1. **強化部分更新（Partial Update）邏輯**
   - 明確區分「此欄位本次未操作」與「使用者主動清空此欄位」兩種情境，
     避免未操作欄位被誤寫為空值。
2. **新增寫入結果回報機制**
   - 系統在更新留言後，將回報實際影響的資料筆數；若為零筆，將明確提示「未成功寫入」，
     避免誤判為操作成功。
3. **留言提示狀態與資料狀態綁定**
   - 提示狀態將與資料庫實際寫入結果同步，確保「顯示有留言」等同「資料庫有留言」。
4. **補強整合測試案例**
   - 補上「跨欄位留言保留」「當日記錄尚不存在時的留言寫入」等情境的自動測試，
     防止後續改版時再次出現相同狀況。

---

## 六、時程規劃與工時分項

### 6.1 預估修復工時

| 階段 | 預計完成日 | 工時 (hr) | 說明 |
|---|---|---|---|
| 細部需求與影響評估 | 2026 年 6 月中 | 1.5 | 確認實作細節 |
| 開發與內部測試 | 2026 年 6 月底前 | 7.5 | 含系統修正、整合測試與迴歸測試 |
| 上線與觀察 | 2026 年 7 月初 | 1.5 | 正式上線後將持續觀察一週，確認無異常 |
| **預估修復工時合計** | — | **10.5** | 約 1.5 個工作天 |

### 6.2 已發生之本次檢查耗時

| 項目 | 工時 (hr) |
|---|---|
| 客戶回報收件 + 問題重現 | 0.5 |
| 6/8 request log 調閱與分析 | 1.0 |
| 後台留言更新流程程式碼審視 | 1.0 |
| 撰寫本報告與內部 ticket | 1.0 |
| **本次檢查耗時合計** | **3.5** |

---

## 七、目前狀態與後續聯繫

- 本事件已於內部系統立案追蹤（Redmine #1327），目前**狀態：處理中**。
- 6 月 9 日起已暫停導致本現象的特定操作組合（單一欄位留言更新），
  並請營養師於留言後立即在畫面上確認「已儲存」字樣。
- 內部將於開發完成後另行通知業主進行驗收測試。
- 如對本事件有任何疑問或需要補充說明，歡迎隨時與本團隊聯繫。

---

**文件製作**：席爾克軟體有限公司
**對應單一窗口**：陳國瑋