4.0 KiB
4.0 KiB
后端第一阶段执行清单
文档版本：v1.0 最后更新：2026-04-07 14:15:00
本文档是 backend 当前阶段的执行清单版说明，配合以下文档一起使用：
目标不是再讲架构，而是明确：
- 第一阶段先做什么
- 哪些必须做稳
- 哪些暂时不要做
1. 第一阶段目标
backend 第一阶段建议只完成这 4 件事：
- 发布完整性闭环
- 多赛道发布链稳定
- 准备页地图预览支撑字段稳定
- 运维后台第一期最小对象与页面闭环
一句话：
先把活动能稳定发布、能稳定进入、能稳定多赛道、能稳定预览做稳。
2. 第一阶段必须做稳的能力
2.1 发布完整性
必须保证以下条件一致：
play.canLaunchlaunch- 当前发布 release 校验
要求：
- 缺
runtime不可进入 - 缺
presentation不可进入 - 缺
content bundle不可进入 - 缺
manifest不可进入 - 缺当前发布 release 不可进入
2.2 多赛道发布链
必须保证：
assignmentMode进入发布物courseVariants[]进入发布物launch.variant与最终 session 一致preview.variants[]与 variant 对齐
2.3 准备页地图预览支撑字段
必须稳定提供：
preview.modepreview.baseTilespreview.viewportpreview.variants[].controlspreview.selectedVariantId
2.4 运维后台第一期对象
至少要能稳定管理：
EventEventReleaseMapRuntimeBindingEventPresentationContentBundle
3. 第一阶段建议顺序
第一步：把发布完整性做稳
先做：
play.canLaunch规则统一launch阻断规则统一- release 完整性检查
第二步：把多赛道做稳
先做：
- 发布物里透出
assignmentMode - 发布物里透出
courseVariants[] launch.variant- session 最终绑定 variant
第三步：把准备页预览支撑字段做稳
先做：
play.preview- variant 预览点位
- 单赛道 / 多赛道都可预览
第四步：做运维后台第一期最小页
先做：
- 活动列表
- 活动详情
- 运行绑定
- 展示/内容绑定
- 发布记录
4. 第一阶段对象优先级
P0
EventEventReleaseMapRuntimeBindingEventPresentationContentBundle
P1
PlaceMapAssetTileReleaseCourseSourceCourseSetCourseVariant
P2
GameTemplate- 高级玩法配置
- 高级点位覆盖
- 高级 HUD 配置
5. frontend 当前已经稳定消费的链路
backend 当前可以默认 frontend 已经稳定消费：
- 活动列表卡片最小字段
- 活动详情
status / canLaunch / currentPresentation / currentContentBundle - 准备页摘要
launch.runtimelaunch.variantlaunch.presentationlaunch.contentBundleongoingSession- 结果页 / 历史页活动链
新增或调整接口时，优先不要打断这些链路。
6. 第一阶段暂时不要做什么
当前阶段不建议优先做：
- 全量 JSON 编辑器
- 复杂可视化搭建器
- 全量高级配置开放
- 复杂审核流
- 批量运维能力
- 把
/dev/workbench直接演化成正式后台
7. 第一阶段完成标准
backend 第一阶段如果满足以下条件，就可以认为是“可进入第二阶段”：
- 活动发布对象完整性稳定
- 多赛道活动能稳定发布和进入
- 准备页地图预览字段稳定
- 运维后台第一期页面可用
- 前后端联调不再依赖临时 demo 修补
8. 一句话结论
backend 第一阶段不是做“大而全后台”，而是做一套稳定的活动生产与发布最小闭环。
当前最重要的是先做稳：
- 发布完整性
- 多赛道
- 预览支撑字段
- 运维后台第一期对象与页面