zhaoyuxi/patbond-flutter
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
36 Commits 2 Branches 1 Tag
main
Commit Graph

8 Commits

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
lixi 1afec6aad1 fix: 埋点上传链路三处修复 + 注册手机号 +86 前缀
CI / flutter-gates (push) Successful in 1m3s
Details 
- events 上传地址接错：AnalyticsService 误用 auth(8081)，实际端点在
  user 服务(8082)，新增 patbondUserApiBaseUrl 并接线
- 冲刷时机：新增 flushNow()，SessionTracker 首次离开前台触发，
  修复低活跃用户凑不满 20 条事件永不上传
- 毒丸批次：4xx 永久性拒绝不再重回队列无限重试，丢弃并打日志
- Web/桌面 Platform API 降级（kIsWeb + _platformName）
- 注册手机号 UI 固定 +86 前缀、提交拼 E.164；AppTextField 支持 prefixText

51 测试全绿、analyze 0 问题；Linux 桌面实测注册成功，
curl 实测后端 /api/v1/events 校验行为符合契约。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-07 16:48:36 +08:00
lixi 8ea6265046 fix: Web 平台 Platform.operatingSystemVersion 不支持降级处理
CI / flutter-gates (push) Successful in 1m5s
Details 
AnalyticsService._defaultOsVersion() 在 Web 平台调用 Platform.operatingSystemVersion
会抛 UnsupportedError，导致 flutter run -d chrome 启动崩溃。加 kIsWeb 判断，
Web 平台降级为 'web-unknown'，Android/iOS 保持动态读取不变。

复现：flutter run -d chrome → 报错 analytics_service.dart:53
修复后：Web 平台正常启动；51 测试全绿、flutter analyze 0 问题。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-07 15:44:17 +08:00
lixi 4c2f839a01 修复：埋点接线与三处偏差（sessionId/eventId/设备信息） 
- 生产接线修复：app.dart 组装时传 analytics 实例给 ApiAuthRepository（_buildRepository），修复 M1 遗留的「生产环境 _analytics 恒为 null、挂接点空转」问题
- sessionId 生命周期：新建 SessionTracker (WidgetsBindingObserver)，冷启动生成 UUIDv7、后台超 30 分钟换新、未超阈值沿用原值，不再每事件随机生成
- eventId 改 UUIDv7：对齐 13 号规范（uuid 包已在依赖，直接用 v7()），保留插入时间局部性
- appVersion 动态注入：package_info_plus（新增依赖）异步读取后 setAppVersion，不再硬编码 '1.0.0+1'
- osVersion 动态读取：Platform.operatingSystemVersion 正则提取主版本（如 android-14），不再硬编码
- 队列顺手加固：上传失败批次重回队首而非整批丢弃（一行级缓解，分段持久化属 M2 第二波）

测试新增 9 例：session_tracker_test（5 例：冷启动/短后台/长后台/级联状态/连续幂等），analytics_service_test 补强 4 例（UUIDv7/sessionId 不再逐事件生成/appVersion 可注入/失败重回队列）。

验收对照（06 号报告 §5.1 六条）：1✓ SessionTracker 新建、2✓ 三条语义、3✓ 同会话 sessionId 一致、4✓ sessionId 为 UUID 不持久化、5✓ 单测 3 例（实际 5 例）、6✓ 真机脚本（开发者手测）。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-07 14:49:24 +08:00
lixi 3f8388e5d4 fix: 清零 flutter analyze 问题并修复隐私红线正则缺陷（CI 门禁）
CI / flutter-gates (push) Successful in 50s
Details 
- 修复真实缺陷：隐私红线 RegExp 使用 Dart 不支持的 (?i) 内联标志，构造即抛异常
  导致带 props 的事件被静默丢弃；改为 caseSensitive: false
- 清理埋点模块未用 import/字段/变量（4 warning）
- 构造函数改用初始化形参（含 Dart 3.12 私有具名参数）
- E2E 手动脚本声明 ignore avoid_print + library 指令
- 门禁：format 0 changed / analyze No issues / flutter test 34 passed
 2026-09-04 19:44:46 +08:00
lixi 45f94d2558 style: dart format analytics_service（CI 门禁要求）
CI / flutter-gates (push) Failing after 22s
Details
2026-09-04 18:31:04 +08:00
lixi 60d67a355b feat: 埋点采集模块落地——AnalyticsService + 登录/注册/退出三事件（M0 简化版，报告 13） 
- AnalyticsService：trackEvent(name, props?)/identify(userId)/reset()；隐私红线本地校验（password/token/phone 等模式拒绝）；匿名 ID 持久化复用 session deviceId；sessionId 简化为每事件生成（M0）；网络失败静默丢弃（无重试，按规范）
- 登录/注册成功挂接 auth_login_succeeded / auth_register_succeeded（durationMs）；失败挂接 _failed（failureReason）；退出挂接 auth_logout
- TODO（工单允许部分挂接）：page_viewed（登录/注册/首页/个人中心各一次，M0 无路由埋点基础）；health_record_action（M2 档案实现后挂接）；auth_session_restore_*（Splash 恢复流程待完善）；队列持久化到 shared_preferences 分段（当前内存队列 max 500，满 20 触发上传）
- 测试：flutter test → 34 passed（30→34，新增 analytics_service_test 4 例：字段/隐私拒绝/identify/reset）；flutter analyze → 86 issues（与上一波同源）；dart format → 1 changed

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-04 17:14:20 +08:00