docs+javadoc: 文档-代码对抗核查对齐 + 归档候选物理归档
5 路并行核对总览 §9/§10/§11 + A/B 矩阵声明 vs 两仓代码(48 条 46 条完全一致,无虚报),修正不一致处: - A10 行 🔴→🟡:W1 Flyway(V1-V3)+W2-W4 容器化/nginx/compose 骨架 06-25 已合 main,文档此前低报;§10.2 Flyway/compose 两条标 ✅ - §9 P0② 表格「同族扩长」与对抗审查①矛盾(代码一律拒 TYPE 变更)改齐 - §10.2 render-plan 行号迁 AiDraftGateValidator.java:246(SRP 拆分后位置) - §11 报表单测 73→79;§2「五步编排壳」改四步向导 - CandidateUsersHandler 类级 javadoc:scriptUser 已于 06-26 接入(resolveScriptUsers),删「WARN 降级未接入」陈旧表述(纯注释零行为变更) 归档整理(总览 §8 归档候选落地): - 10 份已完成/被取代文档 git mv 入 docs/归档/(06-14×3/06-15/06-16/06-20 plans、CRUD-QA、C3/C5、总览-06-17) - 引用同步改路径:README 索引、M0剩余项登记、通用模板收口计划、架构方向-design、新闻管理plan - README 刷新至 07-02:补 06-22→06-26 增量一节、审批/报表行状态、§2 补登 06-25/06-26 四份 design/计划、§4 过时「未 push」表述修正 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
@@ -1,7 +1,7 @@
|
||||
# EIP3 → EIP4 项目进度与路线 · 总览(2026-06-21)
|
||||
|
||||
> 维护日期:2026-06-21 | 性质:全项目进度盘点 + 剩余工作路线(A 兼容 / B 新能力)+ 下一步。
|
||||
> **本文取代 `项目进度与路线-总览-2026-06-17.md`**(口径刷新至 06-21,新增「06-17→06-21 增量交付」一节)。
|
||||
> 维护日期:2026-07-02(06-26 增量已并入;07-02 做过一轮文档-代码对抗核查对齐,见 §8 末)| 性质:全项目进度盘点 + 剩余工作路线(A 兼容 / B 新能力)+ 下一步。
|
||||
> **本文取代 `归档/项目进度与路线-总览-2026-06-17.md`**(口径刷新至 06-21,新增「06-17→06-21 增量交付」一节;旧版已于 07-02 物理归档)。
|
||||
> 配套权威:`README.md`(文档索引)、`架构设计.md`、`plans/2026-06-19-EIP4开发平台-架构方向-design.md`(方向 D1-D7)、`plans/2026-06-20-人走五环建新功能-NocoBase式-design.md`(主特性设计)、`framework定制视图-engineclass移植backlog-2026-06-17.md` + `framework定制视图-TODO-2026-06-17.md`(A 兼容台账)。
|
||||
>
|
||||
> 编制方法:6 路并行盘点(两仓 git 真相 / 设计计划 / AI 契约 / 现有索引 / 全量文档分级)→ 综合 → 3 路对抗核对(过报 / 漏报 / 文档整理),核对修正已并入正文。所有 git 短哈希均对两仓 origin/main 核实存在。
|
||||
@@ -15,8 +15,8 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁
|
||||
- **A 兼容线**:通用模板 1363 基本可用;153 定制视图中 framework 推进过半、**业务 106 未动(最大块)**。
|
||||
- **B 新能力线本期里程碑突破**:「人走五环建新功能」低代码平台 **v1 全链交付并合入 origin/main 两仓**;设计器选型(amis-editor)拍板且 **DesignerPage 全闭环上线**(解除历史 P1 头号阻塞);AI 确定性(非 LLM)五环生产线**已合 main**。
|
||||
- **安全基线(§10.1 四项 P0 + 评审追加 2 孪生 + Groovy 沙箱)2026-06-25 全数收口并 push**(platform `eba9ce1` / web `2a37251`),可达 RCE/越权/fail-open 已闭。
|
||||
- **报表保真层(套打 JOR)2026-06-25/26 重宿主 + 安全/OOM 收口全数完成并 push origin/main**(§11):SQLi 门 / IDOR 授权 / XXE / 并发·字节·超时·结果集封顶 / CVE 依赖替换 / 报表只读数据源;11 类 73 单测 + live e2e + 安全对抗复审,三批 merge `e6c73a4`/`dccca17`/`d697885`。
|
||||
- 项目仍在 **dev 环境**,生产上线工程化(A10)未起步。
|
||||
- **报表保真层(套打 JOR)2026-06-25/26 重宿主 + 安全/OOM 收口全数完成并 push origin/main**(§11):SQLi 门 / IDOR 授权 / XXE / 并发·字节·超时·结果集封顶 / CVE 依赖替换 / 报表只读数据源;11 类 79 单测 + live e2e + 安全对抗复审,三批 merge `e6c73a4`/`dccca17`/`d697885`。
|
||||
- 项目仍在 **dev 环境**;生产上线工程化(A10)**MVP 骨架已合 main(2026-06-25)**:W1 Flyway(`db/migration/V1-V3`)+ W2-W4 容器化/nginx 单源/compose 编排(`deploy/` + 模块根 Dockerfile),切流执行 / 性能并发 / 灰度未做。
|
||||
|
||||
---
|
||||
|
||||
@@ -41,7 +41,7 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁
|
||||
| 交付 | 仓 | git 证据 |
|
||||
|---|---|---|
|
||||
| **人走五环可视化新建特性 · 后端全链**(元数据建实体 / 引用列 → recipe 单步编译 → 默认流预览落库 → 发布产人审部署包 + 菜单注册) | platform | merge `75f942b`;`4400eab`(8094 真 DB 五环①②③④含引用列 OWNER→SYS_USER live e2e)、`303b4d0`(修 DesignFeatureController 多构造器漏 `@Autowired` 致 Spring 启动崩)。`/api/meta/{entities,attributes,entity,entity-types}` + `/api/design/{recipe/compile,flows,publish}`。418 单测 + live e2e |
|
||||
| **人走五环 · 前端**(ModelerPage 建模器 + 引用列 picker + NewFeatureShell 五步编排壳 + AI①面 AiFeatureForm + admin-gated 路由) | web | merge `d1fd6ed`;`915443f/fef5e33/4e7a95c/2b261e3/4b9c933`(建模器 UI + meta/recipe/publish api 模块)、`8f94ba3/bfb076f/7153592/a6bd4b0`(编排壳 + 设计中心入口 + 五环 Playwright)、`4e0e974/4b564c6`(AI 入口恒 READY_FOR_HUMAN_REVIEW + M-Gate 渲染冒烟)。73 vitest + build |
|
||||
| **人走五环 · 前端**(ModelerPage 建模器 + 引用列 picker + NewFeatureShell 编排壳(四步向导:建实体/建子表/生成页/发布) + AI①面 AiFeatureForm + admin-gated 路由) | web | merge `d1fd6ed`;`915443f/fef5e33/4e7a95c/2b261e3/4b9c933`(建模器 UI + meta/recipe/publish api 模块)、`8f94ba3/bfb076f/7153592/a6bd4b0`(编排壳 + 设计中心入口 + 五环 Playwright)、`4e0e974/4b564c6`(AI 入口恒 READY_FOR_HUMAN_REVIEW + M-Gate 渲染冒烟)。73 vitest + build |
|
||||
| **DesignerPage 实时设计器闭环上线**(amis-editor 打通:去 StrictMode 修空白屏 / 画布高度约束可滚 / 滚动条可见 / 设计中心独立 tab / `editor.html` CSS import 进 bundle 修生产构建 404)——**解除历史 P1 头号阻塞「DesignerPage 实测不可用」** | web | `2278cbc`(去 StrictMode 修空白屏)、`8603d0f`(滚动条可见)、`3abeefe`(画布可滚)、`f39661a`(设计中心独立 tab)、`ae0155e`(editor.html CSS 进 bundle 修生产构建 404)、`690f4c7`(dev 反代默认 8093 开箱即通) |
|
||||
| **主子表四件套**(建模 / 派生字段 金额=数量×单价 / 父级聚合 总额 SUM / 引用驱动联动 选物料带出单价规格) | platform + web | platform `b0daaaa/d71ad6f/ce544fa/ba8177e/63e6522/3e4264d`(含排除标准审计列让生成页真正可用);web `934c646/c735f24/df0ac72/4a107f3/b578d8d`(向导映射 UI + 真事件 e2e;单选 select 经 `selectedItems.<源>` 取值) |
|
||||
| **AI 确定性(非 LLM)五环增量生产线合 main + 写路径对齐 + 三道硬门收口** | platform | platform-ai + platform-cli 两 Maven 模块;`e550725…6c60383`(blueprint 编译器 + recipe 闸 + 渲染计划闸)、`d3b8846`(**M3a:net-new 标准写收敛到单一 `PageSchemaWriter`** = 单一写真相基石)、`1ff0d33/5f32050/6c60383`(AI-recipe 增改删对齐保真层服务流 `_ADD/_UPDATE/_DELETE`,含 tree-crud 写口径,非自创 `/api/entity` save)、`bac69d8`(typed-recipe 闸只作用 AI 草稿不误伤设计器 overlay)、`c379f5b`(AI 端点要求 admin)、`9aea6c1`(对外措辞收敛为 AI 辅助 + 人审)。`POST /api/ai/features/auto-develop` 终态恒 READY_FOR_HUMAN_REVIEW |
|
||||
@@ -66,7 +66,7 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁
|
||||
| **A7** | 定时任务/调度 | 🔴 | 调度运行时未起步;但「定时任务·设置提醒人」保真端点 `ScheduleJobNotifyController` 已交付(c9e4d35,拆 SENDINFO JSON 为 amis input-table 可编辑回写) |
|
||||
| **A8** | RBAC/数据权限 parity | 🟡 | 菜单/用户/角色/部门/数据权限 5 块管理后台已建(CRUD + amis 页);用户管理达 parity,其余仍 demo 级未逐功能对照验收 |
|
||||
| **A9** | 个人设置/工作日历 | 🟠 | 工作日历视图已移植;个人设置(改密/年历)未起步 |
|
||||
| **A10** | 部署上线工程化 | 🔴(已出 design 待拍板) | 仍 dev(web 5173 + 后端 8093);生产构建 / 数据迁移 runbook 执行 / 性能并发 / 灰度未做(PG/Flowable Runbook 已备未执行切流)。**2026-06-25 已出工程化 design**(`plans/2026-06-25-A10-生产上线工程化-design.md`:现状底数 + 目标拓扑 + W1-W6 分解 + D1-D6 待拍板;MVP=W1 Flyway+W2 容器化+W3 nginx 单源+W4 compose 不卡环境可做) |
|
||||
| **A10** | 部署上线工程化 | 🟡(MVP 骨架已合 main,切流未执行) | 仍 dev(web 5173 + 后端 8093)。**2026-06-25 已落地 MVP 骨架**:design(`plans/2026-06-25-A10-生产上线工程化-design.md`,D1-D6 待拍板)+ **W1 Flyway 平台表迁移**(`platform-app/src/main/resources/db/migration/V1-V3`,本地 PG 真验,merge `f7675c9`)+ **W2-W4 容器化/nginx 单源/compose 编排**(`deploy/` compose+nginx.conf+.env.example+systemd、`platform-app`/`flowable-service` 模块根 Dockerfile,merge `97a0eb1`;后续 `fa3c92b` bootstrap 单一真相 / `2db44a6` 演示库自洽起栈)。**未做**:生产切流执行 / 数据迁移 runbook 实跑 / 性能并发 / 灰度(PG/Flowable Runbook 已备未执行) |
|
||||
|
||||
---
|
||||
|
||||
@@ -145,6 +145,11 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁
|
||||
- 以下**已完成的一次性 plan/报告标为「归档候选」**(本次未物理移动,避免破坏现行文档中的相对引用;可后续批量 `git mv` 入 `归档/`):`plans/2026-06-14-onEvent脚本挂回修复-plan.md`、`plans/2026-06-14-提交审批桥接-design.md`、`plans/2026-06-14-新闻管理垂直切片-plan.md`、`plans/2026-06-15-菜单维护树模式重建与树选择框修复-plan.md`、`plans/2026-06-16-WfTemplate驱动审批界面-完整实现方案.md`、`CRUD-QA-发现与剩余-2026-06-14.md`、`C3压测基线.md`、`C5构建预演报告.md`。
|
||||
- 以下 design/契约文档**正文有过时点**,顶部加「现状以 06-21 总览为准」横幅并指明过时处:`组件设计体系-design-2026-06-15.md`(「未开始」已过时)、`AI_AGENT_AUTO_DEVELOPMENT.md`(「只覆盖最简单 CRUD recipe」已过时,实有 tree-crud + master-detail)、`AI_AGENT_PAGE_BLUEPRINT_CONTRACT.md`(master-detail 列为未来 TODO,实已有 `master-detail-v1.yaml`)、`AI_AGENT_Nocobase_SOURCE_REVIEW.md`(P3 进度前后自相矛盾)。
|
||||
|
||||
**2026-07-02 文档-代码对抗核查对齐**(5 路并行核对本文 §9/§10/§11 + A/B 矩阵全部声明 vs 两仓代码,48 条声明 46 条完全一致、无虚报):
|
||||
- 修正本文与代码不一致处:A10 行 🔴→🟡(W1-W4 骨架 06-25 已合 main,本文此前低报);§9 P0② 表格「同族扩长」与对抗审查①矛盾(代码一律拒 TYPE 变更)已改;§10.2 render-plan 行号迁移至 `AiDraftGateValidator.java:246`;§11 报表单测 73→79;§2「五步编排壳」实为四步向导。
|
||||
- 代码侧同步修正:`CandidateUsersHandler` 类级 javadoc(scriptUser 已于 06-26 接入,注释仍写「WARN 降级未接入」)。
|
||||
- **归档候选物理归档执行**:上方列出的 8 份一次性 plan/报告 + `项目进度与路线-总览-2026-06-17.md`(已被取代)+ `plans/2026-06-20-人走五环建新功能-实施计划.md`(24 任务全完成)共 10 份 `git mv` 入 `归档/`,引用处(README 索引、M0剩余项登记、通用模板收口计划、架构方向-design)已同步改路径。
|
||||
|
||||
---
|
||||
|
||||
## 9. P0/P1 实施记录(2026-06-21 续·已落地 + E2E 验证)
|
||||
@@ -153,7 +158,7 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁
|
||||
|
||||
| 项 | 状态 | 交付 + 证据 |
|
||||
|---|---|---|
|
||||
| **P0② AI 门禁 + 引擎 ALTER 安全通道** | ✅ 完成·已验证 | (a) `AlterTableSqlGuard`(legacy-core,只允许 加列/同族扩长/改可空,拒 DROP/RENAME/SET NOT NULL/多语句/小写绕过)+ `DataDicService.executeAlterSql` 通道 + `MetaController POST /api/meta/entity/{table}/attributes` 加列端点(saveAttr 元数据 + 受控 ALTER 物理表 + evictByTable + 补索引);(b) `PageSchemaController` `?strict` 分流 + `GET /api/page/schema/overlay/audit` 白名单对账端点;(c) `AiAgentService.applyLocalRelease` 织入 `AiToolRegistry.check`(安全门 advisory→**enforced**,非本机/越权写路径 403)。**单测**:Guard 15/0、alter DDL 2/0、安全门 22/0(含新 FORBIDDEN 测试,112 基线无回归)、strict+审计 28/0。**真库 e2e**:建实体→加 4 列(数值/整型/字符串/引用)→元数据齐 + psql 物理列全生效 + 负控(重复列/不存在表/DROP 形态拒)全绿。 |
|
||||
| **P0② AI 门禁 + 引擎 ALTER 安全通道** | ✅ 完成·已验证 | (a) `AlterTableSqlGuard`(legacy-core,只允许 加列/改可空——同族扩长即 ALTER COLUMN TYPE 已经下方对抗审查①移除,拒 DROP/RENAME/SET NOT NULL/TYPE 变更/多语句/小写绕过)+ `DataDicService.executeAlterSql` 通道 + `MetaController POST /api/meta/entity/{table}/attributes` 加列端点(saveAttr 元数据 + 受控 ALTER 物理表 + evictByTable + 补索引);(b) `PageSchemaController` `?strict` 分流 + `GET /api/page/schema/overlay/audit` 白名单对账端点;(c) `AiAgentService.applyLocalRelease` 织入 `AiToolRegistry.check`(安全门 advisory→**enforced**,非本机/越权写路径 403)。**单测**:Guard 15/0、alter DDL 2/0、安全门 22/0(含新 FORBIDDEN 测试,112 基线无回归)、strict+审计 28/0。**真库 e2e**:建实体→加 4 列(数值/整型/字符串/引用)→元数据齐 + psql 物理列全生效 + 负控(重复列/不存在表/DROP 形态拒)全绿。 |
|
||||
| **P1④ 人走五环 v2 · 改表加列** | ✅ 完成·浏览器 E2E | 前端 `meta.ts alterEntity` + `ModelerPage` 行内「加字段」Dialog(复用 FieldTable);打破「v1 只建新不改表」。**build 绿**(tsc 无错)+ **vitest 73/73**。**浏览器 E2E**:`five-ring.spec.ts` 新增「改已有表加列(建模器加字段→元数据落库)」,与五环/主子表共 **5/5 绿**。recipe 扩面(M7 新页型)暂缓。 |
|
||||
| **P1⑥ 运行时 DELETE + 菜单授权** | ✅ 完成·真库 e2e | `PageSchemaWriter.deleteStandard` + `DELETE /api/page/schema/{tpl}/standard`(@Transactional 对称撤销:删 schema+overlay+软删菜单+清 sys_role_menu);`MenuRegistrar.grantToRoles` + `PublishOrchestrator.grantMenuRoles` + `DesignFeatureController.publish` 透传 roleIds(缺省 warning)。**单测**:PageSchemaWriter 6/0、MenuRegistrar 4/0、PageSchemaController 28/0、DeploymentPackageBuilder 1/0(无回归)。**真库 e2e**:发布带 roleIds→授权写 sys_role_menu ✓、无 roleIds→warning 负控 ✓、DELETE 对称撤销(计数全对)+ GET→404 + psql 核对授权落库/清除 ✓。部署包下沉(builder unify)暂缓(纯重构、回归风险高、可见价值低)。 |
|
||||
| **P1⑤ 审批列表入口** | 🟡 接线完成·e2e 验证(运行时阻塞) | 列表入口接线**已 live**:228 个 sys_page_schema 含 `openApprovalDrawer` 按钮(psql 实证名实一致)+ 既有单测(registerApprovalAction 5/converter)。**浏览器 E2E**:新增 `approval-list-entry.spec.ts`(纯 mock)验证生产主路径「转换列表页按钮→选中行→openApprovalDrawer→AppShell→ApprovalDrawer 抽屉打开」1/1 绿。**外部阻塞**:点同意后真实流程流转/候选人计算需客户 BPMN(act 库 dev 不可达);BPMN 流程图编辑器=B3 级另案。 |
|
||||
@@ -199,8 +204,8 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁
|
||||
- **✅【已完成 2026-06-24·稳定性三件套】稳定性配置真空 · high**:原状=HikariCP `maximum-pool-size:5` + `statement_timeout` 全仓零命中 + perPage 无封顶 + `queryForRowSet` 全量物化,四者叠加=一个大/恶意查询(`perPage=999999`)即耗尽连接 + OOM。**已做**:① perPage 硬封顶——新增 `Pagination.clampPerPage`(上限 5000,护栏非产品限),接入 `FlowController.applyPaging` 与 `PickerController.list` 两处 REST 入口(`page` 不封,深翻页合法);② `statement_timeout`——base `application.yml` 加 `hikari.connection-init-sql: SET statement_timeout='${EIP4_DB_STATEMENT_TIMEOUT:120s}'`(dev/local 继承、prod 无 profile 亦继承 base,可环境变量放宽/设 0 关闭);③ 连接池 `maximum-pool-size` 5→20(prod 继承 base 受益)。**验证**:`PaginationTest` 3/3 + `FlowControllerTest`(含新「perPage 超大封顶」集成测试,经真实 `executeGet` 路径) + `PickerControllerTest` 无回归=68/68 绿;`SET statement_timeout='120s'` 经真实 PG(localhost:5433)执行 `SHOW`=2min 确认语法/取值正确;`application.yml` YAML 解析校验通过。**残留(独立较大项,未做)**:`SqlRowSet` 全量物化 → 导出走流式 `RowCallbackHandler`(属性能 P2,见 §10.3)。
|
||||
|
||||
**【生产交付能力 — 意图与实现最大成体系缺口,对应 A10】**
|
||||
- **Flyway 平台表迁移未实现 · medium · L**:`架构设计.md:36` 承诺 Flyway,全仓零命中;SYS_* 建表散落 bootstrap/`*_upsert.sql`/CLI 内嵌(`bootstrap-ai-agent.sql` 两份易漂移)。→ 引入 Flyway 收敛为 `V{n}__*.sql` 单一真相。
|
||||
- **4 进程交付无 compose/Dockerfile/Nginx 配置 · medium · L**:`find docker-compose*` 零命中,切流/回滚仅停留文档。→ 补 `deploy/`(compose 四服务 + 健康检查 + `nginx.conf` 切流 upstream + `.env.example`)。
|
||||
- **✅【已完成 2026-06-25·A10 W1】Flyway 平台表迁移**:`platform-app/src/main/resources/db/migration/V1__sys_page_schema.sql`/`V2__sys_datastatus.sql`/`V3__sys_ai_agent.sql` 单一真相,本地 PG 真验(merge `f7675c9`);`bootstrap-ai-agent.sql` 重复已去(`11e668a`/`fa3c92b` 收敛 bootstrap 单一真相)。
|
||||
- **✅【已完成 2026-06-25·A10 W2-W4】compose/Dockerfile/Nginx 骨架**:`deploy/`(docker-compose.yml + nginx.conf + .env.example + systemd/ + postgres-init/)+ `platform-app/Dockerfile`、`flowable-service/Dockerfile`(merge `97a0eb1`,`2db44a6` 内置演示库自洽起栈)。**残留**:生产切流/灰度未执行(见 A10 行)。
|
||||
- **✅【已完成 2026-06-24】可观测性近零**:原状=无 actuator/无健康端点/无 logback 配置/base 日志 DEBUG(prod 继承会刷屏)。**已做**:① platform-app 加 `spring-boot-starter-actuator`,`management` 只暴露 `health`(`probes.enabled` 开 liveness/readiness,`show-details/components: when-authorized` 匿名不泄露 db 等组件细节)——不上 Prometheus 全家桶,守中间件最小化;② `SecurityConfig.PUBLIC_PATHS` 加 `/actuator/health(/**)`,prod 链探针免认证可达;③ 新增 `logback-spring.xml`(控制台 + 50MB×14 天滚动文件,文件 appender 仅 dev/local/prod 启用、不污染单测);④ base `application.yml` 的 `com.dsasp`/`jdbc.core` 日志 DEBUG→INFO(prod 继承 INFO,dev 仍 DEBUG)。**验证**:真启动 dev profile(1.7s 起)curl `/actuator/health`=`200 {"status":"UP","groups":["liveness","readiness"]}`、`/health/readiness`=200 UP、`/health/liveness`=200 UP;SecurityProfileTest 3/3 + ArchitectureRulesTest 6/6 无回归。**残留**:prod JSON 结构化日志需 Spring Boot 3.4 内建或 logstash-encoder 依赖,留作后续(避免现在加依赖)。
|
||||
|
||||
**【验证体系】**
|
||||
@@ -211,7 +216,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`。
|
||||
- **【采纳自原文档 D1】render-plan 无执行闭环 · high · M**:`validateRenderPlanGate`(SRP 拆分后已迁至 `AiDraftGateValidator.java:246`)纯字段校验,Playwright 只在生成的人工指令字符串里,`READY_FOR_HUMAN_REVIEW` 不含渲染证据。→ 新增 headless render runner 真跑 renderTests 后回写 `runEvidence`。
|
||||
- **✅【已完成 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 合并做)。
|
||||
- **🟡【有界安全修已完成 2026-06-25,完整支持仍 L】前端 scriptCommands 联动静默哑火**:原状=`scriptCommands.ts` 把 `setLabel/setRequired/setFilter/setOptions/setNullSelection/setStyle` 翻成 amis `setValue`,但核实 amis `setValue`(CmptAction)只读 `args.value`、丢弃语义 args → 运行时 no-op(且 `args.value` 为 undefined 经 onChange 路径可能清值);amis 全量 `registerAction` 无这些动词的内置 action。**已做(有界安全修,eip4-web origin/main=`68d797e`)**:6 个动词改为<strong>显式跳过(返回 null,translateCommands 自动过滤)+ 一次性 `console.warn`</strong>——消除清值风险、不再伪装「已处理」、不再用假绿单测掩盖;新增覆盖(跳过/整体过滤/告警去重),full vitest 83/83 + tsc -b 干净。**仍 L(未做)**:要让「动态必填/选项/过滤」真生效需<strong>转换器侧生成数据绑定 schema</strong>(`requiredOn`/`source` 绑数据变量)+ 重放改数据变量 + Playwright 真 DOM e2e,跨 platform-converter + eip4-web,对冻结 amis-fork 有回归面,需独立排期。
|
||||
@@ -254,7 +259,7 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁
|
||||
| 2 | 残留收口:结果集 `maxResultBuffer` 驱动层封顶(防 `TYPE_SCROLL_INSENSITIVE` 全量物化 OOM)+ 多值 `IN (${LIST})` 逗号放行 | `dccca17` |
|
||||
| 3 | CVE 依赖替换(commons-collections 3.0→3.2.2 / log4j 1.2.8→reload4j 1.2.25,引擎 jar 不可改但依赖可换)+ 报表只读数据源(`eip4.report.db.*`,未配回落主源,向后兼容)+ 只读账号 GRANT/巡检 SQL | `d697885` |
|
||||
|
||||
**审计头号风险**:报表 SQL 的 `${PARAM}` 经 jatools `evalTemplate` **字符串拼接**进 SQL 后 `prepareStatement` 执行(无占位符绑定)→ 全参数 SQL 注入。引擎为预编译 jar 不可改,故全部在包装层收口(`ReportParamGuard` 等 11 个类、73 单测)。
|
||||
**审计头号风险**:报表 SQL 的 `${PARAM}` 经 jatools `evalTemplate` **字符串拼接**进 SQL 后 `prepareStatement` 执行(无占位符绑定)→ 全参数 SQL 注入。引擎为预编译 jar 不可改,故全部在包装层收口(`ReportParamGuard` 等 11 个类、79 单测)。
|
||||
|
||||
**关键验证**:数值上下文注入 `?PROJECTID=0 union select…` → 400;IDOR 非超管越权 → 403、超管 bypass → 200;`maxResultBuffer` 经独立 JDBC 探针在同款 `TYPE_SCROLL_INSENSITIVE` 路径实证超限即抛非 OOM;CVE 替换后依赖树/运行时 classpath 实证生效、live HTML/PDF=200 无 ClassNotFound。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user