From a1ecd68e5a1d56eb7c06ff6a8230714704a3b6a1 Mon Sep 17 00:00:00 2001 From: awei Date: Thu, 30 Jul 2026 00:41:04 +0800 Subject: [PATCH] =?UTF-8?q?feat(dispatch):=20=E5=B0=8D=E8=A9=B1=E8=A8=8A?= =?UTF-8?q?=E6=81=AF=E4=B9=9F=E9=80=81=E6=8E=A8=E6=92=AD=E2=80=94=E2=80=94?= =?UTF-8?q?=E6=8E=A8=E7=B5=A6=E6=94=B6=E8=A8=8A=E9=82=A3=E4=B8=80=E6=96=B9?= =?UTF-8?q?=EF=BC=88U2=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 對話先前只走 WS:對方 App 一離開前景 WS 就斷了,訊息只會躺在伺服器上, 要等他自己再打開 App 才看得到。「司機到了要聯絡乘客」「乘客回報遺失物」都因此斷線。 這是 Phase 2 清單上掛很久的「聊天訊息 FCM 推播(App 被殺時)」。 - Dispatcher 加 NotifyDriverRideUpdate,與 NotifyCustomerRideUpdate 共用 notifyRideUpdate (差別只在查哪個角色的裝置)。與 NotifyDriverRideOffer 分開:那支是派單邀請(要開接單卡), 這支是行程進行中的通知。 - ChatService.Send 發完 WS 後推給收訊那一方;**不推給發話者自己的其他裝置**—— 系統匣跳出自己剛送出的訊息只會讓人以為對方回話了。 - 訊息內容放通知本文、不放 data(data 仍只有 type+ride_id):App 醒來後仍以 REST 重讀對話拿完整歷史。本文以 rune 計截斷 60 字,用 byte 截會把中文切成亂碼。 - 用 context.Background():HTTP 回應一送出請求 ctx 就被取消,推播會被腰斬。 驗收:go test ./internal/service -run TestChatSend_ 三支整合測試(真 PostGIS+Redis)通過 +TestPreviewText。反向確認:拿掉 pushToRecipient,「推給對方」那支 FAIL(0 則)。 Co-Authored-By: Claude Opus 5 --- README.md | 2 - cmd/server/main.go | 3 + docs/TODO.md | 35 +++++++- internal/notify/notify.go | 24 +++++- internal/service/chat.go | 51 ++++++++++- internal/service/chat_push_test.go | 133 +++++++++++++++++++++++++++++ 6 files changed, 237 insertions(+), 11 deletions(-) create mode 100644 internal/service/chat_push_test.go diff --git a/README.md b/README.md index b99acd1..a39ae49 100644 --- a/README.md +++ b/README.md @@ -164,8 +164,6 @@ Redis 鍵:`drivers:geo`(GEO 位置集合)、`driver:{id}:loc`(最新位 - **F9-7 `rides` 月分割**:量體達千萬級時依 `completed_at` 做 declarative partitioning。 - **`drivers`/`membership_invoices` 真分頁**:逼近 `MaxListRows=5000` 時比照 `rides` 改 offset/keyset 伺服器端分頁(含前端)。 -- **聊天訊息 FCM 推播**:App 被殺時收不到 `chat.message`(司機派單 A2 與**乘客行程狀態** - 推播皆已實作,見 docs/TODO.md「U. 乘客端 App 推播的送出路徑」;缺的只剩聊天這一種)。 - **F3 強化(可選)**:軌跡稀疏偵測目前用「軌跡 vs 路線取大者」,是否再加 「後台手動校正單筆車資」待產品定。 - **評分的營運動作**(B5 下游):目前三端都只「看得到」評分,**沒有低分司機的處理流程** diff --git a/cmd/server/main.go b/cmd/server/main.go index 47b2b1c..f7599b0 100644 --- a/cmd/server/main.go +++ b/cmd/server/main.go @@ -171,6 +171,9 @@ func main() { rideStopService := service.NewRideStopService(rideRepo, rideStopRepo) rideStopService.SetPublisher(hub) // N7:到站/跳過即時推給乘客(行程進度) chatService := service.NewChatService(rideRepo, rideMessageRepo, hub) + // 對話推播:對方 App 不在前景時 WS 早就斷了,漏了這行訊息只會躺在伺服器上, + // 要等他自己再打開 App 才看得到。 + chatService.SetAppNotifier(appNotify) lostItemService := service.NewLostItemService(rideRepo, lostItemRepo, feeSettings, hub) if cfg.AppEnv == "production" { diff --git a/docs/TODO.md b/docs/TODO.md index 4bd722e..53fcd47 100644 --- a/docs/TODO.md +++ b/docs/TODO.md @@ -1096,6 +1096,34 @@ admin 取消各驗到一則推播,乘客自己取消驗到**沒有**推播。 沒有憑證時走 `LogPusher` stub——這條路徑照樣可驗(log 印得出要送給誰、送什麼 data), 但手機不會真的響。憑證到位後不必再改程式碼。 +### U2. 對話訊息推播(2026-07-30,接著同一條地基做) + +> 這是 Phase 2 清單上掛了很久的「聊天訊息 FCM 推播(App 被殺時)」。 +> 對話先前**只走 WS**:對方 App 一離開前景 WS 就斷了,訊息只會躺在伺服器上, +> 要等他自己再打開 App 才看得到——「司機到了要聯絡乘客」「乘客回報遺失物」都因此斷線。 + +- [x] `Dispatcher` 加 **`NotifyDriverRideUpdate`**(與 `NotifyCustomerRideUpdate` 共用 + `notifyRideUpdate`,差別只在查哪個角色的裝置)。與 `NotifyDriverRideOffer` 分開, + 是因為用途不同:那支是派單邀請(要開接單卡),這支是行程進行中的通知。 +- [x] `ChatService.Send` 寫入並發 WS 後,**推給收訊那一方**:乘客發話推司機、司機發話推乘客。 + **不推給發話者自己的其他裝置**——他知道自己說了什麼,系統匣跳出自己剛送出的訊息 + 只會讓人以為對方回話了。 +- [x] **訊息內容放通知本文、不放 data**(`data` 仍只有 `type`+`ride_id`): + 使用者看得到的就是要看內容,但 App 醒來後仍以 REST 重讀對話拿完整歷史, + 避免推播裡的那一則與伺服器狀態各說各話。本文以 **rune 計截斷 60 字**—— + 用 byte 截會把中文切成亂碼。 +- [x] **用 `context.Background()` 而非請求的 ctx**:HTTP 回應一送出請求 ctx 就被取消, + 推播是回應之後才完成的背景動作,掛在請求 ctx 上會被腰斬。 + +**驗收(2026-07-30 實跑)**:`go test ./internal/service -run TestChatSend_` 三支整合測試 +(真 PostGIS + Redis)通過——推給對方而非發話者、尚未指派司機時不推、未注入 notifier +仍能發話;另有 `TestPreviewText` 釘住 rune 截斷。 +**反向確認**:拿掉 `pushToRecipient` 呼叫,「推給對方」那支 FAIL(0 則)。 + +**App 端同批**:`chat.message` 進兩端推播白名單、收到時**只點亮未讀角標** +(推播 data 沒有訊息本體,餵給 `RideMessage.fromJson` 只會解析失敗被丟掉; +內容等聊天室自己以 REST 補齊)。 + --- ## 下次任務 @@ -1136,10 +1164,9 @@ admin 取消各驗到一則推播,乘客自己取消驗到**沒有**推播。 計費地基 **F1–F8+F3 里程退路+F9-1~F9-6+M 整數台幣 已全數合併進 main**,三端對帳與 F3/F9-3/F9-4 皆 docker E2E 驗過。 其餘皆屬「量體上升後才需」的大資料量最佳化,勿過早做: -1. **協尋/對話 Phase 2 剩餘**:遺失物處理費真金流(目前記帳式確認); - 聊天訊息 FCM 推播(App 被殺時)——**送出的地基已在 U 章備妥** - (`Dispatcher.NotifyCustomerRideUpdate`),要做的是決定聊天訊息要不要另立一種 data type, - 以及 App 端收到後怎麼處理(現行白名單只收行程狀態五種)。~~admin 協尋單總覽+對話稽核 UI~~ ✅ 2026-07-15 +1. **協尋/對話 Phase 2 剩餘**:遺失物處理費真金流(目前記帳式確認)。 + ~~聊天訊息 FCM 推播(App 被殺時)~~ ✅ **2026-07-30 完成**,見 U2。 + ~~admin 協尋單總覽+對話稽核 UI~~ ✅ 2026-07-15 (後端 H4 `GET /api/admin/lost-items`+前端 fleet-frontEnd#11)。 2. **F9-7 rides 月分割**:量體達千萬級時依 `completed_at` 做 declarative partitioning。 3. **drivers/membership 真分頁**:逼近 `MaxListRows=5000` 上限時,比照 rides 改 offset/keyset 伺服器端分頁(含前端)。 diff --git a/internal/notify/notify.go b/internal/notify/notify.go index e74e8bc..c11ea25 100644 --- a/internal/notify/notify.go +++ b/internal/notify/notify.go @@ -79,20 +79,36 @@ func (d *Dispatcher) NotifyDriverRideOffer(ctx context.Context, driverID, rideID // 失敗只打 log:乘客收不到推播的後果是「App 在背景時晚一點才知道」, // 不該讓接單/完成這些主鏈路動作跟著失敗。 func (d *Dispatcher) NotifyCustomerRideUpdate(ctx context.Context, customerID, rideID int64, title, body string, data map[string]string) { + d.notifyRideUpdate(ctx, RoleCustomer, customerID, rideID, title, body, data) +} + +// NotifyDriverRideUpdate 推播「這趟車有新狀況」給司機的所有裝置。 +// +// 與 [Dispatcher.NotifyDriverRideOffer] 的差別是**用途**:那支是派單邀請(要開接單卡), +// 這支是行程進行中的通知(目前是乘客傳來的對話訊息)。 +func (d *Dispatcher) NotifyDriverRideUpdate(ctx context.Context, driverID, rideID int64, title, body string, data map[string]string) { + d.notifyRideUpdate(ctx, RoleDriver, driverID, rideID, title, body, data) +} + +func (d *Dispatcher) notifyRideUpdate( + ctx context.Context, role string, subjectID, rideID int64, + title, body string, data map[string]string, +) { if d == nil || d.tokens == nil { return } - devices, err := d.tokens.ListBySubject(RoleCustomer, customerID) + devices, err := d.tokens.ListBySubject(role, subjectID) if err != nil { - log.Error().Err(err).Int64("customer_id", customerID).Msg("查詢乘客裝置 token 失敗") + log.Error().Err(err).Str("role", role).Int64("subject_id", subjectID). + Msg("查詢裝置 token 失敗") return } if len(devices) == 0 { return } if err := d.push.SendRideUpdate(ctx, devices, rideID, title, body, data); err != nil { - log.Error().Err(err).Int64("customer_id", customerID).Int64("ride_id", rideID). - Msg("App 推播行程狀態失敗") + log.Error().Err(err).Str("role", role).Int64("subject_id", subjectID). + Int64("ride_id", rideID).Msg("App 推播行程狀態失敗") } } diff --git a/internal/service/chat.go b/internal/service/chat.go index 7124e44..32b37a1 100644 --- a/internal/service/chat.go +++ b/internal/service/chat.go @@ -1,13 +1,16 @@ package service import ( + "context" "errors" + "strconv" "strings" "time" "unicode/utf8" "line-fleet-dispatch/internal/events" "line-fleet-dispatch/internal/model" + "line-fleet-dispatch/internal/notify" "line-fleet-dispatch/internal/repository" ) @@ -19,17 +22,25 @@ var ( // chatMaxRunes 單則訊息長度上限(rune 數;DB 另有 char_length ≤ 1000 的最後防線)。 const chatMaxRunes = 500 -// ChatService 乘客↔司機行程內對話:訊息持久化 + WebSocket 即時遞送(chat.message)。 +// ChatService 乘客↔司機行程內對話:訊息持久化 + WebSocket 即時遞送(chat.message) +// + App 推播給**收訊那一方**(對方 App 不在前景時 WS 早就斷了)。 type ChatService struct { rides *repository.RideRepository messages *repository.RideMessageRepository publisher events.Publisher + appNotify *notify.Dispatcher } func NewChatService(rides *repository.RideRepository, messages *repository.RideMessageRepository, publisher events.Publisher) *ChatService { return &ChatService{rides: rides, messages: messages, publisher: publisher} } +// SetAppNotifier 注入 App 推播;可選,未注入時只有 WS +// (=對方 App 一離開前景,訊息就要等他自己再打開才看得到)。 +func (s *ChatService) SetAppNotifier(d *notify.Dispatcher) { + s.appNotify = d +} + // Send 驗證發話者是該趟行程的乘客/被指派司機後寫入訊息,並即時推播給行程雙方。 // 行程任何狀態皆可傳訊(完成後的遺失物協尋也走同一條對話)。 func (s *ChatService) Send(role string, senderID, rideID int64, body string) (*model.RideMessage, error) { @@ -62,9 +73,47 @@ func (s *ChatService) Send(role string, senderID, rideID int64, body string) (*m RideID: rideID, Payload: rideMessagePayload(msg), }) + s.pushToRecipient(ride, msg) return msg, nil } +// pushToRecipient 推播給**對方**(不推給發話者自己的其他裝置——他知道自己說了什麼, +// 而系統匣跳出自己剛送出的訊息只會讓人以為對方回話了)。 +// +// 用 context.Background() 而非請求的 ctx:HTTP 回應一送出,請求 ctx 就被取消, +// 推播是回應之後才完成的背景動作,掛在請求 ctx 上會被腰斬。 +func (s *ChatService) pushToRecipient(ride *model.Ride, msg *model.RideMessage) { + if s.appNotify == nil { + return + } + ctx := context.Background() + data := map[string]string{ + "type": events.TypeChatMessage, + "ride_id": strconv.FormatInt(ride.ID, 10), + } + // 訊息內容放在通知本文(使用者看得到就是要看內容),**不放進 data**—— + // App 醒來後重讀對話 REST 拿完整歷史,避免推播裡的一則與伺服器狀態各說各話。 + body := previewText(msg.Body) + switch msg.SenderRole { + case events.RoleCustomer: + if ride.DriverID != nil { + s.appNotify.NotifyDriverRideUpdate(ctx, *ride.DriverID, ride.ID, "乘客傳來訊息", body, data) + } + case events.RoleDriver: + s.appNotify.NotifyCustomerRideUpdate(ctx, ride.CustomerID, ride.ID, "司機傳來訊息", body, data) + } +} + +// previewText 通知本文的預覽長度上限(rune 計,避免切壞中文)。 +func previewText(body string) string { + const maxRunes = 60 + runes := []rune(body) + if len(runes) <= maxRunes { + return body + } + return string(runes[:maxRunes]) + "…" +} + // List 讀取歷史訊息(本趟乘客/司機;admin 唯讀可稽核),afterID 供增量補讀。 func (s *ChatService) List(role string, subjectID, rideID, afterID int64, limit int) ([]model.RideMessage, error) { ride, err := s.rides.GetByID(rideID) diff --git a/internal/service/chat_push_test.go b/internal/service/chat_push_test.go new file mode 100644 index 0000000..0725800 --- /dev/null +++ b/internal/service/chat_push_test.go @@ -0,0 +1,133 @@ +package service + +import ( + "strings" + "testing" + + "line-fleet-dispatch/internal/constants" + "line-fleet-dispatch/internal/events" + "line-fleet-dispatch/internal/repository" +) + +// 對話訊息先前**只走 WS**:對方 App 一離開前景 WS 就斷了,訊息只會躺在伺服器上, +// 要等他自己再打開 App 才看得到。這組測試釘住「推給對方、不推給自己」。 + +func TestChatSend_推播給對方而不是發話者(t *testing.T) { + db := newServiceTestDB(t) + customers := repository.NewCustomerRepository(db) + drivers := repository.NewDriverRepository(db) + rides := repository.NewRideRepository(db) + messages := repository.NewRideMessageRepository(db) + + cust, err := customers.FindOrCreateByLineUserID("U_chatpush_cust", "乘客") + if err != nil { + t.Fatalf("建立乘客失敗:%v", err) + } + driver, err := drivers.FindOrCreate("U_chatpush_driver", "司機") + if err != nil { + t.Fatalf("建立司機失敗:%v", err) + } + ride := newTestRide(t, rides, cust.ID, constants.RideStatusRequested) + if err := rides.AcceptRide(ride.ID, driver.ID, 300); err != nil { + t.Fatalf("指派司機失敗:%v", err) + } + + chat := NewChatService(rides, messages, &fakePublisher{}) + n, pusher := newFakeNotifier() + chat.SetAppNotifier(n) + + if _, err := chat.Send(events.RoleCustomer, cust.ID, ride.ID, "我在 7-11 門口"); err != nil { + t.Fatalf("乘客發話失敗:%v", err) + } + pushes := pusher.customerPushes() + if len(pushes) != 1 { + t.Fatalf("乘客發話應只推一則(給司機),得到 %d 則:%v", len(pushes), pushes) + } + if pushes[0].data["type"] != events.TypeChatMessage { + t.Errorf("data.type=%q,預期 chat.message", pushes[0].data["type"]) + } + if pushes[0].title != "乘客傳來訊息" { + t.Errorf("title=%q", pushes[0].title) + } + + if _, err := chat.Send(events.RoleDriver, driver.ID, ride.ID, "我五分鐘後到"); err != nil { + t.Fatalf("司機發話失敗:%v", err) + } + pushes = pusher.customerPushes() + if len(pushes) != 2 { + t.Fatalf("司機回話後應累計 2 則推播,得到 %d", len(pushes)) + } + if pushes[1].title != "司機傳來訊息" { + t.Errorf("title=%q", pushes[1].title) + } + // 每則都只送一次:推給發話者自己的裝置只會讓他以為對方回話了。 + // (fakePusher 對任何角色都回一台裝置,所以「推給雙方」在這裡會是 2 則。) +} + +// 還沒派到司機的訂單,乘客發話不該 panic,也不該推給不存在的司機。 +func TestChatSend_尚未指派司機時不推播(t *testing.T) { + db := newServiceTestDB(t) + customers := repository.NewCustomerRepository(db) + rides := repository.NewRideRepository(db) + messages := repository.NewRideMessageRepository(db) + + cust, err := customers.FindOrCreateByLineUserID("U_chatpush_nodriver", "乘客") + if err != nil { + t.Fatalf("建立乘客失敗:%v", err) + } + ride := newTestRide(t, rides, cust.ID, constants.RideStatusRequested) + + chat := NewChatService(rides, messages, &fakePublisher{}) + n, pusher := newFakeNotifier() + chat.SetAppNotifier(n) + + if _, err := chat.Send(events.RoleCustomer, cust.ID, ride.ID, "有人嗎"); err != nil { + t.Fatalf("發話失敗:%v", err) + } + if got := len(pusher.customerPushes()); got != 0 { + t.Fatalf("沒有司機時不該推播,得到 %d 則", got) + } +} + +// 未注入 notifier(既有測試與舊部署)照常運作,只是沒有推播。 +func TestChatSend_未注入notifier不影響發話(t *testing.T) { + db := newServiceTestDB(t) + customers := repository.NewCustomerRepository(db) + rides := repository.NewRideRepository(db) + messages := repository.NewRideMessageRepository(db) + + cust, err := customers.FindOrCreateByLineUserID("U_chatpush_nonotify", "乘客") + if err != nil { + t.Fatalf("建立乘客失敗:%v", err) + } + ride := newTestRide(t, rides, cust.ID, constants.RideStatusRequested) + + chat := NewChatService(rides, messages, &fakePublisher{}) + if _, err := chat.Send(events.RoleCustomer, cust.ID, ride.ID, "沒有推播也要能發話"); err != nil { + t.Fatalf("發話失敗:%v", err) + } +} + +// 通知本文是預覽,太長要截斷——系統匣本來就顯示不完, +// 而且切點必須以 rune 計,否則中文會被切成亂碼。 +func TestPreviewText(t *testing.T) { + short := "我在門口" + if got := previewText(short); got != short { + t.Errorf("短訊息不該改動:%q", got) + } + + long := strings.Repeat("測", 100) + got := previewText(long) + runes := []rune(got) + if len(runes) != 61 { // 60 + 省略號 + t.Fatalf("截斷後 rune 數=%d,預期 61", len(runes)) + } + if runes[len(runes)-1] != '…' { + t.Errorf("截斷後應以省略號結尾:%q", got) + } + for _, r := range runes[:60] { + if r != '測' { + t.Fatalf("切點切壞了中文:%q", got) + } + } +}