-
-
+
-
-
+
-
-
+
-
-
+
-
-
+
-
-
+
-
-
+
-
-
+
-
-
+
-
-
+
1. Bootstrap
+准备 Demo 数据
初始化 demo tenant / channel / event / card。
+
默认入口
+ tenant_demo / mini-demo / evt_demo_001多赛道入口
tenant_demo / mini-demo / evt_demo_variant_manual_0012. Config Pipeline
+本地配置导入与发布
从本地 event 目录导入 source config，生成 preview build，并可直接发布成当前 release。
3. Session State
+当前上下文
当前调试上下文，所有按钮共享这一组状态。
Access Token
@@ -370,8 +532,8 @@ const devWorkbenchHTML = `
-4. SMS Auth
+短信登录 / 绑定
5. WeChat Mini
+微信小程序登录
开发环境可直接使用 dev-xxx code。
6. Entry / Home
+入口与首页
7. Event
+活动与启动
@@ -465,8 +629,8 @@ const devWorkbenchHTML = `
8. Session
+局内状态
9. Results
+结果查询
10. Profile
+当前用户
@@ -540,9 +704,14 @@ const devWorkbenchHTML = `
-
-
-
11. Quick Flows
+ +
+
+
一键流程
把常用接口串成一键工作流，减少重复点击。
@@ -553,8 +722,8 @@ const devWorkbenchHTML = `
-
+
这些流程会复用当前表单里的手机号、设备、event、channel 等输入。
- 12. Request Export
+请求导出
最后一次请求会生成一条可复制的 curl，后面做问题复现会方便很多。
@@ -567,9 +736,262 @@ const devWorkbenchHTML = `
+
+
+
+
+
+
+
+
+
+
资源对象管理
+管理地图、赛场和资源包对象，先建对象，再建版本，后面 Event source 直接引用这些对象。
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Event Source 组装
+创建 Event 并把 map version、playfield version、resource pack version 组装成 source config。
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-
+
+
+
+
-
-
+
13. Scenarios
+Build / Publish / Rollback
+围绕当前 Event 查询 source/build/release 流水线，并执行 build、publish、rollback。
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 场景模板
保存当前表单状态为可复用场景，也支持导入导出 JSON，适合后续切换不同俱乐部、入口和 event。
14. Response Log
+响应日志
最后一次请求的结果会记录在这里，便于后续做请求回放和用例保存。
ready
@@ -603,21 +1025,27 @@ const devWorkbenchHTML = `
-
-
+
- 15. Request History
+请求历史
最近 12 次请求会保留在浏览器本地，刷新页面不会丢。
-
-
16. API 列表
+ +
+
+
-
+
+ API 目录
把当前已实现接口按分组放进 workbench，直接看中文说明、鉴权要求和关键参数，不用来回翻文档。
+GET/healthz
@@ -709,18 +1137,18 @@ const devWorkbenchHTML = `
+
-
+
+ GET/events/{eventPublicID}/play
- 活动详情页 / 开始前准备页聚合接口，判断是否可启动、继续还是查看上次结果。
+ 活动详情页 / 开始前准备页聚合接口，判断是否可启动、继续还是查看上次结果；第一阶段也会返回多赛道 assignmentMode 和 courseVariants。
+
@@ -834,15 +1262,180 @@ const devWorkbenchHTML = `
POST/events/{eventPublicID}/launch
- 基于当前 event 的已发布 release 创建一局 session，并返回 config URL、releaseId、sessionToken。
+ 基于当前 event 的已发布 release 创建一局 session，并返回 config URL、releaseId、sessionToken；多赛道第一阶段支持可选 variantId，并返回最终绑定的 launch.variant。
关键参数：
buildId
+
+
+ GET/admin/maps
+ 后台地图对象列表接口。
+
+
+
+
+ POST/admin/maps
+ 创建地图对象，后续再为它追加版本。
+
+
+
+
+ GET/admin/maps/{mapPublicID}
+ 查看单个地图对象和它的版本列表。
+
+
+
+
+ POST/admin/maps/{mapPublicID}/versions
+ 为地图对象创建一个版本，挂接 mapmeta 和 tiles 根路径。
+
+
+
+
+ GET/admin/playfields
+ 后台赛场对象列表接口。
+
+
+
+
+ POST/admin/playfields
+ 创建赛场对象，适合管理 KML / GeoJSON 这类可复用场地资源。
+
+
+
+
+ GET/admin/playfields/{playfieldPublicID}
+ 查看单个赛场对象和它的版本列表。
+
+
+
+
+ POST/admin/playfields/{playfieldPublicID}/versions
+ 为赛场对象创建一个版本，挂接 KML 等源文件地址和控制点摘要。
+
+
+
+
+ GET/admin/resource-packs
+ 后台资源包对象列表接口。
+
+
+
+
+ POST/admin/resource-packs
+ 创建资源包对象，用来管理内容页、音频和主题资源。
+
+
+
+
+ GET/admin/resource-packs/{resourcePackPublicID}
+ 查看单个资源包对象和它的版本列表。
+
+
+
+
+ POST/admin/resource-packs/{resourcePackPublicID}/versions
+ 为资源包对象创建版本，配置内容入口、音频根路径和主题代码。
+
+
+
+
+ GET/admin/events
+ 后台 event 列表接口。
+
+
+
+
+ POST/admin/events
+ 创建 event 基础信息。
+
+
+
+
+ GET/admin/events/{eventPublicID}
+ 查看 event 明细、最新 source 和当前 source 摘要。
+
+
+
+
+ PUT/admin/events/{eventPublicID}
+ 更新 event 基础信息。
+
+
+
+
+ POST/admin/events/{eventPublicID}/source
+ 把 map/playfield/resource pack 版本和 gameModeCode 组装成 source config。
+
+
+
+
+ GET/admin/events/{eventPublicID}/pipeline
+ 查看 event 下的 source、build、release 流水线概览。
+
+
+
+
+ POST/admin/sources/{sourceID}/build
+ 基于 source 生成一条 build 记录和 preview manifest。
+
+
+
+
+ GET/admin/builds/{buildID}
+ 查看后台 build 明细。
+
+
+
+
+ POST/admin/builds/{buildID}/publish
+ 把后台 build 发布为正式 release，并切换为 event 当前发布版本。
+
+
+
POST/admin/events/{eventPublicID}/rollback
+ 将 event 当前发布版本回滚到指定 releaseId。
+
+