@alanwang-merit/meritdata-platform-skill-package 1.0.10 → 1.0.11

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

@@ -1,597 +0,0 @@
----
-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