Skip to content

fix(app): 點推播喚醒的事件在沒人訂閱時被丟掉——冷啟動補送(第十二輪) - #79

Merged
thothawei merged 1 commit into
mainfrom
claude/fleet-project-continue-50b60c
Jul 29, 2026
Merged

thothawei merged 1 commit into
mainfrom
claude/fleet-project-continue-50b60c

Conversation

@thothawei

Copy link
Copy Markdown
Owner

根因(一句話)

FirebaseFleetPushService 用 StreamController.broadcast(),而廣播串流在沒有訂閱者的
當下 add 的事件會直接消失
(Dart 不緩衝)。冷啟動的順序正好是這樣:

main() → createXxxPushService() → initialize() → getInitialMessage() → _events.add(事件)
       → runApp() → Controller.init() → ... → rideEvents.listen(...)   ← 訂閱在這裡才發生

getInitialMessage() 是「App 被殺 → 點通知 → 冷啟動」唯一的取得管道,
而它在 runApp 之前就把事件送出去了。於是:

  • 司機端:A2 的招牌情境「App 被殺 → 點推播 → 接單卡」——卡片永遠不會出現。
  • 乘客端:第十一輪剛接好的「點推播 → 跟後端對帳」——對帳永遠不會發生。

兩端寫好的處理都在,缺的是事件本身。同一個形狀在本專案出現過很多次
(「處理寫好了,訊號從沒到達」),差別是這次的斷點在 App 自己的串流層,不是跨端契約。

改法

新增 PendingReplaySink<T>:沒有訂閱者時把事件留著,第一個訂閱者上來時用 microtask 補送
(onListen 在訂閱建立過程中被呼叫,當下同步 add 不保證送得到那位訂閱者)。
FirebaseFleetPushService._events 換成它,其餘不動。

  • 只留最後一則:這些事件的用途都是「開一張卡」或「去對一次帳」,補送一整串舊事件
    只會讓畫面閃過一連串過期狀態。
  • 補送過就丟掉:登出後重新訂閱不會再收到同一則。

驗收

  • flutter analyze 無 issue、flutter test 317 passed(312 +新 5)。
  • 反向確認:把 add 退回普通廣播行為(直接 _controller.add),3 案 FAIL。
  • 未做:真裝置端到端(同 A2,卡 google-services.json)。這批修的是「事件到不到得了
    訂閱者」,純 Dart 串流語意,不需要 Firebase 就能釘住。

同批的文件與維護

  • 回填 TODO/README:後端乘客推播的送出路徑已補
    (dispatch PR #61)——
    整條鏈路現在只剩 Firebase 憑證。
  • 維護項 8 做掉:移除兩個殘留 worktree 與五支已合併的本機分支
    (判定用兩點 diff,squash 合併下 git branch --merged 全漏)。
  • 外部資源第三次實查(2026-07-30):兩個 Firebase 設定檔仍不存在、xcrun devicectl 無裝置。

🤖 Generated with Claude Code

FirebaseFleetPushService 用 StreamController.broadcast(),而廣播串流在沒有訂閱者的
當下 add 的事件會直接消失(Dart 不緩衝)。冷啟動的順序正好是這樣:

  main() → createXxxPushService() → initialize() → getInitialMessage() → _events.add(事件)
         → runApp() → Controller.init() → ... → rideEvents.listen(...)

getInitialMessage() 是「App 被殺 → 點通知 → 冷啟動」唯一的取得管道,
而它在 runApp 之前就送出去了。於是司機端「被殺 → 點推播 → 接單卡」(A2 的招牌情境)
與乘客端「點推播 → 跟後端對帳」(第十一輪剛接好的)兩條都是死路徑——
兩端寫好的處理都在,缺的是事件本身。

改法:新增 PendingReplaySink,沒有訂閱者時留著**最後一則**,第一個訂閱者上來時
用 microtask 補送(onListen 在訂閱建立過程中被呼叫,當下同步 add 不保證送得到)。
補送過就丟掉,登出後重新訂閱不會再收到同一則。

驗收:flutter analyze 無 issue、flutter test 317 passed(312+新 5)。
反向確認:把 add 退回普通廣播行為,3 案 FAIL。
真裝置端到端仍卡 google-services.json(同 A2)——這批修的是純 Dart 串流語意,不需憑證。

文件:TODO 第十二輪專段、README 回填後端送出路徑已補(dispatch #61)與測試數 317。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@thothawei
thothawei merged commit 2ad5ddd into main Jul 29, 2026
2 checks passed
@thothawei
thothawei deleted the claude/fleet-project-continue-50b60c branch July 29, 2026 18:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant