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

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/.bak//345/272/224/347/224/250/345/274/200/345/217/221/345/271/263/345/217/260-/346/265/201/347/250/213/347/256/241/347/220/206-/344/275/277/347/224/250/346/224/273/347/225/245/357/274/210/345/205/255/357/274/211/357/274/232/346/265/201/347/250/213/350/277/275/350/270/252/351/241/265/351/235/242/345/265/214/345/205/245/350/241/250/345/215/225/345/274/200/345/217/221.md

@@ -0,0 +1,229 @@
+---
+title: 应用开发平台流程管理使用攻略（六）：流程追踪页面嵌入表单开发
+date: 2025.05.28
+categories:
+  - 开发攻略
+  - 6.13.2
+---
+
+## 																				应用开发平台流程管理使用攻略（六）：流程追踪页面嵌入表单开发
+
+对于需要把现有查看追踪页面的页面拆分开嵌入进自己的表单页面的需求。
+
+## 1. 开发步骤：
+
+### 1.1 更新流程的包到最新版本。
+
+### 1.2 自己表单页面嵌入页面的具体步骤。
+
+#### 1.2.1 获取需要的下面几个参数
+
+port：端口
+
+procDefId：流程定义Id
+
+procInstId：流程实例id
+
+showtitle：是否展示标题   值为 true （展示上面页面的切换文字）或 false （不展示上面页面的切换文字），此种业务场景下拼接false
+
+showtabkey：展示的页面  值有 grid(文字追踪页面)   track（追踪图表页面） apply （审批意见页面）
+
+IsShielding：是否展示标题中的文字追踪和流程意见标题   此种业务场景不用在url中拼接
+
+通过以上拼接出页面的URL。
+
+示例：http://127.0.0.1:8080/bpm/proctrack/index.html?procInstId=d33eaacd-fa4c-11eb-96f9-70b5e84e90b6&procDefId=Process_Demo1:56:0936fb8c-f502-11eb-8ba5-70b5e84e90b6&showtitle=false&showtabkey=grid#/
+
+#### 1.2.2 自己编写接口调用应用开发平台提供的接口获取port和procDefId，procInstId
+
+获取port：
+
+示例：
+
+```java
+@RequestMapping(value = "/port", method = RequestMethod.POST)
+    public @ResponseBody
+    ResultBody<String> getPort(){
+        ResultBody<String> result = bpmEngine.getPort();
+        return ResultBody.success(result.getData());
+    }
+```
+
+当首次打开表单没有没有businessId时，要查询procDefId显示流程追踪图，调用下面接口
+
+```java
+@Autowired
+    BpmEngine bpmEngine;
+
+    @ApiOperation(value = "获取流程最新定义ID", notes = "根据流程定义Key查询最新的流程定义ID")
+    @RequestMapping(value = "/get/{procDefKey}", method = RequestMethod.POST)
+    public @ResponseBody ResultBody<String> getLatestProcDefId(@PathVariable("procDefKey") String procDefKey) {
+
+        // 调用查询流程实例
+        ResultBody<String> procDefId = bpmEngine.getLatestProcDefId(procDefKey);
+        return procDefId;
+    }
+```
+
+
+
+当有了businessId时获取procDefId，procInstId，通过查询mainFormDTO对象
+
+示例：
+
+```java
+@RequestMapping(value = "/mainform", method = RequestMethod.POST)
+    public @ResponseBody
+    ResultBody<MainFormDTO> getMainForm(@RequestParam String businessId){
+        ResultBody<MainFormDTO> result = bpmEngine.queryMainFormsByBusinessId(businessId);
+        return ResultBody.success(result.getData());
+    }
+```
+
+
+
+接口调用方式参考《二次开发--流程API接口》文档
+
+#### 1.2.3 前端开发
+
+使用element-ui组件  Collapse 
+
+```vue
+<el-collapse v-model="activeNames"> 
+<el-collapse-item title="文字追踪" name="1">
+      <div class="trock-div">
+        <iframe
+          allowfullscreen="true"
+          :src="url1"
+          width="100%"
+          style="border:0px;height: calc(100% - 1px)"
+        ></iframe>
+      </div>
+    </el-collapse-item>
+    <el-collapse-item title="图表追踪" name="2">
+      <div class="trock-div">
+        <iframe
+          allowfullscreen="true"
+          :src="url2"
+          width="100%"
+          style="border:0px;height: calc(100% - 1px)"
+        ></iframe>
+      </div>
+    </el-collapse-item>
+    <el-collapse-item title="审批意见" name="3">
+      <div class="trock-div">
+        <iframe
+          allowfullscreen="true"
+          :src="url3"
+          width="100%"
+          style="border:0px;height: calc(100% - 1px)"
+        ></iframe>
+      </div>
+    </el-collapse-item>
+  </el-collapse>
+```
+
+获取拼接所需参数，拼接url
+
+备注所有参数名自己定义。
+
+data中定义三个url:
+
+```vue
+data() {
+    return {
+	 url1: '',
+     url2: '',
+     url3: '',
+    }
+}
+```
+
+方法写在created中：
+
+调用自己的工程接口获取procDefId，procInstId
+
+// 若businessId为空则不用请求了，procDefId，procInstId都赋值为空字符串。追踪页面将会显示空白
+
+示例：
+
+```vue
+var procDefId = '';
+var procInstId = '';
+this.axios['cloud-system-bpm-travel']
+      .post(this.HOST + '/mainform', {
+        businessId: '3f28830b7b32fef7017b3310c8de0004'
+      })
+      .then(function(res) {
+		// 获取procDefId和procInstId
+        procDefId = res.data.procDefId;
+        procInstId = res.data.procInstId;
+		
+		// 这个方法是获取port，拼接url
+        _this.setUrl(procDefId, procInstId);
+      });
+```
+
+方法写在methods中：
+
+```vue
+setUrl(procDefId, procInstId) {
+      let _this = this;
+      let port = '';
+      var url1 = '';
+      var url2 = '';
+      var url3 = '';
+      var shielding = false;
+      // 获取端口
+      this.axios['cloud-system-bpm-travel']
+        .post(this.HOST + '/port')
+        .then(function(res) {
+          port = res.data;
+          url1 = _this.appendUrl('grid', port, procInstId, procDefId);
+          url2 = _this.appendUrl('track', port, procInstId, procDefId);
+          url3 = _this.appendUrl('apply', port, procInstId, procDefId);
+          _this.url1 = url1;
+          _this.url2 = url2;
+          _this.url3 = url3;
+        });
+    },
+appendUrl(key, port, procInstId, procDefId) {
+      let url = '';
+      if (port == '80') {
+        url =
+          'http://' +
+          window.location.hostname +
+          '/bpm/proctrack/index.html?procInstId=' +
+          procInstId +
+          '&procDefId=' +
+          procDefId +
+          '&showtitle=false&showtabkey=' +
+          key;
+      } else {
+        url =
+          'http://' +
+          window.location.hostname +
+          ':' +
+          port +
+          '/bpm/proctrack/index.html?procInstId=' +
+          procInstId +
+          '&procDefId=' +
+          procDefId +
+          '&showtitle=false&showtabkey=' +
+          key;
+      }
+      return url;
+    }
+```
+
+以上步骤完成嵌入，具体页面样式自己开发。
+
+效果如下：
+
+闭合：
+
+![image-20210817172626314](.\imgs\流程应用开发\image-20210817172626314.png)
+
+展开：
+
+![image-20210817172538277](.\imgs\流程应用开发\image-20210817172538277.png)

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/.bak//345/272/224/347/224/250/345/274/200/345/217/221/345/271/263/345/217/260-/346/265/201/347/250/213/347/256/241/347/220/206-/344/275/277/347/224/250/346/224/273/347/225/245/357/274/210/345/233/233/357/274/211/357/274/232/350/207/252/345/256/232/344/271/211/344/272/272/345/221/230.md

