zhangyan 114c524044 完善一键回归与真实输入准备 4 dagen geleden
..
cmd 94a1f0ba78 Add backend foundation and config-driven workbench 6 dagen geleden
docs 114c524044 完善一键回归与真实输入准备 4 dagen geleden
internal 114c524044 完善一键回归与真实输入准备 4 dagen geleden
migrations 129ea935db 完善活动运营域与联调标准化 4 dagen geleden
scripts 0e28f70bad 完善多赛道联调与全局产品架构 5 dagen geleden
.env.example a70dc8d5d0 完善后端联调链路与模拟器多通道支持 6 dagen geleden
README.md 114c524044 完善一键回归与真实输入准备 4 dagen geleden
go.mod 94a1f0ba78 Add backend foundation and config-driven workbench 6 dagen geleden
go.sum 94a1f0ba78 Add backend foundation and config-driven workbench 6 dagen geleden
start-backend.ps1 0e28f70bad 完善多赛道联调与全局产品架构 5 dagen geleden

README.md

Backend

文档版本:v1.12 最后更新:2026-04-03 13:24:38

这套后端现在已经能支撑一条完整主链:

entry -> auth -> home/cards -> event play -> launch -> session -> result

并且已经按“配置驱动游戏”收口:

  • 业务对象是 event
  • 运行配置对象是 event_release
  • 真正进入游戏时客户端消费的是 manifest_url
  • session 会固化当时实际绑定的 release

文档导航

快速启动

  1. 配置环境变量,参考 .env.example
  2. 按顺序执行 migrations
  3. 启动服务
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,并输出逐步日志与预期判定
    • 一键标准回归:在标准发布链跑通后,继续自动验证 play / launch / result / history