ai-engineering-init 1.3.4 → 1.4.0

package/.claude/skills/workflow-engine/SKILL.md

@@ -14,272 +14,166 @@ description: |
   触发词：工作流、流程、审批、WarmFlow、FlowEngine、任务、办理、驳回、转办、委派、加签、减签、抄送、流程实例、流程定义、办理人、GlobalListener、ProcessEvent
 ---
 
-# 工作流引擎开发规范
+# 工作流引擎开发规范（WarmFlow）
 
-> 本项目基于 **WarmFlow** 实现工作流引擎，提供流程定义、流程实例、任务管理、办理人分配等功能。
+> 基于 **WarmFlow** 实现，架构层次：Controller → Service → WarmFlow Core (FlowEngine) → Mapper → Listener/Handler
 
-## 架构概述
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                       Controller Layer                           │
-│  FlwTaskController | FlwInstanceController | FlwDefinitionController
-│  FlwCategoryController | FlwSpelController | TestLeaveController │
-└─────────────────────────────┬───────────────────────────────────┘
-                              │
-┌─────────────────────────────▼───────────────────────────────────┐
-│                        Service Layer                             │
-│  FlwTaskService | FlwInstanceService | FlwDefinitionService     │
-│  FlwCategoryService | FlwSpelService | TestLeaveService         │
-│                              │                                   │
-│  ┌───────────────────────────▼─────────────────────────────────┐│
-│  │           WarmFlow Core (FlowEngine)                         ││
-│  │   TaskService | InsService | DefService | NodeService        ││
-│  └─────────────────────────────────────────────────────────────┘│
-└─────────────────────────────┬───────────────────────────────────┘
-                              │
-┌─────────────────────────────▼───────────────────────────────────┐
-│                        Mapper Layer                              │
-│  FlwCategoryMapper | FlwSpelMapper | TestLeaveMapper            │
-│  FlwInstanceMapper | FlwTaskMapper | FlwInstanceBizExtMapper    │
-└─────────────────────────────┬───────────────────────────────────┘
-                              │
-┌─────────────────────────────▼───────────────────────────────────┐
-│                   Listener & Handler                             │
-│  WorkflowGlobalListener (任务监听) | FlowProcessEventHandler (事件发布)
-└─────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 核心组件
-
-### 1. FlowEngine 服务访问
+## 一、FlowEngine 核心服务
 
 ```java
 import org.dromara.warm.flow.core.FlowEngine;
 
-// 任务服务
-FlowEngine.taskService()
-
-// 实例服务
-FlowEngine.insService()
-
-// 流程定义服务
-FlowEngine.defService()
-
-// 节点服务
-FlowEngine.nodeService()
-
-// 历史任务服务
-FlowEngine.hisTaskService()
-
-// 用户服务
-FlowEngine.userService()
+FlowEngine.taskService()      // 任务服务
+FlowEngine.insService()       // 实例服务
+FlowEngine.defService()       // 流程定义服务
+FlowEngine.nodeService()      // 节点服务
+FlowEngine.hisTaskService()   // 历史任务服务
+FlowEngine.userService()      // 用户服务
 ```
 
-### 2. 任务状态枚举
+## 二、关键枚举
+
+### 任务状态 TaskStatusEnum
 
 ```java
 package org.dromara.workflow.common.enums;
 
 public enum TaskStatusEnum {
-    CANCEL("cancel", "撤销"),
-    PASS("pass", "通过"),
-    WAITING("waiting", "待审核"),
-    INVALID("invalid", "作废"),
-    BACK("back", "退回"),
-    TERMINATION("termination", "终止"),
-    TRANSFER("transfer", "转办"),
-    DEPUTE("depute", "委托"),
-    COPY("copy", "抄送"),
-    SIGN("sign", "加签"),
-    SIGN_OFF("sign_off", "减签"),
-    TIMEOUT("timeout", "超时");
-
-    private final String status;
-    private final String desc;
-
-    // 判断状态是否为通过或退回
-    public static boolean isPassOrBack(String status) {
-        return PASS.getStatus().equals(status) || BACK.getStatus().equals(status);
-    }
+    CANCEL("cancel", "撤销"),    PASS("pass", "通过"),
+    WAITING("waiting", "待审核"), INVALID("invalid", "作废"),
+    BACK("back", "退回"),        TERMINATION("termination", "终止"),
+    TRANSFER("transfer", "转办"), DEPUTE("depute", "委托"),
+    COPY("copy", "抄送"),        SIGN("sign", "加签"),
+    SIGN_OFF("sign_off", "减签"), TIMEOUT("timeout", "超时");
+
+    // 判断是否为通过或退回
+    public static boolean isPassOrBack(String status) { ... }
 }
 ```
 
-### 3. 办理人类型枚举
+### 办理人类型 TaskAssigneeEnum
 
-> ⚠️ **注意**：USER 和 SPEL 类型没有前缀！
+> **注意**：USER 和 SPEL 类型没有前缀！
 
 ```java
-package org.dromara.workflow.common.enums;
-
 public enum TaskAssigneeEnum {
-    USER("用户", ""),           // ⚠️ 用户没有前缀
+    USER("用户", ""),           // 无前缀
     ROLE("角色", "role:"),
     DEPT("部门", "dept:"),
     POST("岗位", "post:"),
-    SPEL("SpEL表达式", "");     // ⚠️ SpEL 没有前缀，通过 $ 或 # 开头判断
+    SPEL("SpEL表达式", "");     // 无前缀，通过 $ 或 # 开头判断
 
-    private final String desc;
-    private final String code;
-
-    // 判断是否为 SPEL 表达式（以 $ 或 # 开头）
     public static boolean isSpelExpression(String value) {
         return StringUtils.startsWith(value, "$") || StringUtils.startsWith(value, "#");
     }
 }
 ```
 
-**storageId 格式示例**：
-```
-123           → 用户ID 123（无前缀）
-role:456      → 角色ID 456
-dept:789      → 部门ID 789
-post:101      → 岗位ID 101
-#{expression} → SpEL表达式（# 开头）
-${variable}   → 默认变量策略（$ 开头）
-```
+**storageId 格式**：`123`(用户) | `role:456` | `dept:789` | `post:101` | `#{expr}` | `${var}`
 
 ---
 
-## 常用操作
+## 三、常用操作
 
-### 1. 启动流程
+### 3.1 启动流程
 
 ```java
 @Autowired
 private IFlwTaskService flwTaskService;
 
-// 方式一：使用 FlwTaskService
-public void startProcess() {
-    StartProcessBo bo = new StartProcessBo();
-    bo.setFlowCode("leave_apply");           // 流程编码
-    bo.setBusinessId("order_123");           // 业务ID
-    bo.setVariables(Map.of("amount", 1000)); // 流程变量
-
-    StartProcessReturnDTO result = flwTaskService.startWorkFlow(bo);
-    Long instanceId = result.getProcessInstanceId();
-    Long taskId = result.getTaskId();
-}
+StartProcessBo bo = new StartProcessBo();
+bo.setFlowCode("leave_apply");
+bo.setBusinessId("order_123");
+bo.setVariables(Map.of("amount", 1000));
+StartProcessReturnDTO result = flwTaskService.startWorkFlow(bo);
 ```
 
 ```java
+// 供其他模块调用
 @Autowired
 private WorkflowService workflowService;
 
-// 方式二：使用 WorkflowService（供其他模块调用）
-public void startProcess() {
-    StartProcessDTO dto = new StartProcessDTO();
-    dto.setFlowCode("leave_apply");
-    dto.setBusinessId("order_123");
-    dto.setVariables(Map.of("amount", 1000));
-
-    StartProcessReturnDTO result = workflowService.startWorkFlow(dto);
-}
+StartProcessDTO dto = new StartProcessDTO();
+dto.setFlowCode("leave_apply");
+dto.setBusinessId("order_123");
+StartProcessReturnDTO result = workflowService.startWorkFlow(dto);
 ```
 
-### 2. 办理任务
+### 3.2 办理任务
 
 ```java
-public void completeTask() {
-    CompleteTaskBo bo = new CompleteTaskBo();
-    bo.setTaskId(taskId);                    // 任务ID
-    bo.setMessage("同意");                    // 审批意见
-    bo.setVariables(Map.of("approved", true)); // 流程变量
-
-    // 指定下一节点办理人（可选）
-    bo.setAssigneeMap(Map.of(
-        "pass:nodeCode", "user:1,user:2"
-    ));
-
-    flwTaskService.completeTask(bo);
-}
+CompleteTaskBo bo = new CompleteTaskBo();
+bo.setTaskId(taskId);
+bo.setMessage("同意");
+bo.setVariables(Map.of("approved", true));
+bo.setAssigneeMap(Map.of("pass:nodeCode", "user:1,user:2")); // 可选：指定下一节点办理人
+flwTaskService.completeTask(bo);
 ```
 
-### 3. 驳回任务
+### 3.3 驳回
 
 ```java
-public void rejectTask() {
-    BackProcessBo bo = new BackProcessBo();
-    bo.setTaskId(taskId);
-    bo.setNodeCode("apply_node");    // 驳回到的节点
-    bo.setMessage("资料不完整");
-
-    flwTaskService.backProcess(bo);
-}
+BackProcessBo bo = new BackProcessBo();
+bo.setTaskId(taskId);
+bo.setNodeCode("apply_node");
+bo.setMessage("资料不完整");
+flwTaskService.backProcess(bo);
 ```
 
-### 4. 转办/委派
+### 3.4 转办 / 委派 / 加签 / 减签
 
 ```java
-// 转办（转给他人办理，自己不再参与）
-TaskOperationBo transferBo = new TaskOperationBo();
-transferBo.setTaskId(taskId);
-transferBo.setUserId("targetUserId");
-transferBo.setMessage("转交处理");
-flwTaskService.taskOperation(transferBo, FlowConstant.TRANSFER_TASK);
-
-// 委派（委托他人代办，最终还需自己确认）
-TaskOperationBo deputeBo = new TaskOperationBo();
-deputeBo.setTaskId(taskId);
-deputeBo.setUserId("targetUserId");
-deputeBo.setMessage("请协助处理");
-flwTaskService.taskOperation(deputeBo, FlowConstant.DELEGATE_TASK);
+TaskOperationBo bo = new TaskOperationBo();
+bo.setTaskId(taskId);
+bo.setUserId("targetUserId");
+bo.setMessage("转交处理");
+
+// 转办（转给他人，自己不再参与）
+flwTaskService.taskOperation(bo, FlowConstant.TRANSFER_TASK);
+
+// 委派（委托代办，最终还需自己确认）
+flwTaskService.taskOperation(bo, FlowConstant.DELEGATE_TASK);
+
+// 加签 / 减签
+bo.setUserIds(List.of("user1", "user2"));
+flwTaskService.taskOperation(bo, FlowConstant.ADD_SIGNATURE);
+flwTaskService.taskOperation(bo, FlowConstant.REDUCTION_SIGNATURE);
 ```
 
-### 5. 加签/减签
+### 3.5 查询任务
 
 ```java
-// 加签（增加办理人）
-TaskOperationBo addBo = new TaskOperationBo();
-addBo.setTaskId(taskId);
-addBo.setUserIds(List.of("user1", "user2"));
-addBo.setMessage("增加会签人员");
-flwTaskService.taskOperation(addBo, FlowConstant.ADD_SIGNATURE);
-
-// 减签（减少办理人）
-TaskOperationBo reduceBo = new TaskOperationBo();
-reduceBo.setTaskId(taskId);
-reduceBo.setUserIds(List.of("user1"));
-reduceBo.setMessage("减少会签人员");
-flwTaskService.taskOperation(reduceBo, FlowConstant.REDUCTION_SIGNATURE);
+flwTaskService.pageByTaskWait(bo, pageQuery);      // 当前用户待办
+flwTaskService.pageByTaskFinish(bo, pageQuery);     // 当前用户已办
+flwTaskService.pageByAllTaskWait(bo, pageQuery);    // 所有待办（管理员）
+flwTaskService.pageByAllTaskFinish(bo, pageQuery);  // 所有已办（管理员）
+flwTaskService.pageByTaskCopy(bo, pageQuery);       // 抄送任务
 ```
 
 ---
 
-## 业务集成
-
-### 1. 监听流程事件
+## 四、业务集成 - 事件监听
 
 > 事件类位于 `org.dromara.common.core.domain.event` 包
 
-```java
-import org.springframework.context.event.EventListener;
-import org.dromara.common.core.domain.event.ProcessEvent;
-import org.dromara.common.core.domain.event.ProcessTaskEvent;
-import org.dromara.common.core.domain.event.ProcessDeleteEvent;
+| 事件类 | 触发时机 | 主要字段 |
+|-------|---------|---------|
+| `ProcessEvent` | 流程状态变更 | flowCode, businessId, status, submit |
+| `ProcessTaskEvent` | 任务创建 | flowCode, businessId, taskId, nodeCode |
+| `ProcessDeleteEvent` | 流程删除 | flowCode, businessId |
 
+```java
 @Component
 public class OrderWorkflowListener {
 
-    /**
-     * 监听流程状态变更
-     */
     @EventListener(condition = "#event.flowCode == 'order_approve'")
     public void onProcessEvent(ProcessEvent event) {
         String businessId = event.getBusinessId();
-        String status = event.getStatus();
-        boolean isSubmit = event.isSubmit();
-
-        // 申请人提交
-        if (isSubmit) {
+        if (event.isSubmit()) {
             orderService.updateStatus(businessId, "PENDING");
             return;
         }
-
-        // 根据流程状态更新业务数据
-        switch (status) {
+        switch (event.getStatus()) {
             case "finish" -> orderService.updateStatus(businessId, "APPROVED");
             case "back" -> orderService.updateStatus(businessId, "REJECTED");
             case "cancel" -> orderService.updateStatus(businessId, "CANCELLED");
@@ -288,389 +182,140 @@ public class OrderWorkflowListener {
         }
     }
 
-    /**
-     * 监听任务创建（发送通知）
-     */
     @EventListener(condition = "#event.flowCode == 'order_approve'")
     public void onTaskCreated(ProcessTaskEvent event) {
-        Long taskId = event.getTaskId();
-        String businessId = event.getBusinessId();
-        // 获取待办人并发送通知
-        sendNotification(taskId);
-    }
-
-    /**
-     * 监听流程删除
-     */
-    @EventListener(condition = "#event.flowCode == 'order_approve'")
-    public void onProcessDeleted(ProcessDeleteEvent event) {
-        String businessId = event.getBusinessId();
-        // 清理业务相关数据
-        orderService.cleanupWorkflowData(businessId);
+        sendNotification(event.getTaskId());
     }
 }
 ```
 
-### 2. 事件类型说明
-
-| 事件类 | 触发时机 | 主要字段 |
-|-------|---------|---------|
-| `ProcessEvent` | 流程状态变更（提交、通过、驳回、撤销、终止、作废、完成） | flowCode, businessId, status, submit |
-| `ProcessTaskEvent` | 任务创建时 | flowCode, businessId, taskId, nodeCode |
-| `ProcessDeleteEvent` | 流程删除时 | flowCode, businessId |
-
-### 3. 查询待办/已办任务
-
-```java
-@Autowired
-private IFlwTaskService flwTaskService;
-
-// 查询当前用户待办任务
-public TableDataInfo<FlowTaskVo> getTodoList(FlowTaskBo bo, PageQuery pageQuery) {
-    return flwTaskService.pageByTaskWait(bo, pageQuery);
-}
-
-// 查询当前用户已办任务
-public TableDataInfo<FlowHisTaskVo> getDoneList(FlowTaskBo bo, PageQuery pageQuery) {
-    return flwTaskService.pageByTaskFinish(bo, pageQuery);
-}
-
-// 查询所有待办任务（管理员）
-public TableDataInfo<FlowTaskVo> getAllTodoList(FlowTaskBo bo, PageQuery pageQuery) {
-    return flwTaskService.pageByAllTaskWait(bo, pageQuery);
-}
-
-// 查询所有已办任务（管理员）
-public TableDataInfo<FlowHisTaskVo> getAllDoneList(FlowTaskBo bo, PageQuery pageQuery) {
-    return flwTaskService.pageByAllTaskFinish(bo, pageQuery);
-}
-
-// 查询抄送任务
-public TableDataInfo<FlowTaskVo> getCopyList(FlowTaskBo bo, PageQuery pageQuery) {
-    return flwTaskService.pageByTaskCopy(bo, pageQuery);
-}
-```
-
 ---
 
-## 全局监听器
+## 五、全局监听器 WorkflowGlobalListener
 
-`WorkflowGlobalListener` 实现 `GlobalListener` 接口，在任务生命周期的关键节点执行：
+实现 `GlobalListener` 接口，在任务生命周期关键节点执行：
 
 ```java
-package org.dromara.workflow.listener;
-
-import org.dromara.warm.flow.core.listener.GlobalListener;
-import org.dromara.warm.flow.core.listener.ListenerVariable;
-
 @Component
 public class WorkflowGlobalListener implements GlobalListener {
-
     @Override
-    public void create(ListenerVariable listenerVariable) {
-        // 任务创建时执行
-    }
+    public void create(ListenerVariable var) { /* 任务创建 */ }
 
     @Override
-    public void start(ListenerVariable listenerVariable) {
-        // 任务开始办理时执行
-        // 可在此处理：抄送设置、自定义变量
-        String ext = listenerVariable.getNode().getExt();
-        Map<String, Object> variable = listenerVariable.getVariable();
-        // 解析节点扩展配置...
+    public void start(ListenerVariable var) {
+        // 任务开始办理：处理抄送、自定义变量
+        String ext = var.getNode().getExt();
+        Map<String, Object> variable = var.getVariable();
     }
 
     @Override
-    public void assignment(ListenerVariable listenerVariable) {
-        // 分派监听器，动态修改待办任务信息
-        // 可在此处理：指定办理人、申请节点办理人设置
-        List<Task> nextTasks = listenerVariable.getNextTasks();
-        FlowParams flowParams = listenerVariable.getFlowParams();
-        // 处理办理人权限...
+    public void assignment(ListenerVariable var) {
+        // 分派：动态修改待办任务的办理人
+        List<Task> nextTasks = var.getNextTasks();
+        FlowParams flowParams = var.getFlowParams();
     }
 
     @Override
-    public void finish(ListenerVariable listenerVariable) {
-        // 任务完成后执行
-        // 可在此处理：状态更新、消息通知、抄送、事件发布
-        Instance instance = listenerVariable.getInstance();
-        Definition definition = listenerVariable.getDefinition();
-        // 发布流程事件...
+    public void finish(ListenerVariable var) {
+        // 完成：状态更新、消息通知、事件发布
+        Instance instance = var.getInstance();
+        Definition definition = var.getDefinition();
     }
 }
 ```
 
 ---
 
-## 流程常量
+## 六、流程常量 FlowConstant
 
 ```java
 package org.dromara.workflow.common.constant;
 
 public interface FlowConstant {
-    // 基础常量
-    String INITIATOR = "initiator";               // 流程发起人
-    String INITIATOR_DEPT_ID = "initiatorDeptId"; // 发起人部门ID
-    String BUSINESS_ID = "businessId";            // 业务ID
-    String BUSINESS_CODE = "businessCode";        // 业务编码
-    String SUBMIT = "submit";                     // 申请人提交标识
-
-    // 任务操作类型
-    String DELEGATE_TASK = "delegateTask";        // 委托任务
-    String TRANSFER_TASK = "transferTask";        // 转办任务
+    String INITIATOR = "initiator";               // 发起人
+    String INITIATOR_DEPT_ID = "initiatorDeptId"; // 发起人部门
+    String BUSINESS_ID = "businessId";
+    String SUBMIT = "submit";                     // 提交标识
+
+    String DELEGATE_TASK = "delegateTask";        // 委托
+    String TRANSFER_TASK = "transferTask";        // 转办
     String ADD_SIGNATURE = "addSignature";        // 加签
     String REDUCTION_SIGNATURE = "reductionSignature"; // 减签
 
-    // 抄送与消息
     String FLOW_COPY_LIST = "flowCopyList";       // 抄送人列表
-    String MESSAGE_TYPE = "messageType";          // 消息类型
-    String MESSAGE_NOTICE = "messageNotice";      // 消息内容
-
-    // 自动化配置
-    String AUTO_PASS = "autoPass";                // 自动通过标识
+    String MESSAGE_TYPE = "messageType";
+    String MESSAGE_NOTICE = "messageNotice";
+    String AUTO_PASS = "autoPass";                // 自动通过
 
-    // 流程分类
-    String CATEGORY_ID_TO_NAME = "category_id_to_name";
-    String FLOW_CATEGORY_NAME = "flow_category_name#30d";
-    Long FLOW_CATEGORY_ID = 100L;                 // 默认租户OA申请分类id
-
-    // 任务状态字典
-    String WF_TASK_STATUS = "wf_task_status";
-
-    // 忽略标识（高级配置）
     String VAR_IGNORE = "ignore";                 // 忽略办理权限校验
-    String VAR_IGNORE_DEPUTE = "ignoreDepute";    // 忽略委派处理
-    String VAR_IGNORE_COOPERATE = "ignoreCooperate"; // 忽略会签票签处理
+    String VAR_IGNORE_DEPUTE = "ignoreDepute";
+    String VAR_IGNORE_COOPERATE = "ignoreCooperate";
 }
 ```
 
----
-
-## 消息通知
-
-### 通知类型
-
-```java
-package org.dromara.workflow.common.enums;
-
-public enum MessageTypeEnum {
-    SYSTEM_MESSAGE("1", "站内信"),
-    EMAIL_MESSAGE("2", "邮箱"),
-    SMS_MESSAGE("3", "短信");
-
-    private final String code;
-    private final String desc;
-}
-```
-
-### 配置消息通知
-
-在流程变量中设置：
+### 消息通知
 
 ```java
+// MessageTypeEnum: "1"=站内信, "2"=邮箱, "3"=短信
 Map<String, Object> variable = new HashMap<>();
-variable.put(FlowConstant.MESSAGE_TYPE, List.of("1", "2"));  // 站内信 + 邮箱
+variable.put(FlowConstant.MESSAGE_TYPE, List.of("1", "2"));
 variable.put(FlowConstant.MESSAGE_NOTICE, "您有新的审批任务");
 ```
 
 ---
 
-## API 接口
+## 七、API 接口速查
 
-### 任务管理 (/workflow/task)
+### 任务 /workflow/task
 
 | 接口 | 方法 | 说明 |
 |------|------|------|
 | `/startWorkFlow` | POST | 启动流程 |
 | `/completeTask` | POST | 办理任务 |
-| `/backProcess` | POST | 驳回审批 |
-| `/pageByTaskWait` | GET | 当前用户待办任务 |
-| `/pageByTaskFinish` | GET | 当前用户已办任务 |
-| `/pageByAllTaskWait` | GET | 所有待办任务 |
-| `/pageByAllTaskFinish` | GET | 所有已办任务 |
-| `/pageByTaskCopy` | GET | 当前用户抄送任务 |
-| `/{taskId}` | GET | 根据 taskId 查询任务详情 |
-| `/getNextNodeList` | POST | 获取下一节点信息 |
-| `/{taskId}/{nowNodeCode}` | GET | 获取可驳回的前置节点 |
+| `/backProcess` | POST | 驳回 |
+| `/pageByTaskWait` | GET | 当前用户待办 |
+| `/pageByTaskFinish` | GET | 当前用户已办 |
+| `/pageByTaskCopy` | GET | 抄送任务 |
+| `/getNextNodeList` | POST | 下一节点信息 |
 | `/terminationTask` | POST | 终止流程 |
-| `/{taskOperation}` | POST | 任务操作（委派/转办/加签/减签） |
-| `/{taskId}` | GET | 获取当前任务所有办理人 |
-| `/updateAssignee/{userId}` | PUT | 修改任务办理人 |
-| `/urgeTask` | POST | 催办任务 |
+| `/{taskOperation}` | POST | 委派/转办/加签/减签 |
+| `/urgeTask` | POST | 催办 |
 
-### 实例管理 (/workflow/instance)
+### 实例 /workflow/instance
 
 | 接口 | 方法 | 说明 |
 |------|------|------|
-| `/pageByRunning` | GET | 运行中的流程实例 |
-| `/pageByFinish` | GET | 已完成的流程实例 |
-| `/pageByCurrent` | GET | 当前用户发起的流程 |
-| `/{businessId}` | GET | 根据业务ID查询实例 |
-| `/flowHisTaskList/{businessId}` | GET | 获取流程图和审批记录 |
-| `/cancelProcessApply` | PUT | 撤销流程申请 |
-| `/invalid` | POST | 作废流程 |
-| `/deleteByBusinessIds/{businessIds}` | DELETE | 按业务ID删除实例 |
-| `/deleteByInstanceIds/{instanceIds}` | DELETE | 按实例ID删除实例 |
-| `/deleteHisByInstanceIds/{instanceIds}` | DELETE | 删除已完成的实例 |
-| `/instanceVariable/{instanceId}` | GET | 获取流程变量 |
-| `/updateVariable` | PUT | 更新流程变量 |
-| `/active/{id}` | PUT | 激活/挂起流程实例 |
-
-### 流程定义 (/workflow/definition)
+| `/pageByRunning` | GET | 运行中实例 |
+| `/pageByFinish` | GET | 已完成实例 |
+| `/pageByCurrent` | GET | 当前用户发起 |
+| `/cancelProcessApply` | PUT | 撤销申请 |
+| `/invalid` | POST | 作废 |
+| `/flowHisTaskList/{businessId}` | GET | 流程图+审批记录 |
 
-| 接口 | 方法 | 说明 |
-|------|------|------|
-| `/list` | GET | 查询已发布的流程定义 |
-| `/unPublishList` | GET | 查询未发布的流程定义 |
-| `/{id}` | GET | 获取流程定义详情 |
-| `/` | POST | 新增流程定义 |
-| `/` | PUT | 修改流程定义 |
-| `/publish/{id}` | PUT | 发布流程定义 |
-| `/unPublish/{id}` | PUT | 取消发布流程定义 |
-| `/{ids}` | DELETE | 删除流程定义 |
-| `/copy/{id}` | POST | 复制流程定义 |
-| `/importDef` | POST | 导入流程定义 |
-| `/exportDef/{id}` | POST | 导出流程定义 |
-| `/xmlString/{id}` | GET | 获取定义 JSON 字符串 |
-| `/active/{id}` | PUT | 激活/挂起流程定义 |
-
-### 流程分类 (/workflow/category)
+### 定义 /workflow/definition
 
 | 接口 | 方法 | 说明 |
 |------|------|------|
-| `/list` | GET | 查询流程分类列表 |
-| `/export` | POST | 导出流程分类 |
-| `/{categoryId}` | GET | 获取分类详情 |
-| `/` | POST | 新增分类 |
-| `/` | PUT | 修改分类 |
-| `/{categoryId}` | DELETE | 删除分类 |
-| `/categoryTree` | GET | 获取分类树列表 |
+| `/list` | GET | 已发布定义 |
+| `/publish/{id}` | PUT | 发布 |
+| `/unPublish/{id}` | PUT | 取消发布 |
+| `/copy/{id}` | POST | 复制 |
+| `/importDef` | POST | 导入 |
+| `/exportDef/{id}` | POST | 导出 |
 
 ---
 
-## 文件位置
+## 八、核心文件位置
 
 ```
 ruoyi-modules/ruoyi-workflow/src/main/java/org/dromara/workflow/
-├── controller/
-│   ├── FlwTaskController.java         # 任务管理
-│   ├── FlwInstanceController.java     # 实例管理
-│   ├── FlwDefinitionController.java   # 流程定义
-│   ├── FlwCategoryController.java     # 流程分类
-│   ├── FlwSpelController.java         # SpEL表达式
-│   └── TestLeaveController.java       # 请假示例
-├── service/
-│   ├── IFlwTaskService.java
-│   ├── IFlwInstanceService.java
-│   ├── IFlwDefinitionService.java
-│   ├── IFlwCategoryService.java
-│   ├── IFlwSpelService.java
-│   ├── IFlwTaskAssigneeService.java
-│   ├── IFlwNodeExtService.java
-│   ├── IFlwCommonService.java
-│   ├── ITestLeaveService.java
-│   └── impl/
-│       ├── FlwTaskServiceImpl.java
-│       ├── FlwInstanceServiceImpl.java
-│       ├── FlwDefinitionServiceImpl.java
-│       ├── FlwCategoryServiceImpl.java
-│       ├── FlwSpelServiceImpl.java
-│       ├── FlwTaskAssigneeServiceImpl.java
-│       ├── FlwNodeExtServiceImpl.java
-│       ├── FlwCommonServiceImpl.java
-│       ├── TestLeaveServiceImpl.java
-│       └── WorkflowServiceImpl.java   # 通用工作流服务
-├── mapper/                            # Mapper 层（非 DAO）
-│   ├── FlwCategoryMapper.java
-│   ├── FlwSpelMapper.java
-│   ├── FlwTaskMapper.java
-│   ├── FlwInstanceMapper.java
-│   ├── FlwInstanceBizExtMapper.java
-│   └── TestLeaveMapper.java
-├── listener/
-│   └── WorkflowGlobalListener.java    # 全局监听器
-├── handler/
-│   ├── FlowProcessEventHandler.java   # 事件发布
-│   └── WorkflowPermissionHandler.java # 权限处理
-├── rule/
-│   └── SpelRuleComponent.java         # SpEL 规则组件
-├── domain/
-│   ├── FlowCategory.java
-│   ├── FlowSpel.java
-│   ├── FlowInstanceBizExt.java
-│   ├── TestLeave.java
-│   ├── bo/                            # 业务对象
-│   │   ├── StartProcessBo.java
-│   │   ├── CompleteTaskBo.java
-│   │   ├── BackProcessBo.java
-│   │   ├── TaskOperationBo.java
-│   │   └── ...
-│   └── vo/                            # 视图对象
-│       ├── FlowTaskVo.java
-│       ├── FlowHisTaskVo.java
-│       ├── FlowInstanceVo.java
-│       └── ...
-├── config/
-│   └── WarmFlowConfig.java            # WarmFlow 配置
-└── common/
-    ├── ConditionalOnEnable.java       # 条件注解
-    ├── constant/
-    │   └── FlowConstant.java          # 常量
-    └── enums/
-        ├── TaskStatusEnum.java        # 任务状态
-        ├── TaskAssigneeEnum.java      # 办理人类型
-        ├── TaskAssigneeType.java      # 办理人类型扩展
-        ├── MessageTypeEnum.java       # 消息类型
-        ├── ButtonPermissionEnum.java  # 按钮权限
-        ├── CopySettingEnum.java       # 抄送设置
-        ├── NodeExtEnum.java           # 节点扩展
-        └── VariablesEnum.java         # 变量枚举
-```
-
----
-
-## 检查清单
-
-- [ ] 是否正确使用 `FlowEngine` 访问核心服务？
-- [ ] 是否使用 `ProcessEvent`/`ProcessTaskEvent` 监听流程状态变更？
-- [ ] 是否正确配置办理人（注意：用户ID无前缀，角色/部门/岗位有前缀）？
-- [ ] 是否在业务模块中正确集成 `WorkflowService`？
-- [ ] 是否处理了流程各状态（通过、驳回、撤销、终止）的业务逻辑？
-- [ ] 是否配置了消息通知（SSE/邮件/短信）？
-- [ ] API 方法名是否使用 pageBy* 命名规范（如 pageByTaskWait）？
-
----
-
-## 常见问题
-
-### Q1: 用户ID和角色ID在办理人配置中的区别？
-
-```java
-// ✅ 用户ID - 无前缀
-"123"           // 直接是用户ID
-
-// ✅ 角色ID - 有 role: 前缀
-"role:456"      // 角色ID
-
-// ✅ 部门ID - 有 dept: 前缀
-"dept:789"      // 部门ID
-
-// ✅ 岗位ID - 有 post: 前缀
-"post:101"      // 岗位ID
-```
-
-### Q2: 如何判断是否为 SpEL 表达式？
-
-```java
-// SpEL 表达式以 # 或 $ 开头
-TaskAssigneeEnum.isSpelExpression("#{initiator}")  // true
-TaskAssigneeEnum.isSpelExpression("${deptLeader}") // true
-TaskAssigneeEnum.isSpelExpression("user:123")      // false
-```
-
-### Q3: 如何忽略办理权限校验？
-
-```java
-Map<String, Object> variable = new HashMap<>();
-variable.put(FlowConstant.VAR_IGNORE, true);  // 忽略办理权限校验
+├── controller/          # FlwTaskController, FlwInstanceController, FlwDefinitionController
+├── service/impl/        # FlwTaskServiceImpl, WorkflowServiceImpl
+├── mapper/              # FlwTaskMapper, FlwInstanceMapper
+├── listener/            # WorkflowGlobalListener
+├── handler/             # FlowProcessEventHandler, WorkflowPermissionHandler
+├── domain/bo/           # StartProcessBo, CompleteTaskBo, BackProcessBo, TaskOperationBo
+├── domain/vo/           # FlowTaskVo, FlowHisTaskVo, FlowInstanceVo
+├── common/constant/     # FlowConstant
+└── common/enums/        # TaskStatusEnum, TaskAssigneeEnum, MessageTypeEnum
 ```