docs/contracts/config-governance-v1.md(小冈 323 冻结,2026-09-14 19:2x)。
4 端点均 admin 鉴权、前缀 /api/miniapp/admin/config,响应包 {ok:true,data}:
| 方法 | 路径 | 请求 | 响应 data |
|---|---|---|---|
| GET | /versions | — | {versions:ConfigVersion[], current:number} |
| POST | /publish | {snapshot:ConfigSnapshot, note} | {version} |
| POST | /rollback | {toVersion, note} | {version}(生成新版本指向旧快照) |
| GET | /current | — | ConfigSnapshot & {version} |
校验:brandName 必填 1-20 字;themePrimary 须 HEX;logoUrl/heroBgUrl 须 https。
错误码:422 参数非法(含 details) / 403 非管理员 / 404 版本不存在 / 409 并发冲突。
services/contract.ts:ConfigSnapshot(6字段) / ConfigVersion / ConfigVersionsResp / ConfigCurrentResp / PublishReq/PublishResp / RollbackReq/RollbackRespservices/api.ts:listConfigVersions / getConfigCurrent / publishConfig / rollbackConfig(OkEnvelope+unwrap,MINI_ADMIN=/api/miniapp/admin)pages/ConfigVersion.tsx(新)+ ConfigVersion.css(新):App.tsx 路由 /config-versions;components/menu.ts 菜单项「品牌配置版本」(R7){snapshot,note} / rollback {toVersion,note} 对齐