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

文件編號：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 日當日的系統操作紀錄後，此現象與後台療程日誌的「單一欄位更新」流程有關。為避免類似情況再次發生，本團隊將同步啟動系統端的優化作業。

二、涉及範圍

三、現象描述

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

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

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

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

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

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

五、預計改善方向

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

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

六、時程規劃與工時分項

6.1 預估修復工時

6.2 已發生之本次檢查耗時

七、目前狀態與後續聯繫

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

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