npm - @alanwang-merit/meritdata-platform-skill-package - Versions diffs - 1.0.10 → 1.0.12 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (631) hide show

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/10_/344/270/211/345/271/263/345/217/260/346/234/215/345/212/241-3.4/345/244/232/347/263/273/347/273/237/351/233/206/346/210/220+3.5/346/225/260/346/215/256/345/257/206/347/272/247.md DELETED Viewed

@@ -1,91 +0,0 @@
----
-name: 多系统集成 + 数据密级过滤
-source-file: 公共资产清单
-source-section: 3.4 多系统集成 + 3.2 外部接口占位 + 3.5 数据密级过滤
-keywords: [WebService, RESTful, 多系统集成, @EnableDataSecretFilter, 数据密级, syncOrg, syncUser, syncResource, syncRole, syncAssign]
-use-cases: [HR系统同步组织人员, 同步资源/角色/权限, 启用数据密级过滤, 行级数据访问控制]
-related: [22, 34, 08]
----
-# 多系统集成 + 数据密级过滤
-> **原文章节**：`公共资产清单 → 3.4 多系统集成 + 3.5 数据密级过滤`
-> **行号范围**：L1675–L1735
-## 🎯 一句话
-通过 WebService/RESTful 同步组织/人员/资源/角色/权限数据，并通过 `@EnableDataSecretFilter` 注解实现 Hibernate 行级数据密级过滤。
-> **原文件 3.2 章节说明**：原文件 L1305–L1310 的 3.2 章节为占位（"参考外部接口清单"），无实质内容。本文件合并该占位说明，所有外部接口详细定义请参考 `微服务外部接口清单-20260716.md`。
-## 📋 接口/方法清单
-### 3.4 多系统集成
-**详细参考**：应用开发平台-基础平台-使用攻略（三）：组织和人员同步.md
-基于 WebService 和 RESTful API 的组织、人员、资源、角色、权限同步功能，支持外部系统数据接入。
-#### 3.4.1 WebService同步接口
-WebService 地址格式：`http://网关地址/应用名称/ws/{服务名}?wsdl`
-| 服务名 | 方法名 | 参数 | 返回值 | 说明 | 使用场景 |
-|--------|--------|------|--------|------|----------|
-| syncOrgWebService | syncOrg | xml字符串 | "1"成功/"0"失败 | 组织同步 | 外部HR系统同步组织架构到平台 |
-| syncUserWebService | syncUser | xml字符串 | "1"成功/"0"失败 | 人员同步 | 外部系统同步人员信息（入职、离职、调动） |
-| syncResourceWebService | syncResource | xml字符串 | "1"成功/"0"失败 | 资源同步 | 同步菜单、资源、按钮等权限数据 |
-| syncRoleWebService | syncRole | xml字符串 | "1"成功/"0"失败 | 角色同步 | 同步角色数据到平台 |
-| syncAssignWebService | syncAssign | xml字符串 | "1"成功/"0"失败 | 权限同步 | 同步人员-角色、资源-角色分配关系 |
-**完整包路径**：`com.meritdata.cloud.system.manager.ou.sync.ws.impl`
-#### 3.4.2 RESTful API同步接口
-完整包路径：`com.meritdata.cloud.system.manager.ou.sync.controller.WebApiSyncController`
-基础路径：`/webapi/ou/sync`
-| 接口路径 | 方法 | 参数 | 说明 | 使用场景 |
-|----------|------|------|------|----------|
-| /webapi/ou/sync/org | POST | orgInfo (xml字符串) | 组织同步 | 外部系统通过REST API同步组织数据 |
-| /webapi/ou/sync/user | POST | userInfo (xml字符串) | 人员同步 | 外部系统通过REST API同步人员数据 |
-| /webapi/ou/sync/resource | POST | resourceInfo (xml字符串) | 资源同步 | 外部系统同步菜单资源数据 |
-| /webapi/ou/sync/role | POST | roleInfo (xml字符串) | 角色同步 | 外部系统同步角色数据 |
-| /webapi/ou/sync/duty | POST | dutyInfo (xml字符串) | 职务同步 | 外部系统同步职务数据 |
-| /webapi/ou/sync/assign | POST | assignInfo (xml字符串) | 权限同步 | 外部系统同步权限分配数据 |
-**注意**：调用RESTful API需要在请求Header中携带app-key和app-token进行认证。
----
-### 3.5 数据密级过滤
-数据密级过滤是基于 Hibernate `@Filter` 实现的行级数据访问控制机制，通过在实体类上标注 `@EnableDataSecretFilter` 注解，自动拦截并过滤用户可访问的数据范围。
-#### EnableDataSecretFilter 注解
-**使用说明**：
-在进行数据密级过滤的实体类或方法上添加 `@EnableDataSecretFilter` 注解，`DataSecretInterceptor` 拦截器会自动启用 Hibernate 的 `secretDataFilter`，根据当前用户的密级过滤高于当前用户密级的数据，只能看低于或等于其密级的数据。
-**使用示例**：
-```java
-// 标注在方法上
-@LogOperation(type = "select")
-@EnableDataSecretFilter
-public List<Emp> selectEmpList() {
-    return empRepository.findAll();
-}
-```
-## 💡 使用建议
-1. **组合同步**：WebService 适合内网传统系统集成，RESTful API 适合现代微服务调用，优先选择 RESTful 风格。
-2. **app-key/app-token**：RESTful 调用必须从平台申请并放置在 Header，注意 HTTPS 保护和 Token 定期刷新。
-3. **数据密级必读**：在涉密业务（如合同、人员档案）的查询方法上加 `@EnableDataSecretFilter`，否则密级较高的数据可能被越权查询。
-## 🔗 相关章节
-- `08_三平台服务-3.3会话信息-SessionUtils.md`（当前用户密级获取）
-- `11_三平台服务-3.6服务通知-CloudFeignMessageClient.md`（同步完成后通过 Feign 通知）

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/11_/344/270/211/345/271/263/345/217/260/346/234/215/345/212/241-3.6/346/234/215/345/212/241/351/200/232/347/237/245-CloudFeignMessageClient.md DELETED Viewed

