完善联调标准化与诊断链路
This commit is contained in:
@@ -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`
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user