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


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

`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
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`