} 空=通过。
+ *
+ * fixture 逐字复刻 §0 真实形态:candidateUsers/collection 值是引擎 handler 表达式,内容段花括号全角【】、
+ * XML 属性内引号 {@code "}(DOM 解码回真引号后 validator 再 replace 全角→半角 JSON.parse)。
+ */
+class ModelSemanticValidatorTest {
+
+ private final JdbcTemplate jdbcTemplate = mock(JdbcTemplate.class);
+ private final ModelSemanticValidator validator = new ModelSemanticValidator(jdbcTemplate);
+
+ private static final String CANDIDATE_PREFIX = "${candidateUsersHandler.getCandidateUsers(execution,'";
+ private static final String MULTI_PREFIX = "${multiInstanceUsersHandler.getUsers(execution,'";
+ private static final String SUFFIX = "')}";
+
+ /** formKey 存在性查询恒返回给定 count(一次 stub 覆盖所有 formKey)。 */
+ private void formKeyCount(int count) {
+ when(jdbcTemplate.queryForObject(anyString(), eq(Integer.class), any())).thenReturn(count);
+ }
+
+ /** 办理人/会签内容段:半角 JSON → 花括号全角【】(方括号保持半角,逐字对齐存储态)。 */
+ private static String toStored(String halfWidthJson) {
+ return halfWidthJson.replace("{", "【").replace("}", "】");
+ }
+
+ private static String candidateExpr(String itemsJson) {
+ return CANDIDATE_PREFIX + toStored("{\"items\":" + itemsJson + "}") + SUFFIX;
+ }
+
+ private static String multiExpr(String itemsJson) {
+ return MULTI_PREFIX + toStored("{\"items\":" + itemsJson + "}") + SUFFIX;
+ }
+
+ /** XML 属性值转义(内嵌 JSON 双引号 → ")。 */
+ private static String attr(String s) {
+ return s.replace("&", "&").replace("\"", """).replace("<", "<");
+ }
+
+ private static String bpmn(String processInner) {
+ return ""
+ + ""
+ + "" + processInner + "";
+ }
+
+ private static String userTaskWithCandidate(String name, String candidateExpr) {
+ return "";
+ }
+
+ private static String cosignUserTask(String name, String collectionExpr, String completion) {
+ String cc = completion == null ? ""
+ : "" + attr(completion) + "";
+ return ""
+ + "" + cc
+ + "";
+ }
+
+ // ---------------------------------------------------------------- 通过
+
+ @Test
+ void 合法流程_办理人items非空白名单_formKey存在_预设完成条件_零错误() {
+ formKeyCount(1);
+ String xml = bpmn(
+ ""
+ + cosignUserTask("会签", multiExpr("[{\"type\":\"depart\",\"content\":\"d1\"}]"),
+ "${nrOfCompletedInstances/nrOfInstances==1}"));
+
+ assertThat(validator.validate(xml)).isEmpty();
+ }
+
+ @Test
+ void 裸userTask无办理人无formKey_不属本校验器职责_零错误() {
+ String xml = bpmn("");
+ assertThat(validator.validate(xml)).isEmpty();
+ // 无 formKey → 不查库
+ verify(jdbcTemplate, never()).queryForObject(anyString(), eq(Integer.class), any());
+ }
+
+ @Test
+ void 非handler裸候选值_非EIP4codec产物_放行不校验JSON() {
+ // 直接写 ${someVar} 等裸表达式:非 EIP4 办理人 handler 形态,不套 JSON 白名单(避免误拒合法 Flowable 裸值)
+ String xml = bpmn("");
+ assertThat(validator.validate(xml)).isEmpty();
+ }
+
+ // ---------------------------------------------------------------- 办理人 JSON 错误
+
+ @Test
+ void 办理人items为空数组_error() {
+ String xml = bpmn(userTaskWithCandidate("空办理人", candidateExpr("[]")));
+ List errors = validator.validate(xml);
+ assertThat(errors).hasSize(1);
+ assertThat(errors.get(0)).contains("空办理人").contains("为空");
+ }
+
+ @Test
+ void 办理人type非白名单_error() {
+ String xml = bpmn(userTaskWithCandidate("坏type",
+ candidateExpr("[{\"type\":\"bogusType\",\"content\":\"x\"}]")));
+ List errors = validator.validate(xml);
+ assertThat(errors).hasSize(1);
+ assertThat(errors.get(0)).contains("坏type").contains("bogusType");
+ }
+
+ @Test
+ void 办理人JSON无法解析_error() {
+ // 内容段坏 JSON(缺闭合)——全角还原后仍非法
+ String bad = CANDIDATE_PREFIX + toStored("{\"items\":[{\"type\":") + SUFFIX;
+ String xml = bpmn("");
+ List errors = validator.validate(xml);
+ assertThat(errors).hasSize(1);
+ assertThat(errors.get(0)).contains("坏JSON").contains("JSON");
+ }
+
+ @Test
+ void 办理人多个type_逐项报非法() {
+ String xml = bpmn(userTaskWithCandidate("多项",
+ candidateExpr("[{\"type\":\"user\",\"content\":\"a\"},"
+ + "{\"type\":\"bad1\",\"content\":\"b\"},{\"type\":\"bad2\",\"content\":\"c\"}]")));
+ List errors = validator.validate(xml);
+ assertThat(errors).hasSize(2);
+ assertThat(errors).anyMatch(e -> e.contains("bad1")).anyMatch(e -> e.contains("bad2"));
+ }
+
+ // ---------------------------------------------------------------- 会签 collection + 完成条件
+
+ @Test
+ void 会签collection的items为空_error() {
+ formKeyCount(1);
+ String xml = bpmn(cosignUserTask("空会签", multiExpr("[]"),
+ "${nrOfCompletedInstances/nrOfInstances==1}"));
+ List errors = validator.validate(xml);
+ assertThat(errors).hasSize(1);
+ assertThat(errors.get(0)).contains("空会签").contains("为空");
+ }
+
+ @Test
+ void 会签自定义完成条件_不阻断_零错误() {
+ // T2.4 保留自定义完成条件态:非三预设的合法表达式必须放行(别把存量自定义条件拒了)
+ String xml = bpmn(cosignUserTask("过六成会签",
+ multiExpr("[{\"type\":\"user\",\"content\":\"u1\"}]"),
+ "${nrOfCompletedInstances/nrOfInstances>0.6}"));
+ assertThat(validator.validate(xml)).isEmpty();
+ }
+
+ @Test
+ void 会签过半预设_不阻断_零错误() {
+ String xml = bpmn(cosignUserTask("过半会签",
+ multiExpr("[{\"type\":\"user\",\"content\":\"u1\"}]"),
+ "${nrOfCompletedInstances/nrOfInstances>0.5}"));
+ assertThat(validator.validate(xml)).isEmpty();
+ }
+
+ @Test
+ void 会签指定数预设_不阻断_零错误() {
+ String xml = bpmn(cosignUserTask("三票会签",
+ multiExpr("[{\"type\":\"user\",\"content\":\"u1\"}]"),
+ "${nrOfCompletedInstances>=3}"));
+ assertThat(validator.validate(xml)).isEmpty();
+ }
+
+ @Test
+ void 会签完成条件空白_error() {
+ String xml = bpmn(cosignUserTask("空条件会签",
+ multiExpr("[{\"type\":\"user\",\"content\":\"u1\"}]"), " "));
+ List errors = validator.validate(xml);
+ assertThat(errors).hasSize(1);
+ assertThat(errors.get(0)).contains("空条件会签").contains("完成条件");
+ }
+
+ // ---------------------------------------------------------------- formKey 存在性
+
+ @Test
+ void formKey不存在于模板库_error() {
+ formKeyCount(0);
+ String xml = bpmn("");
+ List errors = validator.validate(xml);
+ assertThat(errors).hasSize(1);
+ assertThat(errors.get(0)).contains("带表单").contains("ghost-uuid").contains("view_wftemplate");
+ }
+
+ @Test
+ void formKey读库异常_降级放行不阻断部署() {
+ when(jdbcTemplate.queryForObject(anyString(), eq(Integer.class), any()))
+ .thenThrow(new DataAccessResourceFailureException("db down"));
+ String xml = bpmn("");
+ // 读库抖动不因基础设施问题阻断发布(全站降级惯例),该项引用完整性检查跳过
+ assertThat(validator.validate(xml)).isEmpty();
+ }
+
+ // ---------------------------------------------------------------- XML 层防御
+
+ @Test
+ void 坏XML_error不抛() {
+ List errors = validator.validate("");
+ assertThat(errors).isNotEmpty();
+ assertThat(errors.get(0)).contains("解析");
+ }
+
+ @Test
+ void 含DOCTYPE_XXE防御_error() {
+ String evil = "]>"
+ + "";
+ List errors = validator.validate(evil);
+ assertThat(errors).isNotEmpty();
+ }
+
+ @Test
+ void 空XML_error() {
+ assertThat(validator.validate(" ")).isNotEmpty();
+ assertThat(validator.validate(null)).isNotEmpty();
+ }
+}
diff --git a/platform-flow-gateway/src/test/java/com/eip4/platform/flowgateway/ProcessModelerControllerTest.java b/platform-flow-gateway/src/test/java/com/eip4/platform/flowgateway/ProcessModelerControllerTest.java
index 766d167..92d8aa3 100644
--- a/platform-flow-gateway/src/test/java/com/eip4/platform/flowgateway/ProcessModelerControllerTest.java
+++ b/platform-flow-gateway/src/test/java/com/eip4/platform/flowgateway/ProcessModelerControllerTest.java
@@ -32,6 +32,8 @@ import org.springframework.web.method.support.HandlerMethodArgumentResolver;
import org.springframework.web.method.support.ModelAndViewContainer;
import com.eip4.platform.auth.security.AuthPrincipal;
+import com.eip4.platform.flowgateway.aggregate.FlowDeployAuditService;
+import com.eip4.platform.flowgateway.aggregate.ModelSemanticValidator;
import com.eip4.platform.flowgateway.aggregate.WfTemplatePickerService;
import com.eip4.platform.flowgateway.client.FlowRemoteException;
import com.eip4.platform.flowgateway.client.FlowServiceUnavailableException;
@@ -47,8 +49,10 @@ class ProcessModelerControllerTest {
private final FlowableClient flowableClient = mock(FlowableClient.class);
private final WfTemplatePickerService wfTemplatePickerService = mock(WfTemplatePickerService.class);
- private final ProcessModelerController controller =
- new ProcessModelerController(flowableClient, wfTemplatePickerService);
+ private final ModelSemanticValidator semanticValidator = mock(ModelSemanticValidator.class);
+ private final FlowDeployAuditService deployAuditService = mock(FlowDeployAuditService.class);
+ private final ProcessModelerController controller = new ProcessModelerController(
+ flowableClient, wfTemplatePickerService, semanticValidator, deployAuditService);
/** 真实形态:中文 key + 冒号分隔的 procDefId。 */
private static final String CN_PROCDEF = "总包合同交底:3:abc123";
@@ -368,4 +372,104 @@ class ProcessModelerControllerTest {
// 路由匹配 PUT 谓词 + {id} 绑定到 "m1" 交给控制器
verify(flowableClient).updateModel(eq("m1"), any());
}
+
+ // ---- 发布门(T3.2):超管门 → 语义校验 → 转发部署 → 审计 INSERT。语义 fail 零转发零审计;非超管零触达。----
+
+ @Test
+ void 发布_超管语义通过_转发部署并写审计_operator为userId() {
+ when(flowableClient.getModel("m1"))
+ .thenReturn(Map.of("found", true, "bpmnXml", ""));
+ when(semanticValidator.validate("")).thenReturn(List.of());
+ Map deployed = Map.of("status", 0, "deploymentId", "dep-9",
+ "processKey", "总包合同交底", "newVersion", 4);
+ when(flowableClient.deployModel("m1")).thenReturn(deployed);
+
+ ResponseEntity