@@ -1,467 +0,0 @@
----
-name: 服务通知 CloudFeignMessageClient
-source-file: 公共资产清单
-source-section: 3.6 服务通知
-keywords: [CloudFeignMessageClient, 服务通知, sendRoleMessage, sendResourceMessage, sendUserRoleMessage, sendAssignMessage, sendUserAppMessage, DynamicCloudFeignClient, CloudTenancySync, 角色变更, 资源变更, 权限分配]
-use-cases: [角色变更通知, 资源变更通知, 用户角色变更通知, 权限分配变更通知, 租户同步, 用户/组织/人员变更通知]
-related: [08, 10, 12]
----
-# 服务通知 CloudFeignMessageClient
-> **原文章节**：`公共资产清单 → 3.6 服务通知`
-> **行号范围**：L1736–L2176
-## 🎯 一句话
-通过 `CloudFeignMessageClient`（5 个消息发送方法）+ `DynamicCloudFeignClient`（动态 FeignClient）+ 二开 Feign 接收接口，实现租户、组织、人员、角色、权限变更时跨服务的实时消息通知。
-## 📋 接口/方法清单
-### 3.6.1 租户同步
-**使用场景**：创建租户时，同步信息给二开服务
-#### 3.6.1.1 动态FeignClient构建
-完整包路径：`com.meritdata.cloud.feignclient.DynamicCloudFeignClient`
-方法：`getFeignClient(serviceName, type)`
-入参：String serviceName, Class<T> type
-返回：T (泛型FeignClient)
-使用场景：根据服务名称动态获取FeignClient，用于调用二开服务的接口
-**Nacos配置**：
-```properties
-meritdata.cloud.sync-tenancy-receiver: cloud-system-demo  # 二开服务名称，多个服务用逗号分隔
-```
-#### 3.6.1.2 租户同步发送
-完整包路径：`com.meritdata.cloud.system.manager.ou.tenancy.dynsync.CloudTenancySync`
-方法：`syncAdd(Tenancy tenancy)`
-入参：Tenancy tenancy
-返回：ResultBody<String>
-使用场景：当新建租户时，平台异步向已配置的二开服务发送租户同步消息
-**Nacos配置**：
-```properties
-meritdata.cloud.sync-tenancy-receiver: cloud-system-demo1,cloud-system-demo2  # 多个服务用逗号分隔
-```
-#### 3.6.1.3 租户同步接收
-完整包路径：`com.meritdata.cloud.system.manager.ou.tenancy.dynsync.CloudTenancySync`
-方法：`POST /api/tenancy/sync/add`
-入参：Tenancy tenancy
-返回：ResultBody<String>
-使用场景：二开服务实现租户同步接收接口，接收平台发送的租户信息
-**二开服务实现示例**：
-```java
-/**
- * 二开服务实现租户同步接收接口
- */
-@RestController
-@RequestMapping("/api/tenancy/sync")
-public class TenancySyncReceiver {
-    @PostMapping("/add")
-    public ResultBody<String> syncAdd(@RequestBody Tenancy tenancy) {
-        log.info("收到租户同步消息: {}", tenancy);
-        // 创建租户专属数据空间、初始化租户配置等
-        return ResultBody.success("同步成功");
-    }
-}
-```
----
-### 3.6.2 用户权限同步
-**使用场景**：用户、角色、权限变更时，发送消息通知订阅的二开服务
-**Nacos配置**：
-```properties
-meritdata.cloud.sync-cloud-data-application-name: cloud-system-demo  # 订阅消息的二开服务名称
-```
-**公共消息体 MessageBody 字段说明**：
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| tid | String | 租户ID |
-| theme | String | 消息主题（ROLE/RESOURCE/USER_ROLE/ASSIGN） |
-| data | List | 消息数据列表（RoleMessage/ResourceMessage/RoleUserMessage/AssignMessage） |
-#### 3.6.2.1 发送角色变更消息
-完整包路径：`com.meritdata.cloud.feignclient.CloudFeignMessageClient`
-方法：`sendRoleMessage(MessageBody messageBody)`
-入参：MessageBody（data为List<RoleMessage>）
-返回：boolean
-使用场景：角色信息变更时，发送消息通知相关系统
-**角色消息（RoleMessage）字段说明**：
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| id | String | 角色ID |
-| deptId | String | 部门ID |
-| deptCode | String | 部门编码 |
-| code | String | 角色编码 |
-| name | String | 角色名称 |
-| type | Integer | 角色类型 |
-| application | String | 产品名称 |
-| operation | String | 操作：add新增、update更新、del删除 |
-| timeStamp | String | 时间戳 |
-**二开服务接收示例**：
-```java
-@PostMapping("/send-role-message")
-public boolean sendRoleMessage(@RequestBody MessageBody messageBody) {
-    List<RoleMessage> roleList = (List<RoleMessage>) messageBody.getData();
-    for (RoleMessage role : roleList) {
-        String operation = role.getOperation();  // add/update/del
-        String roleCode = role.getCode();
-        String roleName = role.getName();
-    }
-    return true;
-}
-```
-#### 3.6.2.2 发送资源变更消息
-方法：`sendResourceMessage(MessageBody messageBody)`
-入参：MessageBody（data为List<ResourceMessage>）
-返回：boolean
-使用场景：资源（菜单）信息变更时，发送消息通知相关系统
-**资源消息（ResourceMessage）字段说明**：
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| id | String | 资源ID |
-| parentId | String | 父资源ID |
-| type | String | 类型：0模块、1菜单、2组件、4分组 |
-| name | String | 资源名称 |
-| url | String | 菜单路由 |
-| embedUrl | String | 嵌入URL |
-| application | String | 产品名称 |
-| sort | Integer | 排序 |
-| iconPath | String | 图标路径 |
-| operation | String | 操作：add新增、update更新、del删除 |
-| timeStamp | String | 时间戳 |
-**二开服务接收示例**：
-```java
-@PostMapping("/send-resource-message")
-public boolean sendResourceMessage(@RequestBody MessageBody messageBody) {
-    List<ResourceMessage> resourceList = (List<ResourceMessage>) messageBody.getData();
-    for (ResourceMessage resource : resourceList) {
-        String operation = resource.getOperation();  // add/update/del
-        String type = resource.getType();            // 0模块/1菜单/2组件/4分组
-        String url = resource.getUrl();              // 菜单路由
-    }
-    return true;
-}
-```
-#### 3.6.2.3 发送用户角色变更消息
-方法：`sendUserRoleMessage(MessageBody messageBody)`
-入参：MessageBody（data为List<RoleUserMessage>）
-返回：boolean
-使用场景：用户角色分配变更时，发送消息通知相关系统
-**用户角色消息（RoleUserMessage）字段说明**：
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| userId | String | 用户ID |
-| userCode | String | 用户编码 |
-| roleCode | String | 角色编码 |
-| operation | String | 操作：add新增、del删除 |
-| timeStamp | String | 时间戳 |
-**二开服务接收示例**：
-```java
-@PostMapping("/send-user-role-message")
-public boolean sendUserRoleMessage(@RequestBody MessageBody messageBody) {
-    List<RoleUserMessage> userRoleList = (List<RoleUserMessage>) messageBody.getData();
-    for (RoleUserMessage userRole : userRoleList) {
-        String operation = userRole.getOperation();  // add/del
-        String userId = userRole.getUserId();
-        String roleCode = userRole.getRoleCode();
-    }
-    return true;
-}
-```
-#### 3.6.2.4 发送权限分配变更消息
-方法：`sendAssignMessage(MessageBody messageBody)`
-入参：MessageBody（data为List<AssignMessage>）
-返回：boolean
-使用场景：权限分配变更时，发送消息通知相关系统
-**权限分配消息（AssignMessage）字段说明**：
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| resourceId | String | 资源ID |
-| type | String | 授权类型：3按机构、4按角色、6按人员 |
-| code | String | 角色编码或机构编码 |
-| url | String | 菜单路由 |
-| application | String | 产品名称 |
-| operation | String | 操作：add新增、del删除 |
-| timeStamp | String | 时间戳 |
-**二开服务接收示例**：
-```java
-@PostMapping("/send-assign-message")
-public boolean sendAssignMessage(@RequestBody MessageBody messageBody) {
-    List<AssignMessage> assignList = (List<AssignMessage>) messageBody.getData();
-    for (AssignMessage assign : assignList) {
-        String operation = assign.getOperation();  // add/del
-        String type = assign.getType();            // 3按机构/4按角色/6按人员
-        String resourceId = assign.getResourceId();
-    }
-    return true;
-}
-```
----
-### 3.6.3 服务通知二开接口
-**使用场景**：平台端用户、组织、人员等变更时，通知二开服务进行相应处理
-#### 3.6.3.1 用户新增通知
-完整包路径：`com.meritdata.cloud.system.manager.ou.user.controller.IUserPortalService`
-FeignClient接口：`POST /user-add`
-入参：User user
-返回：void
-**Nacos配置（二开服务）**：
-```properties
-meritdata.cloud.user-customization-extension-application-name: cloud-system-demo  # 二开服务名，平台端调用
-```
-**二开服务实现**：
-```java
-@PostMapping("/user-add")
-public void userAdd(@RequestBody User user) {
-    // 处理用户新增逻辑
-}
-```
-#### 3.6.3.2 用户编辑通知
-方法：`POST /user-update`
-入参：User user
-返回：void
-**二开服务实现**：
-```java
-@PostMapping("/user-update")
-public void userUpdate(@RequestBody User user) {
-    // 处理用户编辑逻辑
-}
-```
-#### 3.6.3.3 用户删除通知
-方法：`POST /user-remove`
-入参：UserListDto userListDto
-返回：void
-**二开服务实现**：
-```java
-@PostMapping("/user-remove")
-public void userRemove(@RequestBody UserListDto userListDto) {
-    // 处理用户删除逻辑
-}
-```
-#### 3.6.3.4 初始化密码通知
-方法：`POST /resetPass`
-入参：User user
-返回：void
-**二开服务实现**：
-```java
-@PostMapping("/resetPass")
-public void resetPass(@RequestBody User user) {
-    // 处理初始化密码逻辑
-}
-```
-#### 3.6.3.5 修改密码通知
-方法：`POST /changePass`
-入参：User user
-返回：void
-**二开服务实现**：
-```java
-@PostMapping("/changePass")
-public void changePass(@RequestBody User user) {
-    // 处理修改密码逻辑
-}
-```
-#### 3.6.3.6 组织新增通知
-完整包路径：`com.meritdata.cloud.system.manager.ou.org.controller.IOrgPortalService`
-FeignClient接口：`POST /api/ou/org/create`
-入参：Organization org
-返回：void
-**Nacos配置（二开服务）**：
-```properties
-meritdata.cloud.org-emp-customization-extension-application-name: cloud-system-demo  # 二开服务名
-```
-**二开服务实现**：
-```java
-@PostMapping("/api/ou/org/create")
-public void orgAdd(@RequestBody Organization org) {
-    // 处理组织新增逻辑
-}
-```
-#### 3.6.3.7 组织修改通知
-方法：`POST /api/ou/org/update`
-入参：Organization org
-返回：void
-**二开服务实现**：
-```java
-@PostMapping("/api/ou/org/update")
-public void orgUpdate(@RequestBody Organization org) {
-    // 处理组织修改逻辑
-}
-```
-#### 3.6.3.8 组织删除通知
-方法：`POST /api/ou/org/delete`
-入参：OrgListDto orgListDto
-返回：void
-**二开服务实现**：
-```java
-@PostMapping("/api/ou/org/delete")
-public void orgRemove(@RequestBody OrgListDto orgListDto) {
-    // 处理组织删除逻辑
-}
-```
-#### 3.6.3.9 人员新增通知
-方法：`POST /emp-add`
-入参：Emp emp
-返回：void
-**二开服务实现**：
-```java
-@PostMapping("/emp-add")
-public void empAdd(@RequestBody Emp emp) {
-    // 处理人员新增逻辑
-}
-```
-#### 3.6.3.10 人员修改通知
-方法：`POST /emp-update`
-入参：Emp emp
-返回：void
-**二开服务实现**：
-```java
-@PostMapping("/emp-update")
-public void empUpdate(@RequestBody Emp emp) {
-    // 处理人员修改逻辑
-}
-```
-#### 3.6.3.11 人员删除通知
-方法：`POST /emp-delete`
-入参：EmpListDto empListDto
-返回：void
-**二开服务实现**：
-```java
-@PostMapping("/emp-delete")
-public void empRemove(@RequestBody EmpListDto empListDto) {
-    // 处理人员删除逻辑
-}
-```
-## 💡 使用建议
-1. **5 大消息发送方法**：`sendRoleMessage` / `sendResourceMessage` / `sendUserRoleMessage` / `sendAssignMessage` / `sendUserAppMessage` 涵盖平台所有权限/资源变更场景。
-2. **Nacos 订阅优先**：二开服务只需在 `application-name` 注册后即可接收到所有平台变更消息，无需开发 FeignClient。
-3. **二开服务零侵入**：通过 `IUserPortalService` / `IOrgPortalService` 接收用户/组织/人员变更通知，本服务本地业务尽量在 `@PostMapping` 接收方法中处理。
-## 🔗 相关章节
-- `08_三平台服务-3.3会话信息-SessionUtils.md`（会话信息获取）
-- `10_三平台服务-3.4多系统集成+3.5数据密级.md`（多系统集成）
-- `12_四业务组件-4.1工作流BpmEngine.md`（BPM 流程）

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/12_/345/233/233/344/270/232/345/212/241/347/273/204/344/273/266-4.1/345/267/245/344/275/234/346/265/201BpmEngine.md DELETED Viewed

