# API 契约：系统配置

*所有接口需要 ADMIN 权限*

---

## GET /api/config

**描述**: 获取所有配置项（公司级配置 + 全局默认配置合并，公司级优先）

**响应** `200`:
```json
{
  "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}

**描述**: 更新单项配置（若公司级配置不存在则创建；若存在则覆盖）

**请求体**:
```json
{
  "configValue": "glm-4-turbo",
  "description": "升级到 GLM-4-Turbo 模型"
}
```

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