Files
label_backend/specs/001-label-backend-spec/contracts/config.md
wh 4054a1133b feat(plan): 生成 label_backend 完整实施规划文档
Phase 0:research.md(10项技术决策,无需澄清项)
Phase 1:data-model.md(11张表+Redis结构),contracts/(8个模块API契约),quickstart.md(Docker Compose启动+流水线验证)
plan.md:宪章11条全部通过,项目结构确认
2026-04-09 12:27:16 +08:00

1.2 KiB

API 契约:系统配置

所有接口需要 ADMIN 权限


GET /api/config

描述: 获取所有配置项(公司级配置 + 全局默认配置合并,公司级优先)

响应 200:

{
  "code": "SUCCESS",
  "data": {
    "items": [
      {
        "configKey": "prompt_extract_text",
        "configValue": "请提取以下文本中的主语-谓语-宾语三元组...",
        "description": "文本三元组提取 Prompt 模板",
        "scope": "GLOBAL",
        "updatedAt": "2026-04-09T00:00:00"
      },
      {
        "configKey": "model_default",
        "configValue": "glm-4-turbo",
        "description": "默认 AI 辅助模型",
        "scope": "COMPANY",
        "updatedAt": "2026-04-09T09:00:00"
      }
    ]
  }
}

scope 字段:GLOBAL(来自全局默认)、COMPANY(来自公司级覆盖)


PUT /api/config/{key}

描述: 更新单项配置(若公司级配置不存在则创建;若存在则覆盖)

请求体:

{
  "configValue": "glm-4-turbo",
  "description": "升级到 GLM-4-Turbo 模型"
}

响应 200: {"code": "SUCCESS", "data": null}
失败: 400 UNKNOWN_CONFIG_KEY: 未知的配置键(防止拼写错误创建无效配置)