69 lines
3.2 KiB
Markdown
69 lines
3.2 KiB
Markdown
# 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`
|
||
|
||
## 文档导航
|
||
|
||
- [文档索引](D:/dev/cmr-mini/backend/docs/README.md)
|
||
- [系统架构](D:/dev/cmr-mini/backend/docs/系统架构.md)
|
||
- [核心流程](D:/dev/cmr-mini/backend/docs/核心流程.md)
|
||
- [API 清单](D:/dev/cmr-mini/backend/docs/接口清单.md)
|
||
- [数据模型](D:/dev/cmr-mini/backend/docs/数据模型.md)
|
||
- [配置管理方案](D:/dev/cmr-mini/backend/docs/配置管理方案.md)
|
||
- [资源对象与目录方案](D:/dev/cmr-mini/backend/docs/资源对象与目录方案.md)
|
||
- [后台管理最小方案](D:/dev/cmr-mini/backend/docs/后台管理最小方案.md)
|
||
- [开发说明](D:/dev/cmr-mini/backend/docs/开发说明.md)
|
||
|
||
## 快速启动
|
||
|
||
1. 配置环境变量，参考 [`.env.example`](D:/dev/cmr-mini/backend/.env.example)
|
||
2. 按顺序执行 [migrations](D:/dev/cmr-mini/backend/migrations)
|
||
3. 启动服务
|
||
|
||
```powershell
|
||
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`
|
||
|
||
|