diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/publish/DeploymentPackage.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/publish/DeploymentPackage.java new file mode 100644 index 0000000..3b0dc23 --- /dev/null +++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/publish/DeploymentPackage.java @@ -0,0 +1,21 @@ +package com.eip4.platform.metadata.publish; + +import java.util.List; +import java.util.Map; + +/** + * Production 人审部署包(建物 3 · DECISION-2)。 + * + *

与 platform-ai 的 {@code AiDeploymentPackage} 同形精简版: + * 不含 taskId/changeSetId/runEvidence(人走五环无 AiTask 上下文),其余字段一致。 + * 恒 requiresHumanApproval=true —— 生产上线走既有人审流程,本包不执行任何生产 SQL。 + */ +public record DeploymentPackage( + String status, + boolean requiresHumanApproval, + long generatedAt, + Map manifest, + List sqlStatements, + List rollbackSqlStatements, + List warnings) { +} diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/publish/DeploymentPackageBuilder.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/publish/DeploymentPackageBuilder.java index cb02c1f..c4b19ec 100644 --- a/platform-metadata/src/main/java/com/eip4/platform/metadata/publish/DeploymentPackageBuilder.java +++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/publish/DeploymentPackageBuilder.java @@ -1,8 +1,111 @@ package com.eip4.platform.metadata.publish; +import java.util.ArrayList; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; + import org.springframework.stereotype.Service; -/** 平台内自包含部署包生成器(Task 13 实现)。 */ +/** + * 平台内自包含 production 部署包生成器(建物 3 · DECISION-2)。 + * + *

不依赖 platform-ai(依赖图:platform-ai → platform-metadata,反向不可)。 + * 从发布编排上下文合成 change-set,产出与 AiDeploymentPackage 同形的 {@link DeploymentPackage}。 + * 产物为 production 人审草稿:manifest + 顺序 SQL(page_schema / serviceflow / menu)+ 对称 rollback。 + * 实体 DDL 因不在此处掌握列定义,以占位 + warning 提示人工补全,恒 requiresHumanApproval=true。 + */ @Service public class DeploymentPackageBuilder { + + /** 发布编排上下文 → 部署包输入。 */ + public record Input( + String entityId, + String tableName, + String templateId, + String menuName, + String menuId, + List flows) { + } + + public DeploymentPackage build(Input in) { + long now = System.currentTimeMillis(); + + Map manifest = new LinkedHashMap<>(); + manifest.put("entityId", in.entityId()); + manifest.put("templateId", in.templateId()); + manifest.put("tableName", in.tableName()); + manifest.put("menuId", in.menuId()); + manifest.put("menuName", in.menuName()); + manifest.put("flowCount", in.flows() == null ? 0 : in.flows().size()); + manifest.put("flows", in.flows() == null ? List.of() : List.copyOf(in.flows())); + manifest.put("generatedAt", now); + manifest.put("source", "design-publish"); + + List sql = new ArrayList<>(); + sql.add("-- [1] 实体 DDL:本平台内 net-new 实体由元数据引擎建表," + + "生产环境请人工从源库导出 CREATE TABLE " + in.tableName() + " 及索引后置入此处。"); + sql.add("-- [2] 标准层页面 schema(唯一真相 PageSchemaWriter.upsertStandard 的等价 SQL):"); + sql.add("-- 生产请用导出的 schema JSON 替换 :schemaJson 占位"); + // 列名严格对齐唯一写口 PageSchemaWriter.upsertStandard: + // (template_id, name, schema_json, schema_etag, version, update_time) + ON CONFLICT(template_id)。 + // sys_page_schema 无 layer/updateby/updatetime 列,勿用(评审 §B.9-6 已核)。 + sql.add("INSERT INTO sys_page_schema(template_id, name, schema_json, schema_etag, version, update_time)" + + " VALUES(" + sqlString(in.templateId()) + ", " + sqlString(in.menuName()) + + ", :schemaJson, :schemaEtag, 1, " + now + ")" + + " ON CONFLICT (template_id) DO UPDATE SET schema_json=EXCLUDED.schema_json," + + " schema_etag=EXCLUDED.schema_etag, version=sys_page_schema.version+1," + + " update_time=EXCLUDED.update_time;"); + sql.add("-- [3] 默认服务流:生产请用导出的 contentxml 替换 :contentxml 占位"); + if (in.flows() != null) { + for (String flow : in.flows()) { + sql.add("INSERT INTO sys_serviceflow(sys_serviceflow_id, displayname, contentxml, entityid)" + + " VALUES(" + sqlString(flow) + ", " + sqlString(flow) + ", :contentxml, " + + sqlString(in.entityId()) + ")" + + " ON CONFLICT (sys_serviceflow_id) DO NOTHING;"); + } + } + sql.add("-- [4] 功能菜单:生产请替换 ${parentMenuId}/${menuRoot} 为目标环境的菜单父节点"); + sql.add("INSERT INTO sys_menu(sys_menu_id, name, parentid, view_templateid, typename, menuroot, seq," + + " isactive, version, createtime, createby, updatetime, updateby)" + + " VALUES(" + sqlString(in.menuId()) + ", " + sqlString(in.menuName()) + + ", ${parentMenuId}, " + sqlString(in.templateId()) + ", '功能菜单', ${menuRoot}, 0," + + " 1, 0, " + now + ", 'DESIGN_PUBLISH', " + now + ", 'DESIGN_PUBLISH')" + + " ON CONFLICT (sys_menu_id) DO NOTHING;"); + + List rollback = new ArrayList<>(); + rollback.add("UPDATE sys_menu SET isactive=0, updatetime=" + now + + ", updateby='DESIGN_PUBLISH_ROLLBACK', version=version+1" + + " WHERE TRIM(view_templateid)=" + sqlString(in.templateId()) + ";"); + rollback.add("DELETE FROM sys_page_schema WHERE template_id=" + sqlString(in.templateId()) + ";"); + if (in.flows() != null && !in.flows().isEmpty()) { + List quoted = new ArrayList<>(); + for (String flow : in.flows()) { + quoted.add(sqlString(flow)); + } + rollback.add("DELETE FROM sys_serviceflow WHERE sys_serviceflow_id IN (" + + String.join(", ", quoted) + ");"); + } + rollback.add("-- 实体 DELETE:人工确认后 DELETE /api/meta/entity/" + in.tableName() + + "(含物理表 DROP),并清理 SYS_ENTITY/SYS_ENTITYATTRIBUTE 元数据。"); + + List warnings = new ArrayList<>(); + warnings.add("实体 DDL 与 schema_json/contentxml 为占位,生产部署前须由人工从本地库导出真实定义置入。"); + warnings.add("sys_menu 的 ${parentMenuId}/${menuRoot} 须替换为生产环境目标菜单父节点。"); + warnings.add("本部署包恒人审:生产上线走既有人工审核流程,平台不自动在生产执行任何 SQL。"); + + return new DeploymentPackage( + "READY_FOR_HUMAN_REVIEW", + true, + now, + manifest, + List.copyOf(sql), + List.copyOf(rollback), + List.copyOf(warnings)); + } + + private static String sqlString(String value) { + String text = value == null ? "" : value; + return "'" + text.replace("'", "''") + "'"; + } } diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/publish/PublishOrchestrator.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/publish/PublishOrchestrator.java index 151751b..2d2fb35 100644 --- a/platform-metadata/src/main/java/com/eip4/platform/metadata/publish/PublishOrchestrator.java +++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/publish/PublishOrchestrator.java @@ -47,6 +47,17 @@ public class PublishOrchestrator { return menuRegistrar.register(templateId, menuName, parentMenuId, operator); } + /** generateDeploymentPackage != false 时生成 production 人审部署包;否则返回 null。 */ + public DeploymentPackage buildDeploymentPackage(String entityId, String tableName, String templateId, + String menuName, String menuId, + List flows, boolean generate) { + if (!generate) { + return null; + } + return deploymentPackageBuilder.build(new DeploymentPackageBuilder.Input( + entityId, tableName, templateId, menuName, menuId, flows)); + } + /** 返回实体当前持久化的流名列表(发布后读 SYS_SERVICEFLOW,经 Task 10 预览服务)。 */ public List flowNames(String entityId) { List out = new ArrayList<>(); diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/web/DesignFeatureController.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/DesignFeatureController.java index 7ffb071..a71ebe8 100644 --- a/platform-metadata/src/main/java/com/eip4/platform/metadata/web/DesignFeatureController.java +++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/DesignFeatureController.java @@ -218,7 +218,23 @@ public class DesignFeatureController { String parentMenuId = body.get("parentMenuId") == null ? null : body.get("parentMenuId").toString().trim(); String menuId = publishOrchestrator.registerMenu(templateId, menuName, parentMenuId, operator); data.put("menuId", menuId); - // deploymentPackage 由 Task 13 补齐 + + boolean generatePkg = !(Boolean.FALSE.equals(body.get("generateDeploymentPackage"))); + @SuppressWarnings("unchecked") + List flowsForPkg = (List) data.get("flows"); + com.eip4.platform.metadata.publish.DeploymentPackage pkg = publishOrchestrator.buildDeploymentPackage( + entityId, tableName, templateId, menuName, menuId, flowsForPkg, generatePkg); + if (pkg != null) { + Map pkgMap = new LinkedHashMap<>(); + pkgMap.put("status", pkg.status()); + pkgMap.put("requiresHumanApproval", pkg.requiresHumanApproval()); + pkgMap.put("generatedAt", pkg.generatedAt()); + pkgMap.put("manifest", pkg.manifest()); + pkgMap.put("sqlStatements", pkg.sqlStatements()); + pkgMap.put("rollbackSqlStatements", pkg.rollbackSqlStatements()); + pkgMap.put("warnings", pkg.warnings()); + data.put("deploymentPackage", pkgMap); + } Map resp = new LinkedHashMap<>(); resp.put("status", 0); resp.put("data", data); diff --git a/platform-metadata/src/test/java/com/eip4/platform/metadata/publish/DeploymentPackageBuilderTest.java b/platform-metadata/src/test/java/com/eip4/platform/metadata/publish/DeploymentPackageBuilderTest.java new file mode 100644 index 0000000..728f56c --- /dev/null +++ b/platform-metadata/src/test/java/com/eip4/platform/metadata/publish/DeploymentPackageBuilderTest.java @@ -0,0 +1,38 @@ +package com.eip4.platform.metadata.publish; + +import static org.assertj.core.api.Assertions.assertThat; + +import java.util.List; + +import org.junit.jupiter.api.Test; + +class DeploymentPackageBuilderTest { + + @Test + void buildProducesManifestRollbackAndRequiresHumanApproval() { + DeploymentPackageBuilder builder = new DeploymentPackageBuilder(); + DeploymentPackageBuilder.Input input = new DeploymentPackageBuilder.Input( + "ENT-1", "DEMO_TBL", "TPL-1", "演示功能", "MENU-1", + List.of("DEMO_TBL_ADD", "DEMO_TBL_UPDATE", "DEMO_TBL_SEARCH", + "DEMO_TBL_DELETE", "DEMO_TBL_LOAD")); + + DeploymentPackage pkg = builder.build(input); + + assertThat(pkg.requiresHumanApproval()).isTrue(); + assertThat(pkg.status()).isEqualTo("READY_FOR_HUMAN_REVIEW"); + assertThat(pkg.manifest()).containsKeys("entityId", "templateId", "tableName", "menuId", "flowCount"); + assertThat(pkg.manifest().get("flowCount")).isEqualTo(5); + // SQL 草稿覆盖四类工件 + assertThat(pkg.sqlStatements()).anyMatch(s -> s.contains("sys_page_schema")); + assertThat(pkg.sqlStatements()).anyMatch(s -> s.contains("sys_serviceflow")); + assertThat(pkg.sqlStatements()).anyMatch(s -> s.contains("sys_menu")); + // §B.9-6: 真实列对齐——sys_page_schema 无 layer 列,SQL 不得出现 'layer' + assertThat(pkg.sqlStatements()).noneMatch(s -> s.contains("layer")); + // rollback 对称且含 DELETE + assertThat(pkg.rollbackSqlStatements()).anyMatch(s -> s.contains("DELETE FROM sys_page_schema")); + assertThat(pkg.rollbackSqlStatements()).anyMatch(s -> s.contains("DELETE FROM sys_serviceflow")); + assertThat(pkg.rollbackSqlStatements()).anyMatch(s -> s.contains("sys_menu")); + // 生产 DDL 由人工补全 → warning + assertThat(pkg.warnings()).isNotEmpty(); + } +}