hailin/gcx - gcx - AI Wolves Team

Commit Graph

Author	SHA1	Message	Date
hailin	9519e29b8f	feat(mobile/telemetry): collect real network type via connectivity_plus - Add connectivity_plus: ^6.0.3 to pubspec.yaml - DeviceInfoCollector._getNetworkType() calls Connectivity().checkConnectivity() and maps ConnectivityResult → wifi / mobile / ethernet / vpn / bluetooth / none / unknown - networkType field in DeviceContext is now populated on every cold start - All page_view and session events carry the accurate network type in device props Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-07 09:43:04 -08:00
hailin	9b760c56ee	feat(mobile/telemetry): add comprehensive event tracking for DAU, real-time presence & funnels ## 架构设计（亿级用户规模） - 客户端：本地队列(500条) + 批量上传(20条/30s) + 10% 采样率 - 心跳：前台每60s发送，后端3分钟滑动窗口 → 实时在线率 - DAU：app_session_start 事件 + installId 去重 - 后端接入：Kafka → ClickHouse 消费落盘 ## 新增 TelemetryRouteObserver (NEW FILE) - 继承 RouteObserver<PageRoute>，注册到 MaterialApp.navigatorObservers - 自动记录所有页面 page_view（push/pop/replace），零侵入业务页面 - 属性：page_name, previous_page, nav_action - 覆盖全部 37 个已注册路由，无需逐页埋点 ## main.dart - 接入 TelemetryRouteObserver.instance - 新增 FlutterError.onError 全局钩子 → logError 上报 Widget build 异常 ## auth_service.dart — 认证漏斗 \| 事件 \| 触发时机 \| method 属性 \| \|------\|---------\|------------\| \| register_success \| 注册成功 \| phone_sms / email_code \| \| login_success \| 登录成功 \| password / phone_sms / email_code / wechat / alipay / google / apple \| \| user_logout \| 主动登出 \| — \| ## self_hosted_updater.dart — 升级漏斗 update_prompted → update_accepted / update_dismissed → update_download_started → update_download_completed / update_download_failed / update_download_cancelled → update_install_triggered / update_install_failed Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-07 09:39:48 -08:00
hailin	ce9cc5b72e	feat(telemetry): 完整实现 presence-service 迁移 + Flutter 遥测接入 ## 后端 (backend/services/telemetry-service) ### 修复骨架中的关键缺陷 - 创建本地 JwtAuthGuard / AdminGuard，替换不存在的 @genex/common 包 - 修复 req.user.sub → req.user.id（与 JwtStrategy.validate() 返回值对齐） - 重写 Dockerfile，移除对不存在的 packages/common 目录的引用 - 更新 telemetry.module.ts，将 JwtAuthGuard / AdminGuard 注册为 providers - admin-telemetry.controller.ts 改用本地 AdminGuard（检查 role === 'admin'） ### 新增功能 - GET /api/v1/telemetry/config：公开配置下发接口 Flutter TelemetryConfig.syncFromRemote() 每小时拉取，返回全局开关、采样率、心跳间隔等配置，所有字段支持环境变量覆盖（TELEMETRY_GLOBAL_ENABLED 等） - 设备字段（deviceBrand/deviceModel/deviceOs/appVersion/locale）提升为顶层列 BatchEventsDto / TelemetryEvent 实体 / recordEvents() 全链路补齐原因：JSONB 内字段无法走 B-tree 索引，千万级数据分组查询需独立列 ### DB 迁移 - 050_add_device_fields_to_telemetry_events.sql：为已有 telemetry_events 表新增 5 个设备字段列和 device_brand / app_version 索引 ### docker-compose 环境变量 - telemetry-service 新增 TELEMETRY_GLOBAL_ENABLED / SAMPLING_RATE / HEARTBEAT_INTERVAL / CONFIG_VERSION 环境变量，支持生产环境热调整 ## 前端 ### genex-mobile (Flutter 消费者端) - 复制 lib/core/telemetry/ 模块（11个文件）：TelemetryService、 HeartbeatService、SessionManager、TelemetryUploader、TelemetryStorage 等 - 修正 API 路径：presence/heartbeat → telemetry/heartbeat， analytics/events → telemetry/events - pubspec.yaml 新增依赖：uuid ^4.3.3、equatable ^2.0.5、device_info_plus ^10.1.0 - main.dart：initState 首帧回调初始化 TelemetryService（需 BuildContext 采集设备信息）已登录时自动注入 accessToken - auth_service.dart：_setAuth() 登录成功后注入 userId + accessToken； _clearAuth() 退出时清除（同时覆盖 Token 过期自动清除场景） ### admin-app (Flutter 发行方控制台) - 复制 lib/core/telemetry/ 模块（同上） - pubspec.yaml 新增依赖：uuid、equatable、device_info_plus、shared_preferences - IssuerLoginPage：initState 首帧初始化 + 登录成功后注入 userId/token 使用 api.gogenex.cn（与 UpdateService 域名一致） - settings_page.dart：退出登录时调用 clearUserId() + clearAccessToken() ## 架构说明 - 在线人数：Redis Sorted Set (genex:presence:online)，心跳 60s/次，180s 窗口判定在线 - DAU：app_session_start 事件写入 telemetry_events，每天凌晨 1 点聚合到 daily_active_stats 表，同时每小时滚动更新当日 DAU - 设备字段采用 Amplitude 风格：前端本地队列存 properties 内， toServerJson() 上传时自动提升为顶层字段，后端写入独立索引列 - 心跳需要 JWT 认证（未登录用户自动跳过，不报错） - 遥测完全异步，任何失败只打 debug 日志，不影响主流程 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-05 23:33:13 -08:00

Author

SHA1