@@ -1,86 +0,0 @@
----
-name: 工作流组件 BpmEngine
-source-file: 公共资产清单
-source-section: 4.1 工作流组件
-keywords: [BpmEngine, 工作流, Camunda, BPMN, startProcess, complete, processRetfirnode, processRetprenode, queryMainForms, getPage, getGraphTrack, getOpinions, getUndoPage, 流程追踪, 流程审批]
-use-cases: [流程发起, 流程审批, 流程退回, 流程追踪, 流程待办查询, 审批意见填写, 流程监听器开发, 自定义人员选择器]
-related: [16, 11]
----
-# 工作流组件 BpmEngine
-> **原文章节**：`公共资产清单 → 4.1 工作流组件`
-> **行号范围**：L2179–L2235
-## 🎯 一句话
-基于 Camunda BPM 7.21.0 的工作流引擎，对外提供 13 个方法覆盖流程启动、审批、退回、删除、待办、追踪、意见等全场景。
-## 📋 接口/方法清单
-### 4.1 工作流组件-详细参考：应用开发平台-流程管理-使用攻略（一)：流程API接口.md
-基于 Camunda BPM 7.21.0 的工作流引擎，所有对外接口均通过 `BpmEngine` 提供。
-**二开服务使用方式**：通过 `@Autowired` 注入 `BpmEngine`，直接调用其方法。
-```
-@Autowired
-private BpmEngine bpmEngine;
-```
-方法概览表：
-| 来源类 | 方法名 | 作用场景 | 说明 |
-|------|--------|----------|------|
-| BpmEngine | startProcess | 启动流程 | 根据流程定义Key和businessId启动流程 |
-| BpmEngine | ruleEngineInit | 规则引擎初始化 | 查询流程按钮配置信息，初始化流程操作界面 |
-| BpmEngine | ruleEngineRun | 规则引擎执行 | 根据businessId查询待办任务 |
-| BpmEngine | complete | 完成任务 | 完成当前任务，推进流程到下一节点 |
-| BpmEngine | processRetfirnode | 退回拟稿人 | 退回流程至拟稿人（流程起点） |
-| BpmEngine | processRetprenode | 退回上一环节 | 退回流程至上一环节处理人 |
-| BpmEngine | deleteProcInsts | 删除流程实例 | 根据businessIds删除流程实例 |
-| BpmEngine | queryMainForms | 流程实例查询 | 分页查询流程实例列表 |
-| BpmEngine | getPage | 文字追踪 | 获取流程流转路径文字信息 |
-| BpmEngine | getGraphTrack | 图表追踪 | 获取流程图形追踪信息 |
-| BpmEngine | getOpinions | 审批意见 | 获取流程审批意见列表 |
-| BpmEngine | addOrUpdate | 填写意见 | 在节点填写审批意见 |
-| BpmEngine | getUndoPage | 个人待办列表 | 获取当前用户的待办任务列表 |
-**重要变量说明**：
-| 变量名 | 类型 | 说明 | 示例值 |
-|--------|------|------|--------|
-| businessId | String | 业务ID（唯一标识业务数据） | "3f28824f77d7e9a60177d8110b670002" |
-| procDefKey | String | 流程定义Key（在BPMN文件中定义） | "Process_Demo1" |
-| procInstId | String | 流程实例ID（启动后生成） | "57f63abb-74b1-11eb-bd66-00d861edd189" |
-| taskId | String | 任务ID（当前待办任务） | "9f2c6791-7748-11eb-90ec-00d861edd189" |
-| taskDefKey | String | 任务节点定义Key | "Activity_0vjczzn" |
-| procDefId | String | 流程定义ID（包含版本信息） | "Process_Demo1:4:d349d3dd-7689-11eb-ac36-00d861edd189" |
-| bpmOperValue | String | 操作按钮值（对应流程配置） | "bpmSendBtn"、"bpmRetfirnodeBtn" |
-| bpmOperName | String | 操作按钮名称 | "发送"、"退回" |
-| approve[type] | String | 审批方式 | "onlyApprove"（唯一审批）、"anyApprove"（或签）、"paraApprove"（会签）、"seqApprove"（顺序审批） |
-**组合场景表**：
-| 场景 | 使用场景 | 详细参考 |
-|------|----------|----------|
-| 流程API接口 | 了解BpmEngine提供的所有API接口，包括启动流程、完成任务、查询实例等 | 应用开发平台-流程管理-使用攻略（一）：流程API接口.md |
-| 工作流程应用开发 | 基于差旅费报销等业务场景，学习如何创建后端工程、配置流程、设计表单、集成前后端 | 应用开发平台-流程管理-使用攻略（二）：工作流程应用开发.md |
-| 监听表达式开发 | 开发自定义监听器jar包，实现流程监听表达式，在流程事件触发时执行自定义业务逻辑 | 应用开发平台-流程管理-使用攻略（三）：监听表达式开发.md |
-| 自定义人员 | 配置自定义人员选择器，通过后端接口动态返回流程下一环节的处理人 | 应用开发平台-流程管理-使用攻略（四）：自定义人员.md |
-| 待办同步门户开发 | 将流程产生的待办信息同步到其他门户页面处理，支持Portal和RTX两种方式 | 应用开发平台-流程管理-使用攻略（五）：待办同步门户开发.md |
-| 流程追踪页面嵌入表单 | 将流程追踪页面（文字追踪、图表追踪、审批意见）嵌入到自定义表单页面中 | 应用开发平台-流程管理-使用攻略（六）：流程追踪页面嵌入表单开发.md |
-| 流程模块设计 | 了解流程模块的整体设计思路、架构组成和业务逻辑 | 应用开发平台-流程管理-使用攻略（七）：流程模块设计说明文档.md |
-## 💡 使用建议
-1. **businessId 必填唯一**：业务表主键作为 `businessId`，与流程实例强绑定，便于按业务数据反查流程状态。
-2. **退回策略**：拟稿人退回用 `processRetfirnode`，上一环节退回用 `processRetprenode`，注意传递 `taskId`。
-3. **审批方式关键**：节点配置 `onlyApprove` / `anyApprove` / `paraApprove` / `seqApprove` 直接影响 `complete` 行为的提交人选择。
-4. **前端协同**：BPM 流程页面（追踪/审批/意见）使用 `MeritBPM` 前端组件对应后端 API，详见 `16_五前端资产-5.1UI组件库-下半.md` 与 `公共资产清单 5.3 节`。
-## 🔗 相关章节
-- `11_三平台服务-3.6服务通知-CloudFeignMessageClient.md`（流程结果通过服务通知广播）
-- `16_五前端资产-5.1UI组件库-下半.md`（BPM 前端组件协同）
-- `公共资产清单 5.3 流程组件与方法`（MeritBPM 前端方法与后端 API 对应）