t2f.md 3.8 KB

T2F 协作清单

文档版本:v1.6 最后更新:2026-04-03 13:08:15

说明:

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

1. 当前目标

当前前端线程已完成活动运营域摘要接线第一刀,进入联调标准化配合与小范围修复阶段。

本阶段目标:

  • 验证活动运营域摘要接线是否稳定
  • 修正联调中发现的小范围字段、展示、一致性问题
  • 使用 backend 当前统一的“一键测试环境”和稳定 demo 数据做回归
  • 继续保持 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 并发布
    • 分步日志 / 真实错误 / stack / 最后一次 curl / 预期判定

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 对象

5. 当前待前端回写

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

  1. 联调过程中是否发现字段缺失或命名不稳
  2. 当前展示是否有明显歧义或信息层级问题
  3. 是否需要后端补更多名称摘要或默认字段
  4. 有没有因为活动运营摘要接线影响到 runtime 稳定主链

6. 当前总控确认

  1. 活动运营域摘要第一刀视为已完成
  2. 前端当前进入联调回归与小范围修复阶段
  3. 当前只接受字段修正、摘要打磨、一致性修复
  4. 不继续扩新页面链,不做复杂运营样式
  5. 如果前端发现缺字段,再由总控统一回写给 backend
  6. 当前前端下一步重点是配合 backend 的一键测试环境做稳定回归,不再新增玩家侧功能入口

7. 一句话结论

当前前端最重要的事不是继续扩新链,而是:

把活动运营域摘要第一刀先稳住,并统一切到 backend 一键测试环境下做联调回归和小范围修复。