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

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

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

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

@@ -0,0 +1,86 @@
+---
+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 对应）