完善联调标准化与诊断链路

This commit is contained in:
2026-04-03 17:01:04 +08:00
parent 114c524044
commit b09c21c814
35 changed files with 2677 additions and 175 deletions

View File

@@ -1,6 +1,6 @@
# Backend
> 文档版本v1.12
> 最后更新2026-04-03 13:24:38
> 文档版本v1.17
> 最后更新2026-04-03 16:16:38
这套后端现在已经能支撑一条完整主链:
@@ -14,6 +14,27 @@
- 真正进入游戏时客户端消费的是 `manifest_url`
- `session` 会固化当时实际绑定的 `release`
当前 workbench 里新增的“当前 Launch 实际配置摘要”仅用于调试:
- 它会由 backend 代读当前 launch 对应的 manifest
- 用来显示:
- `configUrl`
- `releaseId`
- `manifestUrl`
- `schemaVersion`
- `playfield.kind`
- `game.mode`
- 这块只服务联调排查,不参与正式客户端运行链路
- 正式客户端仍应直接消费 `launch` 返回的:
- `launch.config.configUrl`
- `launch.resolvedRelease.manifestUrl`
当前 workbench 里新增的“前端调试日志”也仅用于联调:
- frontend 可将页面侧调试日志 `POST``/dev/client-logs`
- backend 会临时保留最近 200 条日志,供 workbench 查看与清空
- 这块只用于联调排查,不替代正式生产日志体系
## 文档导航
- [文档索引](D:/dev/cmr-mini/backend/docs/README.md)
@@ -64,5 +85,15 @@ cd D:\dev\cmr-mini\backend
- 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`
- 真实输入替换第一刀:`Bootstrap Demo` 已改用真实可访问的 KML 与地图资源 URL
- manual 多赛道 demo已切到真实 `c01.kml / c02.kml` 输入
- 前端调试日志:
- `POST /dev/client-logs`
- `GET /dev/client-logs`
- `DELETE /dev/client-logs`
- 显式玩法入口:
- 顺序赛:`evt_demo_001`
- 积分赛:`evt_demo_score_o_001`
- 多赛道:`evt_demo_variant_manual_001`