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

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/45_3.16/344/272/272/345/221/230/351/200/211/346/213/251/345/231/250-/344/270/213/345/215/212.md

@@ -0,0 +1,242 @@
+---
+name: 3.16 人员选择器（下半）
+source-file: 外部接口清单
+source-section: 3.16.5–3.16.7 人员选择器
+keywords: [人员信息列表, 工作组人员, 根机构人员]
+use-cases: [人员选择器]
+related: [44_3.16人员选择器-上半.md]
+---
+
+# 3.16 人员选择器（下半）
+
+> **原文章节**：`外部接口清单 → 3.16.5–3.16.7 人员选择器`
+> **行号范围**：L11761-L11976
+
+## 🎯 一句话
+本章节提供按人员 ID、根机构或工作组获取人员列表，以及机构下级机构和工作组树接口。
+
+## 📋 接口清单
+
+### 3.16.5 id
+
+- **接口地址**：`/api/userselect/userinfo/listbyuserids`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`根据人员id 获取人员信息列表`
+---
+
+### 根据人员获取人员信息列表
+
+- **接口备注**：`根据人员id 获取人员信息列表`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| userids | 00d9188541d5421 6a1e2c9cf5004a2d 2 | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661249253826 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/userselect/userinfo/listby userids | String | api 路径 |
+| data |  | Object | 返回数据 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | Boolean | 成功响应 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661249253826,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+页 260/276
+"path": "/api/userselect/userinfo/listbyuserids",
+"data": [
+{
+"userId": "00d9188541d54216a1e2c9cf5004a2d2",
+"userName": "zhangyan1",
+"empId": "42c272d4e8944f86b90d6917b96d252a",
+"empName": "张彦
+1dsdsdsdsdsdsdsdsdsdsdsdsdss2sssssssssssssssssssssssssssss",
+"empCode":
+"zhangyan1sssssssssssssssssssssssss2sssssssssssssssssssssssss",
+"email": null,
+"deptId": "3f2883b2821950330182199cb96e0047",
+"deptName": "美林数据"
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 3.16.6 id
+
+- **接口地址**：`/api/userselect/userinfo/listbyworkgroup`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`根据根机构或工作组id 获取人员信息`
+---
+
+### 根据根机构或工作组获取人员信息
+
+- **接口备注**：`根据根机构或工作组id 获取人员信息`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| filterUserIds |  | String | 否 | 暂无描述 |
+| grades |  | String | 否 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661249445475 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/userselect/userinfo/listby workgroup | String | api 路径 |
+| data |  | Object | 返回数据 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | Boolean | 成功响应 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661249445475,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/userselect/userinfo/listbyworkgroup",
+"data":{
+"rows": [
+{
+"userId": "624a42c2c7444facaabac78686c2f4e4",
+"userName": "12345",
+"empId":
+"3d6887c59b5642899425ea21202287b8",
+"empName": "sadasd",
+"empCode": "sds",
+"email": null,
+"deptId": "3f2883b2823d5f6c01823d6c7554000a",
+"deptName": "dsd"
+页 262/276
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 3.16.7 id
+
+- **接口地址**：`/api/userselect/workgrouptree`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`根据机构id 查询机构下的下级机构和工作组`
+---
+
+### 根据机构查询机构下的下级机构和工作组
+
+- **接口备注**：`根据机构id 查询机构下的下级机构和工作组`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| pid | 3f2883b282195033 0182199cb96e0047 | String | 否 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661249481646 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661249481646,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/userselect/workgrouptree",
+"data": [
+{
+"id": "3f2883b2823d5f6c01823d77e5be001f",
+"name": "111",
+"parentId": "3f2883b2821950330182199cb96e0047",
+"level": null,
+"itemType": "2",
+"dLevelCode": "000001------",
+"deptCode": "merit"
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+
+## 💡 使用建议
+- 批量人员查询前校验 userids 的分隔格式和数量，避免请求体过大。
+- 根机构或工作组人员接口返回 rows 列表，空列表应作为无匹配结果处理。
+
+## 🔗 相关章节
+- 44_3.16人员选择器-上半.md

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/46_3.17/345/241/253/346/212/245/346/212/245/350/241/250+3.18/351/252/214/350/257/201/347/240/201.md

@@ -0,0 +1,178 @@
+---
+name: 3.17 填报报表 + 3.18 验证码
+source-file: 外部接口清单
+source-section: 3.17 填报报表 + 3.18 获取验证码
+keywords: [填报报表, 报表授权, 验证码]
+use-cases: [报表填报, 登录验证码]
+related: [47_3.19工作台维护.md]
+---
+
+# 3.17 填报报表 + 3.18 验证码
+
+> **原文章节**：`外部接口清单 → 3.17 填报报表 + 3.18 获取验证码`
+> **行号范围**：L11977-L12128
+
+## 🎯 一句话
+本章节提供报表下载、报表授权状态查询和登录验证码获取接口。
+
+## 📋 接口清单
+
+## 3.17 填报报表
+
+---
+
+### 3.17.1
+
+- **接口地址**：`/api/report/download?fileName=111`
+- **请求类型**：`text/plain`
+- **请求方式**：`get`
+- **接口备注**：`下载报告`
+- **调试工具**：`ApiPost`
+
+**URI 参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| fileName | 111 | Text | 是 | 暂无描述 |
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |  |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回失败示例**：
+
+```json
+{"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 3.17.2 获取报表是否授权
+
+- **接口地址**：`/api/report/get-grant`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`获取报表是否授权`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |  |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661161507040 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/report/get-grant | String | api 路径 |
+| data | false | Boolean | 返回数据 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | Boolean | 成功响应 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661161507040,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/report/get-grant",
+"data":false,
+"extraInfo":{},
+"success":true
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+## 3.18 获取验证码
+
+---
+
+### 3.18.1
+
+- **接口地址**：`/verify/codeimg`
+- **请求类型**：`application/json`
+- **请求方式**：`post`
+- **接口备注**：`获取并输出验证码`
+---
+
+### 获取并输出验证码
+
+- **接口备注**：`获取并输出验证码`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |  |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+
+## 💡 使用建议
+- 下载报表时校验 fileName 参数并按文件流响应处理，不要把二进制内容当作 JSON。
+- 验证码接口用于登录安全校验，客户端应避免缓存或明文记录验证码数据。
+
+## 🔗 相关章节
+- 47_3.19工作台维护.md

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/47_3.19/345/267/245/344/275/234/345/217/260/347/273/264/346/212/244.md

@@ -0,0 +1,196 @@
+---
+name: 3.19 工作台维护
+source-file: 外部接口清单
+source-section: 3.19 工作台维护
+keywords: [工作台, 用户工作台菜单, Logo配置]
+use-cases: [工作台菜单, Logo配置]
+related: [48_3.20调度编排.md]
+---
+
+# 3.19 工作台维护
+
+> **原文章节**：`外部接口清单 → 3.19 工作台维护`
+> **行号范围**：L12129-L12298
+
+## 🎯 一句话
+本章节提供用户工作台菜单权限树和工作台 Logo 获取接口。
+
+## 📋 接口清单
+
+## 3.19 工作台维护
+
+---
+
+### 3.19.1 用户工作台菜单权限接口
+
+- **接口地址**：`/api/us/workbench-menu/workbench-menu-tree-by-user`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`用户工作台菜单权限接口`
+- **调试工具**：`ApiPost`
+
+**URI 参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| id | 3f28832d8001ff240 180023fedf9001f | String | 否 | 工作台菜单 id |
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| id | 3f28832d8001ff240 180023fedf9001f | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"tenantId": "",
+"secretCode": null,
+"secretName": null,
+"createTime": null,
+"updateTime": 1661238996786,
+"creatorId": null,
+"reviserId": null,
+"id": "-1",
+"name": "全部菜单",
+"parentId": null,
+"workbenchId": null,
+"icon": null,
+"shortCut": null,
+"type": "-1",
+"resourceId": null,
+"homeMenu": null,
+"homeUrl": null,
+"homeType": null,
+页 268/276
+"showHomeMenu":false,
+"sort": null,
+"resourceName": null,
+"applicationName": null,
+"productName": null,
+"showType": null,
+"uri": null,
+"version": null,
+"remark": null,
+"text": null,
+"moduleName": null,
+"embedUrl": null,
+"menuUrl": null,
+"system_code": null,
+"component": null,
+"showMenu": "0",
+"children": [
+{
+"tenantId": "",
+"secretCode": null,
+"secretName": null,
+"createTime": null,
+"updateTime": 1661238996824,
+"creatorId": null,
+"reviserId": null,
+"id": "3f28832d8001ff240180023fee010020",
+"name": "首页",
+"parentId": "-1",
+"workbenchId": "3f28832d8001ff240180023fedf9001f",
+"icon": "el-icon-setting",
+"shortCut": "false",
+"type": "1",
+"resourceId": "home",
+"homeMenu": "1",
+"homeUrl": null,
+"homeType": "resource",
+"showHomeMenu":false,
+"sort":0,
+"resourceName": "首页",
+"applicationName": "cloud-system-manage",
+"productName": "cloud-system",
+"showType": "none",
+"uri": "/ucenter/index",
+"version": "0.0.1-SNAPSHOT.88262",
+"remark": null,
+"text": null,
+"moduleName": null,
+页 269/276
+"embedUrl": null,
+"menuUrl": "",
+"system_code": null,
+"component": "views/system/index.vue",
+"showMenu": "0",
+"children": []
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 3.19.2 logo
+
+- **接口地址**：`/api/us/workbench/get-logo`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`获取图片输出流logo`
+- **调试工具**：`ApiPost`
+
+**URI 参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| workbenchId | ff8080817fb908d50 17fb9c558ff002e | String | 是 | workbenchId |
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| workbenchId | ff8080817fb908d50 17fb9c558ff002e | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+
+## 💡 使用建议
+- 工作台菜单树查询需要传入正确的工作台菜单 ID，并兼容嵌套 children。
+- Logo 接口返回图片输出流，调用方应按二进制资源进行缓存和展示。
+
+## 🔗 相关章节
+- 48_3.20调度编排.md