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

This commit is contained in:
2026-04-03 13:11:41 +08:00
parent 0e28f70bad
commit 129ea935db
56 changed files with 11004 additions and 196 deletions

View File

@@ -1,6 +1,6 @@
# CMR Mini 开发架构阶段总结
> 文档版本v1.0
> 最后更新2026-04-02 08:28:05
> 文档版本v1.13
> 最后更新2026-04-03 13:08:15
文档维护约定:
@@ -10,6 +10,77 @@
本文档用于记录当前阶段小程序的整体架构、分层原则、事件驱动链路、模拟器体系,以及后续继续扩展时应遵守的边界。
当前补充约定:
- 多线程联调场景下,正式架构与长期结论优先沉淀到 `doc/`
- 面向后端线程的阶段性实施说明,优先写入根目录 [t2b.md](D:/dev/cmr-mini/t2b.md)。
- backend 新增写给总控线程的回写板:
- [b2t.md](D:/dev/cmr-mini/b2t.md)
- 面向前端线程的阶段性实施说明,优先写入根目录 [t2f.md](D:/dev/cmr-mini/t2f.md)。
- frontend 写给总控线程的回写板:
- [f2t.md](D:/dev/cmr-mini/f2t.md)
- 分层原则固定为:
- 玩家用前端
- 管理者用后端
- 中间层负责契约、架构、性能、健壮性与伸缩性
- 不把后台复杂性直接暴露给玩家界面
- 后台生产闭环的正式架构稿见:
- [后台生产闭环架构草案](D:/dev/cmr-mini/doc/backend/后台生产闭环架构草案.md)
- 正式上线时的数据库与服务发布流程见:
- [生产发布与数据库上线方案](D:/dev/cmr-mini/doc/backend/生产发布与数据库上线方案.md)
- backend 下一阶段建议:
- runtime 链已收口frontend 当前不再扩 runtime 页面链
- 活动运营域第二阶段第四刀已完成:
- `EventPresentation` 统一导入入口
- `Event` 默认 active 三元组固化
- publish 默认继承 active 三元组
- 当前主线已切到“联调标准化阶段”
- 当前已完成:
- `GET /events/{eventPublicID}` 透出 `currentPresentation / currentContentBundle`
- `GET /events/{eventPublicID}/play` 透出 `currentPresentation / currentContentBundle`
- `launch` 透出 `presentation / contentBundle`
- publish 可自动补齐 `presentationId / contentBundleId`
- `release detail` 已统一活动运营摘要
- `ContentBundle` 统一导入入口第一版已完成
- `Bootstrap Demo` 已可补齐:
- `place / map asset / tile release / course source / course set / course variant / runtime binding`
- `一键补齐 Runtime 并发布` 已可从空白状态跑完整测试链
- workbench 日志已具备:
- 分步日志
- 真实错误
- stack
- 最后一次 curl
- 预期判定
- 下一步建议:
- 固化“一键测试”链路为联调标准路径
- 固化稳定测试数据,不再依赖手工铺对象
- 逐步准备更接近生产的真实输入:
- 地图资源 URL
- KML / 赛道文件
- 内容 manifest
- presentation schema
- 活动文案样例
- 前端线程建议正式上场时机:
- 现在已完成活动运营域摘要接线第一刀
- 当前已完成:
- runtime 摘要链:
- 准备页预览态摘要
- 地图页
- 单局结果页
- 历史结果列表页
- 首页 ongoing
- 首页 recent
- 活动运营域摘要链:
- 活动详情页
- 活动准备页
- 会话快照
- 当前建议:
- frontend 进入联调标准化配合与小范围修复阶段
- 只做字段修正、摘要打磨、一致性修复
- 优先复用 backend 一键测试环境做回归
- 不继续扩新页面链
- 不做复杂运营样式
当前阶段的核心目标已经从“把地图画出来”升级为“建立一套可长期扩展的运动地图游戏底座”。
这套底座已经具备以下关键能力: