[v2.1] A 应用内审批地基：oapi 增 GET /tasks/by-biz——按单据查当前人待办(0/1/N 均 200 空数组不泄露，校 schId/bizType/assignee 三 match，IT 11 例)

2026-10-19 16:44:35 +08:00
parent 8ceb2a4247
commit 132919b029
4 changed files with 385 additions and 0 deletions
@@ -349,6 +349,79 @@ public class OapiFlowService {
        return toPageResult(p.getTotalElements(), items, page, size);
    }

+    /**
+     * 按业务单据查当前人待办（v2.1 应用内审批的业务详情卡片数据源）：
+     * 补齐 tasks/todo 缺的那一侧——todo 是"人 → 单据列表"，本方法是"单据 → 我的待办"，
+     * 子应用据此判断"当前人是否该办件的待办人"，不必再拉全量待办在前端过滤。
+     * <p>治理口径：
+     * <ul>
+     *   <li>只返回 {@code assigneeId=operatorId} 且 status=PENDING 的任务；他人待办与"办件不存在"
+     *       一律出空数组（HTTP 200），出参不区分二者，避免用本端点探测别人的办件；</li>
+     *   <li>租户收敛在定位查询本身（{@code findBySchIdAndBizTypeAndBizId}），bizType 不匹配即空；</li>
+     *   <li>{@code outlets} 只为当前人的任务计算，且出边 &gt;1 才透出（与
+     *       {@code FlowQueryService.detail} 的办理面板口径一致——单出口无需选择，不给前端多余分支）；</li>
+     *   <li>不透出他人办理人、意见或定义内部 id；taskId 是办理必需的运行时身份，保留。</li>
+     * </ul>
+     */
+    public OapiModels.ByBizTasksVo tasksByBiz(Long schId, String bizType, String bizId, Integer operatorId) {
+        if (schId == null || schId <= 0 || operatorId == null || operatorId <= 0) {
+            throw new BizException(ErrorCode.PARAM_ERROR, "缺少必要参数：schId/operatorId（均须为正）");
+        }
+        String cleanBizType = emptyToNull(bizType);
+        String cleanBizId = emptyToNull(bizId);
+        if (cleanBizType == null || cleanBizId == null) {
+            throw new BizException(ErrorCode.PARAM_ERROR, "缺少必要参数：bizType/bizId");
+        }
+        OapiModels.ByBizTasksVo vo = new OapiModels.ByBizTasksVo();
+        vo.setBizType(cleanBizType);
+        vo.setBizId(cleanBizId);
+        FlwInstance instance = instanceRepository
+                .findBySchIdAndBizTypeAndBizId(schId, cleanBizType, cleanBizId).orElse(null);
+        if (instance == null) {
+            return vo;
+        }
+        vo.setInstanceId(instance.getId());
+        vo.setStatus(instance.getStatus());
+        vo.setCurrentNodes(instance.getCurrentNodes());
+        List<FlwTask> mine = taskRepository
+                .findByInstanceIdAndStatus(instance.getId(), FlwEnums.TaskStatus.PENDING.getCode()).stream()
+                .filter(t -> operatorId.equals(t.getAssigneeId()))
+                .sorted(java.util.Comparator.comparing(FlwTask::getId))
+                .collect(java.util.stream.Collectors.toList());
+        if (mine.isEmpty()) {
+            return vo;
+        }
+        FlwDef def = defRepository.findById(instance.getDefId()).orElse(null);
+        FlowDefModel model = def == null ? null : flowEngine.parseModel(def);
+        for (FlwTask t : mine) {
+            vo.getTasks().add(toByBizTaskVo(t, model));
+        }
+        return vo;
+    }
+
+    private OapiModels.ByBizTaskVo toByBizTaskVo(FlwTask t, FlowDefModel model) {
+        OapiModels.ByBizTaskVo vo = new OapiModels.ByBizTaskVo();
+        vo.setTaskId(t.getId());
+        vo.setNodeId(t.getNodeId());
+        vo.setNodeName(t.getNodeName());
+        vo.setArriveTime(t.getArriveTime() == null ? null : t.getArriveTime().toString());
+        if (model == null) {
+            return vo;
+        }
+        List<FlowDefModel.Edge> outs = model.outEdges(t.getNodeId());
+        if (outs.size() > 1) {
+            for (FlowDefModel.Edge e : outs) {
+                FlowDefModel.Node to = model.node(e.to);
+                OapiModels.ByBizOutletVo outlet = new OapiModels.ByBizOutletVo();
+                outlet.setName(e.name);
+                outlet.setToNodeId(e.to);
+                outlet.setToNodeName(to == null || to.name == null || to.name.isEmpty() ? e.to : to.name);
+                vo.getOutlets().add(outlet);
+            }
+        }
+        return vo;
+    }
+
    /**
     * 同意（oapi，应用内审批）：operatorId 由调用方应用按其登录态传入，本端按任务办理人
     * 复核（{@code task.assigneeId == operatorId}，不满足→业务码拒绝，应用签名不替代"谁在办"）。