Skip to content
Merged
Show file tree
Hide file tree
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
2 changes: 0 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 下游):目前三端都只「看得到」評分,**沒有低分司機的處理流程**
Expand Down
3 changes: 3 additions & 0 deletions cmd/server/main.go
Original file line number Diff line number Diff line change
Expand Up @@ -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" {
Expand Down
35 changes: 31 additions & 4 deletions docs/TODO.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 補齊)。

---

## 下次任務
Expand Down Expand Up @@ -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 伺服器端分頁(含前端)。
Expand Down
24 changes: 20 additions & 4 deletions internal/notify/notify.go
Original file line number Diff line number Diff line change
Expand Up @@ -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 推播行程狀態失敗")
}
}

Expand Down
51 changes: 50 additions & 1 deletion internal/service/chat.go
Original file line number Diff line number Diff line change
@@ -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"
)

Expand All @@ -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) {
Expand Down Expand Up @@ -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)
Expand Down
133 changes: 133 additions & 0 deletions internal/service/chat_push_test.go
Original file line number Diff line number Diff line change
@@ -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)
}
}
}
Loading