EMS

需求確認 1：修補範圍¶

Ken 已確認：

• 本單只處理 Branch heartbeat watchdog 的 BootNotification reconnect grace。
• Charge Point 重連後立即補送 Heartbeat 不納入 #1436；若後續需要，另列為防禦性強化。
• 不修改 #1421 範圍。

需求確認 2：廠牌適用範圍¶

Ken 已確認：

• reconnect grace 是 Branch 端、廠牌無關 的 OCPP liveness 判斷。
• 任何 Charge Point 只有在 Branch 實際收到 fresh BootNotification 時，才取得 grace。
• 不控制、不要求也不偽造 Fortune 或其他第三方充電樁的 Heartbeat 發送行為。
• 若設備重連後沒有送 BootNotification，本次規則不提供 grace；既有 watchdog 行為不變。

需求確認 3：grace 設定來源¶

Ken 已確認：

• BootNotification reconnect grace 直接沿用既有 ems.branch.chargePoint.offlineTimeoutSeconds。
• 目前設定值為 330 秒（300 秒 Heartbeat interval + 30 秒容錯）。
• 本單不新增第二組 grace timeout 設定，避免兩套 OCPP liveness 時窗不一致。

需求確認階段完成，下一步進入實作規劃與 E2E Impact Review。

階段 2：實作規劃確認¶

Ken 已確認規劃可接受。

核准範圍¶

• Watchdog 候選查詢只有在 lastHeartbeat 與 lastBootNotification 都 stale／null 時才列入。
• 寫入前 row-lock recheck 套用相同規則；任一證據仍在 cutoff 內即取消離線覆寫。
• BootNotification 更新與 watchdog 使用同一把 charge point row lock。
• 不更新或偽造 lastHeartbeat，不修改 operational status。
• 不修改任何廠牌的 Heartbeat 發送行為。
• 不新增 schema 或設定；grace 沿用 offlineTimeoutSeconds。

E2E Impact¶

• Update：OCP-007
• Priority：P1
• Trigger：offline watchdog、OCPP reconnect liveness 或相關 production incident 修正
• Release pack：Major / Charging / OCPP

下一步進入階段 3；多案例測試計畫仍須 Ken 另行明確啟動。

階段 3：實作完成，等待正式測試啟動¶

已完成草稿¶

• Branch watchdog candidate query 改為只有 lastHeartbeat 與 lastBootNotification 都 stale／null 才列入。
• row-lock recheck 使用相同 cutoff；任一存活證據位於 cutoff 內即取消 OFFLINE／UNAVAILABLE 覆寫。
• handleBootNotification() 改用與 watchdog 相同的 pessimistic row lock。
• Boot 只更新 Boot timestamp 與 connection，不刷新／偽造 Heartbeat，也不覆寫 operational status。
• 沿用既有 offlineTimeoutSeconds=330；無 schema／config／charge_point／vendor-specific 變更。
• 已更新 AI knowledge、E2E inventory 的 OCP-007 與 #1436 草稿報告。

已完成、未執行測試的檢查¶

• git diff --check：PASS。
• E2E catalog validator：PASS（176 cases）。
• java/ems_branch: mvn -DskipTests package：BUILD SUCCESS；主程式與 test source 編譯成功，Surefire 顯示 Tests are skipped。
• 尚未 commit、push 或部署。

待 Ken 啟動的正式 Unit 測試計畫¶

Command：

cd java/ems_branch
mvn -Dtest=ChargePointOfflineServiceTest,ChargePointOfflineWatchdogTaskTest,ChargePointServiceOcppConnectionStatusTest test

涵蓋範圍：

1. fresh Heartbeat cutoff 邊界不誤判。
2. 舊 Heartbeat + fresh Boot 的 CP003 reconnect grace，不覆寫 connectors。
3. Heartbeat + Boot 都過期時仍正常 OFFLINE／UNAVAILABLE。
4. Boot 與 watchdog 共用 row lock，且 Boot 不改 Heartbeat／operational status。
5. 既有 watchdog cutoff 傳遞與 offline transaction／queue／event 保護回歸。

環境與資料風險：

• JUnit 5 + Mockito isolated unit tests。
• 不載入 Spring integration/test profile。
• 不連接任何外部服務、正式／共用資料庫或 OCPP Charge Point。
• 不修改共用資料；只使用 process 內 mock objects。
• 一次執行 3 個 test classes，依 SOP 必須等 Ken 明確回覆「開始測試」。

修補版部署與 E2E 另屬階段 4；Unit 授權不包含部署或 E2E。

階段 3：正式 Unit 測試結果¶

Ken 已明確回覆「開始測試」，本次只執行先前列出的測試計畫：

cd java/ems_branch
mvn -Dtest=ChargePointOfflineServiceTest,ChargePointOfflineWatchdogTaskTest,ChargePointServiceOcppConnectionStatusTest test

結果¶

• ChargePointOfflineWatchdogTaskTest：1 PASS。
• ChargePointServiceOcppConnectionStatusTest：6 PASS。
• ChargePointOfflineServiceTest：11 PASS。
• 合計：18 tests，Failures 0，Errors 0，Skipped 0。
• Maven：BUILD SUCCESS。
• 完成時間：2026-08-13 11:31:44（Asia/Taipei）。

