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

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/42_3.15/350/265/204/346/272/220/347/273/264/346/212/244-/344/270/212/345/215/212.md

@@ -0,0 +1,767 @@
+---
+name: 3.15 资源维护（上半）
+source-file: 外部接口清单
+source-section: 3.15.1–3.15.6 资源维护
+keywords: [资源维护, 资源菜单, 门户菜单, vue]
+use-cases: [资源菜单管理, 门户菜单]
+related: [43_3.15资源维护-下半.md]
+---
+
+# 3.15 资源维护（上半）
+
+> **原文章节**：`外部接口清单 → 3.15.1–3.15.6 资源维护`
+> **行号范围**：L10386-L11125
+
+## 🎯 一句话
+本章节覆盖资源新增、删除、按扩展字段删除，以及用户门户菜单树和菜单列表查询接口。
+
+## 📋 接口清单
+
+## 3.15 资源维护
+
+---
+
+### 3.15.1
+
+- **接口地址**：`/api/authority/resource/create`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`新增资源接口`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 |  |  | 是否必填 | 参数描述 |
+|---|---|---|---|---|---|---|
+|  |  |  | 参数类型 |  |  |  |
+| parentId | 1 | String |  |  | 是 | 暂无描述 |
+| name | apitest | String |  |  | 是 | 暂无描述 |
+| type | 0 | String |  |  | 是 | 暂无描述 |
+| showType |  | String |  |  | 否 | 暂无描述 |
+| uri |  | String |  |  | 否 | 暂无描述 |
+| embedUrl |  | String |  |  | 否 | 暂无描述 |
+| applicationName | an | String |  |  | 是 | 暂无描述 |
+| openType |  | String |  |  | 否 | 暂无描述 |
+| sort | 1 | String |  |  | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661238376466 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/authority/resource/create | 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": 1661238376466,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/authority/resource/create",
+"data":{
+"id": "679da66c6da949b6832edd1a1e6af228",
+"parentId": "1",
+"uri": null,
+"code": null,
+"type": "0",
+"name": "apitest",
+"remark": null,
+"sort": 1,
+"version": null,
+"text": "apitest",
+"checked": null,
+"state": "open",
+"objId": null,
+"iconPath": null,
+"productName": null,
+页 224/276
+"applicationName": "an",
+"moduleName": "",
+"sysResource": "1",
+"init": "0",
+"component": null,
+"embedUrl": null,
+"menuUrl": null,
+"showType": null,
+"showMenuKey": null,
+"groupId": null,
+"showMenu": "0",
+"openType": null,
+"mainProduct": null,
+"resoure_type": null,
+"system_code": null,
+"isEntrance": "1",
+"extendColumn1": "001",
+"extendColumn2": null,
+"extendColumn3": null,
+"extendColumn4": null,
+"extendColumn5": null,
+"extendColumn6": null,
+"extendColumn7": null,
+"extendColumn8": null,
+"secretCode": null,
+"secretName": null,
+"systemName": null,
+"extendColumn9": null,
+"a": null,
+"b": null,
+"c": null,
+"d": 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,
+页 225/276
+"t": null,
+"u": null,
+"v": null,
+"w": null,
+"x": null,
+"y": null,
+"z": null,
+"authorities": null,
+"children": [],
+"attributes":{
+"type": "0",
+"uri": null,
+"parentId": "1"
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 3.15.2
+
+- **接口地址**：`/api/authority/resource/delete`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`删除资源接口`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| ids | 001d1d0c3e7442da 98eb137ceed9b832 | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661224925284 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/authority/resource/delete | String | api 路径 |
+| data |  | Boolean | 返回数据 |
+| data.success | true | 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": 1661224925284,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/authority/resource/delete",
+"data":{
+"success":true
+},
+"extraInfo":{},
+"success":true
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 3.15.3 根据扩展字段删除资源菜单
+
+- **接口地址**：`/api/authority/resource/delete-by-extendcolumn`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`根据扩展字段删除资源菜单`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 |  |  |  | 是否必填 | 参数描述 |
+|---|---|---|---|---|---|---|
+|  |  |  | 参数类型 |  |  |  |
+| extendColumn1 | 001 | String |  |  | 否 | 暂无描述 |
+| extendColumn2 | String | String |  |  | 否 | 暂无描述 |
+| extendColumn3 | String | String |  |  | 否 | 暂无描述 |
+| extendColumn4 | String | String |  |  | 否 | 暂无描述 |
+| extendColumn5 | String | String |  |  | 否 | 暂无描述 |
+| extendColumn6 | String | String |  |  | 否 | 暂无描述 |
+| extendColumn7 | String | String |  |  | 否 | 暂无描述 |
+| extendColumn8 | String | String |  |  | 否 | 暂无描述 |
+| isEntrance | String | String |  |  | 否 | 暂无描述 |
+| res_url | String | String |  |  | 否 | 暂无描述 |
+| resoure_type | String | String |  |  | 否 | 暂无描述 |
+| system_code | String | String |  |  | 否 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661225153900 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/authority/resource/delete -by-extendcolumn | String | api 路径 |
+| data | true | Boolean | 返回数据 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | Boolean | 成功响应 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+页 228/276
+{
+"timestamp": 1661225153900,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/authority/resource/delete-by-extendcolumn",
+"data":true,
+"extraInfo":{},
+"success":true
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 3.15.4 vue—, 框架获取用户门户菜单树，分为系统菜单和资源菜单默认为系统菜单
+
+- **接口地址**：`/api/authority/resource/getUserPermission`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`获取用户门户菜单树`
+---
+
+### 获取用户门户菜单树
+
+- **接口备注**：`获取用户门户菜单树`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| sysResource | String | String | 否 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"id": "-1",
+页 229/276
+"parentId": null,
+"uri": null,
+"code": null,
+"type": "-1",
+"name": "全部资源",
+"remark": null,
+"sort": null,
+"version": null,
+"text": "全部资源",
+"checked": null,
+"state": "open",
+"objId": null,
+"iconPath": null,
+"productName": null,
+"applicationName": null,
+"moduleName": null,
+"sysResource": null,
+"init": null,
+"component": null,
+"embedUrl": null,
+"menuUrl": null,
+"showType": null,
+"showMenuKey": null,
+"groupId": null,
+"showMenu": "0",
+"openType": null,
+"mainProduct": null,
+"resoure_type": null,
+"system_code": null,
+"isEntrance": null,
+"extendColumn1": null,
+"extendColumn2": null,
+"extendColumn3": null,
+"extendColumn4": null,
+"extendColumn5": null,
+"extendColumn6": null,
+"extendColumn7": null,
+"extendColumn8": null,
+"secretCode": null,
+"secretName": null,
+"systemName": null,
+"extendColumn9": null,
+"a": null,
+"b": null,
+"c": null,
+"d": null,
+"e": null,
+页 230/276
+"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,
+"y": null,
+"z": null,
+"authorities": null,
+"children": [
+{
+"id": "home",
+"parentId": "-1",
+"uri": "/ucenter/index",
+"code": null,
+"type": "1",
+"name": "首页",
+"remark": null,
+"sort":-1,
+"version": "0.0.1-SNAPSHOT.88262",
+"text": "首页",
+"checked": null,
+"state": null,
+"objId": null,
+"iconPath": "el-icon-setting",
+"productName": "cloud-system",
+"applicationName": "cloud-system-manage",
+"moduleName": "",
+"sysResource": "1",
+"init": "1",
+"component": "views/system/index.vue",
+"embedUrl": "",
+"menuUrl": "",
+"showType": "select",
+页 231/276
+"showMenuKey": null,
+"groupId": null,
+"showMenu": "0",
+"openType": null,
+"mainProduct": null,
+"resoure_type": null,
+"system_code": null,
+"isEntrance": null,
+"extendColumn1": null,
+"extendColumn2": null,
+"extendColumn3": null,
+"extendColumn4": null,
+"extendColumn5": null,
+"extendColumn6": null,
+"extendColumn7": null,
+"extendColumn8": null,
+"secretCode": null,
+"secretName": null,
+"systemName": null,
+"extendColumn9": null,
+"a": null,
+"b": null,
+"c": null,
+"d": 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,
+"y": null,
+"z": null,
+"authorities": null,
+页 232/276
+"children": [],
+"attributes":{}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 3.15.5 tempo, 获取用户门户菜单列表，分为系统菜单和资源菜单默认为系统菜单
+
+- **接口地址**：`/api/authority/resource/getUserPermissionList`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`获取用户门户菜单列表`
+---
+
+### 获取用户门户菜单列表
+
+- **接口备注**：`获取用户门户菜单列表`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |  |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+[
+{
+"id": "1f7ee42ea24d443c8aa40c437267ff22",
+"privId": "b39a44adb9084cfcb2a69062966ff229",
+"objId": "XTGLY",
+"type": "4",
+"hasProgeny": null,
+"init": "1",
+"productName": "cloud-system",
+"extendColumn1": null,
+"extendColumn2": null,
+"extendColumn3": null,
+"extendColumn4": null,
+"extendColumn5": null,
+"extendColumn6": null,
+"extendColumn7": null,
+"extendColumn8": null,
+"dlevelCode": null
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 3.15.6 vue—,
+
+- **接口地址**：`/api/authority/resource/getUserPermissionProductCtrl`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`获取用户门户菜单树`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |  |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"id": "-1",
+"parentId": null,
+"uri": null,
+"code": null,
+"type": "-1",
+"name": "全部资源",
+"remark": null,
+"sort": null,
+"version": null,
+"text": "全部资源",
+"checked": null,
+"state": "open",
+"objId": null,
+"iconPath": null,
+"productName": null,
+"applicationName": null,
+"moduleName": null,
+"sysResource": null,
+"init": null,
+"component": null,
+"embedUrl": null,
+"menuUrl": null,
+"showType": null,
+"showMenuKey": null,
+"groupId": null,
+"showMenu": "0",
+"openType": null,
+"mainProduct": null,
+"resoure_type": null,
+"system_code": null,
+"isEntrance": null,
+"extendColumn1": null,
+页 235/276
+"extendColumn2": null,
+"extendColumn3": null,
+"extendColumn4": null,
+"extendColumn5": null,
+"extendColumn6": null,
+"extendColumn7": null,
+"extendColumn8": null,
+"secretCode": null,
+"secretName": null,
+"systemName": null,
+"extendColumn9": null,
+"a": null,
+"b": null,
+"c": null,
+"d": 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,
+"y": null,
+"z": null,
+"authorities": null,
+"children": [
+{
+"id": "home",
+"parentId": "-1",
+"uri": "/ucenter/index",
+"code": null,
+"type": "1",
+"name": "首页",
+"remark": null,
+页 236/276
+"sort":-1,
+"version": "0.0.1-SNAPSHOT.88262",
+"text": "首页",
+"checked": null,
+"state": null,
+"objId": null,
+"iconPath": "el-icon-setting",
+"productName": "cloud-system",
+"applicationName": "cloud-system-manage",
+"moduleName": "",
+"sysResource": "1",
+"init": "1",
+"component": "views/system/index.vue",
+"embedUrl": "",
+"menuUrl": "",
+"showType": "select",
+"showMenuKey": null,
+"groupId": null,
+"showMenu": "0",
+"openType": null,
+"mainProduct": null,
+"resoure_type": null,
+"system_code": null,
+"isEntrance": null,
+"extendColumn1": null,
+"extendColumn2": null,
+"extendColumn3": null,
+"extendColumn4": null,
+"extendColumn5": null,
+"extendColumn6": null,
+"extendColumn7": null,
+"extendColumn8": null,
+"secretCode": null,
+"secretName": null,
+"systemName": null,
+"extendColumn9": null,
+"a": null,
+"b": null,
+"c": null,
+"d": null,
+"e": null,
+"f": null,
+"g": null,
+"h": null,
+"i": null,
+"j": null,
+"k": null,
+页 237/276
+"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,
+"y": null,
+"z": null,
+"authorities": null,
+"children": [],
+"attributes":{}
+```
+
+
+**返回失败示例**：
+
+```json
+页 238/276
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+
+## 💡 使用建议
+- 资源创建时确认 parentId、applicationName、type 和 sort 等关键字段。
+- 门户菜单接口区分树、列表及产品控制变体，按前端展示形态选择接口。
+- 按扩展字段删除资源前应确认字段组合，避免删除范围过大。
+
+## 🔗 相关章节
+- 43_3.15资源维护-下半.md