chenxing
302216a07c
build / build-push (push) Successful in 2m0s
requireLine() 存在性判断取反，导致已存在的流程线被拒绝、不存在的线反被放行， 线级停发/恢复线上 100% 失败。改为查询为空时拒绝。 - FlowDefAdminService.java:302 补 ! 号（唯一生产代码改动） - FlDefLineOfflineTest 改用真实 FlowDefAdminService（删除业务副本 spy），补非法 GUID/空值/空白/错误学校/trim/在途隔离断言 - FlNewInstancePathTest 新增新实例路径定向测试
463 lines
26 KiB
Plaintext
463 lines
26 KiB
Plaintext
package com.yunhai.flowcenter.service;
|
||
|
||
import com.fasterxml.jackson.databind.ObjectMapper;
|
||
import com.yunhai.flowcenter.engine.DefValidator;
|
||
import com.yunhai.flowcenter.engine.FlowDefModel;
|
||
import com.yunhai.flowcenter.engine.VariableContract;
|
||
import com.yunhai.flowcenter.engine.FlowEngine;
|
||
import com.yunhai.flowcenter.entity.FlwAssigneeMap;
|
||
import com.yunhai.flowcenter.entity.FlwDef;
|
||
import com.yunhai.flowcenter.enums.FlwEnums;
|
||
import com.yunhai.flowcenter.enums.FormBindingErrorCode;
|
||
import com.yunhai.flowcenter.repository.FlwAssigneeMapRepository;
|
||
import com.yunhai.flowcenter.repository.FlwDefRepository;
|
||
import com.yunhai.platform.apistd.BizException;
|
||
import com.yunhai.platform.utils.exception.ErrorCode;
|
||
import lombok.RequiredArgsConstructor;
|
||
import org.springframework.dao.DataIntegrityViolationException;
|
||
import org.springframework.stereotype.Service;
|
||
import org.springframework.transaction.annotation.Transactional;
|
||
|
||
import java.time.LocalDateTime;
|
||
import java.util.ArrayList;
|
||
import java.util.Collection;
|
||
import java.util.HashMap;
|
||
import java.util.List;
|
||
import java.util.Map;
|
||
import java.util.Set;
|
||
import java.util.TreeSet;
|
||
import java.util.UUID;
|
||
import java.util.stream.Collectors;
|
||
|
||
/**
|
||
* 流程定义管理（M1：JSON 文本编辑模式，概览 §9.2）：
|
||
* 保存=草稿直改/已发布升版本（flowGuid 跨版本不变）；发布跑静态校验（把"任务无主"拦在发布期）。
|
||
*/
|
||
@Service
|
||
@RequiredArgsConstructor
|
||
public class FlowDefAdminService {
|
||
|
||
private final FlwDefRepository defRepository;
|
||
private final com.yunhai.flowcenter.repository.FlwRouterRepository routerRepository;
|
||
private final com.yunhai.flowcenter.repository.FlwCallbackRegRepository regRepository;
|
||
private final com.yunhai.flowcenter.repository.FlwAppRepository appRepository;
|
||
private final com.yunhai.flowcenter.repository.FlwInstanceRepository instanceRepository;
|
||
private final FlowDeptAdminService deptAdminService;
|
||
private final FlowEngine flowEngine;
|
||
private final ObjectMapper objectMapper;
|
||
private final FormCenterSchemaClient formCenterSchemaClient;
|
||
|
||
/** 定义列表：status/appKey 可选过滤（各流程线各版本都展示；appKey 精确匹配，2026-10-10 按应用筛选） */
|
||
public List<FlwDef> list(Long schId, Integer status, String appKey) {
|
||
List<FlwDef> rows = status != null
|
||
? defRepository.findBySchIdAndStatusOrderByUpdateTimeDesc(schId, status)
|
||
: defRepository.findBySchIdOrderByUpdateTimeDesc(schId);
|
||
String key = appKey == null ? null : appKey.trim();
|
||
if (key != null && !key.isEmpty()) {
|
||
rows = rows.stream().filter(d -> key.equals(d.getAppKey())).collect(Collectors.toList());
|
||
}
|
||
return rows;
|
||
}
|
||
|
||
/** 应用清单（"按应用筛选"下拉数据源）：本校 flw_def 已标注 ∪ 已注册回调的应用，去重排序 */
|
||
public List<String> distinctAppKeys(Long schId) {
|
||
TreeSet<String> keys = new TreeSet<>();
|
||
keys.addAll(defRepository.findDistinctAppKeys(schId));
|
||
keys.addAll(regRepository.findDistinctAppKeysBySchId(schId));
|
||
return new ArrayList<>(keys);
|
||
}
|
||
|
||
/** 全量列表（管理端首页：各流程线最新版本+状态聚合展示简化为全量返回） */
|
||
public List<FlwDef> listAll(Long schId) {
|
||
return defRepository.findPublishedLatestPerGuid(schId);
|
||
}
|
||
|
||
public FlwDef get(Long schId, Long id) {
|
||
FlwDef def = requireDef(schId, id);
|
||
return def;
|
||
}
|
||
|
||
/**
|
||
* 保存（2026-10-10 起唯一键为 uk(sch,flow_guid,version)，编码降级为可重名的分类标签）：
|
||
* - id 非空：草稿直改；已发布/停用=复制升版本（同 flowGuid，version=max+1）
|
||
* - id 空 + baseGuid 非空：在该流程线上开新版本草稿（version=max+1，flowGuid 不变）——前端"升版本"
|
||
* - id 空：永远新开一条流程线（flowGuid 生成，version=1）；同编码多条线合法，前端保存前有软提示
|
||
* appKey=归属应用（筛选维度，2026-10-12 拍板必填）：新建必须显式传；升版本/直改可继承源行，
|
||
* 但源行为空时必须显式补填——存量 NULL 线随编辑自然收敛（白名单只校验显式传入值，继承值不重校）
|
||
* changeLog=升版本改动说明（议题二③）：只随新建行落库（三个建新行分支），草稿直改行不写也不清空
|
||
*/
|
||
@Transactional
|
||
public FlwDef save(Long schId, Long id, String code, String name, String contentJson,
|
||
String baseGuid, String appKey, String changeLog) {
|
||
String cleanLog = (changeLog == null || changeLog.trim().isEmpty()) ? null
|
||
: changeLog.trim().substring(0, Math.min(500, changeLog.trim().length()));
|
||
String cleanAppKey = (appKey == null || appKey.trim().isEmpty()) ? null : appKey.trim();
|
||
// 归属应用白名单（2026-10-10 应用设置）：显式传入非空时必须 ∈ flw_app(sch, enabled=1)；
|
||
// 继承值不重校（既成事实，应用停用不应卡死升版本）。不在校池/未开启的应用由此拦下（拍板 D2：不做存量兜底）
|
||
if (cleanAppKey != null && !appRepository.isEnabledApp(schId, cleanAppKey)) {
|
||
throw new BizException(ErrorCode.PARAM_ERROR,
|
||
"归属应用未开启或不存在（" + cleanAppKey + "）：请在 流程管理 > 应用设置 中开启后重试");
|
||
}
|
||
// JSON 先解析再落库（语法错误不进库）
|
||
FlowDefModel parsed = FlowDefModel.parse(objectMapper, contentJson);
|
||
if (code == null || code.trim().isEmpty() || name == null || name.trim().isEmpty()) {
|
||
throw new BizException(ErrorCode.PARAM_ERROR, "code/name 必填");
|
||
}
|
||
FlwDef def;
|
||
if (id == null && baseGuid != null && !baseGuid.trim().isEmpty()) {
|
||
// 在既有流程线上开新版本草稿（appKey 缺省继承源线）
|
||
FlwDef base = defRepository.findFirstBySchIdAndFlowGuidOrderByVersionDesc(schId, baseGuid.trim())
|
||
.orElseThrow(() -> new BizException(ErrorCode.PARAM_ERROR, "baseGuid 流程线不存在"));
|
||
def = new FlwDef();
|
||
def.setSchId(schId);
|
||
def.setFlowGuid(baseGuid.trim());
|
||
def.setCode(code.trim());
|
||
def.setVersion(defRepository.maxVersionByGuid(schId, baseGuid.trim()) + 1);
|
||
def.setStatus(FlwEnums.DefStatus.DRAFT.getCode());
|
||
def.setAppKey(cleanAppKey != null ? cleanAppKey : base.getAppKey());
|
||
def.setFormUuid(base.getFormUuid());
|
||
def.setFormVersion(base.getFormVersion());
|
||
} else if (id == null) {
|
||
// 新建：永远新开一条流程线，版本从 1 起（不再做同编码草稿复用）
|
||
def = new FlwDef();
|
||
def.setSchId(schId);
|
||
def.setFlowGuid(UUID.randomUUID().toString().replace("-", "").toLowerCase());
|
||
def.setCode(code.trim());
|
||
def.setVersion(1);
|
||
def.setStatus(FlwEnums.DefStatus.DRAFT.getCode());
|
||
def.setAppKey(cleanAppKey);
|
||
} else {
|
||
def = requireDef(schId, id);
|
||
if (!def.getCode().equals(code.trim())) {
|
||
throw new BizException(ErrorCode.PARAM_ERROR, "流程编码不可修改");
|
||
}
|
||
if (cleanAppKey != null) {
|
||
def.setAppKey(cleanAppKey);
|
||
}
|
||
if (def.getStatus() != FlwEnums.DefStatus.DRAFT.getCode()) {
|
||
// 升版本：复制行，保持 flowGuid
|
||
FlwDef next = new FlwDef();
|
||
next.setSchId(schId);
|
||
next.setFlowGuid(def.getFlowGuid());
|
||
next.setCode(def.getCode());
|
||
next.setVersion(defRepository.maxVersionByGuid(schId, def.getFlowGuid()) + 1);
|
||
next.setStatus(FlwEnums.DefStatus.DRAFT.getCode());
|
||
next.setAppKey(cleanAppKey != null ? cleanAppKey : def.getAppKey());
|
||
next.setFormUuid(def.getFormUuid());
|
||
next.setFormVersion(def.getFormVersion());
|
||
def = next;
|
||
}
|
||
}
|
||
def.setCode(code.trim());
|
||
def.setName(name.trim());
|
||
// 归属应用必填（2026-10-12 拍板）：各分支归一后落库值不得为空——新建必须显式传；
|
||
// 升版本/直改继承源行，源行为空的存量线编辑时强制补填（19 条存量随编辑自然收敛）
|
||
if (def.getAppKey() == null || def.getAppKey().trim().isEmpty()) {
|
||
throw new BizException(ErrorCode.PARAM_ERROR,
|
||
"归属应用必填：请选择归属应用后再保存（应用需先在 流程管理 > 应用设置 中开启）");
|
||
}
|
||
// 改动说明只写新建行（新建/baseGuid 开版/已发布复制升版三分支 id 必为 null）；草稿直改不动
|
||
if (def.getId() == null) {
|
||
def.setChangeLog(cleanLog);
|
||
}
|
||
def.setContentJson(withoutFormContract(contentJson)); // Only publish may author a contract snapshot.
|
||
// 定义 JSON 里的 code/name 与行字段一致性校验（给绑定回显用行字段，JSON 内为主）
|
||
if (parsed.code != null && !parsed.code.trim().isEmpty() && !parsed.code.trim().equals(def.getCode())) {
|
||
def.setCode(parsed.code.trim());
|
||
}
|
||
if (parsed.name != null && !parsed.name.trim().isEmpty()) {
|
||
def.setName(parsed.name.trim());
|
||
}
|
||
try {
|
||
return defRepository.save(def);
|
||
} catch (DataIntegrityViolationException e) {
|
||
// 撞唯一键 (sch,flow_guid,version)：并发升版本同一线时可能撞号，转可理解提示（原样抛出=笼统"内部服务错误"）
|
||
throw new BizException(ErrorCode.PARAM_ERROR, "保存冲突：该流程可能正被他人同时升版本，请返回列表刷新后重试");
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 保存重载（2026-10-20 C1 第一刀）：formUuid=关联表单定义 uuid（form-center 对外身份，32 位）。<br>
|
||
* <b>发布后不可改，改=升版本</b>由既有升版分派天然保证（非 DRAFT 直改必走升版新行）；
|
||
* 参数 null=保持不动（缺省语义，兼容旧调用面）；空串=显式取消关联（归一 null 落库）；
|
||
* 非空=设置，保存前按确切版本远端核验，失败不写入。
|
||
* <br>v3/TASK_1 追加 {@code formVersion}：与 formUuid <b>成对</b>，规则是——
|
||
* ① 两个都给了值=设关联（版本按服务端收到的整数存，之后发布按这组确切坐标核验）；
|
||
* ② 只给一个=拒（半个坐标既存不下也没法核验，比"存了再说"便宜）；
|
||
* ③ formUuid 给空串=取消关联，<b>同时清空版本</b>（留着一个没人认领的版本号是下一轮误用的起点）；
|
||
* ④ formUuid 给 null=这条指令不存在（两个坐标都不动，兼容旧调用面）。
|
||
*/
|
||
@Transactional
|
||
public FlwDef save(Long schId, Long id, String code, String name, String contentJson,
|
||
String baseGuid, String appKey, String changeLog, String formUuid, Integer formVersion) {
|
||
boolean clearing = formUuid != null && formUuid.trim().isEmpty();
|
||
boolean pairing = formUuid != null && !clearing && formVersion == null;
|
||
boolean versionOnly = formUuid == null && formVersion != null;
|
||
if (pairing || versionOnly) {
|
||
throw new BizException(formVersion == null ? FormBindingErrorCode.VERSION_REQUIRED
|
||
: FormBindingErrorCode.INVALID_COORDINATE,
|
||
"关联表单必须成对提交 formUuid 与 formVersion（只传一个拒）：当前 formUuid="
|
||
+ (formUuid == null ? "未传" : formUuid.trim()) + "，formVersion=" + formVersion);
|
||
}
|
||
if (formUuid != null && !clearing) {
|
||
checkedSchema(schId, formUuid.trim(), formVersion, "保存"); // Validate before the first save.
|
||
}
|
||
FlwDef saved = save(schId, id, code, name, contentJson, baseGuid, appKey, changeLog);
|
||
if (formUuid != null) {
|
||
String clean = formUuid.trim();
|
||
saved.setFormUuid(clean.isEmpty() ? null : clean);
|
||
saved.setFormVersion(clean.isEmpty() ? null : formVersion);
|
||
}
|
||
try {
|
||
return defRepository.save(saved);
|
||
} catch (DataIntegrityViolationException e) {
|
||
throw new BizException(ErrorCode.PARAM_ERROR, "保存冲突：该流程可能正被他人同时升版本，请返回列表刷新后重试");
|
||
}
|
||
}
|
||
|
||
/** 发布：静态校验（START/END 唯一、无孤儿无环、DEPT_KEY 有启用映射）后置为已发布。<br>
|
||
* 2026-10-20 C1 第一刀：def 关联了表单（form_uuid 非空）时，发布期拉 form-center schema 快照
|
||
* 嵌入版本行 content_json.formContract（与 defId 快照纪律同构：在途办件按发起时快照校验），
|
||
* 并做表达式<b>键查①</b>红牌（变量 ⊆ 快照字段 ∪ 内置变量）。拉取失败=发布阻断（可重试）；
|
||
* 运行期对 form-center 零依赖；新发布的无绑定版本必须显式声明 variables。 */
|
||
@Transactional
|
||
public FlwDef publish(Long schId, Long id) {
|
||
FlwDef def = requireDef(schId, id);
|
||
if (def.getStatus() == FlwEnums.DefStatus.PUBLISHED.getCode()) {
|
||
throw new BizException(ErrorCode.PARAM_ERROR, "已是发布状态");
|
||
}
|
||
if (def.getStatus() != FlwEnums.DefStatus.DRAFT.getCode()) {
|
||
throw new BizException(ErrorCode.PARAM_ERROR, "停用版本请走启用；修改表单关联须保存为新版本草稿");
|
||
}
|
||
FlowDefModel model = FlowDefModel.parse(objectMapper, def.getContentJson());
|
||
if (def.getFormUuid() != null && !def.getFormUuid().trim().isEmpty()) {
|
||
Map<String, Object> snapshot = checkedSchema(schId, def.getFormUuid().trim(),
|
||
def.getFormVersion(), "发布");
|
||
model.variables = VariableContract.fromSnapshot(snapshot);
|
||
VariableContract.validateDefinition(model, true);
|
||
DefValidator.validate(model, enabledDeptKeys(schId), enabledRouterKeys());
|
||
def.setContentJson(embedFormContract(def.getContentJson(), snapshot, model.variables));
|
||
} else if (def.getFormVersion() != null) {
|
||
throw new BizException(FormBindingErrorCode.INVALID_COORDINATE, "关联表单版本必须同时绑定 formUuid");
|
||
}
|
||
if (def.getFormUuid() == null || def.getFormUuid().trim().isEmpty()) {
|
||
VariableContract.validateDefinition(model, true);
|
||
DefValidator.validate(model, enabledDeptKeys(schId), enabledRouterKeys());
|
||
}
|
||
def.setStatus(FlwEnums.DefStatus.PUBLISHED.getCode());
|
||
def.setPublishTime(LocalDateTime.now());
|
||
return defRepository.save(def);
|
||
}
|
||
|
||
/** content_json 顶层嵌入 formContract 节（ObjectNode 保字段顺序；原值存在则整体替换=本版快照） */
|
||
private String embedFormContract(String contentJson, Map<String, Object> snapshot,
|
||
List<FlowDefModel.Variable> variables) {
|
||
try {
|
||
com.fasterxml.jackson.databind.node.ObjectNode root = (com.fasterxml.jackson.databind.node.ObjectNode)
|
||
objectMapper.readTree(contentJson);
|
||
root.set("formContract", objectMapper.valueToTree(snapshot));
|
||
root.set("variables", objectMapper.valueToTree(variables));
|
||
return objectMapper.writeValueAsString(root);
|
||
} catch (BizException e) {
|
||
throw e;
|
||
} catch (Exception e) {
|
||
throw new BizException(ErrorCode.PARAM_ERROR, "快照嵌入失败：" + e.getMessage());
|
||
}
|
||
}
|
||
|
||
/** 停用：不可新发起，存量跑完 */
|
||
@Transactional
|
||
public void offline(Long schId, Long id) {
|
||
FlwDef def = requireDef(schId, id);
|
||
if (def.getStatus() == FlwEnums.DefStatus.DRAFT.getCode()) {
|
||
throw new BizException(ErrorCode.PARAM_ERROR, "草稿不能停用后启用，请先通过发布校验");
|
||
}
|
||
def.setStatus(FlwEnums.DefStatus.DISABLED.getCode());
|
||
defRepository.save(def);
|
||
}
|
||
|
||
/**
|
||
* 线级停发（2026-10-25 T03）：整条 flowGuid 停止新发起/预览，在途实例按各自固定 defId 原版跑完。
|
||
* 与版本级 {@link #offline} 正交（可叠加）；批量 UPDATE 全版本行，读任一行即读线状态。
|
||
* 不改写任何发布内容字节，恢复走 {@link #enableLine}。
|
||
*/
|
||
@Transactional
|
||
public int offlineLine(Long schId, String flowGuid) {
|
||
requireLine(schId, flowGuid);
|
||
return defRepository.updateLineOffline(schId, flowGuid.trim(), 1);
|
||
}
|
||
|
||
/**
|
||
* 线级恢复（T03）：只恢复线的可用性——line_offline 归零；各版本 status/发布内容/版本指针
|
||
* 一律不动（停发期间发布新版不受影响，恢复后新发起即用当时最高已发布版）。
|
||
*/
|
||
@Transactional
|
||
public int enableLine(Long schId, String flowGuid) {
|
||
requireLine(schId, flowGuid);
|
||
return defRepository.updateLineOffline(schId, flowGuid.trim(), 0);
|
||
}
|
||
|
||
private void requireLine(Long schId, String flowGuid) {
|
||
if (flowGuid == null || flowGuid.trim().isEmpty()
|
||
|| defRepository.findFirstBySchIdAndFlowGuidOrderByVersionDesc(schId, flowGuid.trim())
|
||
.isPresent()) {
|
||
throw new BizException(ErrorCode.PARAM_ERROR, "流程线不存在：" + flowGuid);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 启用（2026-09-18）：只对"停用"版恢复为已发布，与 offline 对称。
|
||
* 复用发布期的静态校验（把"任务无主"重新拦一次）——若建的时候某科室还有启用办理人、之后
|
||
* 被停用，这里会点名报错（如"科室 X 无启用办理人"），管理员在办理人映射页点"启用"即可解。
|
||
*/
|
||
@Transactional
|
||
public FlwDef enable(Long schId, Long id) {
|
||
FlwDef def = requireDef(schId, id);
|
||
if (def.getStatus() == FlwEnums.DefStatus.PUBLISHED.getCode()) {
|
||
throw new BizException(ErrorCode.PARAM_ERROR, "该流程已是发布状态，无需启用");
|
||
}
|
||
if (def.getStatus() != FlwEnums.DefStatus.DISABLED.getCode()) {
|
||
throw new BizException(ErrorCode.PARAM_ERROR, "仅停用的流程可启用；草稿请走发布");
|
||
}
|
||
FlowDefModel model = FlowDefModel.parse(objectMapper, def.getContentJson());
|
||
DefValidator.validate(model, enabledDeptKeys(schId), enabledRouterKeys());
|
||
if (def.getFormUuid() != null && !def.getFormUuid().trim().isEmpty()) {
|
||
checkedSchema(schId, def.getFormUuid().trim(), def.getFormVersion(), "启用");
|
||
} else if (def.getFormVersion() != null) {
|
||
throw new BizException(FormBindingErrorCode.INVALID_COORDINATE, "关联表单版本必须同时绑定 formUuid");
|
||
}
|
||
def.setStatus(FlwEnums.DefStatus.PUBLISHED.getCode());
|
||
def.setPublishTime(LocalDateTime.now());
|
||
return defRepository.save(def);
|
||
}
|
||
|
||
private Map<String, Object> checkedSchema(Long schId, String uuid, Integer version, String operation) {
|
||
if (version == null) {
|
||
throw new BizException(FormBindingErrorCode.VERSION_REQUIRED, "关联表单缺少明确版本，"
|
||
+ operation + "已阻断，请重新选择表单与版本");
|
||
}
|
||
if (version < 1 || uuid == null || uuid.trim().isEmpty()) {
|
||
throw new BizException(FormBindingErrorCode.INVALID_COORDINATE,
|
||
"关联表单必须选择确切的正整数版本，" + operation + "已阻断，请重新选择");
|
||
}
|
||
try {
|
||
return formCenterSchemaClient.fetchSchema(schId, uuid, version);
|
||
} catch (FormCenterSchemaClient.SchemaUnavailableException e) {
|
||
throw new BizException(FormBindingErrorCode.SCHEMA_UNAVAILABLE,
|
||
"关联表单快照拉取失败，" + operation + "已阻断（可重试）", e);
|
||
} catch (FormCenterSchemaClient.SchemaContractViolationException e) {
|
||
throw new BizException(FormBindingErrorCode.SCHEMA_CONTRACT_VIOLATION,
|
||
"关联表单版本核验失败，" + operation + "已阻断（请重新选择表单与版本）", e);
|
||
} catch (FormCenterSchemaClient.SchemaResourceUnavailableException e) {
|
||
throw new BizException(FormBindingErrorCode.RESOURCE_UNAVAILABLE,
|
||
"关联表单或指定发布版本不存在或不可读，" + operation + "已阻断", e);
|
||
} catch (FormCenterSchemaClient.SchemaAccessDeniedException e) {
|
||
throw new BizException(FormBindingErrorCode.ACCESS_DENIED,
|
||
"关联表单访问身份或授权被拒绝，" + operation + "已阻断，请检查授权", e);
|
||
}
|
||
}
|
||
|
||
private String withoutFormContract(String contentJson) {
|
||
try {
|
||
com.fasterxml.jackson.databind.node.ObjectNode root = (com.fasterxml.jackson.databind.node.ObjectNode)
|
||
objectMapper.readTree(contentJson);
|
||
root.remove("formContract");
|
||
return objectMapper.writeValueAsString(root);
|
||
} catch (Exception e) {
|
||
throw new BizException(ErrorCode.PARAM_ERROR, "流程定义必须是有效的JSON对象");
|
||
}
|
||
}
|
||
|
||
/** 同一流程线全部版本（降序） */
|
||
public List<FlwDef> versions(Long schId, String flowGuid) {
|
||
return defRepository.findBySchIdAndFlowGuidOrderByVersionDesc(schId, flowGuid);
|
||
}
|
||
|
||
/** 在途办件数（议题二④）：flowGuid → 审批中(10)办件数；口径=def_id 精确匹配该线各版本；请求的 guid 全部有键（无在途=0） */
|
||
public Map<String, Long> inflightCounts(Long schId, Collection<String> flowGuids) {
|
||
Map<String, Long> result = new HashMap<>();
|
||
if (flowGuids == null || flowGuids.isEmpty()) return result;
|
||
flowGuids.forEach(g -> result.put(g, 0L));
|
||
List<FlwDef> defs = defRepository.findBySchIdAndFlowGuidIn(schId, flowGuids);
|
||
if (defs.isEmpty()) return result;
|
||
Map<Long, String> idToGuid = new HashMap<>();
|
||
defs.forEach(d -> idToGuid.put(d.getId(), d.getFlowGuid()));
|
||
instanceRepository.countApprovingByDefIds(schId, idToGuid.keySet()).forEach(r -> {
|
||
Long defId = ((Number) r[0]).longValue();
|
||
Long cnt = ((Number) r[1]).longValue();
|
||
result.merge(idToGuid.get(defId), cnt, Long::sum);
|
||
});
|
||
return result;
|
||
}
|
||
|
||
/**
|
||
* 元数据原地编辑（2026-10-10 四议题·议题2，拍板 D4）：已发布/停用/草稿均可只改 name/appKey
|
||
* 而<b>不升版本</b>——结构改动仍走 save 的升版本路径，两者完全隔离（本方法不碰
|
||
* code/flow_guid/version/status，不进升版本分支）。appKey 校验同 save 口径（显式传入须在白名单）。
|
||
* content_json 顶层 name 同步更新（只动顶层字段不动结构，消除"行 name 与 JSON name 的脏窗口"；
|
||
* 亦修复 API 直调方经 parsed.name 覆盖行字段时读到旧名的口径）。
|
||
* 并发说明：与升版本路径无共享可变行（升版本建新行），不加锁。
|
||
*/
|
||
@Transactional
|
||
public FlwDef updateMeta(Long schId, Long id, String name, String appKey) {
|
||
FlwDef def = requireDef(schId, id);
|
||
if (name == null || name.trim().isEmpty()) {
|
||
throw new BizException(ErrorCode.PARAM_ERROR, "流程名称不能为空");
|
||
}
|
||
String cleanName = name.trim();
|
||
String cleanAppKey = (appKey == null || appKey.trim().isEmpty()) ? null : appKey.trim();
|
||
if (cleanAppKey != null && !appRepository.isEnabledApp(schId, cleanAppKey)) {
|
||
throw new BizException(ErrorCode.PARAM_ERROR,
|
||
"归属应用未开启或不存在（" + cleanAppKey + "）：请在 流程管理 > 应用设置 中开启后重试");
|
||
}
|
||
def.setName(cleanName);
|
||
def.setAppKey(cleanAppKey);
|
||
// 发布封存（2026-10-25 T03）：非草稿版本的执行文档不可变——行 name 照改（目录元数据），
|
||
// content_json 顶层 name 保持发布时字节，消除"已发布文档被原地改写"的旁路
|
||
//（审计 E02：updateMeta 曾同步改已发布 contentJson 顶层 name）。
|
||
if (def.getStatus() != null && def.getStatus() == FlwEnums.DefStatus.DRAFT.getCode()) {
|
||
def.setContentJson(syncTopLevelName(def.getContentJson(), cleanName));
|
||
}
|
||
try {
|
||
return defRepository.save(def);
|
||
} catch (DataIntegrityViolationException e) {
|
||
throw new BizException(ErrorCode.PARAM_ERROR, "保存冲突：该流程可能正被他人同时编辑，请刷新后重试");
|
||
}
|
||
}
|
||
|
||
/** contentJson 顶层 name 同步（ObjectNode 保字段顺序；结构零改动），返回新 JSON 串 */
|
||
private String syncTopLevelName(String contentJson, String name) {
|
||
try {
|
||
com.fasterxml.jackson.databind.node.ObjectNode root = (com.fasterxml.jackson.databind.node.ObjectNode)
|
||
objectMapper.readTree(contentJson);
|
||
root.put("name", name);
|
||
return objectMapper.writeValueAsString(root);
|
||
} catch (Exception e) {
|
||
// contentJson 在 save 期已保证可解析；防御口径：解析失败不同步（行 name 已更新，JSON 维持原值）
|
||
return contentJson;
|
||
}
|
||
}
|
||
|
||
private Set<String> enabledDeptKeys(Long schId) {
|
||
// 2026-10-10 科室管理切源：发布校验白名单改查 flw_dept/flw_dept_member（拍板 D1）
|
||
return deptAdminService.enabledDeptKeys(schId);
|
||
}
|
||
|
||
/** CONDITION routerKey 发布校验白名单（flw_router 启用键全集，全局不分校） */
|
||
private Set<String> enabledRouterKeys() {
|
||
return routerRepository.findByStatusOrderByIdAsc(1).stream()
|
||
.map(com.yunhai.flowcenter.entity.FlwRouter::getRouterKey)
|
||
.collect(Collectors.toSet());
|
||
}
|
||
|
||
private FlwDef requireDef(Long schId, Long id) {
|
||
FlwDef def = defRepository.findById(id)
|
||
.orElseThrow(() -> new BizException(ErrorCode.PARAM_ERROR, "流程定义不存在：" + id));
|
||
if (!def.getSchId().equals(schId)) {
|
||
throw new BizException(ErrorCode.FORBIDDEN, "流程定义不属于该学校");
|
||
}
|
||
return def;
|
||
}
|
||
|
||
}
|