T2F 协作清单

文档版本：v1.10 最后更新：2026-04-03 19:26:23

说明：

本文件由总控维护，写给前端线程
只写当前阶段实施说明，不写长讨论稿
正式架构与长期结论以 doc/ 下文档为准

1. 当前目标

当前前端线程已完成：

活动运营域摘要接线第一刀
活动卡片列表最小产品化第一刀

当前进入：

活动卡片列表最小产品化第一刀联调回归与小范围修复阶段

本阶段目标：

在 backend 一键测试环境下回归活动列表页第一刀
验证卡片字段、分组、跳转与详情页链路稳定
只做小范围修复，不扩更多玩家侧新链
继续保持 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 展开成资源明细
不重构首页、结果页、历史页已有结构
不做复杂运营化列表
不重做首页现有入口区

3.5 当前活动列表第一刀已完成

当前已落地：

独立活动列表页：/pages/events/events
最小卡片样式
最小筛选：全部 / 体验
从列表跳活动详情页
首页补“活动列表”独立入口

当前第一刀最小字段已覆盖：

eventId
title
subtitle
summary
status
timeWindow
ctaText
coverUrl
isDefaultExperience
currentPresentation
currentContentBundle

4. 当前阶段原则

玩家面对的是前端，前端页面必须保持干净、利落、人性化
先接新增摘要，不重构整条前端主链
resolvedRelease / business / variant 旧字段继续保留
runtime 主链已经稳定，不要为了活动运营摘要去动 runtime 主链
先做“看得见活动运营对象”，不先做复杂运营化样式
当前活动列表第一刀允许扩一个独立列表页，但不扩更多玩家侧新链
当前联调应优先复用 backend 一键测试环境，不再各自手工铺多份 demo 对象
当前联调应优先复用 backend 提供的结构化诊断链，不再依赖截图 + 口头描述排查

5. 当前待前端回写

请前端线程后续重点回写：

列表字段是否足够支持当前最小卡片
全部 / 体验 分组是否符合当前产品预期
卡片点击进入活动详情页是否稳定
是否需要 backend 再补名称摘要、状态字段或默认值
有没有因为活动列表接线影响到 runtime 稳定主链

6. 当前总控确认

活动运营域摘要第一刀视为已完成
前端当前进入联调回归与小范围修复阶段
当前只接受字段修正、摘要打磨、一致性修复
当前不继续扩更多玩家侧新链，不做复杂运营样式
如果前端发现缺字段，再由总控统一回写给 backend
当前前端下一步重点是配合 backend 的一键测试环境做稳定回归
当前前端继续只做：
- 联调回归
- 小范围修复
- 结构化日志补充
当前活动列表第一刀已完成，暂不进入第二刀产品扩展

7. 一句话结论

当前前端最重要的事不是继续扩新页面，而是：

把活动卡片列表最小产品化第一刀先稳住，并统一切到 backend 一键测试环境下做联调回归和小范围修复。

t2f.md 4.8 KB Geçmiş Ham