完善活动运营域与联调标准化

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

@@ -0,0 +1,204 @@
+# 第五刀联调回归清单
+> 文档版本：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 摘要可同时回流
+- 恢复链、结果链、首页摘要链不互相打架