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:
@@ -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) {
|
||||
|
||||
@@ -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;
|
||||
|
||||
Reference in New Issue
Block a user