feat: 提交流程中心后端代码

Spring Boot 流程引擎服务：流程定义/实例/任务、审批人解析、回调分发、oapi 接口及单元测试。保留远程 .gitea/workflows/build.yml 与 docker/Dockerfile，新增 .gitignore 排除 target/ 构建产物。
2026-09-15 10:42:56 +08:00
parent 0296b2b5dd
commit c1103aeb29
65 changed files with 7119 additions and 0 deletions
@@ -0,0 +1,64 @@
+package com.yunhai.flowcenter.engine;
+
+import com.yunhai.flowcenter.entity.FlwAssigneeMap;
+import com.yunhai.flowcenter.repository.FlwAssigneeMapRepository;
+import com.yunhai.platform.apistd.BizException;
+import com.yunhai.platform.openapi.client.OpenApiUserClient;
+import com.yunhai.platform.utils.exception.ErrorCode;
+import com.yunhai.platform.utils.model.BoaUser;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * 办理人解析（概览 §六）：DEPT_KEY 查显式映射表（零跨服务依赖）；USERS 定义直配，
+ * 姓名经 UserBase /oapi/user/byId 补全（失败降级空名不阻塞）。SUBMITTER_DEPT/FORM_FIELD 二期。
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class AssigneeResolver {
+
+    private final FlwAssigneeMapRepository mapRepository;
+    private final OpenApiUserClient userClient;
+
+    public List<AssigneeRef> resolve(Long schId, FlowDefModel.Node node) {
+        FlowDefModel.Assignee a = node.assignee;
+        if (a == null) {
+            throw new BizException(ErrorCode.PARAM_ERROR, "节点缺少办理人配置：" + node.id);
+        }
+        List<AssigneeRef> refs = new ArrayList<>();
+        if (FlowDefModel.ASSIGNEE_DEPT_KEY.equals(a.type)) {
+            List<FlwAssigneeMap> maps = mapRepository.findEnabled(schId, a.deptKey);
+            for (FlwAssigneeMap m : maps) {
+                refs.add(new AssigneeRef(m.getUserId(), m.getUserName()));
+            }
+        } else if (FlowDefModel.ASSIGNEE_USERS.equals(a.type)) {
+            if (a.userIds != null) {
+                for (Integer uid : a.userIds) {
+                    refs.add(new AssigneeRef(uid, fetchName(uid)));
+                }
+            }
+        } else {
+            throw new BizException(ErrorCode.PARAM_ERROR, "一期不支持办理人类型：" + a.type);
+        }
+        if (refs.isEmpty()) {
+            throw new BizException(ErrorCode.PARAM_ERROR,
+                    "节点[" + node.id + "]无可用办理人（映射可能已被停用）");
+        }
+        return refs;
+    }
+
+    private String fetchName(Integer userId) {
+        try {
+            BoaUser user = userClient.getUserById(String.valueOf(userId));
+            return user == null ? "" : (user.getName() == null ? "" : user.getName());
+        } catch (Exception e) {
+            log.warn("[flow-center] UserBase 用户名补全失败 userId={}：{}", userId, e.getMessage());
+            return "";
+        }
+    }
+}