4054a1133b
Phase 0：research.md（10项技术决策，无需澄清项） Phase 1：data-model.md（11张表+Redis结构），contracts/（8个模块API契约），quickstart.md（Docker Compose启动+流水线验证） plan.md：宪章11条全部通过，项目结构确认
54 lines
1.2 KiB
Markdown
54 lines
1.2 KiB
Markdown
# 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`: 未知的配置键（防止拼写错误创建无效配置）
|