foodie-server/docs/order-push-overview.md

訂單推送說明（測試參考）

最後更新: 2026-06-25 用途: 列出訂單流程中所有會觸發推送的場景，供測試驗證。

本文推送文案以繁體中文展示。實際推送時文案會跟隨接收人的語言設置自動切換（支援 簡中 / 越南語 / 英文 / 繁中），但下方表格統一以繁中舉例。

---

一、推送基本說明

• 每條推送會出現在兩個地方：① 手機通知欄（僅 iOS）；② App 內「消息中心」列表（iOS / Android 都有）。
• Android 手機沒有通知欄推送（暫未接入 Android 推送通道），只能在 App 內消息列表看到。
• 推送語言跟隨接收人的語言設置（簡中 / 越南語 / 英文 / 繁中），同一場景不同語言賬號看到的文案不同。
• 正文中的 {訂單號} 是實際訂單編號，會替換成真實號碼。

---

二、推送場景

#	觸發操作	推送對象	標題	通知正文（繁中示例）
1	用戶下單成功	商家	消息	有新訂單,NO:{訂單號}
2a	貨到付款下單成功	商家	消息	有新訂單
2b	貨到付款下單成功	附近騎手	消息	有新訂單
3a	商家點擊「出餐」	用戶	消息	商家已經出餐,訂單號:,NO:{訂單號}
3b	商家點擊「出餐」	騎手	消息	商家已經出餐,訂單號:,NO:{訂單號}
4a	騎手點擊「接單」	用戶	消息	騎手已接單,NO:{訂單號}
4a′	騎手點擊「接單」	商家	消息	騎手已接單,NO:{訂單號}
4b	騎手點擊「取餐」（開始配送）	用戶	消息	騎手配送中,NO:{訂單號}
4c	騎手點擊「送達」	用戶	消息	騎手已送達,NO:{訂單號}
5a	平台後台把訂單改為「騎手已接單」	用戶	消息	騎手已接單,NO:{訂單號}
5a′	平台後台把訂單改為「騎手已接單」	商家	消息	騎手已接單,NO:{訂單號}
5b	平台後台把訂單改為「配送中」	用戶	消息	騎手配送中,NO:{訂單號}
5c	平台後台把訂單改為「已送達」	用戶	消息	騎手已送達,NO:{訂單號}

說明：場景 4 是騎手在騎手端 App 操作；場景 5 是平台後台人工改訂單狀態。兩者推送的文案一樣。

---

三、推送文案對照（繁中）

場景 / 含義	繁體中文（zh_TW）
標題（所有推送通用）	消息
有新訂單	有新訂單
商家已經出餐	商家已經出餐,訂單號:
騎手已接單	騎手已接單
騎手配送中	騎手配送中
騎手已送達	騎手已送達

---

四、測試驗證要點

每個場景觸發後，按接收人登錄對應端（用戶 App / 商家端 / 騎手端）檢查：

1. iOS：通知欄收到推送 + App 內消息列表有新記錄。
2. Android：App 內消息列表有新記錄（通知欄不會有，屬正常）。
3. 文案：標題和正文與上表一致；正文末尾的訂單號與實際訂單一致。
4. 多語言：把接收賬號切到不同語言，文案應隨之變成對應語言。
5. 接收人：確認只有「推送對象」列裡的人收到，其他人不收到。

---

五、已知現狀（測試時知悉即可，不算 Bug）

• 貨到付款下單（場景 2）的通知不帶訂單號：商家 / 騎手通知欄只看到「有新訂單」，看不到具體訂單號（點擊進 App 仍可看到訂單詳情）。
• 商家出餐文案略冗餘：顯示為 商家已經出餐,訂單號:,NO:123（冒號和逗號連在一起），現狀如此。
• 暫不存在的推送（本次不在範圍，測試時不用驗證）：取消訂單、退款、超時無騎手、抽成返還、自動恢復營業等通知，以及 Android 通知欄推送。