@alanwang-merit/meritdata-platform-skill-package 1.0.0

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/30_2.3/350/247/222/350/211/262/347/273/264/346/212/244-/344/270/213/345/215/212.md

@@ -0,0 +1,597 @@
+---
+name: 2.3 角色维护（下半）
+source-file: 外部接口清单
+source-section: 2.3.9–2.3.16 角色维护
+keywords: [成果管理员, 系统角色, 删除用户角色, tempo]
+use-cases: [成果管理员查询, 系统角色列表]
+related: [29_2.3角色维护-上半.md]
+---
+
+# 2.3 角色维护（下半）
+
+> **原文章节**：`外部接口清单 → 2.3.9–2.3.16 角色维护`
+> **行号范围**：L4996-L5565
+
+## 🎯 一句话
+本章节提供成果管理员、系统角色、角色人员及 Tempo 角色树等角色维护接口。
+
+## 📋 接口清单
+
+### 2.3.9
+
+- **接口地址**：`/api/ou/role/getUserIsSubCGAdmin`
+- **请求类型**：`application/json`
+- **请求方式**：`post`
+- **接口备注**：`当前用户是否为成果管理员`
+---
+
+### 当前用户是否为成果管理员
+
+- **接口备注**：`当前用户是否为成果管理员`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |  |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 2.3.10
+
+- **接口地址**：`/api/ou/role/list`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`角色列表接口`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| page | 1 | String | 是 | 分页页码，数字类型 |
+| rows | 10 | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661239801286 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/ou/role/list | String | api 路径 |
+| data |  | String | 返回数据 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | Boolean | 成功响应 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661239801286,
+"status": 1,
+页 119/276
+"message": "成功",
+"stackmessage": null,
+"path": "/api/ou/role/list",
+"data":{
+"rows": [
+{
+"tenantId": "",
+"secretCode": null,
+"secretName": null,
+"createTime": null,
+"updateTime": 1661239801276,
+"creatorId": null,
+"reviserId": null,
+"id": "112c9e1c1b634e6e96a4104e79ee262d",
+"deptId":
+"3f2883b2821950330182199cb96e0047",
+"deptName": "美林数据",
+"describe": "",
+"name": "111",
+"code": "111",
+"type":0,
+"sort":0,
+"applicationName": null,
+"authority":
+"112c9e1c1b634e6e96a4104e79ee262d"
+},
+{
+"tenantId": "",
+"secretCode": null,
+"secretName": null,
+"createTime": null,
+"updateTime": 1661239801276,
+"creatorId": null,
+"reviserId": null,
+"id": "d6bf90dd189944a2b327554b212472b4",
+"deptId":
+"3f2883b282195033018219a0be6b004e",
+"deptName": "11",
+"describe": "",
+"name": "1111",
+"code": "1111",
+"type":0,
+"sort":0,
+"applicationName": null,
+"authority":
+"d6bf90dd189944a2b327554b212472b4"
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 2.3.11
+
+- **接口地址**：`/api/ou/role/list-role-user`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`查询角色下人员列表接口`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| roleCode | 111 | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661239869868 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661239869868,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/ou/role/list-role-user",
+"data": [
+{
+"tenantId": "",
+"secretCode": null,
+"secretName": null,
+"createTime": null,
+"updateTime": 1661239869868,
+"creatorId": null,
+"reviserId": null,
+"id": "3d6887c59b5642899425ea21202287b8",
+"name": "sadasd",
+"code": "sds",
+"sex": null,
+"birthday": null,
+"folk": null,
+"education": null,
+"handset": null,
+"familyPhone": null,
+"email": null,
+"sortNo": null,
+"systemUser": null,
+"deptId": "3f2883b2823d5f6c01823d6c7554000a",
+"deptCode": "dsd",
+"deptName": "dsd",
+"userId": null,
+"userState": null,
+"weixinNo": null,
+"province": null,
+"city": null,
+"county": null,
+"grade": null,
+页 122/276
+"workgroupName": null,
+"workgroupId": null,
+"postName": null,
+"postId": null,
+"postFlag": null,
+"roleId": null,
+"ipAddress": null,
+"macAddress": null,
+"gradeName": null,
+"manageDeptName": null,
+"manageDeptId": null,
+"empCategorys":{},
+"cateCodes": null,
+"userName": null,
+"detptype": null,
+"roleName": null,
+"did": "3f2883b282c4c2cd0182c4fa6d4c0046",
+"isSubDsAdmin": null,
+"isCGSysadmin": null,
+"authStatus": null,
+"parentsOrgs":{},
+"resultName": null,
+"cycleDeptName": null,
+"userType": null,
+"d": null,
+"addTime": null,
+"lastTime": null,
+"e": null,
+"f": null,
+"g": null,
+"h": null,
+"i": null,
+"j": null,
+"k": null,
+"l": null,
+"m": null,
+"n": null,
+"o": null,
+"p": null,
+"q": null,
+"r": null,
+"s": null,
+"t": null,
+"u": null,
+"v": null,
+"w": null,
+"x": null,
+页 123/276
+"y": null,
+"z": null
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 2.3.12 系统角色列表接口
+
+- **接口地址**：`/api/ou/role/listSysRole`
+- **请求类型**：`application/json`
+- **请求方式**：`post`
+- **接口备注**：`角色列表接口`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |  |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661239901692 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/ou/role/listSysRole | String | api 路径 |
+| data |  | Array | 返回数据 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661239901692,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/ou/role/listSysRole",
+"data": [
+{
+"tenantId": null,
+"secretCode": null,
+"secretName": null,
+"createTime": null,
+"updateTime": 1660704084000,
+"creatorId": null,
+"reviserId": null,
+"id": "XTGLY",
+"deptId": "1",
+"deptName": "组织机构",
+"describe": null,
+"name": "系统管理员",
+"code": "XTGLY",
+"type": 1,
+"sort": 100,
+"applicationName": "",
+"authority": "XTGLY"
+}
+```
+
+
+**返回失败示例**：
+
+```json
+页 125/276
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 2.3.13 Id
+
+- **接口地址**：`/api/ou/role/listUserByRole`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`根据角色Id 获取用户`
+---
+
+### 根据角色获取用户
+
+- **接口备注**：`根据角色Id 获取用户`
+- **调试工具**：`ApiPost`
+
+**URI 参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| map | Object | Object | 是 | map |
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| roleId | 112c9e1c1b634e6e 96a4104e79ee262d | String | 是 | 暂无描述 |
+| page | 1 | String | 是 | 暂无描述 |
+| rows | 10 | String | 是 | 暂无描述 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"rows": [],
+"deptcodes": null,
+"total": 0,
+"pageSize": 10,
+"pageNumber": 1,
+"totalPages":0,
+"records":0
+}
+```
+
+
+**返回失败示例**：
+
+```json
+页 126/276
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 2.3.14
+
+- **接口地址**：`/api/ou/role/queryChildCGAdminsByRoleId`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`获取子成果管理员列表`
+---
+
+### 获取子成果管理员列表
+
+- **接口备注**：`获取子成果管理员列表`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| roleId | 112c9e1c1b634e6e 96a4104e79ee262d | String | 是 | 暂无描述 |
+| name |  | String | 否 | 暂无描述 |
+| page | 1 | String | 是 | 暂无描述 |
+| rows | 10 | String | 是 | 暂无描述 |
+| sort | 10 | String | 是 | 暂无描述 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"rows": [],
+"deptcodes": null,
+"total": 0,
+"pageSize": 10,
+"pageNumber": 1,
+"totalPages":0,
+"records":0
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 2.3.15
+
+- **接口地址**：`/api/ou/role/removeRoleUser`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`删除用户角色接口`
+---
+
+### 删除用户角色接口
+
+- **接口备注**：`删除用户角色接口`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| ids | 3d6887c59b564289 9425ea21202287b8 *3f2883b2823d5f6 c01823d6c7554000 a | String | 是 | 暂无描述 |
+| roleId | 112c9e1c1b634e6e 96a4104e79ee262d | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 2.3.16 tempo
+
+- **接口地址**：`/api/ou/role/tree-tempo`
+- **请求类型**：`application/json`
+- **请求方式**：`post`
+- **接口备注**：`tempo 使用`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |  |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661241800969 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/ou/role/tree-tempo | String | api 路径 |
+| data |  | Array | 返回数据 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | Boolean | 成功响应 |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661241800969,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/ou/role/tree-tempo",
+"data": [
+{
+"code": "merit",
+"isAble": "1",
+"simpleName": "美林数据",
+"name": "美林数据",
+"pid": "1",
+"id": "3f2883b2821950330182199cb96e0047",
+"sort":0,
+"type": "org",
+"dLevelCode": "000001"
+},
+{
+"code": "AQGLY",
+"name": "安全管理员",
+```
+
+---
+
+### 安全管理员
+
+### 安全审计员
+
+### 调度编排管理员
+
+### 租户管理员
+
+
+## 💡 使用建议
+- 调用成果管理员状态接口前确认当前会话身份。
+- 角色列表与人员角色接口使用分页参数时，保持 page/rows 一致。
+- 删除用户角色前核对 roleId 与 ids 的对应关系。
+
+## 🔗 相关章节
+- 29_2.3角色维护-上半.md