mini-prog/doc/gameplay/第五刀联调回归清单.md

第五刀联调回归清单

文档版本：v1.0 最后更新：2026-04-03 14:50:00

目标

本清单用于回归验证第五刀“前端接线阶段”的实际效果，重点确认：

• launch.runtime 是否已稳定进入前端运行链
• 多赛道与 runtime 摘要是否能同时正确回流
• 恢复链、结果链、首页摘要链是否保持一致

本清单优先验证“可见”和“一致”，不要求当前阶段完成复杂运营样式。

当前范围

本轮重点回归以下页面：

• 活动页
• 准备页
• 地图页
• 单局结果页
• 历史结果列表页
• 首页 ongoing / recent

建议测试数据

优先使用后端当前已提供的多赛道手动 demo：

• eventPublicID = evt_demo_variant_manual_001
• variant_a
  • name = A 线
  • routeCode = route-variant-a
• variant_b
  • name = B 线
  • routeCode = route-variant-b

普通单赛道活动可继续使用：

• eventPublicID = evt_demo_001

回归项

1. 准备页预览态摘要

验证目标：

• 准备页能显示“运行对象摘要”
• 当前阶段允许是预览态，不要求已经拿到完整 launch.runtime

检查点：

• 地点 当前允许显示 待 launch.runtime 确认
• 地图 当前允许显示 待 launch.runtime 确认
• 赛道
  • manual 模式下，应跟随当前选择变化
• RouteCode
  • manual 模式下，应跟随当前选择变化

2. Launch Runtime 映射

验证目标：

• 进入地图后，前端已正式消费后端 launch.runtime

检查点：

• 地图页“当前游戏”摘要中可看到：
  • 运行绑定
  • 地点
  • 地图
  • 赛道集
  • 赛道版本
  • RouteCode
  • 瓦片版本

3. 多赛道手动选择

验证目标：

• manual 模式下，准备页选择的赛道和最终 launch.variant / launch.runtime 一致

建议步骤：

1. 打开 evt_demo_variant_manual_001
2. 在准备页选择 A 线
3. 进入地图，记录地图页 runtime 摘要
4. 结束一局，记录结果页摘要
5. 再重复一次，切换到 B 线

检查点：

• 地图页 赛道版本
• 单局结果页 赛道版本
• 历史结果列表页该条记录的 赛道
• 首页 recent

都应能区分 A 线 / B 线

4. 单局结果页 Runtime

验证目标：

• 结果页优先消费 result.session.runtime
• 如果后端某次未带该字段，前端能回退到 launch 快照，不出现空白

检查点：

• 结果页中可见：
  • 运行绑定
  • 地点
  • 地图
  • 赛道集
  • 赛道版本
  • RouteCode
  • 瓦片版本

5. 历史结果列表页 Runtime

验证目标：

• 历史结果列表页保持摘要态，不改主结构，但能看到 runtime 对象

检查点：

• 每条结果卡片可显示：
  • 地点
  • 地图
  • 赛道

6. 首页 Ongoing / Recent Runtime

验证目标：

• 首页 ongoing / recent 已开始展示 runtime 摘要

检查点：

• 进行中运行对象
• 最近一局运行对象

内容至少包含：

• 地点
• 地图
• 赛道

7. 恢复链 Runtime 一致性

验证目标：

• 非正常退出后恢复，赛道和 runtime 不发生漂移

建议步骤：

1. 使用多赛道活动选择 B 线
2. 进入地图并开始一局
3. 非正常退出
4. 重新进入程序并选择“继续恢复”

检查点：

• 恢复后的地图页 runtime 摘要仍然是原来的 place / map / variant
• 赛道版本不变

8. 放弃恢复语义

验证目标：

• 放弃恢复不会上错局
• 放弃后不会残留旧 runtime

建议步骤：

1. 打开一局并异常退出
2. 再进程序，选择“放弃”
3. 回首页

检查点：

• 不再提示旧局恢复
• 首页 ongoing 应消失
• 再开新局时 runtime 摘要以新局为准

问题记录建议

如果发现问题，尽量一次性记录：

• eventPublicID
• 选择的 variantId / routeCode
• launch.variant
• launch.runtime
• 地图页 runtime 摘要
• 结果页 runtime 摘要
• 首页 / 历史页摘要
• 是否属于恢复场景

当前阶段结论标准

本轮完成标准不是“页面全部重做”，而是：

• launch.runtime 已进入用户侧主页面链
• 多赛道与 runtime 摘要可同时回流
• 恢复链、结果链、首页摘要链不互相打架