已驗證重點¶

• 舊 Heartbeat + cutoff 內 fresh BootNotification：略過 OFFLINE／UNAVAILABLE 覆寫。
• Heartbeat 與 BootNotification 都早於 cutoff：仍正常離線。
• cutoff 等值邊界不誤判。
• Boot 與 watchdog 共用 row lock。
• Boot 不刷新／偽造 Heartbeat，不覆寫 operational status。
• 既有 active transaction、queue、event 與快速重連保護測試未退化。

測試為 JUnit 5 + Mockito isolated Unit Tests，未載入 integration/test profile、未連接外部服務或任何資料庫，未修改共用資料。

階段 3 完成。目前尚未 commit、push 或部署；Unit 授權不包含部署與 E2E。修補版 E2E 報告仍維持 PARTIAL。

已合併至 private¶

Ken 已明確指示 merge to private 並關閉 #1436 worktree。

Git¶

• 修補 commit：6f09934 — fix(#1436): 修正重連後 watchdog 誤判離線
• 測試／文件 commit：feb98c0 — test(#1436): 補充 CP003 重連回歸測試報告
• private merge commit：fa9c18e — merge(#1436): 整合 CP003 重連 watchdog 修正
• feature branch 與 private 均已推送至 origin。

最終驗證（最新 origin/private 基線）¶

• 3 個 isolated Unit Test classes：18 tests，Failures 0，Errors 0，Skipped 0，BUILD SUCCESS。
• mvn -DskipTests package：BUILD SUCCESS。
• E2E catalog validator：PASS（176 cases）。
• git diff --check：PASS。

尚待事項¶

• 本次未部署。
• 修補版 OCPP reconnect 完整 E2E 尚未執行，報告維持 PARTIAL，不得視為 PASS。
• 因此目前只記錄程式已合併，不將 #1436 誤標為已完成部署／E2E。

2026-08-22 Production 再次發生：CT1 CP001¶

本次為 #1436 相同根因在另一個 CloudLink instance 的 production recurrence，補充追蹤如下。

影響範圍¶

• 案場：CT1（寶台 A17）
• Charge Point：CP001
• 受影響 connectors：CP001-001、CP001-003、CP001-007
• 使用者影響：Branch／LIFF 顯示 UNAVAILABLE，無法開始充電
• CP001-002 未受影響：事件當下有 active transaction，offline propagation 受到 currentTransactionId 保護；交易結束後又收到真實 AVAILABLE

現場證據與時序¶

1. 2026-08-20 04:20:18：CP001 reconnect，BootNotification Accepted；001／003／007 均送出初始 StatusNotification(AVAILABLE)。
2. 04:23:18：WebSocket 因未及時收到 pong，以 code 1006 關閉。
3. 04:23:48：CP001 再次建立 WebSocket；因 BootNotification cooldown，這次跳過 Boot。
4. 04:25:50.496：offline watchdog 以 cutoff 04:20:20.493 掃到 stale candidate。
5. 04:25:50.498：Branch 依舊的 lastHeartbeat=04:07:15 將 CP001 判為 HEARTBEAT_STALE。
6. 04:25:50.504～04:25:50.507：001／003／007 被 offline propagation 改成 UNAVAILABLE / OCPP heartbeat stale。
7. 04:25:57.236：watchdog 完成。
8. 04:25:57.709：下一筆 Heartbeat 隨即把 CP001 恢復 ONLINE，但未恢復 connector operational status。
9. 至 2026-08-22 20:00，Branch 三支仍為 stale UNAVAILABLE；edge cp_connectors 三支皆為 AVAILABLE，Modbus polling／meter read 持續正常。

暫時復原¶

復原前交叉確認：

• Branch CP001 現存 connector 的 current_transaction_id 全為 null。
• Branch linked ACTIVE transaction：0。
• Edge cp_transactions 沒有 CP001 ACTIVE transaction。
• Edge 四支 connector 均為 AVAILABLE 且 meter read 新鮮。

只重啟 ems-cp-api（CP001），未重啟 Branch、CP002、CP003，也未直接修改 DB：

• 20:01:28：WebSocket connected、BootNotification Accepted、Heartbeat #1 成功。
• Modbus gateway recovery：1/1 成功；設備通訊驗證：1/1 成功。
• 20:01:38～20:01:42：001／003／007 逐支送出初始 StatusNotification(AVAILABLE/NOERROR)。
• 20:01:43：三支在 Branch 均已恢復 AVAILABLE。

追蹤結論¶

• 本次證明 #1436 並非只限 CP003，而是 CP001 也會發生的 CP instance-independent race。
• 現場已恢復，但永久修補仍須完成 A17 部署與 reconnect → Boot／Boot cooldown → watchdog → first Heartbeat 的 E2E 驗收。
• E2E impact 不新增重複案例，沿用 Update：OCP-007，P1，Major / Charging / OCPP release pack。