一張訂單敲門,回饋要交給誰?

成單事件只帶來訂單資料。活動要先找出來,才知道接下來該派給哪一個回饋 Job。

一張訂單剛成立,系統收到 OrderCreated 事件。事件帶來商店、TG 編號與訂單成立時間,卻沒有附上「應參加哪些活動」的答案。

一則事件,如何變成多筆工作

箭頭表示工作交接。找到幾檔符合時間的活動,就可能建立幾筆子 Task;建立 Task 尚不代表回饋成功。

PromotionRewardLoyaltyPointsDispatcherV2 像派件員。它先看訂單當時有哪些活動,再把每檔活動交給對應的子 Task。名稱裡雖有 LoyaltyPoints,實際上也派送優惠券。

派件員不計算最後該給幾點、幾張券,也不親自發放。真正的門檻判斷與回饋紀錄由下游 Job 處理。

先核對時間,再讓活動各自處理

同一張訂單可能遇到多檔活動。先拆成獨立工作,才不用把所有計算都擠在一個 dispatcher 裡。

OrderCreated 事件只說「這張 TG 成立了」,沒有說「請交給活動 101」。Dispatcher 得先判斷訂單成立時間是否落在每檔活動的期間內。

時間對不上,就不會建立這檔活動的 Task

時間條件為 StartDateTime ≤ OrderDateTime ≤ EndDateTime。這是訂單時間點與活動期間的比較,還不是金額或會員門檻的計算。

若把每個「訂單 × 活動」組合的讀規則、算條件、發回饋都放進 dispatcher,活動越多,單一 Job 就跑越久;其中一檔卡住,後面的活動也得等。現在由 dispatcher 先篩時間與類型,再讓各筆子 Task 處理完整規則。

派送階段仍逐筆 await CreateAsync。若建立某筆子 Task 失敗,當次尚未派出的活動仍會受影響。

10:00 查活動,10:03 才開始的怎麼辦?

候選活動會快取 5 分鐘。查詢先往未來多看 30 分鐘,避免稍後成立的訂單找不到剛開始的活動。

PromotionEngineService 透過 Promotion Service 的 POST api/promotion-rules/ongoing-list 取得候選活動,按商店快取 5 分鐘。遠端查詢從執行當下往前 7 天,一直查到執行當下往後 30 分鐘。往前是為了涵蓋 ATM 等非即時付款的時間差;往後則是替快取期間即將開始的活動預留位置。

把時鐘撥到 10:00

10:00,建立候選活動快取

查詢終點設為 10:30,讓已存在、預定 10:03 開始的活動先進清單。

10:03,活動開始

這檔活動已在候選清單裡,不必等快取過期後重新查詢。

10:04,新訂單成立

仍讀同一份快取,但用這張訂單的 OrderDateTime 再比一次活動期間。

如果 10:00 查詢只抓到當下,預定 10:03 開始的活動可能不在快取中;10:04 的訂單便無從命中它。

進了候選清單,也不能提早命中

訂單時間活動開始結果
10:0010:03尚未開始,排除
10:0410:03時間對得上,可以派送
每筆訂單都套用 StartDateTime ≤ OrderDateTime ≤ EndDateTime。30 分鐘是候選查詢緩衝,不是快取期限。

活動若在快取建立後才新增,既有快取不會因 30 分鐘緩衝而立即更新;仍須等後續刷新。

點數走點數,券走券

同樣是時間有效的活動,類型不同,派去的 Job 不同;點數活動還多一道 ExtendInfo 檢查。

活動類型決定派送方向

送點類型為 RewardReachPriceWithPoint2 與 RewardReachPriceWithRatePoint2;送券類型為 RewardReachPriceWithCoupon。優惠券分支不檢查 ExtendInfo。

Dispatcher 先逐檔建立點數 Task,再處理優惠券。每檔活動各有一筆 PromotionRewardRequestEntity:

交給子 Job 的資料

欄位來源
ShopId成單事件的商店
TradesOrderGroupCode成單事件的 TG 編號
OrderDateTime訂單成立時間
PromotionEngineId這一檔活動的 ID
EventSourceOrderCreated
每檔活動各建一筆資料,子 Job 收到後再讀規則與計算回饋。

活動有非空白 GroupCode 時,程式視為佔額活動,將 BookingTime 設為建立當下的 UTC 時間再加 5 分 10 秒。多出的 10 秒,是為了避免剛好 5 分鐘時立即執行。

同一張 TG,最後分出幾張工作單?

用三檔候選活動走一次,就能看見時間、ExtendInfo 與 GroupCode 各自在哪一步發揮作用。

假設 10:04 有一張 TG 成立,同一商店有三檔候選活動。以下是示意情境,不是實際執行結果。

三檔活動逐一點名

活動當時情況Dispatcher 的動作
送點活動甲10:03 開始,且有 ExtendInfo建立一筆給點 Task
送點活動乙時間有效,但沒有 ExtendInfo不建立給點 Task
送券活動丙時間有效,且有 GroupCode建立一筆給券 Task,安排約 5 分 10 秒後執行
三檔候選活動中,這個例子建立了兩筆子 Task。是否真的給點或給券,要等下游 Job 判斷。

這張 TG 的交接順序

事件報到

OrderCreated 提供商店、TG 與訂單時間。

Dispatcher 篩選

核對活動時間與類型,再處理 ExtendInfo 等派送條件。

子 Job 接手

一檔活動一筆 Task;各自判斷門檻、計算並處理回饋。

同一張 TG 可以拆成多筆工作,派送成功與回饋成功是兩個不同階段。

訂單取消了,先前的回饋怎麼辦?

成單時派出去的點數與券,遇到取消或退貨還有另一位派件員接手。它找出訂單成立當時有效的活動,再把回收工作交給對應的 Job。

RecycleLoyaltyPointsDispatcherV2 接收 OrderCancelled 或 OrderReturned 事件。事件提供商店與子單 TSCode;取消時間取 CancelDateTime,退貨時間取 ReturnedDateTime。缺少子單代碼或無法取得對應的事件時間時,這次派送就到此結束。

回收派件員如何找到工作

活動用訂單成立時間查,不用取消或退貨時間查。點數活動還需通過 ExtendInfo 檢查;優惠券分支沒有這道檢查。

回收派件員先向 ERP 查 TSCode 的訂單成立時間,再用商店與該時間查活動。每檔入選活動各形成一筆 RecycleRequestEntity,同時帶著訂單成立時間與取消/退貨發生時間。前者用來找活動,後者交給下游處理回收。

兩位派件員的交接差異

情境找活動的時間建立的子 Task
訂單成立,派送回饋事件中的 OrderDateTimePromotionRewardLoyaltyPointsV2 或 PromotionRewardCoupon
訂單取消或退貨,派送回收由 TSCode 查得的訂單成立時間RecycleLoyaltyPointsV2 或 PromotionRecycleCoupon
回收事件發生時,活動可能早已結束;回收派送仍以原訂單成立當時的活動為準。

這支 Job 只建立回收 Task,不直接扣回點數或收回券。點數與券的派送分支並行執行,各分支內逐筆建立 Task;真正的回收結果仍由下游 Job 決定。