3.0 KiB
3.0 KiB
Backend
文档版本：v1.11 最后更新：2026-04-03 13:04:32
这套后端现在已经能支撑一条完整主链：
entry -> auth -> home/cards -> event play -> launch -> session -> result
并且已经按“配置驱动游戏”收口：
- 业务对象是
event - 运行配置对象是
event_release - 真正进入游戏时客户端消费的是
manifest_url session会固化当时实际绑定的release
文档导航
快速启动
- 配置环境变量，参考
.env.example - 按顺序执行 migrations
- 启动服务
cd D:\dev\cmr-mini\backend
.\start-backend.ps1
当前重点
- 统一登录：短信 + 微信小程序
- 多入口：
tenant + entry_channel - 首页聚合：
/home、/cards、/me/entry-home - 配置驱动启动：
/events/{id}/play、/events/{id}/launch - 局生命周期：
start / finish / detail - 局后结果：
/sessions/{id}/result、/me/results - 第一阶段生产骨架：
places / map-assets / tile-releases / course-sources / course-sets / course-variants / runtime-bindings - 第三刀最小接线：
runtimeBinding -> eventRelease -> launch.runtime - 第四刀发布闭环：
publish(runtimeBindingId) -> eventRelease -> launch.runtime - 活动运营域第二阶段：
event_presentations / content_bundles / event_release -> presentation,bundle,runtime - 活动运营域第二阶段第二刀：
event detail / event play / launch -> presentation,bundle 摘要 - 活动运营域第二阶段第三刀：
release 摘要闭环 + content bundle import - 活动运营域第二阶段第四刀：
presentation import + event 默认 active 绑定 + publish 默认继承 - 开发工作台：
/dev/workbench- 用户主链调试
- 资源对象与 Event 组装调试
- Build / Publish / Rollback 调试
- Release / RuntimeBinding 最小挂接验证
- Event Presentation / Content Bundle 最小挂接验证
- Content Bundle Import 最小导入验证
- Presentation Import / Event 默认绑定 / Publish 默认继承验证
- Runtime 自动补齐 + 默认绑定发布一键验证
- Bootstrap Demo 自动回填最小生产骨架 ID
- 一键测试环境：可从空白状态自动准备 demo event、source/build/release、presentation、content bundle、place、map asset、tile release、course source、course set、course variant、runtime binding，并输出逐步日志与预期判定