flow-center/flow-center-service
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 提交流程中心后端代码
build / build-push (push) Successful in 28s
Details

Browse Source 
Spring Boot 流程引擎服务：流程定义/实例/任务、审批人解析、
回调分发、oapi 接口及单元测试。
保留远程 .gitea/workflows/build.yml 与 docker/Dockerfile，
新增 .gitignore 排除 target/ 构建产物。
This commit is contained in:
chenxing
2026-09-15 10:42:56 +08:00
parent 0296b2b5dd
commit c1103aeb29
65 changed files with 7119 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/main/java/com/yunhai/flowcenter/controller/api/FlowAdminController.java
+201
View File
@@ -0,0 +1,201 @@
package com.yunhai.flowcenter.controller.api;
import com.yunhai.flowcenter.entity.FlwAssigneeMap;
import com.yunhai.flowcenter.entity.FlwCallbackLog;
import com.yunhai.flowcenter.entity.FlwCallbackReg;
import com.yunhai.flowcenter.entity.FlwDef;
import com.yunhai.flowcenter.entity.FlwInstance;
import com.yunhai.flowcenter.model.FlowModels;
import com.yunhai.flowcenter.repository.FlwInstanceRepository;
import com.yunhai.flowcenter.service.FlowAdminGuard;
import com.yunhai.flowcenter.service.FlowCallbackAdminService;
import com.yunhai.flowcenter.service.FlowDefAdminService;
import com.yunhai.flowcenter.service.FlowDiagramService;
import com.yunhai.flowcenter.service.FlowMapAdminService;
import com.yunhai.platform.utils.model.BasePageResult;
import com.yunhai.platform.utils.model.BoaUser;
import lombok.RequiredArgsConstructor;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.PageRequest;
import org.springframework.data.domain.Sort;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import java.util.List;
import java.util.Map;
/**
* 管理端（/api/flow/admin/**，CAS + 管理员角色，FlowAdminGuard 校验）：
* 定义 JSON 编辑/发布/停用、办理人映射 CRUD（成员检索调 UserBase）、
* 回调注册管理/推送日志/死信重推、办件查询。
*/
@RestController
@RequestMapping("/api/flow/admin")
@RequiredArgsConstructor
public class FlowAdminController {
private final FlowAdminGuard adminGuard;
private final FlowDefAdminService defAdminService;
private final FlowMapAdminService mapAdminService;
private final FlowCallbackAdminService callbackAdminService;
private final FlwInstanceRepository instanceRepository;
private final FlowDiagramService diagramService;
// ==================== 流程定义 ====================
@GetMapping("/def/list")
public List<FlwDef> defList(BoaUser user,
@RequestParam(value = "status", required = false) Integer status) {
return defAdminService.list(adminGuard.requireAdmin(user, null), status);
}
@GetMapping("/def/get")
public FlwDef defGet(BoaUser user, @RequestParam("id") Long id) {
return defAdminService.get(adminGuard.requireAdmin(user, null), id);
}
/** 保存（新建草稿/编辑；已发布定义保存=升版本，flowGuid 不变；baseGuid=在指定流程线上开新版本草稿） */
@PostMapping("/def/save")
public FlwDef defSave(BoaUser user, @RequestBody Map<String, Object> body) {
Long schId = adminGuard.requireAdmin(user, null);
Long id = body.get("id") == null ? null : Long.valueOf(String.valueOf(body.get("id")));
return defAdminService.save(schId, id,
(String) body.get("code"), (String) body.get("name"),
(String) body.get("contentJson"), (String) body.get("baseGuid"));
}
@PostMapping("/def/publish/{id}")
public FlwDef defPublish(BoaUser user, @PathVariable("id") Long id) {
return defAdminService.publish(adminGuard.requireAdmin(user, null), id);
}
@PostMapping("/def/offline/{id}")
public void defOffline(BoaUser user, @PathVariable("id") Long id) {
defAdminService.offline(adminGuard.requireAdmin(user, null), id);
}
@GetMapping("/def/versions")
public List<FlwDef> defVersions(BoaUser user, @RequestParam("flowGuid") String flowGuid) {
return defAdminService.versions(adminGuard.requireAdmin(user, null), flowGuid);
}
/** 流程定义示意图（方案 §3.1）：requireAdmin 后按 defId 任意版本出图（草稿可预览） */
@GetMapping("/def/diagram")
public FlowModels.DiagramVo defDiagram(BoaUser user, @RequestParam("id") Long id,
@RequestParam(value = "mode", required = false) String mode) {
Long schId = adminGuard.requireAdmin(user, null);
FlwDef def = defAdminService.get(schId, id);
return diagramService.build(def, null, mode);
}
// ==================== 办理人映射 ====================
@GetMapping("/map/list")
public List<FlwAssigneeMap> mapList(BoaUser user,
@RequestParam(value = "deptKey", required = false) String deptKey) {
return mapAdminService.listByDept(adminGuard.requireAdmin(user, null), deptKey);
}
@PostMapping("/map/save")
public FlwAssigneeMap mapSave(BoaUser user, @RequestBody Map<String, Object> body) {
Long schId = adminGuard.requireAdmin(user, null);
return mapAdminService.save(schId,
(String) body.get("deptKey"), (String) body.get("deptName"),
body.get("userId") == null ? null : Integer.valueOf(String.valueOf(body.get("userId"))),
(String) body.get("userName"));
}
@PostMapping("/map/disable/{id}")
public void mapDisable(BoaUser user, @PathVariable("id") Long id) {
mapAdminService.disable(adminGuard.requireAdmin(user, null), id);
}
/** 成员检索（UserBase /oapi/user/byId） */
@GetMapping("/map/lookupUser")
public com.yunhai.platform.utils.model.BoaUser lookupUser(BoaUser user,
@RequestParam("userId") Integer userId) {
adminGuard.requireAdmin(user, null);
return mapAdminService.lookupUser(userId);
}
// ==================== 回调注册/推送日志/死信 ====================
@GetMapping("/callback/regList")
public List<FlwCallbackReg> regList(BoaUser user) {
return callbackAdminService.listRegs(adminGuard.requireAdmin(user, null));
}
@PostMapping("/callback/regStatus/{id}")
public void regStatus(BoaUser user, @PathVariable("id") Long id,
@RequestParam("enabled") boolean enabled) {
callbackAdminService.setRegStatus(adminGuard.requireAdmin(user, null), id, enabled);
}
/** secret 重置（新 secret 返回给前端展示一次） */
@PostMapping("/callback/resetSecret/{id}")
public Map<String, String> resetSecret(BoaUser user, @PathVariable("id") Long id) {
String secret = callbackAdminService.resetSecret(adminGuard.requireAdmin(user, null), id);
return java.util.Collections.singletonMap("secret", secret);
}
@GetMapping("/callback/logs")
public BasePageResult<FlwCallbackLog> logs(BoaUser user,
@RequestParam(value = "status", required = false) Integer status,
@RequestParam(value = "event", required = false) String event,
@RequestParam(value = "instanceId", required = false) Long instanceId,
@RequestParam(value = "page", required = false) Integer page,
@RequestParam(value = "size", required = false) Integer size) {
return callbackAdminService.pageLogs(adminGuard.requireAdmin(user, null), status, event, instanceId, page, size);
}
/** 挂起列表（待推且重试达阈值；持续重试中疑似消费方停机的可视入口） */
@GetMapping("/callback/hung")
public BasePageResult<FlwCallbackLog> hung(BoaUser user,
@RequestParam(value = "page", required = false) Integer page,
@RequestParam(value = "size", required = false) Integer size) {
return callbackAdminService.pageHung(adminGuard.requireAdmin(user, null), page, size);
}
/** 管理端手工标记死信（死信唯一人工入口；标记后可 rePush 复活） */
@PostMapping("/callback/markDead/{id}")
public void markDead(BoaUser user, @PathVariable("id") Long id) {
callbackAdminService.markDead(adminGuard.requireAdmin(user, null), id);
}
@GetMapping("/callback/dead")
public BasePageResult<FlwCallbackLog> dead(BoaUser user,
@RequestParam(value = "page", required = false) Integer page,
@RequestParam(value = "size", required = false) Integer size) {
return callbackAdminService.pageDead(adminGuard.requireAdmin(user, null), page, size);
}
@PostMapping("/callback/repush")
public void repush(BoaUser user, @RequestBody List<Long> logIds) {
callbackAdminService.rePush(adminGuard.requireAdmin(user, null), logIds);
}
// ==================== 办件查询 ====================
@GetMapping("/instance/page")
public BasePageResult<FlwInstance> instancePage(
BoaUser user,
@RequestParam(value = "status", required = false) Integer status,
@RequestParam(value = "keyword", required = false) String keyword,
@RequestParam(value = "page", required = false) Integer page,
@RequestParam(value = "size", required = false) Integer size) {
Long schId = adminGuard.requireAdmin(user, null);
Page<FlwInstance> p = instanceRepository.pageAdmin(schId, status, keyword,
PageRequest.of(page == null || page < 1 ? 0 : page - 1,
size == null || size < 1 || size > 100 ? 10 : size,
Sort.by(Sort.Order.desc("id"))));
int pi = page == null || page < 1 ? 1 : page;
int ps = size == null || size < 1 || size > 100 ? 10 : size;
return new BasePageResult<>(p.getContent(), (int) p.getTotalElements(), pi, ps,
p.getTotalPages(), p.hasNext());
}
}
src/main/java/com/yunhai/flowcenter/controller/api/FlowBaseController.java
+49
View File
@@ -0,0 +1,49 @@
package com.yunhai.flowcenter.controller.api;
import com.yunhai.platform.utils.model.BoaUser;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
/**
* 前端壳基础端点（对齐 UserBase BaseController 的 /api/base/* 形态）：
* GetUserInfo 返回当前登录人；GetUserMod 返回本地路由菜单——flow-center 是独立登录态应用，
* 菜单不走 UserBase app_module 下发（概览 §9.4），modId 为本应用内部约定。
*/
@RestController
public class FlowBaseController {
/** 左侧菜单（本地路由，顺序即展示顺序） */
private static final String[][] MENUS = {
{"100", "工作台", "/workbench"},
{"101", "我的办件", "/my"},
{"102", "办件记录", "/admin/instances"},
{"103", "流程定义", "/admin/defs"},
{"104", "办理人映射", "/admin/maps"},
{"105", "回调管理", "/admin/callbacks"},
};
@GetMapping("/api/base/GetUserInfo")
public BoaUser getUserInfo(BoaUser authUserWithDept) {
return authUserWithDept;
}
@GetMapping("/api/base/GetUserMod")
public List<Map<String, Object>> getUserMod() {
List<Map<String, Object>> modList = new ArrayList<>();
for (String[] m : MENUS) {
Map<String, Object> item = new HashMap<>();
item.put("id", Integer.valueOf(m[0]));
item.put("modId", Integer.valueOf(m[0]));
item.put("name", m[1]);
item.put("page", m[2]);
item.put("children", new ArrayList<>());
modList.add(item);
}
return modList;
}
}
src/main/java/com/yunhai/flowcenter/controller/api/FlowUserController.java
+146
View File
@@ -0,0 +1,146 @@
package com.yunhai.flowcenter.controller.api;
import com.yunhai.flowcenter.entity.FlwInstance;
import com.yunhai.flowcenter.entity.FlwTask;
import com.yunhai.flowcenter.model.FlowModels;
import com.yunhai.flowcenter.service.FlowAccessGuard;
import com.yunhai.flowcenter.service.FlowDiagramService;
import com.yunhai.flowcenter.service.FlowInstanceService;
import com.yunhai.flowcenter.service.FlowQueryService;
import com.yunhai.flowcenter.service.FlowTaskService;
import com.yunhai.platform.apistd.BizException;
import com.yunhai.platform.utils.exception.ErrorCode;
import com.yunhai.platform.utils.model.BasePageResult;
import com.yunhai.platform.utils.model.BoaUser;
import lombok.RequiredArgsConstructor;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import java.util.Map;
/**
* 用户面（/api/flow/**，CAS 会话）：我的办件/待办/已办/办件详情/办理/撤回/催办。
* 一切审批入口的收敛点（概览 §8.5 不变式 2）：业务系统内嵌页、消息跳转最终都调这套 API。
*/
@RestController
@RequestMapping("/api/flow")
@RequiredArgsConstructor
public class FlowUserController {
private final FlowQueryService queryService;
private final FlowTaskService taskService;
private final FlowInstanceService instanceService;
private final FlowAccessGuard accessGuard;
private final FlowDiagramService diagramService;
/** 我提交的办件 */
@GetMapping("/my")
public BasePageResult<FlowModels.InstanceItem> my(BoaUser user,
@RequestParam(value = "status", required = false) Integer status,
@RequestParam(value = "page", required = false) Integer page,
@RequestParam(value = "size", required = false) Integer size) {
return queryService.pageMy(requireSchId(user), user.getId(), status, page, size);
}
/** 我的待办（主路径，走 assignee 索引） */
@GetMapping("/todo")
public BasePageResult<FlowModels.TaskItem> todo(BoaUser user,
@RequestParam(value = "page", required = false) Integer page,
@RequestParam(value = "size", required = false) Integer size) {
return queryService.pageTodo(requireSchId(user), user.getId(), page, size);
}
/** 我的已办 */
@GetMapping("/done")
public BasePageResult<FlowModels.TaskItem> done(BoaUser user,
@RequestParam(value = "page", required = false) Integer page,
@RequestParam(value = "size", required = false) Integer size) {
return queryService.pageDone(requireSchId(user), user.getId(), page, size);
}
/** 办件详情（提交人/办理人/本校管理员可见） */
@GetMapping("/instance/{id}")
public FlowModels.InstanceDetail detail(BoaUser user, @PathVariable("id") Long id) {
FlwInstance instance = instanceService.requireInstance(requireSchId(user), id);
accessGuard.requireInstanceVisible(instance, user);
return queryService.detail(requireSchId(user), id, user.getId());
}
/** 任务定位办件详情（办理页 /task/{taskId} 数据源；可见性走办件详情同一守卫） */
@GetMapping("/task/{id}/detail")
public FlowModels.InstanceDetail taskDetail(BoaUser user, @PathVariable("id") Long id) {
Long schId = requireSchId(user);
FlwTask task = taskService.requireTask(schId, id);
FlwInstance instance = instanceService.requireInstance(schId, task.getInstanceId());
accessGuard.requireInstanceVisible(instance, user);
return queryService.detail(schId, instance.getId(), user.getId());
}
/** 同意（opinion 可选）——一切审批入口的收敛点 */
@PostMapping("/task/{id}/approve")
public void approve(BoaUser user, @PathVariable("id") Long id,
@RequestBody(required = false) Map<String, String> body) {
String opinion = body == null ? null : body.get("opinion");
taskService.handle(requireSchId(user), id, true, opinion, user.getId());
}
/** 拒绝（opinion 必填） */
@PostMapping("/task/{id}/reject")
public void reject(BoaUser user, @PathVariable("id") Long id,
@RequestBody(required = false) Map<String, String> body) {
String opinion = body == null ? null : body.get("opinion");
taskService.handle(requireSchId(user), id, false, opinion, user.getId());
}
/** 撤回（提交人；仅尚无任务被办理时） */
@PostMapping("/instance/{id}/withdraw")
public void withdraw(BoaUser user, @PathVariable("id") Long id) {
FlwInstance instance = instanceService.requireInstance(requireSchId(user), id);
if (!instance.getSubmitterId().equals(user.getId())) {
throw new BizException(ErrorCode.FORBIDDEN, "仅提交人本人可撤回");
}
instanceService.withdraw(requireSchId(user), id);
}
/** 催办（提交人/管理员；对全部待办任务各催一次，msgNo 幂等） */
@PostMapping("/instance/{id}/urge")
public void urge(BoaUser user, @PathVariable("id") Long id) {
instanceService.urgeInstance(requireSchId(user), id, user.getId());
}
/**
* 流程示意图（方案 §3.1）：flowGuid=最高已发布版（登录+本校）；
* instanceId=办件 def 快照版，可见性与办件详情同口径（requireInstanceVisible）。
*/
@GetMapping("/diagram")
public FlowModels.DiagramVo diagram(BoaUser user,
@RequestParam(value = "flowGuid", required = false) String flowGuid,
@RequestParam(value = "instanceId", required = false) Long instanceId,
@RequestParam(value = "mode", required = false) String mode) {
Long schId = requireSchId(user);
if (flowGuid != null && !flowGuid.trim().isEmpty()) {
return diagramService.byGuid(schId, flowGuid.trim(), mode);
}
if (instanceId != null) {
FlwInstance instance = instanceService.requireInstance(schId, instanceId);
accessGuard.requireInstanceVisible(instance, user);
return diagramService.byInstance(instance, mode);
}
throw new BizException(ErrorCode.PARAM_ERROR, "缺少必要参数：flowGuid 或 instanceId");
}
private Long requireSchId(BoaUser user) {
if (user == null) {
throw new BizException(ErrorCode.FORBIDDEN, "未登录");
}
if (user.getCurrentRole() == null || user.getCurrentRole().getSchId() == null) {
throw new BizException(ErrorCode.PARAM_ERROR, "当前身份无学校归属（区域账号无流程业务）");
}
return Long.valueOf(user.getCurrentRole().getSchId());
}
}
src/main/java/com/yunhai/flowcenter/controller/oapi/OapiFlowController.java
+64
View File
@@ -0,0 +1,64 @@
package com.yunhai.flowcenter.controller.oapi;
import com.yunhai.flowcenter.model.OapiModels;
import com.yunhai.flowcenter.service.OapiFlowService;
import lombok.RequiredArgsConstructor;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestAttribute;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import java.util.List;
/**
* 托管接入件（/oapi/flow/**，appKey 签名强制，V2.0 Part D #5 前置 M1）。
* 出入参逐字对齐 svc-hall FlowCenterClient（《流程中心M1开工说明.md》§5 契约锚点）：
* - GET /oapi/flow/list?schId= → data=[{flowGuid,name,version,nodeSummary}]
* - GET /oapi/flow/{flowGuid}?schId= → data={flowGuid,name,version,nodeSummary}
* - POST /oapi/flow/apply → data={instanceId,duplicated}
* - GET /oapi/flow/instance?bizType=&bizId=&schId= → data={status,version,instanceId,nodeSummary,traceJson,…}
* - POST /oapi/flow/callback/reg?schId= → data={secret}
*/
@RestController
@RequestMapping("/oapi/flow")
@RequiredArgsConstructor
public class OapiFlowController {
private final OapiFlowService flowService;
@GetMapping("/list")
public List<OapiModels.FlowSummaryVo> list(@RequestParam("schId") Long schId) {
return flowService.listFlows(schId);
}
@GetMapping("/{flowGuid}")
public OapiModels.FlowSummaryVo getFlow(@PathVariable("flowGuid") String flowGuid,
@RequestParam("schId") Long schId) {
return flowService.getFlow(schId, flowGuid);
}
@PostMapping("/apply")
public OapiModels.ApplyResultVo apply(@RequestParam("schId") Long schId,
@RequestBody OapiModels.ApplyBody body) {
return flowService.apply(schId, body);
}
@GetMapping("/instance")
public OapiModels.InstanceVo instance(@RequestParam("bizType") String bizType,
@RequestParam("bizId") String bizId,
@RequestParam("schId") Long schId) {
return flowService.instanceByBiz(schId, bizType, bizId);
}
@PostMapping("/callback/reg")
public OapiModels.CallbackRegResultVo registerCallback(
@RequestParam("schId") Long schId,
@RequestAttribute(value = "yh.app.auth", required = false) String appKey,
@RequestBody OapiModels.CallbackRegBody body) {
return flowService.registerCallback(schId, appKey, body);
}
}