Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 30 additions & 5 deletions docs/TODO.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 一定會再踩)

Expand Down Expand Up @@ -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 前先看那兩條。
Expand Down
Loading