152 lines
4.3 KiB
Markdown
152 lines
4.3 KiB
Markdown
# T2F 协作清单
|
||
> 文档版本：v1.7
|
||
> 最后更新：2026-04-03 16:55:07
|
||
|
||
说明：
|
||
|
||
- 本文件由总控维护，写给前端线程
|
||
- 只写当前阶段实施说明，不写长讨论稿
|
||
- 正式架构与长期结论以 `doc/` 下文档为准
|
||
|
||
---
|
||
|
||
## 1. 当前目标
|
||
|
||
当前前端线程已完成**活动运营域摘要接线第一刀**，进入联调标准化配合与小范围修复阶段。
|
||
|
||
本阶段目标：
|
||
|
||
- 验证活动运营域摘要接线是否稳定
|
||
- 修正联调中发现的小范围字段、展示、一致性问题
|
||
- 使用 backend 当前统一的“一键测试环境”和稳定 demo 数据做回归
|
||
- 使用 backend 当前统一的结构化诊断入口做回归：
|
||
- `回归结果汇总`
|
||
- `当前 Launch 实际配置摘要`
|
||
- `前端调试日志`
|
||
- 继续保持 runtime 主链稳定，不扩新页面链
|
||
|
||
---
|
||
|
||
## 2. 当前后端已完成能力
|
||
|
||
后端当前已完成：
|
||
|
||
- `GET /events/{eventPublicID}` 透出：
|
||
- `currentPresentation`
|
||
- `currentContentBundle`
|
||
- `GET /events/{eventPublicID}/play` 透出：
|
||
- `currentPresentation`
|
||
- `currentContentBundle`
|
||
- `POST /events/{eventPublicID}/launch` 透出：
|
||
- `launch.presentation`
|
||
- `launch.contentBundle`
|
||
- publish 在未显式传入：
|
||
- `presentationId`
|
||
- `contentBundleId`
|
||
时，可按 event 当前 active 配置自动补齐
|
||
- runtime 主链继续保持稳定兼容：
|
||
- `resolvedRelease`
|
||
- `business`
|
||
- `variant`
|
||
- `runtime`
|
||
- backend 当前测试能力已升级：
|
||
- `Bootstrap Demo`
|
||
- `一键补齐 Runtime 并发布`
|
||
- `一键标准回归`
|
||
- `回归结果汇总`
|
||
- `当前 Launch 实际配置摘要`
|
||
- 分步日志 / 真实错误 / stack / 最后一次 curl / 预期判定
|
||
- `POST /dev/client-logs`
|
||
|
||
---
|
||
|
||
## 3. 当前已完成
|
||
|
||
### 3.1 活动详情页
|
||
|
||
已开始展示：
|
||
|
||
- `currentPresentation`
|
||
- `presentationId`
|
||
- `templateKey`
|
||
- `version`
|
||
- `currentContentBundle`
|
||
- `bundleId`
|
||
- `bundleType`
|
||
- `version`
|
||
|
||
当前仍保持活动运营摘要展示，不做复杂运营样式。
|
||
|
||
### 3.2 活动准备页
|
||
|
||
已在当前 runtime 预览摘要旁边补活动运营摘要：
|
||
|
||
- 当前展示版本
|
||
- 当前内容包版本
|
||
|
||
仍然只做摘要，不重构准备页结构。
|
||
|
||
### 3.3 launch 会话快照
|
||
|
||
以下字段已收进当前会话快照：
|
||
|
||
- `launch.presentation`
|
||
- `launch.contentBundle`
|
||
|
||
这样后续结果页、历史页如果需要继续透出，就不需要重新拼接。
|
||
|
||
### 3.4 当前阶段仍不做
|
||
|
||
- 不下发复杂 `schema`
|
||
- 不消费完整 `EventPresentation` 结构
|
||
- 不把 `ContentBundle` 展开成资源明细
|
||
- 不重构首页、结果页、历史页已有结构
|
||
- 不启动活动卡片（列表）产品化开发
|
||
|
||
---
|
||
|
||
## 4. 当前阶段原则
|
||
|
||
- 玩家面对的是前端，前端页面必须保持干净、利落、人性化
|
||
- 先接新增摘要，不重构整条前端主链
|
||
- `resolvedRelease / business / variant` 旧字段继续保留
|
||
- runtime 主链已经稳定，不要为了活动运营摘要去动 runtime 主链
|
||
- 先做“看得见活动运营对象”，不先做复杂运营化样式
|
||
- 当前进入联调回归阶段，优先修问题，不主动扩新页面入口
|
||
- 当前联调应优先复用 backend 一键测试环境，不再各自手工铺多份 demo 对象
|
||
- 当前联调应优先复用 backend 提供的结构化诊断链，不再依赖截图 + 口头描述排查
|
||
|
||
---
|
||
|
||
## 5. 当前待前端回写
|
||
|
||
请前端线程后续重点回写：
|
||
|
||
1. 联调过程中是否发现字段缺失或命名不稳
|
||
2. 当前展示是否有明显歧义或信息层级问题
|
||
3. 是否需要后端补更多名称摘要或默认字段
|
||
4. 有没有因为活动运营摘要接线影响到 runtime 稳定主链
|
||
|
||
---
|
||
|
||
## 6. 当前总控确认
|
||
|
||
1. 活动运营域摘要第一刀视为已完成
|
||
2. 前端当前进入联调回归与小范围修复阶段
|
||
3. 当前只接受字段修正、摘要打磨、一致性修复
|
||
4. 不继续扩新页面链，不做复杂运营样式
|
||
5. 如果前端发现缺字段，再由总控统一回写给 backend
|
||
6. 当前前端下一步重点是配合 backend 的一键测试环境做稳定回归，不再新增玩家侧功能入口
|
||
7. 当前前端继续只做：
|
||
- 联调回归
|
||
- 小范围修复
|
||
- 结构化日志补充
|
||
|
||
---
|
||
|
||
## 7. 一句话结论
|
||
|
||
当前前端最重要的事不是继续扩新链，而是：
|
||
|
||
**把活动运营域摘要第一刀先稳住，并统一切到 backend 一键测试环境下做联调回归和小范围修复。**
|