diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/schema/blueprint/PageBlueprintField.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/schema/blueprint/PageBlueprintField.java index 759731f..73f2e57 100644 --- a/platform-metadata/src/main/java/com/eip4/platform/metadata/schema/blueprint/PageBlueprintField.java +++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/schema/blueprint/PageBlueprintField.java @@ -6,5 +6,13 @@ public record PageBlueprintField( String type, boolean required, boolean listVisible, - boolean formVisible) { + boolean formVisible, + String referenceTable, + String displayColumn) { + + /** 6-arg 兼容构造:非引用字段(referenceTable/displayColumn 置空)。保持既有调用方/测试零改。 */ + public PageBlueprintField(String name, String label, String type, + boolean required, boolean listVisible, boolean formVisible) { + this(name, label, type, required, listVisible, formVisible, null, null); + } } diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/schema/blueprint/RecipePageComposer.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/schema/blueprint/RecipePageComposer.java new file mode 100644 index 0000000..4782540 --- /dev/null +++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/schema/blueprint/RecipePageComposer.java @@ -0,0 +1,94 @@ +package com.eip4.platform.metadata.schema.blueprint; + +import java.util.ArrayList; +import java.util.List; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.node.ObjectNode; + +/** + * 共享蓝图装配器:实体属性 → 受控 {@link PageBlueprint} → {@link PageBlueprintCompiler#compile}。 + * + *
人工单步端点(DesignFeatureController)与未来 AI 路径共用同一装配口径(DRY),UI/UE 规则集中在 + * recipe/compiler 而非散落在调用方。本类不写库、不校验白名单(严格 typed 闸在端点层),只负责装配+编译。 + * + *
装配口径镜像 {@code AiFeatureDraftGenerator.pageBlueprint}:tree-crud 的 PARENTID 列 listVisible=false;
+ * displayField 缺省回退首个 NAME/required 列。引用字段(type=reference + referenceTable/displayColumn)
+ * 透传到 {@link PageBlueprintField},由 compiler 渲染显名列(见 applyColumnRender)。
+ */
+public final class RecipePageComposer {
+
+ private final PageBlueprintCompiler compiler;
+
+ public RecipePageComposer(ObjectMapper objectMapper) {
+ this.compiler = new PageBlueprintCompiler(objectMapper);
+ }
+
+ public ObjectNode compose(Spec spec) {
+ if (spec == null) {
+ throw new IllegalArgumentException("compose spec 不能为空");
+ }
+ PageBlueprint blueprint = toBlueprint(spec);
+ return compiler.compile(blueprint);
+ }
+
+ PageBlueprint toBlueprint(Spec spec) {
+ List_SEARCH,列= listVisible 业务列")
+ void composesMaintenanceCrud() {
+ RecipePageComposer.Spec spec = new RecipePageComposer.Spec(
+ "EIP4AI_CUSTOMER", "客户", PageBlueprint.RECIPE_MAINTENANCE_CRUD,
+ "客户维护", "NAME", 20,
+ List.of(
+ new RecipePageComposer.AttrSpec("NAME", "名称", "string", true, null, null),
+ new RecipePageComposer.AttrSpec("LEVEL", "等级", "integer", false, null, null)));
+
+ ObjectNode page = composer.compose(spec);
+
+ assertEquals("page", page.path("type").asText());
+ assertEquals("客户维护", page.path("title").asText());
+ ObjectNode crud = (ObjectNode) page.path("body");
+ assertEquals("/api/flow/EIP4AI_CUSTOMER_SEARCH", crud.path("api").asText());
+ ArrayNode columns = (ArrayNode) crud.path("columns");
+ assertEquals(2, columns.size());
+ assertEquals("NAME", columns.get(0).path("name").asText());
+ assertEquals("LEVEL", columns.get(1).path("name").asText());
+ }
+
+ @Test
+ @DisplayName("2. compose tree-crud → 注入 PARENTID 字段且列表不显示该列")
+ void composesTreeCrudWithParent() {
+ RecipePageComposer.Spec spec = new RecipePageComposer.Spec(
+ "EIP4AI_CATEGORY", "分类", PageBlueprint.RECIPE_TREE_CRUD,
+ "分类维护", "NAME", 20,
+ List.of(
+ new RecipePageComposer.AttrSpec("NAME", "名称", "string", true, null, null),
+ new RecipePageComposer.AttrSpec("PARENTID", "上级", "string", false, null, null)));
+
+ ObjectNode page = composer.compose(spec);
+ ObjectNode crud = (ObjectNode) page.path("body");
+ assertEquals("eip4aiCategoryTreeCrud", crud.path("name").asText());
+ // 业务列里不含 PARENTID(compiler.treeColumns 跳过 PARENTID),但保留「操作」列。
+ ArrayNode columns = (ArrayNode) crud.path("columns");
+ boolean hasParentColumn = false;
+ for (int i = 0; i < columns.size(); i++) {
+ if ("PARENTID".equals(columns.get(i).path("name").asText())) {
+ hasParentColumn = true;
+ }
+ }
+ assertTrue(!hasParentColumn);
+ }
+
+ @Test
+ @DisplayName("3. displayField 省略时回退首个 NAME/required 列")
+ void derivesDisplayFieldWhenBlank() {
+ RecipePageComposer.Spec spec = new RecipePageComposer.Spec(
+ "EIP4AI_ITEM", "条目", PageBlueprint.RECIPE_MAINTENANCE_CRUD,
+ "条目维护", null, 20,
+ List.of(
+ new RecipePageComposer.AttrSpec("CODE", "编码", "string", false, null, null),
+ new RecipePageComposer.AttrSpec("NAME", "名称", "string", true, null, null)));
+
+ ObjectNode page = composer.compose(spec);
+ // displayField 回退到 NAME,filter 兜底用它(此处只需 compose 成功不抛)。
+ assertEquals("page", page.path("type").asText());
+ }
+}