Files
eip4-platform/docs/项目进度与路线-总览-2026-06-21.md
zhengwr adae344323
Some checks failed
ci / build-test-parity (push) Has been cancelled
docs: 核实修正——EIP-3.0 业务源码已在本地,P1③ 仅剩 S1 拍板一重阻塞
用户指出 eip3 源码在当前目录:核实 ../EIP-3.0/(3.1G,pm/hr/oa/dm+framework)确已存在,
总览三处「源码未克隆/在远仓」表述过时修正;并核实当前 eip4 库(5433)=1512 真实 BPMN bytearray+1503 部署+143 act_re_model

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 08:58:18 +08:00

271 lines
52 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# EIP3 → EIP4 项目进度与路线 · 总览(2026-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 核实存在。
---
## 0. 一句话进度
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 类 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),切流执行 / 性能并发 / 灰度未做。
---
## 1. 规模底数(2026-06-17 实测,仍有效)
| 项 | 数 |
|---|---|
| `view_template` 模板总量 | **1516** |
| ├ 通用(无 engineclass,走转换器) | **1363** |
| └ 定制(有 engineclass) | **153** = framework **47** + 业务 pm/hr/oa/dm **106** |
| `sys_page_schema` 已转换页(含 view_page 表单) | 2729 |
| 类型分布 | 列表 type1=858 / 报表 type200=339 / type100=121 / 编辑表单 type7=70 / 树 type3=50 / 树Grid type4=45 / 组合 type6=20 / 树选 type101=11 |
> 元数据单一真相:`SYS_ENTITY` + `SYS_ENTITYATTRIBUTE`(老系统保真层原物,新旧共用)。eip3 本身即元数据驱动低代码平台,「转换」只动页面层,元数据一行没转。
---
## 2. 06-17 → 06-21 增量交付(本期里程碑)
> 两仓 origin/main 终点 = merge commit(eip4-platform `75f942b` / eip4-web `d1fd6ed`),本地 main == origin/main(已 push,无需再决策)。AI 工作 20 提交(`a51f353 → 9aea6c1`)随 human-five-ring 推上 origin/main。
| 交付 | 仓 | 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 |
| **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 |
| **附件双态组件**(查看只读可下载 / 编辑可增删;读路径大写 DOCUMENT 归一 + 写路径对账落库) | platform | `22211b2`(转换器 buildAttachmentField 收敛单个 input-file + `staticOn ${__readonly}`;FlowController.resolveAttachmentFields 修空白图标 + normalizeAttachmentFieldsForWrite 交保真层落库) |
| **framework 视图移植 P2**(审批历史抽屉 / 我发起的流程 / 流程监控 / 数据导入 / 脚本编辑器 / 工作日历 / treegrid 过滤搜索 / 用户+流程 picker 对齐 / 短消息 + 消息详情;定时任务「设置提醒人」) | platform + web | platform `57c3412…d218c2b` 一批(机制① delta 注入 + 整页改写器 + filterscript 级联 + `_SEARCH` real-first + 搜索时间段 + 树编辑 layout)、`c9e4d35`(**DataImportConfigController** 315 行 + **ScheduleJobNotifyController** 397 行,均含单测);web `bf7bb25`(picker parity + 消息详情)、`0d6fab4`(用户选择框 → amis picker)、`d03c2ba`(审批历史抽屉)等 |
---
## 3. A:EIP3 兼容矩阵(老模板可用性)→ 刷新至 06-21
档位:🟢 基本可用 | 🟡 demo/部分(有页/端点未逐功能验收)| 🟠 通用页已产·engineclass delta 未移植 | 🔴 未起步
| ID | 工作块 | 档位 | 说明 |
|---|---|---|---|
| **A0** | 通用模板 1363(转换器) | 🟢 | 基本可用。P0 三项(日历 type5 / 树 type3 / 组合 type6)源码 `598f4f9` 已实现,后续多轮全量重转重导已执行,运行库大概率已生效(**需复核**);残 P1 = 19 页缺 EDITFORM 映射 + onselected/filter/enableButton 脚本挂回 |
| **A1** | 153 定制视图(framework 47 + 业务 106) | 🟠 | framework 除用户管理(parity,`bf7bb25/0d6fab4/17c449c`)外多项已移植(审批历史 / 我发起 / 脚本编辑器 / 工作日历 / treegrid),按 Java 类去重约 38 待写单元;**业务 106 基本没动 = 最大块**(源码已核实在本地 `../EIP-3.0/`,pm/hr/oa/dm 3.1G,2026-07-02);终判 158.75 人日卡 S1 止损评审 |
| **A2** | 流程审批优化 | 🟢 | ApprovalDrawer / WfTemplate 驱动审批 / 审批历史抽屉 / 监控按钮(撤回/结束/高级,早已 live)+ **2026-06-26 审批闭环批补齐**:协办(assist)/转阅(circulated)动作、BPMN 流程图查看(bpmn-js)、会签(BPMN 多实例,scriptUser 候选人解析移植)、会签进度「已会签 N/M」、**xerces 击穿修复**(report 古董 xerces 击穿全部 WfTemplate 解析,已钉 JDK 解析器)。均单测+live。仅剩**客户 BPMN 真实流转(前置①外部)**与**流程定义 Modeler(=B3)**。详见 `docs/plans/2026-06-25-审批闭环-实施计划.md`(main `c95eaee`) |
| **A3** | 报表系统(339) | 🟢 | **套打 JOR 重宿主已完成**(复用客户预编译引擎 headless 渲染,328/339 type=200 为报表查看器 crud,`/api/report/render` 三格式 HTML/PDF/XLS + iframe 保真,push `53f3c25`)+ **保真层安全/OOM 收口已完成**(见 §11,三批 merge)。残:中文字体保真细化 / 钻取链接 / 完整客户库逐张对账;图表 ECharts、报表设计器 B6 仍未起步 |
| **A4** | 附件系统 | 🟠 | 双态组件已上线;缺图片预览、老附件物理文件迁移(下载 403)、DOCUMENT 全生命周期 |
| **A5** | 消息 & 邮件 | 🟠 | 短消息发送 + 消息详情已移植;webmail(IMAP/SMTP)独立子系统未起步;已读联动未接 |
| **A6** | 数据导入/导出 | 🔴 | 数据导入配置端点 `DataImportConfigController` 已落(c9e4d35);整体 FTP+Excel 导入管线 / Excel 导出未成体系 |
| **A7** | 定时任务/调度 | 🔴 | 调度运行时未起步;但「定时任务·设置提醒人」保真端点 `ScheduleJobNotifyController` 已交付(c9e4d35,拆 SENDINFO JSON 为 amis input-table 可编辑回写) |
| **A8** | RBAC/数据权限 parity | 🟡 | 菜单/用户/角色/部门/数据权限 5 块管理后台已建(CRUD + amis 页);用户管理达 parity,其余仍 demo 级未逐功能对照验收 |
| **A9** | 个人设置/工作日历 | 🟠 | 工作日历视图已移植;个人设置(改密/年历)未起步 |
| **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 已备未执行) |
---
## 4. B:EIP4 新能力矩阵 → 本期重大刷新
| ID | 工作块 | 档位 | 说明 |
|---|---|---|---|
| **人走五环** | NocoBase 式建模器 + 实时设计器 v1 | 🟢 | **v1 全链交付 + live 验收 + 合 main 两仓**(platform 418 单测 / web 73 vitest)。五环①②③④(含引用列)+ AI①面恒 READY_FOR_HUMAN_REVIEW + production 人审部署包(requiresHumanApproval=true)+ 主子表四件套全完,红线全守。**v1 限简单 CRUD/树 recipe + 只建新不改表** |
| **B1** | 新设计器(低代码可视化) | 🟢 | **选型已拍板**:D1 签字下注 amis-editor(接受 amis-fork 6.13.0 冻结天花板 / bus factor≈1 自维护);形态 = NocoBase 式建模器 + 实时设计器,不做线性 wizard。**DesignerPage 已修到全闭环**(`2278cbc` 等 6 提交),原 P1 头号阻塞已解除 |
| **B2** | AI 模块 | 🟢 | **确定性(非 LLM)五环增量生产线已合 main**(超 PoC)。platform-ai + platform-cli 落地;终点恒人审、平台不内置生成 LLM(唯 LLM 修复 `HttpAiLlmRepairClient` 默认关、只修不生成)。落地 P0/P1/P2/P4/P5 第一版完成,P3 进行中 |
| **B3** | 流程建模器 BPMN Modeler | 🔴 | 未起步(即 A2 现在唯一缺的「流程定义在线编辑」)。注:BPMN 只读**查看**已做(A2 流程图,bpmn-js NavigatedViewer);Modeler=可编辑+部署,需 S1 拍板自研 vs 嵌入 flowable-modeler |
| **B4** | 生产级 UI/UE 组件体系 | 🟡 | L1 主题(amis-theme.css §10-15 密度/按钮/弹窗/字号)+ L2 行选中 `checkOnItemClick` + 设计中心 DesignCenterPage 已上线;剩选择框统一 / 主子表宿主 / 树编辑 Drawer / 审批待办 未完整(`组件设计体系-design-2026-06-15` 落地状态需对齐本矩阵) |
| **B5** | 移动端 / 响应式 | 🔴 | 未起步 |
| **B6** | 报表设计器(自助报表) | 🔴 | 未起步(与 A3 同根待立项) |
| **B7** | 平台底座 | 🟡 | 元数据单一真相 + `PageSchemaWriter` 单一写真相(`d3b8846`)+ 五重门禁(page-recipe / typed-page-schema / amis-schema / local-smoke / render-plan)已建 |
---
## 5. 下一步工作(优先级排序)
> 来源:综合 6 路盘点 + 对抗核对;size:S=小 / M=中 / L=大。
### P0(先做,本期)
1. **【S,本文即产出】刷新主进度文档到 06-21**:本总览已建;下一步把 `README.md` 索引刷到 06-21、补登 plans/06-19/06-20 三份新 design 与 AI 契约导航、标注已完成的一次性 plan/简报为「归档候选」。*理由:文档时间线断层(最新交付 06-21,文档停 06-17),接手者会被误导。*
2. **【M】AI 门禁余项收口**:存量 overlay 组件 vs 白名单清零、引擎 ALTER 安全通道(`executeCreateSql` 现只接受 CREATE,net-new 仍有裸 JDBC 旁路风险)、安全门 advisory → enforced。*理由:合 main 硬门已清,但这批非红线清理是安全门转强制的前提。依赖:AI 分支已合 main(75f942b)。*
### P1(紧接其后)
3. **【L】framework 业务 106 视图(pm/hr/oa/dm)engineclass delta 移植启动**:A1 真实大头。机制① `EngineclassDelta` 注册表 + 用户管理 Delta 移植方法论已就位可复用。*依赖:S1 止损评审定处置方式(见 §6)。*
4. **【L】人走五环 v2**:ALTER 改已有表(引擎现零迁移路径)+ 主子表/审批/组合 tabs recipe 扩面(路线图 M7)。*须作为新 recipe 增量加入 blueprint,不得绕过门禁。依赖:v1(75f942b/d1fd6ed)+ 引擎 ALTER 安全通道(#2)。*
5. **【✅ 大部完成 2026-06-26】流程审批闭环**:协办/转阅/BPMN流程图/会签/会签进度/监控按钮/xerces修复 全部已做并合 main(`c95eaee`)。**仅剩**:客户 BPMN 真实流转(外部依赖)+ 流程定义 Modeler(=B3,S1 拍板)。*amis 列表入口按钮接线此前已 live(228 页 openApprovalDrawer)。*
6. **【M】AI 链与人工链部署包统一**:`DeploymentPackageBuilder` 下沉(platform-metadata 与 platform-ai 各一份)+ 净新标准页运行时 DELETE/回滚端点 + publish 写角色菜单授权(现仅 INSERT sys_menu,非超管不可见)。*影响人走五环 v1 完整可用。*
### P2(立项 / 排期)
7. **【L】报表系统 A3 立项**:套打 JOR(45) + 图表 ECharts + 打印 + 报表菜单树路由(与 B6 报表设计器同根,体量大独立立项)。
8. **【M】附件 A4 补完**:图片预览 + 老附件物理文件迁移(修下载 403)+ DOCUMENT 全生命周期。
9. **【L】生产上线工程化 A10**:生产构建 / 单源托管(Nginx 或 Spring 伴服 dist + /api)/ 数据迁移 runbook 执行 / 性能并发 / 灰度。*客户最终交付硬门,越早打通越好。*
10. **【M】生产级 UI/UE 组件体系 B4 补完**:选择框统一 / 主子表宿主 / 树编辑 Drawer / 审批待办(L1/L2/设计中心已上线,补 P1-P4 模式骨架)。
---
## 6. 待拍板决策(决定后续排期)
1. **153 定制视图终判三选一**(分期交付 / 引第三方甘特组件 / 扩预算):158.75 人日 ≈ 7.56 人月,超 3 人月止损线,卡 S1 止损评审会。framework 47 已大幅推进,但业务 106 是主体,处置方式直接决定工期。
2. **②面 in-app AI employees / 平台内置生成 LLM 是否立项及时点**:v1 红线 = 平台进程内不内置生成 LLM(AI 走①面外部 agent + Skills + CLI)。②面何时启动、是否触碰对外口径红线待产品决策。
3. **type100(116) / type101(10) 列表选择框死页**:运行时由 `/api/picker/{dialogid}/list` 承接、不读这些 schema;是彻底停转还是留待低代码处理。
4. **onEvent 声明式面板(M5)自动化率目标与人工兜底边界**:逻辑编排 = b 声明式 80% 主干 + 人工 20% 兜底 + c AI 增量(D3),架构标最高不确定环;S3 自动化率 <80% 触发工期重估。
5. **对外口径统一**:人走五环 + AI①面已交付,客户演示/报价如何呈现「AI 辅助」而不越「严禁承诺 AI 全自动开发」红线。
6. **邮件全家桶(webmail IMAP/SMTP)是否纳入本期 parity 必交范围**:独立子系统、体量大。
---
## 7. 现行权威文档导航
| 类别 | 文档 |
|---|---|
| 进度权威(本文) | `项目进度与路线-总览-2026-06-21.md`(A/B 矩阵 + 下一步 + 待拍板) |
| 架构基线 | `架构设计.md`、`迁移手册.md` |
| 方向 / 特性 design | `plans/2026-06-19-EIP4开发平台-架构方向-design.md`(D1-D7)、`plans/2026-06-20-人走五环建新功能-NocoBase式-design.md`、`plans/2026-06-25-A10-生产上线工程化-design.md`(待拍板 D1-D6 + W1-W6) |
| 活路线图 | `plans/2026-06-19-EIP4开发平台-落地执行路线图.md`(M0-M8,状态随里程碑回写) |
| AI 契约 | `AI_AGENT_AUTO_DEVELOPMENT.md`(对外口径红线)、`AI_AGENT_PAGE_BLUEPRINT_CONTRACT.md`、`AI_AGENT_REPAIR_CONTRACT.md`、`AI_AGENT_Nocobase_ADOPTION_PLAN.md` + `skills/` |
| 决策红线来源 | `决策与盘点/EIP3架构决策会纪要.md`(对外口径红线:严禁承诺 AI 全自动开发)、`决策与盘点/EIP3架构决策报告.md` |
| 运维 runbook | `P0-PG升级/PG升级Runbook-v1.md`、`P3-Flowable升级/Flowable升级Runbook-v1.md` |
| A 兼容台账 | `framework定制视图-engineclass移植backlog-2026-06-17.md`(主 backlog)、`framework定制视图-TODO-2026-06-17.md`(活清单·Done/In-Progress/待验三态)、`用户管理-Delta移植-实现过程与踩坑-2026-06-17.md`(方法论/交接) |
| 通用模板线 | `通用模板全类型可用性-通盘盘点与收口计划-2026-06-16.md` |
---
## 8. 文档整理动作记录(2026-06-21 本次)
- **新建本文**为进度权威;`项目进度与路线-总览-2026-06-17.md` 顶部加「已被取代」横幅。
- **README.md** 刷新到 06-21(索引 + 模块完成度 + 导航 + 下一步)。
- **`plans/2026-06-20-人走五环建新功能-实施计划.md`** 加「24 任务全部完成 + 合 main」横幅;**`plans/2026-06-19-EIP4开发平台-落地执行路线图.md`** 回写里程碑状态。
- 以下**已完成的一次性 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 验证)
> 本节记录文档对齐之后启动的 P0/P1 实施。代码**已提交两仓特性分支 `feat/p0p1-impl`(未 push)**:eip4-platform 4 提交(docs / P0② / P0②b+P1⑥ / 对抗审查修复)、eip4-web 1 提交(P1④+P1⑤)。后端改动 `mvn -pl platform-app -am package` 重建 jar + 重启 8094 验证(已执行)。验收脚本:`scripts/p0-alter-acceptance.sh`、`scripts/p1-6-acceptance.sh`。
| 项 | 状态 | 交付 + 证据 |
|---|---|---|
| **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 级另案。 |
| **P1③ framework 业务 106 视图** | 🔴 未启动·待拍板 | 卡 S1 止损评审(§6 待拍板①:分期/第三方/扩预算),需客户决策方向。源码已在本地 `../EIP-3.0/`(2026-07-02 核实),仅剩决策一重阻塞。 |
**对抗审查收口(2026-06-21)**:实施完成后用 3-lens workflow 对自己的 P0②/P1⑥ 代码做对抗审查,揪出并修复 **4 major + 多 minor 真 bug**——①Guard 移除 ALTER COLUMN TYPE(静态守卫拿不到旧尺寸,缩短 `varchar(1)`/`numeric(1,0)` 会截断/溢出存量数据);②`addAttributes` 校验-写分离 + `@Transactional` + ALTER 失败抛异常(防孤儿元数据,PG 事务性 DDL 一起回滚);③`createEntity` 检查 `executeCreateSql` 返回值 + `@Transactional`(引擎拒建表不再静默成功);④`AiToolRegistry.isLocalEnv/isProductionEnv` 改 URI host 精确解析(防 `http://127.0.0.1.evil.com` 伪本地前缀绕过安全门);⑤`grantToRoles` 改 `INSERT...WHERE NOT EXISTS`(**实证 `sys_role_menu` 无唯一约束→`ON CONFLICT DO NOTHING` 不去重→重复发布插重复行**)+ `deleteStandard` trim/isactive 过滤 + `publish` roleIds 只接 String + `columnSqlType` 空 refTable 抛错。修复后全单测 + 双真库验收(含幂等 [2b])+ 浏览器 e2e 6/6 全绿。overlay 审计端点实跑:dev 库仅 1 overlay 用 `dialog`/`submit`(白名单偏窄,非存量页问题)。
**红线遵守**:引擎 ALTER 经 `AlterTableSqlGuard` 白名单(defense-in-depth:控制层 + 保真层双校验),只加列/恒可空、移除 TYPE 变更,杜绝破坏性 DDL;DDL 仍收口保真层单点;net-new 标准层删除收口 `PageSchemaWriter`,不裸 JDBC 旁路。
**仍待(按优先级)**:P0②余项(存量 overlay 白名单 strict 化推进,审计端点已提供对账数据)/ P1④ recipe 扩面 M7 / P1⑥ 部署包下沉统一(已查:两生成器**当前逻辑等价无 bug**,统一是防未来漂移的纯重构,需改 AI 黄金测试,低优先)/ P1⑤ 真实流转(依赖客户 BPMN)/ **P1③ framework 业务 106 视图(阻塞=待 S1 拍板;EIP-3.0 源码已核实在本地 `../EIP-3.0/`,2026-07-02)**。
---
## 10. 架构改进待办(2026-06-24 核实并并入)
> 来源:① 一轮 8 维度架构评审(模块边界 / 巨型类 / 安全 / 性能 / 前端 / AI 五环 / 测试 / 运维),② 对另一份《EIP4 架构分析与改进建议》(其他 agent 产出)逐条对照**真实代码**核实(确认 / 夸大 / 已缓解 / 有意取舍)。**本节合并其可采纳内容,原文档已删除**(无外部引用)。
> **定级第一原则=可达性**(无需前提即可触达 > 需管理员/DBA 前提的二阶面),而非「是否存在字符串拼接」。下列项**独立于 §5/§9**:§9 收口的是 AI 写路径安全门,本节是评审新发现的、AI 链之外的可达攻陷面与工程缺口。
### 10.1 P0 — 安全/工程止血(可达攻陷面 + 零回归防护)✅ 全数收口(2026-06-25)
> 三条安全项强耦合(都靠「非 prod permitAll / prod 仅 authenticated」放大),建议作为一个「**安全基线**」批次一起做。
**✅ 全数收口(2026-06-25·安全基线批次)**:本节 4 项 P0 + 独立 security-reviewer 对抗评审追加的 2 个同类孪生漏洞 + Groovy 沙箱硬化,已全部 TDD + 全 reactor `mvn clean install` 绿 + 原子提交 --no-ff 合 main 并 push origin(**eip4-platform origin/main=`eba9ce1`、eip4-web origin/main=`2a37251`**)。逐项落地:
> - **①RCE/任意 DROP**:拆 `ScriptExecuteController`——任意请求体 Groovy 的 `/api/script/execute` + `/api/script/execute-template-by-name` 移入 `@Profile(SecurityProfiles.BYPASS=dev|local|ci|parity)`,生产仅保留**只重放脚本库内已审产物**的新 `ScriptReplayController`(`/api/script/execute-template`);`RewrittenScriptStore.load` 加 templateId 路径穿越守卫(resolve+normalize+startsWith root,+NUL 字节兜底);三个 `Poc*Controller`(含裸拼 DROP)全 `@Profile(BYPASS)`。(`980d83e`)
> - **②安全默认 fail-open**:宽松 permitAll 链由 `@Profile("!prod")` **反转为显式 opt-in** `@Profile("dev|local|ci|parity")`,严格认证链覆盖默认(含裸 `java -jar` 未设 profile)与 prod;新增 `SecurityProfiles`(旁路名单唯一真相)、`JwtSecretSafetyCheck`(严格 profile 用 dev 默认密钥即启动 fail-fast)、`application-prod.yml`(JWT/DB 无默认值、强制环境变量)。(`24160db`)
> - **③asUser/roles 越权**:`EntityController.buildCtx` 调换优先级 → JWT 绑定身份**恒权威**,客户端 asUser/roles 仅在无 JWT 身份时(非生产旁路)生效。(`1f2365f`)
> - **④CI 孤儿**:`.github/workflows/ci.yml` → `.gitea/workflows/ci.yml`(JDK 改 21);`ci.sh` 起服务加 `--spring.profiles.active=ci`(配合 fail-safe,否则健康检查 401/对拍免令牌失效);新增 eip4-web `.gitea/workflows/ci.yml`(tsc+build+vitest)。(`1a0985f` / web `63d46af`)。**前置条件**:Gitea 需启用 Actions 且注册 `ubuntu-latest` 标签 act_runner 才真跑。
> - **🔴 评审追加(原 §10.1 漏列的同类孪生,已一并修)**:(a) **CRITICAL** `TodoController.runProcessAdvancedScript`(`/api/workflow/process/{id}/advanced-script`)执行请求体 Groovy、无 `@Profile`/无角色门 = 任意认证用户 prod RCE → 注入 `Environment` + `SecurityProfiles.isBypassActive` 守卫,严格 profile 直接 amisFail 不执行(`bc9ae8c`);(b) **HIGH** `PickerController.buildCtx` 与 EntityController 同款 asUser-first IDOR(prod 可达)→ 同改 JWT 权威(`1f2365f`)。
> - **Groovy 沙箱硬化(评审 MEDIUM)**:强化 `MethodCallExpressionChecker`(原仅挡 `System.exit`)→ 编译期拦反射/进程执行/元编程/动态求值(Runtime/ProcessBuilder/`'cmd'.execute()`/Class.forName/反射/GroovyShell/metaClass/危险 System 方法…),覆盖 MethodCall/StaticMethodCall/ConstructorCall/Property 四类表达式;一处收口两条运行时 Groovy 路径(服务流 + onEvent/editgrid 重放,均经 `SecureGroovyScriptEngineFactory`)。先勘探 1428 改写脚本语料确认零使用再 TDD(8/8)+ 全语料编译零加固回归。(merge `eba9ce1`)
> - **生产上线 checklist(运维必知,fail-safe 行为变更)**:prod 必须 `-Dspring.profiles.active=prod` 且设 `EIP4_AUTH_JWT_SECRET`/`EIP4_DB_*`,否则按设计启动失败;`run-dev.sh`(dev)/`ci.sh`(ci) 已自带旁路 profile,本地/对拍不受影响。
> - **未做(更小,DEFER)**:`@EnableMethodSecurity` + 方法级 IMPERSONATE 角色(现以 profile-gate + JWT 权威已闭可达面);`EditGridScriptController` view_page id 白名单(脚本=DB 内已审 + 沙箱已硬化,残余风险低);`SecureASTCustomizer.setIndirectImportCheckEnabled(true)`(服务流脚本不在勘探语料、风险更高);新增「禁生产源码出现 `Poc*` 的 @RestController」ArchUnit 规则(现 3 个 Poc 已 @Profile 隔离)。
| 项 | 严重度 | 证据(file:line) | 建议 |
|---|---|---|---|
| **RCE — `/api/script/execute` + `/api/poc/write-test`** | ✅ 已修(06-25) | `ScriptExecuteController.java:65→:193-198` 真执行请求体 Groovy(不受 facade 绑定约束=任意 Java/RCE),无 `@Profile`、无鉴权;`PocWriteTestController.java:181` `jdbcTemplate.execute("DROP TABLE IF EXISTS "+target)` 裸拼旁路 `DropTableSqlGuard`,无 `@Profile`。三个 `Poc*Controller` + 散落 `/api/poc/*` 随生产 jar 装配;全平台 `@PreAuthorize` 0 命中且无 `@EnableMethodSecurity` | 生产构建移除 / `@Profile("!prod")` 隔离全部 `Poc*`/`ScriptExecute` 端点;保留者加平台管理员级鉴权(开 `@EnableMethodSecurity`);新增 ArchUnit 规则禁生产源码出现 `Poc*` 的 `@RestController` |
| **安全默认 fail-open** | ✅ 已修(06-25) | `SecurityConfig.java:68-71` `@Profile("!prod")`→`anyRequest().permitAll()`(default/local/ci/dev 全放行);prod 严格链(`:50-61`)存在但仅 `@Profile("prod")`,且**仓内无 `application-prod.yml`**=prod 必须显式激活否则默认洞开;`JwtService.java:44-55` 仅校验长度,`application.yml:29` dev 默认密钥能静默签发可伪造令牌 | 补 `application-prod.yml`(JWT secret 强制环境变量、缺省启动失败);**反转 fail-safe**:未知/无 profile 默认走严格链,`permitAll` 收窄到仅 `local\|ci\|test`;prod 若 JWT secret 仍为 dev 默认值则 fail-fast |
| **`asUser/roles` 越权(prod 同样生效)** | ✅ 已修(06-25) | `EntityController.java:222-241` 客户端 `asUser/roles`(无 `@Profile` 的 `@RequestParam`)**优先于** `:247` JWT 绑定的 `UserSession.get()`,直驱 `DataPrivilegeServiceImpl` 行级数据权限,不校验是否等于 JWT 主体 | `asUser/roles` 测试通道 `@Profile("!prod")` 硬隔离;prod 引擎身份只能来自 JWT;确需 impersonation 须校验调用者持 `IMPERSONATE` 角色 |
| **CI 孤儿=自动回归实质为零** | ✅ 已修(06-25) | `eip4-platform/.github/workflows/ci.yml` 是 GitHub Actions 语法但 origin=私有 Gitea(不执行 GHA);`java-version "17"` 写死(项目 JDK21,即便能跑也编译失败=从未真跑过);`eip4-web` 无任何 CI | 把 `scripts/ci.sh` 迁成 `.gitea/workflows/ci.yml`(JDK 改 21)或公司 Jenkins;前端加最小 CI(vitest + `tsc -b`);Gitea 配 branch protection。**理由:P0 安全项修完后没有门禁防再退化。** |
### 10.2 P1 — 稳定性 / 交付能力 / 验证体系 / 可维护性
**【稳定性】**
- **✅【已完成 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】**
- **✅【已完成 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 依赖,留作后续(避免现在加依赖)。
**【验证体系】**
- **🟡【夜间 job 已接 2026-06-25,实跑待 runner+DB】逐行对拍框架已冻结**:原状=`parity-reports/` 全是 `20260611` 时间戳,11 天引擎/转换器改动从未重拍;push CI 只在有提交时跑对拍。**核实**:`ParityCli` 本就「直连 JDBC 基线 vs 引擎 REST 被测逐行 diff,任一不一致退出码 2」=「非 0 即阻断」是内建的(基线=实时 JDBC,非冻结文件);RowDiffTest 30/30 框架健康。**已做**:新增 `.gitea/workflows/parity-nightly.yml`(cron 每日 02:00 CST + 手动 dispatch,跑 `scripts/ci.sh` 全量 seed+all+privilege 对拍、归档报告)——无提交的日子也能捕获隐性漂移。**仍待(环境/基建门,非代码)**:① 真正重拍刷新基线需在 dev/CI 起引擎+真 DB 实跑(`bash scripts/ci.sh` 或 `ParityCli --seed --all`,DB 依赖,本会话 headless 跑不了);② 工作流激活需 Gitea 注册 act_runner(同 ci.yml);③ `--discover`/`--realprivilege` 更广范围退出语义偏探索性,纳入硬门前需真跑核实。
- **保真层引擎核心无单测 + 集成测试静默跳过 · high · L**:`FlowExcuteServiceImpl`(534 行服务流主干)无单测;`FlowExecuteLocalIT.java:60` `assumeTrue(false,"本地不可达,跳过")`=无 DB 的 CI 永远绿但什么都没测(反模式:把「未运行」伪装成「通过」)。→ CI 必须起 testcontainers,DB 不可达应**红**而非跳过。
- **测试金字塔倒置 · high · L**:根目录 71 png + 前端 121 png 人工 dogfooding 是主回归手段;前端 vitest 仅 17 个;3 套 e2e config 故意不配 webServer(复用已跑环境)无法干净 CI 跑起。→ 关键闭环固化成自启动可进 CI 的稳定 e2e;扩 vitest 把「翻译正确但运行时哑火」下沉到单测。
**【可维护性核心】**
- **🟡【已完成安全半步 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**:`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 有回归面,需独立排期。
- **WritePrivilegeChecker 复杂规则 fail-open(读写权限不对称)· medium · M**:`WritePrivilegeChecker.java:156-159` 对部门集合/范围比较类规则 default 放行,而读侧对同类型生成真实约束 → 若客户库含此类写规则可越权 update/delete。→ 不支持类型改 fail-closed。
### 10.3 P2 — 整洁度 / 一致性收敛(多为采纳自原文档的真问题,但属低优先)
- **✅【已完成 2026-06-24】【D5】抽共享 `LocalHostPolicy`**:原状=`AiToolRegistry`/`AiSmokeRunner`/`AiLocalReleaseExecutor` 三处本机白名单互异(ToolRegistry 认展开式 `0:0:0:0:0:0:0:1` 漏 `[::1]`,另两处反之)。**已做**:新增 `LocalHostPolicy.isLocalHost`(去 IPv6 方括号归一 + 精确比对回环集 `{localhost,127.0.0.1,::1,0:0:0:0:0:0:0:1}`,杜绝 `127.0.0.1.evil.com` 伪本地绕过),三处删本地副本统一委托。**验证**:新增 `LocalHostPolicyTest`(接受全部回环形态 + 拒绝伪本地/非本机)3/3 + 三处既有测试(AiToolRegistry 6/AiSmokeRunner 3/AiLocalReleaseExecutor 3)无回归,整套 platform-ai 69/69 绿。
- **✅【已完成 2026-06-24·eip4-web】【B4】抽 `isAdminProfile(profile)` 单函数**:原状=`profile?.account==='admin'||profile?.userId==='ADMIN'` 在 Topbar/ModelerPage/NewFeatureShell/AiFeatureForm/DesignCenterPage 5 处逐字硬编码。**已做**:`auth/token.ts` 加纯函数 `isAdminProfile`(口径逐字保留),5 处统一委托。顺带把 5 个页面测试的 `vi.mock('../auth/token')` 从整模块替换改为 `importOriginal` 只覆盖 `getProfile`(不再 mock 纯函数,修复因 mock 漏 `isAdminProfile` 致的 render 崩)。**验证**:新增 `token.test.ts` 4 测试 + `tsc -b` 干净 + `vitest` 18 文件/77 测试全绿。
- **✅【已完成 2026-06-24·eip4-web】【B2】删 `api/schema.ts` overlay 死代码**:核实 `fetchSchemaLayer`/`putOverlay`/`restoreStandard` 全仓(含 e2e)零引用(真实 overlay API 在 `editor/overlayApi.ts`)后删除;tsc 干净 + vitest 77/77。**未做【B1/B5】**:拆 AmisRenderer SDK 注册逻辑、合并 todo.ts/done.ts 503 降级——均**低优先整洁度**,非架构风险。
- **【D2/D3】AI 多入口来源审计**:REST/CLI/MCP 三通道 actor 恒「agent」无区分,加 `X-EIP4-Agent-Channel` 头 + 审计;`runLocalSmoke` 过 `smoke.run` 工具门对齐 `applyLocalRelease`(localhost 硬门已兜底,非可利用洞)。
- **converter 单测 4820 行/164 用例塞 1 文件**(按控件族拆 6-10 个);**cli/mcp 各仅 1 测试文件**(对外 AI 门面加契约/快照测试);**e2e 5 套 config 碎片化**(合并为 1 主 config + projects)。
- **保真层级联/附件加载残留 N+1**(`loadDoc` 按子行 id 集合一次 IN);端口契约(8084/8093/8094 漂移)+ 源码树 `.omc` 卫生。
### 10.4 严重度纠偏与已缓解(核实原文档后修正,避免误导排期)
| 原文档断言 | 核实结论 | 纠偏 |
|---|---|---|
| **ColumnSQL =最大残余注入面(high/P0)** | **降为 low/二阶纵深防御** | 裸拼属实(`POInfo.java:377` `LEFT JOIN lateral ("+ColumnSQL+")`),但**无可达写路径**:`MetaController.saveAttr` 不写 columnsql、`FieldEditorController` 改业务数据且受 `IdentifierWhitelist` 守卫、`MasterDetailLinker` INSERT 列清单不含它=需 DBA 直改库才触发。价值在加守卫禁任何写路径设 columnsql,优先级远低于 10.1 |
| Admin/AdminWrite 拼 SQL+级联删+调引擎 | **归因部分不实** | AdminController **只读、不调引擎**;级联删只在 AdminWriteController;调引擎实为 EntityController |
| `deleteByType` 列为待修注入热点 | **已缓解** | 已被 `LogController.deleteByType:73` 枚举白名单闸住(非法 type 拒绝);保真层主 CRUD 值位置多数已 `escapeSqlLiteral` 转义 |
| NewFeatureShell/AiFeatureForm 各内联 250+ 行 schema | **夸大** | 合计 ~290 行,但 AiFeatureForm 仅 ~69 行 |
| LLM 修复客户端泄露风险(high) | **已默认关闭** | `HttpAiLlmRepairClient` 经 `@ConditionalOnProperty havingValue=true` + endpoint 空串双重默认关;聚焦「开启时脱敏 + https 白名单」 |
### 10.5 有意取舍(design-intent,不当缺陷)
不引 ORM / 保真层 `com.dsasp.*` 逐字节复刻不重写(故保真层字符串拼接、类级 `@Transactional`、`DataLogManager` 的 `DiscardOldestPolicy` 均源于此,改写须跨流回归不可当普通坏味道)/ 无多租户单客户私有化 / 保真层 MD5 无盐口令(复刻旧 `EncryptUtil` 验存量库)/ AI 红线焊死(部署包恒人审、本机三处校验、LLM 默认关)。这些是已记录的有意决策,**别当 bug**。
> **采纳裁决一句话**:原文档的「工程整洁度 + AI 门禁」清单(A4/A5/D1/D5/B2/B4 等)核实属实、可放心采纳为 P1/P2;但其安全威胁建模做反了(把不可达的 ColumnSQL 当 critical、漏了可达的 RCE/permitAll/asUser),**安全 P0 以本节 10.1 为准**。
---
## 11. 报表保真层(套打 JOR)重宿主 + 安全/OOM 收口(2026-06-25/26)
真实报表 = jatools JOR 套打模板(633 个),**重宿主非重建**:复用客户预编译引擎在无界面环境 headless 渲染为 HTML/PDF/XLS。Phase 1-3(渲染服务 + `/api/report/render` 三格式 + `/api/report/frame` amis 信封 + 转换器对 type=200 产报表查看器 crud,铺全 339)已完成并 push(origin/main `53f3c25`)。其上做了一轮**安全 / 性能 / OOM 审计与收口**(8 维度审计 + 安全 reviewer 对抗复审,TDD + 真库 live e2e),分三批合入 origin/main:
| 批次 | 内容 | merge |
|---|---|---|
| 1 | SQLi 参数门(模板引用名白名单 + 字符白名单值校验 + 身份/数据域注入)/ IDOR 对象级菜单授权 / XXE(字节级拒 DOCTYPE,防 BOM/UTF-16 绕过)/ 渲染并发闸(429) / 产物字节上限(413) / DB `statement_timeout`+`socketTimeout` / 错误响应通用化 | `e6c73a4` |
| 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 个类、79 单测)。
**关键验证**:数值上下文注入 `?PROJECTID=0 union select…` → 400;IDOR 非超管越权 → 403、超管 bypass → 200;`maxResultBuffer` 经独立 JDBC 探针在同款 `TYPE_SCROLL_INSENSITIVE` 路径实证超限即抛非 OOM;CVE 替换后依赖树/运行时 classpath 实证生效、live HTML/PDF=200 无 ClassNotFound。
**仍开口(引擎/部署层)**:凭据外泄不可在渲染层修(模板 `<Connection>` 经同一 `property("DBPassword")` 解析口令,巡检脚本实测当前 326 模板 0 处泄露)→ 真 containment = 只读 DB 账号(脚本已交付 `platform-report/docs/security/`,待运维执行并配 `eip4.report.db.*`);结果集 OOM 对多并发非完全封顶(`maxResultBuffer` 是单查询上限×并发数);裸 `DriverManager` 连接池化未做;`bsh`(jatools fork)/`itext`(只生成不解析 PDF)/`xerces 2.6.2`(XXE 已被前置 DOCTYPE 拒绝兜住) 三 CVE 件不可换,已记录理由。
---
*本文为人工可读的进度权威;逐视图细目见 framework backlog + TODO,方法论/部署 recipe 见用户管理 Delta 移植交接文档,特性设计见 plans/ 下 06-19/06-20 三份 design。架构改进待办见 §10(2026-06-24 并入,取代已删除的《EIP4 架构分析与改进建议》)。*