patbond-flutter

zhaoyuxi/patbond-flutter

Fork 0

Commit Graph

Author	SHA1	Message	Date
lixi	4d40c38f06	新增：埋点队列三项完善——30 秒定时冲刷、失败指数退避、anonymousId 持久化（T3-19） CI / flutter-gates (push) Successful in 2m15s Details - 30 秒定时冲刷：AnalyticsService.startPeriodicFlush/stopPeriodicFlush，前台期间 Timer.periodic 周期冲刷；SessionTracker 新增 onEnterForeground 回调，退后台停（并保留既有 flushNow 触发）、回前台恢复，App dispose 收尾。 - 失败退避：网络错误/5xx 后 30s→60s→120s 指数退避封顶 5 分钟，退避窗口只挡定时冲刷（flushNow/满 20/冷启动显式触发不受限），上传成功即重置； 429 改按网络错误同路径保段重试（Retry-After 分支待后端限流落地）。 - anonymousId 持久化：restore 时从 shared_preferences 采用/落盘 pb.analytics.anonymousId，首次生成后跨冷启动稳定；读取失败降级进程内临时 id 不崩溃。 - 测试 272 → 286（+14）：fakeAsync 定时/退避 8 个、anonymousId 4 个、 429 保段 1 个、前后台回调成对 1 个；analyze 0 问题、format 无 diff。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-09-08 16:12:19 +08:00
lixi	33b993ca0c	新增：埋点分段持久化队列（13 号规范 §3.3，M2 第二波） CI / flutter-gates (push) Successful in 1m6s Details - AnalyticsEventStore：shared_preferences 分段存储（每段 ≤20 条、总上限 500 超限丢最旧整段）、冷启动恢复、损坏段/损坏索引容错、 droppedCount 丢弃诊断计数 - AnalyticsService 接入持久化队列：上传拿到终态（202/4xx）才删段实现 at-least-once；冲刷按段拼批 ≤50 条循环上传（契约单批上限）；取批即封段，冲刷在途新事件写入新开放段不丢 - app.dart 冷启动 restore() 恢复离线积压并冲刷（13 号 §3.4 触发点） - 保留第一波语义：flushNow()、4xx 毒丸丢弃、满 20 条冲刷触发 - 新增 13 个单测（恢复/上限淘汰/损坏容错/202 清段/flushNow 协同/ 分批上传），全套 64 测试全绿 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-09-07 17:04:16 +08:00

Author

SHA1

Message

Date

lixi

4d40c38f06

新增：埋点队列三项完善——30 秒定时冲刷、失败指数退避、anonymousId 持久化（T3-19）

CI / flutter-gates (push) Successful in 2m15s

Details

- 30 秒定时冲刷：AnalyticsService.startPeriodicFlush/stopPeriodicFlush，
  前台期间 Timer.periodic 周期冲刷；SessionTracker 新增 onEnterForeground
  回调，退后台停（并保留既有 flushNow 触发）、回前台恢复，App dispose 收尾。
- 失败退避：网络错误/5xx 后 30s→60s→120s 指数退避封顶 5 分钟，退避窗口
  只挡定时冲刷（flushNow/满 20/冷启动显式触发不受限），上传成功即重置；
  429 改按网络错误同路径保段重试（Retry-After 分支待后端限流落地）。
- anonymousId 持久化：restore 时从 shared_preferences 采用/落盘
  pb.analytics.anonymousId，首次生成后跨冷启动稳定；读取失败降级
  进程内临时 id 不崩溃。
- 测试 272 → 286（+14）：fakeAsync 定时/退避 8 个、anonymousId 4 个、
  429 保段 1 个、前后台回调成对 1 个；analyze 0 问题、format 无 diff。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-09-08 16:12:19 +08:00

lixi

33b993ca0c

新增：埋点分段持久化队列（13 号规范 §3.3，M2 第二波）

CI / flutter-gates (push) Successful in 1m6s

Details

- AnalyticsEventStore：shared_preferences 分段存储（每段 ≤20 条、
  总上限 500 超限丢最旧整段）、冷启动恢复、损坏段/损坏索引容错、
  droppedCount 丢弃诊断计数
- AnalyticsService 接入持久化队列：上传拿到终态（202/4xx）才删段
  实现 at-least-once；冲刷按段拼批 ≤50 条循环上传（契约单批上限）；
  取批即封段，冲刷在途新事件写入新开放段不丢
- app.dart 冷启动 restore() 恢复离线积压并冲刷（13 号 §3.4 触发点）
- 保留第一波语义：flushNow()、4xx 毒丸丢弃、满 20 条冲刷触发
- 新增 13 个单测（恢复/上限淘汰/损坏容错/202 清段/flushNow 协同/
  分批上传），全套 64 测试全绿

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-09-07 17:04:16 +08:00

2 Commits