@@ -0,0 +1,112 @@
+---
+title: 应用开发平台流程管理使用攻略（四）：自定义人员
+date: 2025.05.28
+categories:
+  - 开发攻略
+  - 6.13.2
+---
+
+#  																								  												应用开发平台流程管理使用攻略（四）：自定义人员	
+
+​      流程中提供了选择人员的一些方式，但在业务场景比较多的时候提供固定的几个选项不能满足项目的定制化使用，因此提供了自定义人员的功能来满足项目需要。对于6.2的只能配置单个应用开发平台，6.3 修改实现方式支持多个应用开发平台中的接口。兼容6.2中已配置的计算人员方式。
+
+## 1. 配置位置
+
+流程设计页面---用户任务--人员
+
+![image-20210517150400914](.\imgs\自定义人员\image-20210517150400914.png)
+
+## 2. 配置页面
+
+![image-20210517150807090](.\imgs\自定义人员\image-20210517150807090.png)
+
+![image-20210908143032889](.\imgs\自定义人员\image-20210908143032889.png)
+
+## 3. 参数说明
+
+**示例:**
+
+自定义请求接口名称：demo      Controller层接口 RequestMapping中 “/api/bpm/” 后面的路径
+
+自定义请求方法名称：one          接口“/getUserCode/”后面的路径
+
+自定义条件：String 类型  后续通过使用params.get("customCondition") 获取 ，key固定为customCondition
+
+最终的请求地址为: /api/bpm/<u>demo</u>/getUserCode/<u>one</u>       下划线为自己配置的，其余为固定值
+
+服务名称在nacos中配置：common-cloud-bpm-engine.properties配置文件中
+
+meritdata.cloud.custom-service-name=<u>cloud-system-bpm-demo</u>  下划线部分为应用开发平台名称
+
+| 参数               | 值     | 说明                                      |
+| ------------------ | ------ | ----------------------------------------- |
+| 自定义请求接口名称 | String |                                           |
+| 自定义请求方法名称 | String | 参考截图中的位置                          |
+| 自定义条件         | String | 存储在Map中取的时候，key为customCondition |
+
+示例:
+
+自定义接口请求地址： 从服务名开始完整的接口地址  例如：/cloud-system-bpm-demo/api/bpm/demo/getUserCode/four
+
+/cloud-system-bpm-demo         服务名称
+
+/api/bpm/demo/getUserCode/one          接口地址
+
+\**/getUserCode/**           为接口中固定的部分
+
+自定义条件：String 类型  后续通过使用params.get("customCondition") 获取 ，key固定为customCondition
+
+## 4. 应用开发平台侧的实现方式
+
+注意：若用户想要在已有工程中添加自定义接口就直接在已有服务中添加，若用户想在新的服务中添加就需要新建应用开发平台（创建新服务参考相关新建应用开发平台文档）。
+
+因为以上的url部分为固定值，因此接口开发时接口的请求地址必须按以下规范命名
+
+@RequestMapping(value = "/api/bpm/{自定义请求接口名称}")
+
+@RequestMapping(value = "/getUserCode/{自定义请求方法名称}", method = RequestMethod.POST)
+
+接口返回值：List<String>  userCodes  人员编码集合
+
+### 4.1 bpm工程中调用侧的代码：利用feign调用配置的接口
+
+![image-20210629165316518](.\imgs\自定义人员\image-20210629165316518.png)
+
+### 4.2 bpm工程中调用侧的代码：利用RestTemplate调用配置的接口
+
+url 就是页面配置的自定义请求地址
+
+![image-20210908161257095](.\imgs\自定义人员\image-20210908161257095.png)
+
+### 4.3 中需要配置nacos匿名项防止开启安全项拦截
+
+common.properties  meritdata.cloud.system-anon 中添加 \**/getUserCode/**
+
+![image-20210908144832359](.\imgs\自定义人员\image-20210908144832359.png)
+
+## 5. 自定义接口的开发
+
+* RequestParams
+
+  | 参数   | 参数类型           | 是否必须 | 释义 | 备注 |
+  | ------ | ------------------ | -------- | ---- | ---- |
+  | params | Map<String,String> | 是       |      |      |
+
+* ResponseBody
+  返回数据类型：List\<String> 人员编码集合
+
+demo工程中的Controller层样例代码：
+
+![image-20210914094231607](./imgs/自定义人员\image-20210914094231607.png)
+
+![image-20210628170049773](.\imgs\自定义人员\image-20210628170049773.png)
+
+## 6. 效果展示
+
+通过以上在配置了自定义人员的节点，人员选择框就可以展示自定义人员
+
+以下是demo样例工程中获取的人员展示。
+
+
+
+![image-20210628165548154](.\imgs\自定义人员\image-20210628165548154.png)

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/01_/347/233/256/345/275/225/344/270/216/346/226/207/346/241/243/347/273/223/346/236/204.md

@@ -0,0 +1,97 @@
+---
+name: 目录与文档结构
+source-file: 公共资产清单
+source-section: 前置（标题+目录） L1-L66
+keywords: [平台总览, Maven依赖, 命名规范]
+use-cases: [项目背景了解]
+related: [02_一基础设施-1.1缓存操作-SysCacheServiceFacade.md, 03_一基础设施-1.1缓存操作-StringCacheFacade.md, 04_一基础设施-1.2配置中心-NacosUtils.md, 05_二通用工具-2.1加解密-SM2-SM3-SM4.md, 06_三平台服务-3.1日志服务-ILogPostService.md, 07_三平台服务-3.1日志注解-LogDesc-LogOperation.md]
+---
+
+# 目录与文档结构
+
+> **原文章节**：`公共资产清单 → 前置（标题 + 文档结构）`
+> **行号范围**：L1-L66
+
+## 🎯 一句话
+本章节定义整个公共资产清单的版本信息、覆盖范围以及完整的文档目录结构。
+
+## 📋 接口/方法清单
+
+# 前后端公共资产清单
+
+**版本**：V1.0
+**日期**：2026-05-20
+**说明**：涵盖微服务前后端所有公共资产
+**统计范围**：前端 `cloud_front` 模块 + 后端 `cloud_back` 模块
+
+---
+
+## 文档结构
+
+- [一、基础设施类](#一基础设施类)
+  - [1.1 缓存操作](#11-缓存操作)
+    - [SysCacheServiceFacade](#syscacheservicefacade)
+    - [StringCacheFacade](#stringcachefacade)
+  - [1.2 配置中心](#12-配置中心)
+    - [NacosUtils](#nacosutils)
+- [二、通用工具类](#二通用工具类)
+  - [2.1 SM2 SM3 SM4 加解密](#21-sm2-sm3-sm4-加解密)
+    - [Sm2Utils](#sm2utils)
+    - [SM3Encoder](#sm3encoder)
+    - [Sm4Utils](#sm4utils)
+- [三、平台服务支撑](#三平台服务支撑)
+  - [3.1 日志服务](#31-日志服务)
+    - [ILogPostService](#ilogpostservice)
+    - [@LogDesc/@AddDesc/@DelDesc](#logdescadddescdeldesc)
+    - [@LogOperation](#logoperation)
+  - [3.3 会话信息获取](#33-会话信息获取)
+    - [SessionUtils](#sessionutils)
+    - [IUserOnlineTime](#iuseronlinetime)
+  - [3.4 多系统集成](#34-多系统集成)
+  - [3.5 数据密级过滤](#35-数据密级过滤)
+  - [3.6 服务通知](#36-服务通知)
+    - [租户同步](#租户同步)
+    - [用户权限同步](#用户权限同步)
+    - [服务通知二开接口](#服务通知二开接口)
+- [四、业务组件](#四业务组件)
+  - [4.1 工作流组件](#41-工作流组件)
+  - [4.2 调度组件](#42-调度组件)
+  - [4.3 定时任务](#43-定时任务)
+- [五、前端资产](#五前端资产)
+  - [5.1 UI组件库](#51-ui组件库)
+    - [CloudDialog](#511-通用对话框组件-clouddialog)
+    - [UserSelect](#512-用户选择组件-userselect)
+    - [UserSelectMulti](#513-多用户选择组件-userselectmulti)
+    - [DeptSelect](#514-部门选择组件-deptselect)
+    - [RoleSelect](#515-角色选择组件-roleselect)
+    - [ImportButton](#516-导入按钮组件-importbutton)
+    - [MenuAuth](#517-菜单权限认证组件-menuauth)
+    - [ResourceCodeAuth](#518-资源代码授权组件-resourcecodeauth)
+    - [ThreeMemberAuth](#519-三员授权组件-threememberauth)
+    - [TableHeadSearch](#5110-表格头部搜索组件-tableheadsearch)
+    - [VerifiyPassword](#5111-二级鉴别密码验证弹窗-verifiypassword)
+    - [CommonHeader](#5112-通用头部组件-commonheader)
+  - [5.2 前端工具函数库](#52-前端工具函数库)
+    - [数据格式化类](#数据格式化类)
+    - [表单校验类](#表单校验类)
+    - [防重复点击](#防重复点击)
+    - [加解密类](#加解密类)
+    - [访问日志类](#访问日志类)
+  - [5.3 流程组件与方法](#53-流程组件与方法)
+- [组件及方法统计](#组件及方法统计)
+- [A. Maven依赖坐标](#a-maven依赖坐标)
+- [B. 组件开发注意事项](#b-组件开发注意事项)
+
+---
+
+## 💡 使用建议
+- 文档结构部分清晰划分了基础设施、通用工具、平台服务、业务组件和前端资产五大块，二开项目应优先聚焦 1.x（缓存+配置）、2.x（加解密）、3.x（平台服务）章节，再根据业务需要探索 4.x/5.x。
+- 文件中的章节锚点（如 `#11-缓存操作`）与 `dev-docs/CLAUDE.md` 中的快速检索表完全对应，可直接借助 IDE 大纲或搜索快速跳转。
+
+## 🔗 相关章节
+- 02_一基础设施-1.1缓存操作-SysCacheServiceFacade.md
+- 03_一基础设施-1.1缓存操作-StringCacheFacade.md
+- 04_一基础设施-1.2配置中心-NacosUtils.md
+- 05_二通用工具-2.1加解密-SM2-SM3-SM4.md
+- 06_三平台服务-3.1日志服务-ILogPostService.md
+- 07_三平台服务-3.1日志注解-LogDesc-LogOperation.md