Files
eip4-platform/docs/项目进度与路线-总览-2026-06-21.md
zhengwr dd3b048899 docs: 清除私有托管地址,改中性表述(取码地址向负责人索取)
- 新人上手 §1:托管地址/clone 命令改 <GIT_HOST>:<OWNER> 占位,SSH 端口细节改「向负责人索取」
- 路线图/用户管理Delta/总览 三处历史记录行、.gitea/ci.yml 注释:host 名改「私有 Gitea/私有远程」
- 全仓 grep 验证零残留

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

52 KiB
Raw Blame History

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 仓 3.1G)基本没动 = 最大块;终判 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(紧接其后)

  1. 【L】framework 业务 106 视图(pm/hr/oa/dm)engineclass delta 移植启动:A1 真实大头。机制① EngineclassDelta 注册表 + 用户管理 Delta 移植方法论已就位可复用。依赖:S1 止损评审定处置方式(见 §6)。
  2. 【L】人走五环 v2:ALTER 改已有表(引擎现零迁移路径)+ 主子表/审批/组合 tabs recipe 扩面(路线图 M7)。须作为新 recipe 增量加入 blueprint,不得绕过门禁。依赖:v1(75f942b/d1fd6ed)+ 引擎 ALTER 安全通道(#2)。
  3. 【✅ 大部完成 2026-06-26】流程审批闭环:协办/转阅/BPMN流程图/会签/会签进度/监控按钮/xerces修复 全部已做并合 main(c95eaee)。仅剩:客户 BPMN 真实流转(外部依赖)+ 流程定义 Modeler(=B3,S1 拍板)。amis 列表入口按钮接线此前已 live(228 页 openApprovalDrawer)。
  4. 【M】AI 链与人工链部署包统一:DeploymentPackageBuilder 下沉(platform-metadata 与 platform-ai 各一份)+ 净新标准页运行时 DELETE/回滚端点 + publish 写角色菜单授权(现仅 INSERT sys_menu,非超管不可见)。影响人走五环 v1 完整可用。

P2(立项 / 排期)

  1. 【L】报表系统 A3 立项:套打 JOR(45) + 图表 ECharts + 打印 + 报表菜单树路由(与 B6 报表设计器同根,体量大独立立项)。
  2. 【M】附件 A4 补完:图片预览 + 老附件物理文件迁移(修下载 403)+ DOCUMENT 全生命周期。
  3. 【L】生产上线工程化 A10:生产构建 / 单源托管(Nginx 或 Spring 伴服 dist + /api)/ 数据迁移 runbook 执行 / 性能并发 / 灰度。客户最终交付硬门,越早打通越好。
  4. 【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 待拍板①:分期/第三方/扩预算),需客户决策方向,非本次。

对抗审查收口(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 源码仓本地未克隆,无法分析迁移)。


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 个动词改为显式跳过(返回 null,translateCommands 自动过滤)+ 一次性 console.warn——消除清值风险、不再伪装「已处理」、不再用假绿单测掩盖;新增覆盖(跳过/整体过滤/告警去重),full vitest 83/83 + tsc -b 干净。仍 L(未做):要让「动态必填/选项/过滤」真生效需转换器侧生成数据绑定 schema(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 架构分析与改进建议》)。