P3-4: platform-flow-gateway 单体侧流程网关(Flowable REST 客户端 + 待办聚合 + 事件回写)

- FlowableClient:RestClient 调 flowable-service(eip4.flow.base-url,默认 8089);
  超时/重试(仅连接级)/熔断降级——引擎不可达 → 503 语义(非 500 堆栈),业务错 4xx/5xx 透传。
- 待办聚合(经 platform-app 暴露):GET /api/todo(JWT userId+roles 候选组)、GET /api/done、
  POST /api/task/{id}/complete、POST /api/process/start;聚合层把 Flowable 任务与业务摘要连接
  (businessKey → SYS_DATASTATUS.tablename → loadPOJO 只读标题字段;业务摘要数据源客户库只读,
  拼不到优雅降级为仅流程字段)。
- 事件回写:complete 后按老系统 ProcessCoreServiceImpl.passProcess + WfChangeStatus 语义更新
  SYS_DATASTATUS(结束→STATUS_PASS=3,未结束→STATUS_PROCESSING=2,守卫 oldstatus<status 单调递增;
  upsert UPDATE 命中或 0 行 INSERT);本地库验证,客户库只读。
- flowable-service 契约增强:Flowable 6.8.1 TaskInfo 无 getBusinessKey(),todo/done 出参由查询侧
  从实例补全 businessKey;新增 GET /api/flow/process/{id} 查实例(供办理后判定流程是否结束)。

验证(8089 连本地 eip4flow+客户库只读,8090 连本地 eip4m0,8084 未动):
- 待办聚合数=直查一致:真实用户 829cdcca /api/todo=4 == 8089 直查 count=4。
- 业务摘要拼接正确 + 优雅降级共存:命中条目拼到 SYS_USERGROUP 标题字段,同列表 3 条无映射降级为仅流程字段。
- 熔断:kill 8089 后 /api/todo 返回 503 干净 JSON,platform-app 进程存活不崩。
- 事件回写:本地构造 datastatus=1,经 8090 complete(流程结束)回写为 3;引擎侧实例确结束。
- 21 单测(客户端重试/降级、聚合拼接、回写守卫)+ 全模块 mvn test + ArchUnit 绿。

坑入手册 §6.8(TaskInfo 无 businessKey)/§6.9(503 熔断 + 回写守卫 + SYS_DATASTATUS 无主键)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-06-11 15:12:03 +08:00
parent 6ced9b15f2
commit ac9812e0a1
24 changed files with 1707 additions and 3 deletions

View File

@@ -62,9 +62,28 @@ public class FlowController {
if (candidateUser != null && !candidateUser.isBlank()) {
q = q.taskCandidateUser(candidateUser);
}
return q.orderByTaskCreateTime().desc()
List<TaskDto> dtos = q.orderByTaskCreateTime().desc()
.listPage(firstResult, maxResults)
.stream().map(TaskDto::of).collect(Collectors.toList());
fillBusinessKeyFromRuntime(dtos);
return dtos;
}
/**
* 补全活动待办的 businessKey(Flowable 6.8.1 Task 接口无此字段,从运行时实例反查)。
* 供 gateway 聚合业务摘要;按 processInstanceId 单值查实例 businessKey,缺失则留 null。
*/
private void fillBusinessKeyFromRuntime(List<TaskDto> dtos) {
for (TaskDto d : dtos) {
if (d.processInstanceId == null) {
continue;
}
ProcessInstance pi = runtimeService.createProcessInstanceQuery()
.processInstanceId(d.processInstanceId).singleResult();
if (pi != null) {
d.businessKey = pi.getBusinessKey();
}
}
}
@GetMapping("/tasks/todo/count")
@@ -87,9 +106,25 @@ public class FlowController {
if (assignee != null && !assignee.isBlank()) {
q = q.taskAssignee(assignee);
}
return q.orderByHistoricTaskInstanceEndTime().desc()
List<TaskDto> dtos = q.orderByHistoricTaskInstanceEndTime().desc()
.listPage(firstResult, maxResults)
.stream().map(TaskDto::of).collect(Collectors.toList());
fillBusinessKeyFromHistory(dtos);
return dtos;
}
/** 补全已办的 businessKey(从历史实例反查)。供 gateway 聚合业务摘要。 */
private void fillBusinessKeyFromHistory(List<TaskDto> dtos) {
for (TaskDto d : dtos) {
if (d.processInstanceId == null) {
continue;
}
var hpi = historyService.createHistoricProcessInstanceQuery()
.processInstanceId(d.processInstanceId).singleResult();
if (hpi != null) {
d.businessKey = hpi.getBusinessKey();
}
}
}
@PostMapping("/process/start")
@@ -117,6 +152,29 @@ public class FlowController {
return ResponseEntity.noContent().build();
}
@GetMapping("/process/{processInstanceId}")
@Operation(summary = "查实例", description = "查流程实例:运行中返回 ended=false;已结束返回历史实例 ended=true;不存在 404。供 gateway 办理后判定流程是否结束以回写业务状态")
public ResponseEntity<ProcessInstanceDto> processInstance(@PathVariable String processInstanceId) {
ProcessInstance pi = runtimeService.createProcessInstanceQuery()
.processInstanceId(processInstanceId).singleResult();
if (pi != null) {
return ResponseEntity.ok(ProcessInstanceDto.of(pi));
}
var hpi = historyService.createHistoricProcessInstanceQuery()
.processInstanceId(processInstanceId).singleResult();
if (hpi == null) {
return ResponseEntity.notFound().build();
}
ProcessInstanceDto d = new ProcessInstanceDto();
d.id = hpi.getId();
d.processDefinitionId = hpi.getProcessDefinitionId();
d.processDefinitionKey = hpi.getProcessDefinitionKey();
d.businessKey = hpi.getBusinessKey();
d.ended = hpi.getEndTime() != null;
d.suspended = false;
return ResponseEntity.ok(d);
}
@PostMapping("/process/{processInstanceId}/suspend")
@Operation(summary = "挂起实例", description = "挂起后该实例任务不可办理")
public ResponseEntity<Void> suspend(@PathVariable String processInstanceId) {

View File

@@ -14,6 +14,8 @@ public class TaskDto {
public String processInstanceId;
public String processDefinitionId;
public String taskDefinitionKey;
/** 流程业务主键(Flowable 6.8.1 Task/HistoricTaskInstance 接口无此字段,由查询侧从实例补全;供 gateway 聚合业务摘要)。 */
public String businessKey;
public Long createTimeMillis;
public Long endTimeMillis;
public boolean suspended;