From b69b6a93b39a625a5b414b35c4b1dab701330708 Mon Sep 17 00:00:00 2001 From: awei Date: Wed, 29 Jul 2026 14:47:27 +0800 Subject: [PATCH] =?UTF-8?q?docs(app):=20=E5=9B=9E=E5=A1=AB=E6=95=91?= =?UTF-8?q?=E5=9B=9E=E4=B8=89=E9=A0=85=E7=9A=84=E6=A8=A1=E6=93=AC=E5=99=A8?= =?UTF-8?q?=E5=AF=A6=E8=B7=91=E9=96=89=E7=92=B0=EF=BC=88=E5=85=A9=E9=A0=85?= =?UTF-8?q?=E9=80=9A=E9=81=8E=E3=80=81=E5=BF=83=E8=B7=B3=E9=80=99=E5=B1=A4?= =?UTF-8?q?=E9=A9=97=E4=B8=8D=E5=88=B0=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 司機端跨裝置停靠點同步:API 標記到達後手機未觸碰,5 秒內下一站自動前移、地圖重畫。 乘客端建單 409 接手:畫面直接切到配對中;ride_events 只有兩筆 ride.requested (都是 curl 建的)=App 那次按下沒有產生新訂單,交叉證明走的是接手路徑。 WS 心跳:客戶端 ping 在後端沒有可觀察痕跡,維持單元測試層證據並寫明原因。 Co-Authored-By: Claude Opus 5 --- docs/TODO.md | 35 ++++++++++++++++++++++++++++++----- 1 file changed, 30 insertions(+), 5 deletions(-) diff --git a/docs/TODO.md b/docs/TODO.md index 1d01135..2a34b5c 100644 --- a/docs/TODO.md +++ b/docs/TODO.md @@ -947,8 +947,32 @@ admin 的全域 query 錯誤處理有去重 key 且整個 repo 沒有 `refetchIn `fleet_ws_client_test.dart` 兩案(心跳)。**反向確認**:拿掉 `ride.stop_updated` 處理後 1 案 FAIL、拿掉 409 分支後 2 案 FAIL;心跳那案先斷言預設 `pingInterval` 為 null 再斷言設定後的值,避免寫出恆真的斷言。 -**未做**:這三項都**沒有模擬器實跑**(半開連線要斷網卡層級的手法才造得出來, -409 與跨裝置停靠點需要兩台裝置+後端),只有單元測試與反向確認。 +**✅ 模擬器實跑閉環(2026-07-29 同日補做,`m6_pixel` 雙 flavor + dispatch docker compose,全程截圖)**—— +原本這三項只有單元測試,當天稍後補跑,**兩項閉環、一項確認無法在這層驗**: + +- **司機端跨裝置停靠點同步 ✅**(救自 #61 + dispatch#53): + 司機 `sim29drv`(driver 10)登入→上線(**Redis `drivers:geo` 含 10、`driver:10:loc` 存在 + =真的在派單池**)→ 乘客以 API 建 2 乘客 4 站訂單 ride #16 → **全螢幕接單卡** + (帶「多乘客行程(4 站)」chip)→ 接單 → 行程卡列出全程 4 站、下一站「1. 乘客 A上車」帶操作鈕。 + 接著**用 API 標記 stop 7 到達(=第二台裝置/LINE 那條路徑)**, + **手機全程未觸碰**:5 秒後第 1 站變綠勾「已完成」、下一站自動前移到「2. 乘客 B上車」 + 並帶操作鈕、地圖上該站的紅釘轉灰、B 站變成醒目紅釘。 + 修正前這台會**永遠停在第 1 站**(PR #61 實測是 8 分鐘沒動)。 +- **乘客端建單 409 接手 ✅**(救自 #60): + 乘客 `sim29cust`(customer 9)登入、**畫面上沒有任何進行中訂單**(此時 App 也不輪詢)→ + 以 API 建 ride #17(=另一台裝置/LINE)→ **立刻在 App 按「叫車」** → + 後端回 409 →**畫面直接切到「正在為您配對司機」**,不是錯誤 SnackBar。 + **交叉驗證(決定性)**:`ride_events` 裡 customer 9 的 `ride.requested` **只有兩筆 + (#16、#17,都是 curl 建的)**——App 那次按下**沒有產生任何新訂單**, + 且 `GET /customer/rides` 回 `[(17,1),(16,9)]` 沒有第三張單。 + 接手的 ride #17 的 `pickup_address` 是「API建的上車點」,**不是 App 表單裡的值**, + 證明畫面上的行程來自後端而非本地樂觀狀態。 + (這條路徑不可能來自別的機制:無進行中訂單時輪詢是停的,而 `ride.assigned` 在 + `_activeRide == null` 時會早退。) +- **WS 心跳 ⚠️ 這層驗不到**:客戶端 ping 由 dart:io 直接送控制幀, + gorilla 的預設 PingHandler 自動回 pong 但不寫 log,後端也沒有可觀察的計數器; + 要證明只能封包擷取。**維持單元測試層的證據**(在真 socket 上斷言 + `pingInterval` 從 null 變成 20 秒),半開連線的實機重現需要斷網卡層級的手法。 ### 兩個 GitHub 操作坑(下次做 stacked PR 一定會再踩) @@ -1036,9 +1060,10 @@ admin 的全域 query 錯誤處理有去重 key 且整個 repo 沒有 `refetchIn > **8 支 open PR**,其中兩支是同一個功能的獨立實作——**平行 worktree 的 session > 彼此看不見對方**,題目又都取自本檔的「下一輪 debug 角落」清單,撞題是必然的。 > 要嘛開工前先看 PR 佇列,要嘛在本檔把認領的題目**當場劃掉**。 -> 2. **本批救回的三項只有單元測試,沒有模擬器實跑**:WS 心跳(半開連線)、 -> 建單 409 接手、司機端跨裝置 `ride.stop_updated`。 -> 有機會起兩台裝置+docker 時,這三條值得各跑一次真機閉環。 +> 2. ~~**本批救回的三項只有單元測試,沒有模擬器實跑**~~ ✅ **同日補完**(見上方專段): +> 司機端跨裝置停靠點同步、乘客端建單 409 接手**都已在 `m6_pixel` 上閉環** +> (含 `ride_events` 交叉驗證「App 那次按下沒有產生新訂單」)。 +> **只剩 WS 心跳驗不到**——客戶端 ping 在後端沒有可觀察的痕跡,要證明得封包擷取。 > 3. **stacked PR 的兩個 GitHub 坑**(`--delete-branch` 連帶關閉、 > `pull_request: branches: [main]` 的 base 過濾器擋掉 CI)已寫在上方專段, > 下次再疊 PR 前先看那兩條。