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