refactor(ai): 抽 AiDeploymentSqlBuilder 收窄 AiAgentService(§10.2 SRP slice 1)

把 AiAgentService 内联的部署/回滚 SQL 生成簇(deploymentSql/serviceFlowSql/pageSchemaSql/menuSql/rollbackSql/serviceFlowRollbackSql/entityDeploymentNote + json/sqlString/sha256)逐字移入新 AiDeploymentSqlBuilder(构造取 ObjectMapper,终构造器内 new,不改对外构造签名);AiAgentService 1846→1677 行,SQL 文本字节零变更(红线逐字节对拍)。新增 AiDeploymentSqlBuilderTest 8 用例钉死关键 token(表名/AI_AGENT 审计字面量/ON CONFLICT/version+1/::xml·::jsonb/单引号转义/占位符回退/entityId 替换);AiAgentServiceTest 22/22 行为不变,全 reactor 绿。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-25 13:00:32 +08:00
parent 1102601424
commit 1a57000458
3 changed files with 337 additions and 176 deletions

View File

@@ -1,12 +1,8 @@
package com.eip4.platform.ai.service;
import java.nio.charset.StandardCharsets;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.ArrayList;
import java.util.EnumMap;
import java.util.Comparator;
import java.util.HexFormat;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
@@ -93,6 +89,8 @@ public class AiAgentService {
private final TypedPageSchemaValidator typedSchemaValidator;
private final PageRecipeRegistry pageRecipeRegistry;
private final PageRecipeValidator pageRecipeValidator;
/** 部署/回滚 SQL 生成已抽出(§10.2 SRP slice 1);本类只编排,不再内联 SQL 文本。 */
private final AiDeploymentSqlBuilder sqlBuilder;
private static volatile SchemaGate sharedSchemaGate;
private volatile SchemaGate schemaGate;
@@ -131,6 +129,7 @@ public class AiAgentService {
: typedSchemaValidator;
this.pageRecipeRegistry = PageRecipeRegistry.defaults();
this.pageRecipeValidator = new PageRecipeValidator(objectMapper, pageRecipeRegistry);
this.sqlBuilder = new AiDeploymentSqlBuilder(objectMapper);
}
public AiTask createTask(String objective) {
@@ -515,8 +514,8 @@ public class AiAgentService {
true,
generatedAt,
manifest,
deploymentSql(drafts, entityId, menuIds, generatedAt),
rollbackSql(drafts, generatedAt),
sqlBuilder.deploymentSql(drafts, entityId, menuIds, generatedAt),
sqlBuilder.rollbackSql(drafts, generatedAt),
List.copyOf(warnings),
List.copyOf(runs));
audit(taskId, "deployment-package.generated", "agent", Map.of(
@@ -1566,176 +1565,6 @@ public class AiAgentService {
return Map.copyOf(summary);
}
private List<String> deploymentSql(List<AiDraft> drafts, String entityId,
Map<String, String> menuIdsByTarget, long generatedAt) {
List<String> out = new ArrayList<>();
for (AiDraft draft : drafts) {
switch (draft.artifactType()) {
case ENTITY -> out.add(entityDeploymentNote(draft));
case SERVICEFLOW -> out.addAll(serviceFlowSql(draft, entityId, generatedAt));
case PAGE_SCHEMA -> out.add(pageSchemaSql(draft, generatedAt));
case MENU -> out.add(menuSql(draft, menuIdsByTarget.get(draft.targetId()), generatedAt));
case TEST -> out.add("-- TEST " + draft.targetId() + ": 保留 smoke 结果作为上线审批附件,不生成生产 SQL");
case CODE -> out.add("-- CODE " + draft.targetId() + ": 代码改动需通过代码仓库发布流程,不生成运行态 SQL");
}
}
return List.copyOf(out);
}
private String entityDeploymentNote(AiDraft draft) {
return "-- ENTITY " + draft.targetId()
+ ": 人工审批后在目标环境调用 POST /api/meta/entity,payload="
+ json(draft.payload())
+ ";确认返回 entityId 后替换服务流 SQL 中的 ${entityId}";
}
private List<String> serviceFlowSql(AiDraft draft, String entityId, long generatedAt) {
List<String> out = new ArrayList<>();
String resolvedEntityId = entityId == null || entityId.isBlank() ? "${entityId}" : entityId;
for (JsonNode flow : draft.payload().path("flows")) {
String xml = flow.path("contentXml").asText("");
if (!entityId.isBlank()) {
xml = xml.replace("${entityId}", entityId);
}
out.add("""
INSERT INTO sys_serviceflow
(sys_serviceflow_id, displayname, contentxml, entityid, iscontrol, isupdateable,
isactive, createtime, updatetime, createby, updateby, version)
VALUES (%s, %s, %s::xml, %s, %d, %d, 1, %d, %d, 'AI_AGENT', 'AI_AGENT', 0)
ON CONFLICT (sys_serviceflow_id) DO UPDATE SET
displayname = EXCLUDED.displayname,
contentxml = EXCLUDED.contentxml,
entityid = EXCLUDED.entityid,
iscontrol = EXCLUDED.iscontrol,
isupdateable = EXCLUDED.isupdateable,
updatetime = EXCLUDED.updatetime,
updateby = EXCLUDED.updateby,
version = sys_serviceflow.version + 1;
""".formatted(
sqlString(flow.path("key").asText()),
sqlString(flow.path("displayName").asText(flow.path("key").asText())),
sqlString(xml),
sqlString(resolvedEntityId),
flow.path("control").asBoolean(true) ? 1 : 0,
flow.path("updateable").asBoolean(true) ? 1 : 0,
generatedAt,
generatedAt));
}
return out;
}
private String pageSchemaSql(AiDraft draft, long generatedAt) {
String schemaJson = json(draft.payload());
return """
INSERT INTO sys_page_schema (template_id, name, schema_json, schema_etag, version, update_time)
VALUES (%s, %s, %s::jsonb, %s, 1, %d)
ON CONFLICT (template_id) DO UPDATE SET
name = EXCLUDED.name,
schema_json = EXCLUDED.schema_json,
schema_etag = EXCLUDED.schema_etag,
version = sys_page_schema.version + 1,
update_time = EXCLUDED.update_time;
""".formatted(
sqlString(draft.targetId()),
sqlString(draft.payload().path("title").asText(draft.targetId())),
sqlString(schemaJson),
sqlString(sha256(schemaJson)),
generatedAt);
}
private String menuSql(AiDraft draft, String appliedMenuId, long generatedAt) {
JsonNode payload = draft.payload();
String menuId = appliedMenuId == null || appliedMenuId.isBlank() ? "${menuId}" : appliedMenuId;
String parentId = payload.path("parentId").asText("");
if (parentId.isBlank()) {
parentId = "${parentMenuId}";
}
String menuRoot = payload.path("menuroot").asText("");
if (menuRoot.isBlank()) {
menuRoot = "${menuRoot}";
}
return """
INSERT INTO sys_menu
(sys_menu_id, name, parentid, view_templateid, typename, menuroot, seq,
isactive, version, createtime, createby, updatetime, updateby)
VALUES (%s, %s, %s, %s, %s, %s, %d, 1, 0, %d, 'AI_AGENT', %d, 'AI_AGENT')
ON CONFLICT (sys_menu_id) DO UPDATE SET
name = EXCLUDED.name,
parentid = EXCLUDED.parentid,
view_templateid = EXCLUDED.view_templateid,
typename = EXCLUDED.typename,
menuroot = EXCLUDED.menuroot,
seq = EXCLUDED.seq,
isactive = 1,
updatetime = EXCLUDED.updatetime,
updateby = EXCLUDED.updateby,
version = sys_menu.version + 1;
""".formatted(
sqlString(menuId),
sqlString(payload.path("name").asText(draft.targetId())),
sqlString(parentId),
sqlString(payload.path("viewTemplateId").asText(draft.targetId())),
sqlString(payload.path("typename").asText("功能菜单")),
sqlString(menuRoot),
payload.path("seq").asInt(0),
generatedAt,
generatedAt);
}
private List<String> rollbackSql(List<AiDraft> drafts, long generatedAt) {
List<String> out = new ArrayList<>();
for (AiDraft draft : drafts) {
switch (draft.artifactType()) {
case ENTITY -> out.add("-- ENTITY " + draft.targetId()
+ ": 人工确认后调用 DELETE /api/meta/entity/" + draft.targetId()
+ ",并清理对应菜单/服务流/页面 schema");
case SERVICEFLOW -> out.add(serviceFlowRollbackSql(draft));
case PAGE_SCHEMA -> out.add("DELETE FROM sys_page_schema WHERE template_id = "
+ sqlString(draft.targetId()) + ";");
case MENU -> out.add("""
UPDATE sys_menu
SET isactive = 0, updatetime = %d, updateby = 'AI_AGENT_ROLLBACK',
version = version + 1
WHERE TRIM(view_templateid) = %s;
""".formatted(generatedAt, sqlString(draft.targetId())));
case TEST -> out.add("-- TEST " + draft.targetId() + ": 无生产数据回滚动作");
case CODE -> out.add("-- CODE " + draft.targetId() + ": 通过代码仓库反向补丁或回滚发布单处理");
}
}
return List.copyOf(out);
}
private String serviceFlowRollbackSql(AiDraft draft) {
List<String> keys = new ArrayList<>();
for (JsonNode flow : draft.payload().path("flows")) {
keys.add(sqlString(flow.path("key").asText()));
}
return "DELETE FROM sys_serviceflow WHERE sys_serviceflow_id IN ("
+ String.join(", ", keys) + ");";
}
private String json(Object value) {
try {
return objectMapper.writeValueAsString(value);
} catch (JsonProcessingException ex) {
throw new IllegalArgumentException("AI Agent 部署包 JSON 序列化失败", ex);
}
}
private static String sqlString(String value) {
String text = value == null ? "" : value;
return "'" + text.replace("'", "''") + "'";
}
private static String sha256(String text) {
try {
MessageDigest digest = MessageDigest.getInstance("SHA-256");
return HexFormat.of().formatHex(digest.digest(text.getBytes(StandardCharsets.UTF_8)));
} catch (NoSuchAlgorithmException ex) {
throw new IllegalStateException(ex);
}
}
private static List<String> defaultPlan() {
List<String> plan = new ArrayList<>();
plan.add("采集需求和上下文");

View File

@@ -0,0 +1,203 @@
package com.eip4.platform.ai.service;
import java.nio.charset.StandardCharsets;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.ArrayList;
import java.util.HexFormat;
import java.util.List;
import java.util.Map;
import com.eip4.platform.ai.model.AiDraft;
import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
/**
* AI Agent 部署包 / 回滚 SQL 生成器(自 {@code AiAgentService} 抽出,§10.2 SRP 收敛 slice 1)。
*
* <p>纯生成职责:把已过门禁的草稿({@link AiDraft})翻成人审部署包里的 SQL/备注语句与回滚语句。
* <strong>逐字节复刻原 AiAgentService 实现,零行为变更</strong>(SQL 文本是红线「逐字节对拍」对象,
* 由 {@code AiDeploymentSqlBuilderTest} 黄金串钉死)。所有动态值经 {@link #sqlString} 转义,
* 时间戳/实体 id/菜单 id 由调用方({@code AiAgentService.createDeploymentPackage})解析后传入。
*
* <p>仍恪守红线:本类只<em>生成</em>待人工审批执行的 SQL 文本,不直接落库、不触发执行。
*/
public class AiDeploymentSqlBuilder {
private final ObjectMapper objectMapper;
public AiDeploymentSqlBuilder(ObjectMapper objectMapper) {
this.objectMapper = objectMapper;
}
public List<String> deploymentSql(List<AiDraft> drafts, String entityId,
Map<String, String> menuIdsByTarget, long generatedAt) {
List<String> out = new ArrayList<>();
for (AiDraft draft : drafts) {
switch (draft.artifactType()) {
case ENTITY -> out.add(entityDeploymentNote(draft));
case SERVICEFLOW -> out.addAll(serviceFlowSql(draft, entityId, generatedAt));
case PAGE_SCHEMA -> out.add(pageSchemaSql(draft, generatedAt));
case MENU -> out.add(menuSql(draft, menuIdsByTarget.get(draft.targetId()), generatedAt));
case TEST -> out.add("-- TEST " + draft.targetId() + ": 保留 smoke 结果作为上线审批附件,不生成生产 SQL");
case CODE -> out.add("-- CODE " + draft.targetId() + ": 代码改动需通过代码仓库发布流程,不生成运行态 SQL");
}
}
return List.copyOf(out);
}
private String entityDeploymentNote(AiDraft draft) {
return "-- ENTITY " + draft.targetId()
+ ": 人工审批后在目标环境调用 POST /api/meta/entity,payload="
+ json(draft.payload())
+ ";确认返回 entityId 后替换服务流 SQL 中的 ${entityId}";
}
private List<String> serviceFlowSql(AiDraft draft, String entityId, long generatedAt) {
List<String> out = new ArrayList<>();
String resolvedEntityId = entityId == null || entityId.isBlank() ? "${entityId}" : entityId;
for (JsonNode flow : draft.payload().path("flows")) {
String xml = flow.path("contentXml").asText("");
if (!entityId.isBlank()) {
xml = xml.replace("${entityId}", entityId);
}
out.add("""
INSERT INTO sys_serviceflow
(sys_serviceflow_id, displayname, contentxml, entityid, iscontrol, isupdateable,
isactive, createtime, updatetime, createby, updateby, version)
VALUES (%s, %s, %s::xml, %s, %d, %d, 1, %d, %d, 'AI_AGENT', 'AI_AGENT', 0)
ON CONFLICT (sys_serviceflow_id) DO UPDATE SET
displayname = EXCLUDED.displayname,
contentxml = EXCLUDED.contentxml,
entityid = EXCLUDED.entityid,
iscontrol = EXCLUDED.iscontrol,
isupdateable = EXCLUDED.isupdateable,
updatetime = EXCLUDED.updatetime,
updateby = EXCLUDED.updateby,
version = sys_serviceflow.version + 1;
""".formatted(
sqlString(flow.path("key").asText()),
sqlString(flow.path("displayName").asText(flow.path("key").asText())),
sqlString(xml),
sqlString(resolvedEntityId),
flow.path("control").asBoolean(true) ? 1 : 0,
flow.path("updateable").asBoolean(true) ? 1 : 0,
generatedAt,
generatedAt));
}
return out;
}
private String pageSchemaSql(AiDraft draft, long generatedAt) {
String schemaJson = json(draft.payload());
return """
INSERT INTO sys_page_schema (template_id, name, schema_json, schema_etag, version, update_time)
VALUES (%s, %s, %s::jsonb, %s, 1, %d)
ON CONFLICT (template_id) DO UPDATE SET
name = EXCLUDED.name,
schema_json = EXCLUDED.schema_json,
schema_etag = EXCLUDED.schema_etag,
version = sys_page_schema.version + 1,
update_time = EXCLUDED.update_time;
""".formatted(
sqlString(draft.targetId()),
sqlString(draft.payload().path("title").asText(draft.targetId())),
sqlString(schemaJson),
sqlString(sha256(schemaJson)),
generatedAt);
}
private String menuSql(AiDraft draft, String appliedMenuId, long generatedAt) {
JsonNode payload = draft.payload();
String menuId = appliedMenuId == null || appliedMenuId.isBlank() ? "${menuId}" : appliedMenuId;
String parentId = payload.path("parentId").asText("");
if (parentId.isBlank()) {
parentId = "${parentMenuId}";
}
String menuRoot = payload.path("menuroot").asText("");
if (menuRoot.isBlank()) {
menuRoot = "${menuRoot}";
}
return """
INSERT INTO sys_menu
(sys_menu_id, name, parentid, view_templateid, typename, menuroot, seq,
isactive, version, createtime, createby, updatetime, updateby)
VALUES (%s, %s, %s, %s, %s, %s, %d, 1, 0, %d, 'AI_AGENT', %d, 'AI_AGENT')
ON CONFLICT (sys_menu_id) DO UPDATE SET
name = EXCLUDED.name,
parentid = EXCLUDED.parentid,
view_templateid = EXCLUDED.view_templateid,
typename = EXCLUDED.typename,
menuroot = EXCLUDED.menuroot,
seq = EXCLUDED.seq,
isactive = 1,
updatetime = EXCLUDED.updatetime,
updateby = EXCLUDED.updateby,
version = sys_menu.version + 1;
""".formatted(
sqlString(menuId),
sqlString(payload.path("name").asText(draft.targetId())),
sqlString(parentId),
sqlString(payload.path("viewTemplateId").asText(draft.targetId())),
sqlString(payload.path("typename").asText("功能菜单")),
sqlString(menuRoot),
payload.path("seq").asInt(0),
generatedAt,
generatedAt);
}
public List<String> rollbackSql(List<AiDraft> drafts, long generatedAt) {
List<String> out = new ArrayList<>();
for (AiDraft draft : drafts) {
switch (draft.artifactType()) {
case ENTITY -> out.add("-- ENTITY " + draft.targetId()
+ ": 人工确认后调用 DELETE /api/meta/entity/" + draft.targetId()
+ ",并清理对应菜单/服务流/页面 schema");
case SERVICEFLOW -> out.add(serviceFlowRollbackSql(draft));
case PAGE_SCHEMA -> out.add("DELETE FROM sys_page_schema WHERE template_id = "
+ sqlString(draft.targetId()) + ";");
case MENU -> out.add("""
UPDATE sys_menu
SET isactive = 0, updatetime = %d, updateby = 'AI_AGENT_ROLLBACK',
version = version + 1
WHERE TRIM(view_templateid) = %s;
""".formatted(generatedAt, sqlString(draft.targetId())));
case TEST -> out.add("-- TEST " + draft.targetId() + ": 无生产数据回滚动作");
case CODE -> out.add("-- CODE " + draft.targetId() + ": 通过代码仓库反向补丁或回滚发布单处理");
}
}
return List.copyOf(out);
}
private String serviceFlowRollbackSql(AiDraft draft) {
List<String> keys = new ArrayList<>();
for (JsonNode flow : draft.payload().path("flows")) {
keys.add(sqlString(flow.path("key").asText()));
}
return "DELETE FROM sys_serviceflow WHERE sys_serviceflow_id IN ("
+ String.join(", ", keys) + ");";
}
private String json(Object value) {
try {
return objectMapper.writeValueAsString(value);
} catch (JsonProcessingException ex) {
throw new IllegalArgumentException("AI Agent 部署包 JSON 序列化失败", ex);
}
}
private static String sqlString(String value) {
String text = value == null ? "" : value;
return "'" + text.replace("'", "''") + "'";
}
private static String sha256(String text) {
try {
MessageDigest digest = MessageDigest.getInstance("SHA-256");
return HexFormat.of().formatHex(digest.digest(text.getBytes(StandardCharsets.UTF_8)));
} catch (NoSuchAlgorithmException ex) {
throw new IllegalStateException(ex);
}
}
}