From f5d7a26ed6fec7565fb37b6cb512dd7f9048651c Mon Sep 17 00:00:00 2001 From: awei Date: Wed, 29 Jul 2026 18:31:06 +0800 Subject: [PATCH] =?UTF-8?q?docs(todo):=20T=20=E7=AB=A0=E7=AF=80=E5=9B=9E?= =?UTF-8?q?=E5=A1=AB=E2=80=94=E2=80=94=E4=BA=8B=E4=BB=B6=E6=94=B6=E4=BB=B6?= =?UTF-8?q?=E4=BA=BA=E7=9F=A9=E9=99=A3=E6=8A=93=E5=88=B0=E7=9A=84=E4=B8=89?= =?UTF-8?q?=E5=80=8B=E6=B4=9E=E5=B7=B2=E5=85=A8=E9=83=A8=E4=BF=AE=E6=8E=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5 --- docs/TODO.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/docs/TODO.md b/docs/TODO.md index 3297864..ff0efc3 100644 --- a/docs/TODO.md +++ b/docs/TODO.md @@ -1006,9 +1006,21 @@ admin 端對應:fleet-frontEnd PR #22(司機管理頁評價欄、訂單詳 > 後端這份清單上沒有——所以在這裡補記。App 端已各自做了防線, > 下面每一項都寫明「後端不改的話,App 只能做到什麼程度」。 -**已修(同批合併)**: +**已修**: - [x] **`ride.stop_updated` 只推給乘客**(PR #53)。`publishStops` 的註解假設「司機剛做完動作、 會自己重讀 active」——那句話假設司機只有一台裝置。已改為乘客與司機各推一則。 +- [x] **`ride.cancelled` 從來沒推給司機**(PR #56,2026-07-29)。`cancelActiveRide` 的 + 「通知司機」只有 `line.PushText`——**App 司機一則 WS 事件都收不到**,而司機端沒有輪詢, + 行程卡會一直留著:他繼續開往上車點接一個已經取消的乘客,而後端在取消當下就已把他 + 放回 Idle。這是 **PR #52(司機放棄只推 LINE、App 乘客收不到)在司機側的鏡像**。 +- [x] **`ride.picked_up` 只推給乘客**(PR #57,2026-07-29)。司機第二台裝置/LINE 標記上車後, + 這台停在「前往上車點」階段,按鈕按下去只會被後端拒絕、「放棄此單」也已不可用。 + +> **這三個洞是同一次盤點抓到的**:把 13 個事件型別的**實際收件人**列成矩陣 +> (逐一看 `s.publish(...)` 的 `Recipient`),再對照 App 兩端的 handler。 +> 三者的共同形狀是「**App 端早就寫好處理,後端卻從沒送過**」——那段程式碼一直是死碼。 +> 盤點後**剩下的兩個非對稱是刻意的**:`ride.assigned` 只給司機(乘客不需要知道派給誰)、 +> `driver.location` 只給乘客與 admin(司機不必收自己的位置)。 **待處理**: