From b28d917d566c0882e8b4e0d7183575cd1e25f7dc Mon Sep 17 00:00:00 2001
From: jason <2667446@qq.com>
Date: Sun, 8 Sep 2024 17:20:28 +0800
Subject: [PATCH] =?UTF-8?q?=E4=BB=BF=E9=92=89=E9=92=89=E6=B5=81=E7=A8=8B?=
 =?UTF-8?q?=E8=AE=BE=E8=AE=A1-=20=E4=BB=A3=E7=A0=81=E8=AF=84=E5=AE=A1?=
 =?UTF-8?q?=E4=BF=AE=E6=94=B9?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../definition/BpmProcessNodeProgressEnum.java  |  2 +-
 .../bpm/service/task/BpmActivityService.java    | 17 ++++++++++++++++-
 2 files changed, 17 insertions(+), 2 deletions(-)

diff --git a/yudao-module-bpm/yudao-module-bpm-api/src/main/java/cn/iocoder/yudao/module/bpm/enums/definition/BpmProcessNodeProgressEnum.java b/yudao-module-bpm/yudao-module-bpm-api/src/main/java/cn/iocoder/yudao/module/bpm/enums/definition/BpmProcessNodeProgressEnum.java
index a9483074f..e8095e4a5 100644
--- a/yudao-module-bpm/yudao-module-bpm-api/src/main/java/cn/iocoder/yudao/module/bpm/enums/definition/BpmProcessNodeProgressEnum.java
+++ b/yudao-module-bpm/yudao-module-bpm-api/src/main/java/cn/iocoder/yudao/module/bpm/enums/definition/BpmProcessNodeProgressEnum.java
@@ -29,7 +29,7 @@ public enum BpmProcessNodeProgressEnum {
     USER_TASK_REJECT(31, "审批不通过"), // 审批节点
     USER_TASK_RETURN(32, "已退回"), // 审批节点
     USER_TASK_CANCEL(34, "已取消"), // 审批节点
-    // 40 ~ 50 一般节点的接榫状态 // TODO @jason：接榫 是啥呀？
+    // 40 ~ 50 节点的通用结束状态
     FINISHED(41, "已结束"), // 一般节点的节点的结束状态
     SKIP(42, "跳过"); // 未执行，跳过的节点
 
diff --git a/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/service/task/BpmActivityService.java b/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/service/task/BpmActivityService.java
index 0934b60d6..a3c1a228e 100644
--- a/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/service/task/BpmActivityService.java
+++ b/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/service/task/BpmActivityService.java
@@ -1,6 +1,7 @@
 package cn.iocoder.yudao.module.bpm.service.task;
 
 import cn.iocoder.yudao.module.bpm.controller.admin.task.vo.instance.BpmProcessInstanceProgressRespVO;
+import cn.iocoder.yudao.module.bpm.enums.task.BpmProcessInstanceStatusEnum;
 import org.flowable.engine.history.HistoricActivityInstance;
 
 import java.util.List;
@@ -54,9 +55,23 @@ public interface BpmActivityService {
                                               Boolean isMultiInstance,
                                               List<HistoricActivityInstance> historicActivityList);
 
-    // TODO @jason：可以写下这 2 个方法的注释
+    /**
+     * 获取未执行活动的进度状态
+     *
+     * @param processInstanceStatus 流程实例的状态 {@link BpmProcessInstanceStatusEnum}
+     * @return 活动的进度状态
+     */
     Integer getNotRunActivityProgressStatus(Integer processInstanceStatus);
 
+    /**
+     * 获取未执行活动的用户列表
+     *
+     * @param processInstanceId 流程实例的编号
+     * @param processInstanceStatus 流程实例的状态 {@link BpmProcessInstanceStatusEnum}
+     * @param candidateStrategy 活动的候选人策略
+     * @param candidateParam  活动的候选人参数
+     * @return 用户列表
+     */
     List<BpmProcessInstanceProgressRespVO.User> getNotRunActivityUserList(String processInstanceId,
                                                                           Integer processInstanceStatus,
                                                                           Integer candidateStrategy,