lixi
6fef0db009
CI / flutter-gates (push) Successful in 1m3s
- AnalyticsRouteObserver：didPush/didReplace/didPop 集中捕获，页面零侵入 - AnalyticsPageName 枚举：pageName 编译期锁死（字典 v2 九个初始值 + 客户端现存 create/pet_archive/services/post_detail），字典外路由不上报 - PageViewTracker：page_viewed 单一上报出口，维护 referrer 链（栈底/冷启动首页为 null）与去重（Tab 重复点选） - 三类非路由曝光手动补点：主壳 Tab 切换（IndexedStack）、认证状态机切页（AnimatedSwitcher）、回栈到无名根路由（resolveRootPage） - 既有 Navigator.push 挂 RouteSettings.name：login_page（register）、main_shell_page（post_detail）；fade_route 签名扩展可选 settings - M2 健康档案页面（pet_list/pet_detail/pet_form/record_form/record_detail）先留枚举定义，待功能落地接线 测试新增 8 例（analytics_route_observer_test）：push 上报/push 两页 referrer 链正确 + pop 补报/根路由 resolveRootPage 补报/枚举外不报/dialog 不报/Tab 去重/referrer 连贯/reportTab。 验收对照（06 号报告 §5.2 六条）：1✓ observer 注册、2✓ pageName 枚举含 pet_form、3✓ referrer 链、4✓ 字典外不报、5✓ 单测 push/pop/referrer、6✓ M1 存量四页接全。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
37 lines
1.4 KiB
Dart
37 lines
1.4 KiB
Dart
/// page_viewed 的 pageName 编译期枚举（06 号报告 §5.2 字典 v2 + 03 号评估
|
||
/// §3.2 Tab 映射）。禁止自由路由字符串；带参数路由必须归一化，任何
|
||
/// UUID/ID 不得出现在 pageName 或 referrer 中（隐私红线第 5 条）。
|
||
///
|
||
/// 尚不存在的 M2 页面（petList/petDetail/petForm/recordForm/recordDetail）
|
||
/// 先留枚举定义、不接线，待健康档案页面族落地时启用。
|
||
enum AnalyticsPageName {
|
||
// —— 字典 v2 初始集合（06 §5.2 验收 2）——
|
||
login('login'),
|
||
register('register'),
|
||
home('home'),
|
||
profile('profile'),
|
||
petList('pet_list'),
|
||
petDetail('pet_detail'),
|
||
petForm('pet_form'),
|
||
recordForm('record_form'),
|
||
recordDetail('record_detail'),
|
||
// —— 客户端现存页面/Tab 补充（03 §3.2 Tab 映射，需数据侧同步进字典）——
|
||
create('create'),
|
||
petArchive('pet_archive'),
|
||
services('services'),
|
||
postDetail('post_detail');
|
||
|
||
const AnalyticsPageName(this.pageName);
|
||
|
||
/// 上报值，snake_case，与 RouteSettings.name 一致。
|
||
final String pageName;
|
||
|
||
static final Map<String, AnalyticsPageName> _byName = {
|
||
for (final page in values) page.pageName: page,
|
||
};
|
||
|
||
/// 路由名 → 枚举；不在枚举内返回 null（调用方不上报，06 §5.2 验收 4）。
|
||
static AnalyticsPageName? fromRouteName(String? name) =>
|
||
name == null ? null : _byName[name];
|
||
}
|