lixi
1afec6aad1
CI / flutter-gates (push) Successful in 1m3s
- 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>
54 lines
2.0 KiB
Dart
54 lines
2.0 KiB
Dart
import 'package:flutter/widgets.dart';
|
||
import 'package:uuid/uuid.dart';
|
||
|
||
/// sessionId 生命周期管理（13 号规范 §3.1、06 号报告 §5.1）。
|
||
///
|
||
/// 语义三条：冷启动生成新 sessionId；`paused → resumed` 间隔超过
|
||
/// [timeout]（默认 30 分钟）生成新 sessionId；未超过则沿用原值。
|
||
/// sessionId 不落任何持久化存储——会话本该跨冷启动失效（03 号评估 §3.1，
|
||
/// 纯内存方案，lastActiveAt 不持久化）。
|
||
///
|
||
/// 注意生命周期级联：前台恢复时状态机会依次经过
|
||
/// `paused → hidden → inactive → resumed`，因此只在**离开 resumed 的第一次
|
||
/// 变更**记录退后台时刻，后续级联状态不得覆盖，否则间隔永远趋近于零。
|
||
class SessionTracker with WidgetsBindingObserver {
|
||
SessionTracker({
|
||
this.timeout = const Duration(minutes: 30),
|
||
this.onLeaveForeground,
|
||
DateTime Function()? now,
|
||
}) : _now = now ?? DateTime.now,
|
||
_sessionId = const Uuid().v7();
|
||
|
||
/// 后台超时阈值；构造参数化便于测试注入。
|
||
final Duration timeout;
|
||
|
||
/// 首次离开前台时回调（app 装配层用于触发埋点队列冲刷）。
|
||
final VoidCallback? onLeaveForeground;
|
||
|
||
/// 时钟注入口，测试免真实等待。
|
||
final DateTime Function() _now;
|
||
|
||
String _sessionId;
|
||
DateTime? _leftForegroundAt;
|
||
AppLifecycleState _lastState = AppLifecycleState.resumed;
|
||
|
||
/// 当前会话标识（UUIDv7）。
|
||
String get sessionId => _sessionId;
|
||
|
||
@override
|
||
void didChangeAppLifecycleState(AppLifecycleState state) {
|
||
if (state == AppLifecycleState.resumed) {
|
||
final leftAt = _leftForegroundAt;
|
||
if (leftAt != null && _now().difference(leftAt) > timeout) {
|
||
_sessionId = const Uuid().v7();
|
||
}
|
||
_leftForegroundAt = null;
|
||
} else if (_lastState == AppLifecycleState.resumed) {
|
||
// 首次离开前台才记时；inactive/hidden/paused 级联不覆盖。
|
||
_leftForegroundAt = _now();
|
||
onLeaveForeground?.call();
|
||
}
|
||
_lastState = state;
|
||
}
|
||
}
|