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,68 @@
+package com.yunhai.flowcenter.service;
+
+import com.yunhai.flowcenter.entity.FlwInstance;
+import com.yunhai.flowcenter.repository.FlwTaskRepository;
+import com.yunhai.platform.apistd.BizException;
+import com.yunhai.platform.utils.exception.ErrorCode;
+import com.yunhai.platform.utils.model.BoaUser;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+
+import java.util.Arrays;
+import java.util.List;
+
+/**
+ * 用户面访问守卫（概览 §十）：提交人只读写自己办件；办理人只读写分派给自己的任务；
+ * 管理员本校可查、不可代批。
+ * 管理员口径与 FlowAdminGuard / svc-hall ApplyViewGuard / Notice NoticeFlowGuard 对齐：
+ * type==1（超管）或 roleId∈{2,5,7}（校级管理员）——三者必须同口径，否则校级管理员
+ * 能列办件却在详情页 403（本类原先只认 type==1，2026-09-14 校正）。
+ */
+@Service
+@RequiredArgsConstructor
+public class FlowAccessGuard {
+
+    private static final int SUPER_ADMIN_TYPE = 1;
+    private static final List<Integer> ADMIN_ROLE_IDS = Arrays.asList(2, 5, 7);
+
+    private final FlwTaskRepository taskRepository;
+
+    /** 办件详情可见：提交人本人 / 该办件任务办理人 / 本校管理员（超管或校级管理员） */
+    public void requireInstanceVisible(FlwInstance instance, BoaUser user) {
+        if (user == null || user.getId() == null) {
+            throw new BizException(ErrorCode.FORBIDDEN, "未登录");
+        }
+        if (instance.getSubmitterId().equals(user.getId())) {
+            return;
+        }
+        if (!taskRepository.findByInstanceIdOrderByIdAsc(instance.getId()).stream()
+                .anyMatch(t -> user.getId().equals(t.getAssigneeId()))) {
+            if (!isAdminOf(instance, user)) {
+                throw new BizException(ErrorCode.FORBIDDEN, "仅提交人/办理人/本校管理员可查看该办件");
+            }
+        }
+    }
+
+    /**
+     * 本校管理员（可查不可代批；办理权在 FlowTaskService 里再按 assigneeId 校验）。
+     * 超管与校级管理员均限本校——跨校仍 403，不放大可见范围。
+     */
+    private boolean isAdminOf(FlwInstance instance, BoaUser user) {
+        Long current = currentSchId(user);
+        if (current == null || !current.equals(instance.getSchId())) {
+            return false;
+        }
+        if (user.getType() != null && user.getType() == SUPER_ADMIN_TYPE) {
+            return true;
+        }
+        return user.getRoleIds() != null
+                && user.getRoleIds().stream().anyMatch(r -> r != null && ADMIN_ROLE_IDS.contains(r));
+    }
+
+    private Long currentSchId(BoaUser user) {
+        if (user.getCurrentRole() == null || user.getCurrentRole().getSchId() == null) {
+            return null;
+        }
+        return Long.valueOf(user.getCurrentRole().getSchId());
+    }
+}