mini-prog/backend/docs

Backend Docs

文档版本：v1.0 最后更新：2026-04-02 08:28:05

这套文档服务两个目的：

1. 让后面开发时能快速查到当前后端边界
2. 把“配置驱动游戏”的核心约束写清楚，避免业务层和游戏层重新耦合

建议阅读顺序

1. 系统架构
2. 核心流程
3. API 清单
4. 数据模型
5. 配置管理方案
6. 资源对象与目录方案
7. 后台管理最小方案
8. 前后端联调清单
9. TodoList
10. 开发说明

当前系统范围

当前 backend 已覆盖：

• 多租户入口识别
• APP 短信登录
• 微信小程序登录
• 手机号绑定与账号合并
• 首页卡片与入口聚合
• Event 详情与 play 上下文
• 以 event_release 为核心的 launch
• session 生命周期
• session 结果沉淀
• 开发 workbench

下一阶段建议重点：

• 可伸缩配置管理
• 共享资源对象化
• source/build/release 分层
• 配置构建器
• 发布资产清单

当前最重要的设计约束

• 用户是平台级，不是俱乐部级
• 渠道是入口，不是用户体系
• event 是业务对象，不是运行配置本体
• event_release 才是进入游戏时真正绑定的配置发布对象
• game_session 必须固化当时实际使用的 release

代码入口

• 程序入口：main.go
• 应用装配：app.go
• 路由注册：router.go
• migration：migrations