mini-prog/backend

Backend

文档版本：v1.1 最后更新：2026-04-02 09:35:44

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

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

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

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

文档导航

• 文档索引
• 系统架构
• 核心流程
• API 清单
• 数据模型
• 配置管理方案
• 资源对象与目录方案
• 后台管理最小方案
• 开发说明

快速启动

1. 配置环境变量，参考 .env.example
2. 按顺序执行 migrations
3. 启动服务

cd D:\dev\cmr-mini\backend
go run .\cmd\api

当前重点

• 统一登录：短信 + 微信小程序
• 多入口：tenant + entry_channel
• 首页聚合：/home、/cards、/me/entry-home
• 配置驱动启动：/events/{id}/play、/events/{id}/launch
• 局生命周期：start / finish / detail
• 局后结果：/sessions/{id}/result、/me/results
• 开发工作台：/dev/workbench
  • 用户主链调试
  • 资源对象与 Event 组装调试
  • Build / Publish / Rollback 调试