README.md 2.0 KB

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

代码入口