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,115 @@
+package com.yunhai.flowcenter.model;
+
+import lombok.Data;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * 用户面/管理面 VO（/api/flow/**）。
+ */
+public final class FlowModels {
+
+    private FlowModels() {
+    }
+
+    /** 我的办件列表行 */
+    @Data
+    public static class InstanceItem {
+        private Long instanceId;
+        private String bizType;
+        private String bizId;
+        private String bizTitle;
+        private Integer status;
+        private String currentNodes;
+        private String submitterName;
+        private String submitTime;
+        private String finishTime;
+        private String defName;
+        private Integer defVersion;
+    }
+
+    /** 待办/已办列表行 */
+    @Data
+    public static class TaskItem {
+        private Long taskId;
+        private Long instanceId;
+        private String bizTitle;
+        private String bizType;
+        private String bizId;
+        private Integer instanceStatus;
+        private String nodeId;
+        private String nodeName;
+        private String assigneeName;
+        private Integer status;
+        private String opinion;
+        private String arriveTime;
+        private String handleTime;
+        private String deadline;
+        private Integer urgeCount;
+    }
+
+    /** 办件详情（办理页/详情页数据源） */
+    @Data
+    public static class InstanceDetail {
+        private Long instanceId;
+        private Long schId;
+        private String defCode;
+        private Integer defVersion;
+        private String bizType;
+        private String bizId;
+        private String bizTitle;
+        private String bizUrl;
+        /** 业务摘要 JSON（办理页区块渲染；无富文本正文——概览 §十边界） */
+        private String bizSnapshot;
+        private String formDataJson;
+        private Integer status;
+        private String currentNodes;
+        private Integer submitterId;
+        private String submitterName;
+        private String submitTime;
+        private String finishTime;
+        private Integer version;
+        private String nodeSummary;
+        private List<Map<String, Object>> trace;
+        private List<Map<String, Object>> branches;
+        /** 当前用户可否办理（存在本人的待办任务） */
+        private boolean myPendingTask;
+        private List<Long> myPendingTaskIds;
+    }
+
+    /** 流程示意图出参（用户面 /diagram 与管理面 /admin/def/diagram 共用，方案 §3.1） */
+    @Data
+    public static class DiagramVo {
+        private String flowGuid;
+        private Long defId;
+        private Long instanceId;
+        private String name;
+        private Integer version;
+        private Integer status;
+        /** 实际出图口径：dept｜user｜auto（后端归一化后回显） */
+        private String mode;
+        private List<NodeVo> nodes;
+        private List<EdgeVo> edges;
+    }
+
+    /** 示意图节点（label/subLabel 已按视图解析好，前端只画不解析） */
+    @Data
+    public static class NodeVo {
+        private String id;
+        private String type;
+        private String label;
+        private String subLabel;
+        private String deptKey;
+        private String assigneeType;
+        private String countersign;
+        private Integer deadlineHours;
+    }
+
+    /** 示意图连边 */
+    @Data
+    public static class EdgeVo {
+        private String from;
+        private String to;
+    }
+}