feat(qaops): 增加版本化部门区域归属配置与预览

This commit is contained in:
姚章浩
2026-10-17 11:39:38 +08:00
parent fd04bf7886
commit dab74b706b
23 changed files with 1693 additions and 51 deletions
+51
View File
@@ -44,6 +44,57 @@
}
],
"paths": {
"/api/v1/qa-ops/organization": {
"get": {
"tags": ["QA operations"],
"operationId": "getQAOrganization",
"summary": "管理员读取服务器固定租户的完整部门路径、已保存区域归属与快照时间,不返回人员名单",
"responses": {
"200": {"$ref": "#/components/responses/Envelope"},
"400": {"$ref": "#/components/responses/BadRequest"},
"401": {"description": "需要登录"},
"403": {"description": "仅管理员可访问"},
"500": {"$ref": "#/components/responses/InternalError"},
"503": {"description": "治理侧组织存储不可用"}
}
}
},
"/api/v1/qa-ops/organization/preview": {
"post": {
"tags": ["QA operations"],
"operationId": "previewQAOrganizationRegions",
"summary": "预览当前通讯录版本下的父子部门区域归属和去重人数,不保存修改",
"parameters": [{"name":"X-Governance-Action","in":"header","required":true,"schema":{"const":"qa-organization"}}],
"requestBody": {"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["directory_id","base_revision","rules"],"properties":{"directory_id":{"type":"string"},"base_revision":{"type":"string"},"rules":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["department_id","region"],"properties":{"department_id":{"type":"string"},"region":{"enum":["国内工业","APAC","EMEA","America"]}}}}}}}}},
"responses": {
"200": {"$ref": "#/components/responses/Envelope"},
"400": {"$ref": "#/components/responses/BadRequest"},
"401": {"description": "需要登录"},
"403": {"description": "仅管理员同源操作可访问"},
"409": {"description": "通讯录或配置版本已变化,需重新读取"},
"500": {"$ref": "#/components/responses/InternalError"},
"503": {"description": "治理侧组织存储不可用"}
}
}
},
"/api/v1/qa-ops/organization/regions": {
"put": {
"tags": ["QA operations"],
"operationId": "saveQAOrganizationRegions",
"summary": "保存版本化区域配置;操作人取管理员会话,不改变钉钉或DobotAI数据",
"parameters": [{"name":"X-Governance-Action","in":"header","required":true,"schema":{"const":"qa-organization"}}],
"requestBody": {"$ref":"#/paths/~1api~1v1~1qa-ops~1organization~1preview/post/requestBody"},
"responses": {
"200": {"$ref": "#/components/responses/Envelope"},
"400": {"$ref": "#/components/responses/BadRequest"},
"401": {"description": "需要登录"},
"403": {"description": "仅管理员同源操作可访问"},
"409": {"description": "版本冲突或尚无完整通讯录"},
"500": {"$ref": "#/components/responses/InternalError"},
"503": {"description": "治理侧组织存储不可用"}
}
}
},
"/api/v1/qa-ops/status": {
"get": {
"tags": ["QA operations"],