Message

Date

hailin

9519e29b8f

feat(mobile/telemetry): collect real network type via connectivity_plus

- Add connectivity_plus: ^6.0.3 to pubspec.yaml
- DeviceInfoCollector._getNetworkType() calls Connectivity().checkConnectivity()
  and maps ConnectivityResult → wifi / mobile / ethernet / vpn / bluetooth / none / unknown
- networkType field in DeviceContext is now populated on every cold start
- All page_view and session events carry the accurate network type in device props

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-03-07 09:43:04 -08:00

hailin

9b760c56ee

feat(mobile/telemetry): add comprehensive event tracking for DAU, real-time presence & funnels

## 架构设计（亿级用户规模）
- 客户端：本地队列(500条) + 批量上传(20条/30s) + 10% 采样率
- 心跳：前台每60s发送，后端3分钟滑动窗口 → 实时在线率
- DAU：app_session_start 事件 + installId 去重
- 后端接入：Kafka → ClickHouse 消费落盘

## 新增 TelemetryRouteObserver (NEW FILE)
- 继承 RouteObserver<PageRoute>，注册到 MaterialApp.navigatorObservers
- 自动记录所有页面 page_view（push/pop/replace），零侵入业务页面
- 属性：page_name, previous_page, nav_action
- 覆盖全部 37 个已注册路由，无需逐页埋点

## main.dart
- 接入 TelemetryRouteObserver.instance
- 新增 FlutterError.onError 全局钩子 → logError 上报 Widget build 异常

## auth_service.dart — 认证漏斗
| 事件 | 触发时机 | method 属性 |
|------|---------|------------|
| register_success | 注册成功 | phone_sms / email_code |
| login_success    | 登录成功 | password / phone_sms / email_code / wechat / alipay / google / apple |
| user_logout      | 主动登出 | — |

## self_hosted_updater.dart — 升级漏斗
update_prompted → update_accepted / update_dismissed
→ update_download_started → update_download_completed / update_download_failed / update_download_cancelled
→ update_install_triggered / update_install_failed

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-03-07 09:39:48 -08:00

hailin

ce9cc5b72e

feat(telemetry): 完整实现 presence-service 迁移 + Flutter 遥测接入

## 后端 (backend/services/telemetry-service)

### 修复骨架中的关键缺陷
- 创建本地 JwtAuthGuard / AdminGuard，替换不存在的 @genex/common 包
- 修复 req.user.sub → req.user.id（与 JwtStrategy.validate() 返回值对齐）
- 重写 Dockerfile，移除对不存在的 packages/common 目录的引用
- 更新 telemetry.module.ts，将 JwtAuthGuard / AdminGuard 注册为 providers
- admin-telemetry.controller.ts 改用本地 AdminGuard（检查 role === 'admin'）

### 新增功能
- GET /api/v1/telemetry/config：公开配置下发接口
  Flutter TelemetryConfig.syncFromRemote() 每小时拉取，返回全局开关、采样率、
  心跳间隔等配置，所有字段支持环境变量覆盖（TELEMETRY_GLOBAL_ENABLED 等）
- 设备字段（deviceBrand/deviceModel/deviceOs/appVersion/locale）提升为顶层列
  BatchEventsDto / TelemetryEvent 实体 / recordEvents() 全链路补齐
  原因：JSONB 内字段无法走 B-tree 索引，千万级数据分组查询需独立列

### DB 迁移
- 050_add_device_fields_to_telemetry_events.sql：为已有 telemetry_events 表
  新增 5 个设备字段列和 device_brand / app_version 索引

### docker-compose 环境变量
- telemetry-service 新增 TELEMETRY_GLOBAL_ENABLED / SAMPLING_RATE /
  HEARTBEAT_INTERVAL / CONFIG_VERSION 环境变量，支持生产环境热调整

## 前端

### genex-mobile (Flutter 消费者端)
- 复制 lib/core/telemetry/ 模块（11个文件）：TelemetryService、
  HeartbeatService、SessionManager、TelemetryUploader、TelemetryStorage 等
- 修正 API 路径：presence/heartbeat → telemetry/heartbeat，
  analytics/events → telemetry/events
- pubspec.yaml 新增依赖：uuid ^4.3.3、equatable ^2.0.5、device_info_plus ^10.1.0
- main.dart：initState 首帧回调初始化 TelemetryService（需 BuildContext 采集设备信息）
  已登录时自动注入 accessToken
- auth_service.dart：_setAuth() 登录成功后注入 userId + accessToken；
  _clearAuth() 退出时清除（同时覆盖 Token 过期自动清除场景）

### admin-app (Flutter 发行方控制台)
- 复制 lib/core/telemetry/ 模块（同上）
- pubspec.yaml 新增依赖：uuid、equatable、device_info_plus、shared_preferences
- IssuerLoginPage：initState 首帧初始化 + 登录成功后注入 userId/token
  使用 api.gogenex.cn（与 UpdateService 域名一致）
- settings_page.dart：退出登录时调用 clearUserId() + clearAccessToken()

## 架构说明
- 在线人数：Redis Sorted Set (genex:presence:online)，心跳 60s/次，180s 窗口判定在线
- DAU：app_session_start 事件写入 telemetry_events，每天凌晨 1 点聚合到
  daily_active_stats 表，同时每小时滚动更新当日 DAU
- 设备字段采用 Amplitude 风格：前端本地队列存 properties 内，
  toServerJson() 上传时自动提升为顶层字段，后端写入独立索引列
- 心跳需要 JWT 认证（未登录用户自动跳过，不报错）
- 遥测完全异步，任何失败只打 debug 日志，不影响主流程

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-03-05 23:33:13 -08:00

3 Commits