feat: add AI render plan gate

This commit is contained in:
2026-06-17 13:28:49 +08:00
parent 718c5a5b9b
commit d91da77038
7 changed files with 313 additions and 19 deletions

View File

@@ -876,7 +876,10 @@ public class AiAgentService {
case ENTITY -> gates.add(validateEntityGate(payload));
case SERVICEFLOW -> gates.add(validateServiceFlowGate(payload));
case MENU -> gates.add(validateMenuGate(payload));
case TEST -> gates.add(validateTestGate(payload));
case TEST -> {
gates.add(validateTestGate(payload));
gates.add(validateRenderPlanGate(payload));
}
case CODE -> gates.add(new AiGateResult("code-review-required", true, List.of("代码草稿需后续静态检查/单测门禁")));
}
return List.copyOf(gates);
@@ -971,6 +974,113 @@ public class AiAgentService {
return new AiGateResult("smoke-plan", messages.isEmpty(), messages.stream().limit(20).toList());
}
private AiGateResult validateRenderPlanGate(JsonNode payload) {
List<String> messages = new ArrayList<>();
JsonNode tests = payload.path("renderTests");
if (!tests.isArray() || tests.isEmpty()) {
messages.add("renderTests 至少需要 1 条");
} else {
for (JsonNode test : tests) {
String name = test.path("name").asText("");
String recipe = test.path("recipe").asText("");
String schemaUrl = test.path("schemaUrl").asText("");
String rootType = test.path("expectedRootType").asText("");
String bodyType = test.path("expectedBodyType").asText("");
String crudName = test.path("expectedCrudName").asText("");
String expectedApi = test.path("expectedApi").asText("");
JsonNode components = test.path("expectedComponents");
JsonNode columns = test.path("expectedColumns");
JsonNode actions = test.path("expectedActions");
JsonNode texts = test.path("expectedTexts");
if (name.isBlank()) {
messages.add("render name 不能为空");
}
if (pageRecipeRegistry.find(recipe).isEmpty()) {
messages.add("render recipe 未注册: " + recipe);
}
if (!schemaUrl.startsWith("/api/page/schema/")) {
messages.add("render schemaUrl 必须以 /api/page/schema/ 开头: " + schemaUrl);
}
if (!"page".equals(rootType)) {
messages.add("render expectedRootType 必须是 page");
}
if (!"crud".equals(bodyType)) {
messages.add("render expectedBodyType 必须是 crud");
}
if (crudName.isBlank()) {
messages.add("render expectedCrudName 不能为空");
}
if (!expectedApi.startsWith("/api/entity/")) {
messages.add("render expectedApi 必须指向 /api/entity/: " + expectedApi);
}
if (PageBlueprint.RECIPE_TREE_CRUD.equals(recipe) && !expectedApi.contains("/tree?")) {
messages.add("tree-crud-v1 render expectedApi 必须是树接口");
}
if (PageBlueprint.RECIPE_MAINTENANCE_CRUD.equals(recipe) && !expectedApi.contains("/list?")) {
messages.add("maintenance-crud-v1 render expectedApi 必须是列表接口");
}
if (!components.isArray() || components.isEmpty()) {
messages.add("render expectedComponents 至少需要 1 项");
} else {
if (!arrayContainsText(components, "page")) {
messages.add("render expectedComponents 必须包含 page");
}
if (!arrayContainsText(components, "crud")) {
messages.add("render expectedComponents 必须包含 crud");
}
}
if (!columns.isArray() || columns.isEmpty()) {
messages.add("render expectedColumns 至少需要 1 项");
} else {
for (JsonNode column : columns) {
if (column.path("name").asText("").isBlank()) {
messages.add("render expectedColumns.name 不能为空");
}
if (column.path("label").asText("").isBlank()) {
messages.add("render expectedColumns.label 不能为空");
}
}
}
if (!actions.isArray() || actions.isEmpty()) {
messages.add("render expectedActions 至少需要 1 项");
} else {
if (!arrayContainsText(actions, "新增")
&& !arrayContainsTextStartingWith(actions, "新增顶级")) {
messages.add("render expectedActions 必须包含新增动作");
}
if (!arrayContainsText(actions, "编辑")) {
messages.add("render expectedActions 必须包含编辑动作");
}
if (!arrayContainsText(actions, "删除")) {
messages.add("render expectedActions 必须包含删除动作");
}
}
if (!texts.isArray() || texts.isEmpty()) {
messages.add("render expectedTexts 至少需要 1 项");
}
}
}
return new AiGateResult("render-plan", messages.isEmpty(), messages.stream().limit(20).toList());
}
private static boolean arrayContainsText(JsonNode array, String value) {
for (JsonNode item : array) {
if (value.equals(item.asText(""))) {
return true;
}
}
return false;
}
private static boolean arrayContainsTextStartingWith(JsonNode array, String prefix) {
for (JsonNode item : array) {
if (item.asText("").startsWith(prefix)) {
return true;
}
}
return false;
}
private static boolean isValidFlowXml(String xml) {
if (xml == null || xml.isBlank()) {
return false;

View File

@@ -141,8 +141,11 @@ public class AiFeatureDraftGenerator {
ObjectNode create = addSmoke(tests, "entity-create", "POST",
"/api/entity/" + spec.tableName() + "/save", 200);
create.set("requestBody", sampleEntityBody(spec));
ArrayNode renderTests = root.putArray("renderTests");
addRender(renderTests, spec);
ArrayNode manual = root.putArray("manualGates");
manual.add("确认实体字段、菜单位置、权限角色和服务流写入策略");
manual.add("按 renderTests 使用 Playwright 渲染页面,确认组件、列和操作按钮符合 recipe");
manual.add("确认本地 smoke 通过后再人工部署线上");
return root;
}
@@ -156,6 +159,71 @@ public class AiFeatureDraftGenerator {
return t;
}
private void addRender(ArrayNode renderTests, FeatureSpec spec) {
ObjectNode render = renderTests.addObject();
render.put("name", "page-render");
render.put("recipe", spec.pageRecipe());
render.put("schemaUrl", "/api/page/schema/" + spec.templateId());
render.put("expectedRootType", "page");
render.put("expectedBodyType", "crud");
render.put("expectedCrudName", expectedCrudName(spec));
render.put("expectedApi", expectedPageApi(spec));
if (PageBlueprint.RECIPE_TREE_CRUD.equals(spec.pageRecipe())) {
render.put("childrenColumnName", "children");
}
ArrayNode components = render.putArray("expectedComponents");
components.add("page");
components.add("crud");
components.add("form");
components.add("button");
addExpectedColumns(render.putArray("expectedColumns"), spec);
addExpectedActions(render.putArray("expectedActions"), spec);
ArrayNode texts = render.putArray("expectedTexts");
texts.add(spec.featureName());
texts.add(spec.entityName());
for (FieldSpec field : spec.fields()) {
if (!"PARENTID".equals(field.column())) {
texts.add(field.label());
}
}
}
private void addExpectedColumns(ArrayNode columns, FeatureSpec spec) {
for (FieldSpec field : spec.fields()) {
if ("PARENTID".equals(field.column())) {
continue;
}
ObjectNode column = columns.addObject();
column.put("name", field.column());
column.put("label", field.label());
}
}
private void addExpectedActions(ArrayNode actions, FeatureSpec spec) {
if (PageBlueprint.RECIPE_TREE_CRUD.equals(spec.pageRecipe())) {
actions.add("新增顶级" + spec.entityName());
actions.add("刷新");
actions.add("加子" + spec.entityName());
} else {
actions.add("新增");
}
actions.add("编辑");
actions.add("删除");
}
private static String expectedCrudName(FeatureSpec spec) {
return lowerCamel(spec.tableName())
+ (PageBlueprint.RECIPE_TREE_CRUD.equals(spec.pageRecipe()) ? "TreeCrud" : "Crud");
}
private static String expectedPageApi(FeatureSpec spec) {
if (PageBlueprint.RECIPE_TREE_CRUD.equals(spec.pageRecipe())) {
return "/api/entity/" + spec.tableName()
+ "/tree?parentKey=PARENTID&idKey=" + spec.tableName() + "_ID&perPage=2000";
}
return "/api/entity/" + spec.tableName() + "/list?page=${page}&perPage=${perPage}";
}
private ObjectNode sampleEntityBody(FeatureSpec spec) {
ObjectNode body = objectMapper.createObjectNode();
for (FieldSpec field : spec.fields()) {
@@ -303,6 +371,17 @@ public class AiFeatureDraftGenerator {
return metadata;
}
private static String lowerCamel(String table) {
String[] parts = table.toLowerCase(Locale.ROOT).split("_+");
StringBuilder sb = new StringBuilder(parts[0]);
for (int i = 1; i < parts.length; i++) {
if (!parts[i].isBlank()) {
sb.append(Character.toUpperCase(parts[i].charAt(0))).append(parts[i].substring(1));
}
}
return sb.toString();
}
@SuppressWarnings("unchecked")
private Map<String, Object> pageSchemaMetadata(PageBlueprint pageBlueprint) {
Map<String, Object> metadata = metadata("page-schema", "sys_page_schema");