Merge docs/ai-agent-srp-done: §10.2 AiAgentService SRP 完成标记
Some checks failed
ci / build-test-parity (push) Has been cancelled
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -211,7 +211,7 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁
|
||||
- **🟡【已完成安全半步 2026-06-24】【采纳自原文档 A5】AiLocalReleaseExecutor 裸写 sys_serviceflow/sys_menu**:**已做**——把执行器里所有裸 JDBC(sys_serviceflow UPSERT + sys_menu INSERT/UPDATE + ensureAiMenuParent + tableExists + 实体复用查询)下沉到新类 `platform-ai/.../service/AiReleaseWriter`,执行器只剩编排不再直接碰库;SQL 逐字保留(纯搬迁零行为变更)。**顺带补缺口**:新增 `AiReleaseWriterTest`(4 值断言:serviceflow 审计/`?::xml`/bool→int、菜单 INSERT 全列值、UPDATE 全字段、自动建「AI Agent」目录)——补上原 `AiLocalReleaseExecutorTest` 只查「SQL 含表名」的宽松缺口。**验证**:platform-ai 30/30 绿(黄金测试经搬迁仍绿=行为未变)。**未做(推迟为专项)**:与人走五环 `MenuRegistrar` 统一成单一写器——调查发现两者已实质分叉(本类 UPDATE 全字段 + operator 字面量 'AI_AGENT' + 顶级目录「AI Agent」vs MenuRegistrar 窄 UPDATE + `?` operator + 「新功能」),且各有钉死测试,真统一需重写两路测试 + 重验两条红线邻近路径(建议 live e2e),风险/工作量超「快速增量」,留作 A5 完整版专项。
|
||||
- **✅【已完成 2026-06-24】【采纳自原文档 A4】ArchUnit 规则扩充**:`ArchitectureRulesTest.java` 从 1 条扩到 **6 条**——3 条强制(保真层禁依赖现代层 / 库模块[converter·parity]不得依赖应用编排层 / 模块切片 `beFreeOfCycles` 无环)+ 3 条**棘轮**(控制器不得新增直用 `JdbcTemplate` / 不得新增 Controller→Controller 互注入 / 不得新增 `Poc*` 调试控制器)。棘轮以「已知债务清单」基线化存量(JdbcTemplate 26 个 / 互注入 4 个 / Poc 3 个),只挡新增、清单即待偿台账。**验证**:`mvn -pl platform-app test -Dtest=ArchitectureRulesTest` 6/6 绿;并以临时探针走完整 RED→GREEN(探针触发恰好 3 条棘轮失败、强制规则不受影响,证明非空绿)。**一处刻意偏离原文档**:未加「禁控制器调 `POJOCRUDService`/引擎」——因 `com.eip4.*→com.dsasp.*` 是双层制明确允许(现代层=保真层薄门面),真正的坏味道是控制器直拼原始 SQL(已由 JdbcTemplate 棘轮覆盖)。**后续**:随 A1/A3 把控制器 SQL 收口到 Service 后,从清单删项,清空即把棘轮升为强制规则。
|
||||
- **【采纳自原文档 D1】render-plan 无执行闭环 · high · M**:`AiAgentService.validateRenderPlanGate:987-1085` 纯字段校验,Playwright 全是注释,`READY_FOR_HUMAN_REVIEW` 不含渲染证据。→ 新增 headless render runner 真跑 renderTests 后回写 `runEvidence`。
|
||||
- **AiAgentService(1846 LOC)SRP 严重违反 · high · L**:~28 public 入口 + 内联 9+ `validate*Gate` + 部署/回滚 SQL 生成 + 运行记录映射揉一类。→ 门禁抽 `AiDraftGateValidator`、SQL 抽 `AiDeploymentSqlBuilder`、持久化抽 `AiRunStore`,主类收敛为薄编排门面。
|
||||
- **✅【已完成 2026-06-25】AiAgentService(曾 1846 LOC)SRP 收窄**:原状=~28 public 入口 + 内联 9+ `validate*Gate` + 部署/回滚 SQL 生成 + 运行记录映射揉一类。**已做**:① 部署/回滚 SQL 簇 → `AiDeploymentSqlBuilder`(黄金串测试钉死红线 SQL 字节);② 草稿门禁电池(validateDraft + 各 `validate*Gate` + SchemaGate 懒加载状态 + 正则常量)→ `AiDraftGateValidator`(直测各类 pass/fail,D3 红线判定零变更)。主类 **1846→1329 行(-28%)** 收敛为薄编排门面(29 public 方法协调 store + 抽出的 collaborator)。**验证**:逐方法/逐字搬迁、行为零变更——AiAgentServiceTest 22/22 + AiAgentControllerTest 11/11 + pipeline 无回归,platform-ai 79 全绿 + 全 reactor `mvn clean install` 绿;新增 AiDeploymentSqlBuilderTest 8 + AiDraftGateValidatorTest 7。**有意丢弃 AiRunStore**:持久化已由现有 `AiAgentStore`(saveTask/saveDraft/saveRun/…)承担,另抽会重复。分支 `feat/ai-agent-service-split` --no-ff 合 main,origin/main=`285d601`。
|
||||
- **【采纳自原文档 A1/A3】platform-metadata 过厚(31 Controller / 4 Service / 0 Repository)+ Controller 互注入 · medium · L**:`EntityController.java:46/:398` 直接注入并调用 `PickerController`。→ 抽 `PickerService`/`ReferenceResolutionService` 切断互注入;建 web/service/repository 分层(与 ArchUnit 合并做)。
|
||||
- **前端 scriptCommands 联动静默哑火 · medium · M**:`scriptCommands.ts:60-117` 把 `setRequired/setOptions/setFilter` 翻成 amis 未注册的 `setValue` 非标准 arg → 运行时 no-op、不报错、单测只断翻译形状。「动态必填/动态选项/数据过滤」可能整类失效。→ 改走 amis 真支持机制 + 补真实 DOM 断言 e2e。
|
||||
- **WritePrivilegeChecker 复杂规则 fail-open(读写权限不对称)· medium · M**:`WritePrivilegeChecker.java:156-159` 对部门集合/范围比较类规则 default 放行,而读侧对同类型生成真实约束 → 若客户库含此类写规则可越权 update/delete。→ 不支持类型改 fail-closed。
|
||||
|
||||
Reference in New Issue
Block a user