- 新人上手 §1:托管地址/clone 命令改 <GIT_HOST>:<OWNER> 占位,SSH 端口细节改「向负责人索取」 - 路线图/用户管理Delta/总览 三处历史记录行、.gitea/ci.yml 注释:host 名改「私有 Gitea/私有远程」 - 全仓 grep 验证零残留 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
52 KiB
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/ web2a37251),可达 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-webd1fd6ed),本地 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(先做,本期)
- 【S,本文即产出】刷新主进度文档到 06-21:本总览已建;下一步把
README.md索引刷到 06-21、补登 plans/06-19/06-20 三份新 design 与 AI 契约导航、标注已完成的一次性 plan/简报为「归档候选」。理由:文档时间线断层(最新交付 06-21,文档停 06-17),接手者会被误导。 - 【M】AI 门禁余项收口:存量 overlay 组件 vs 白名单清零、引擎 ALTER 安全通道(
executeCreateSql现只接受 CREATE,net-new 仍有裸 JDBC 旁路风险)、安全门 advisory → enforced。理由:合 main 硬门已清,但这批非红线清理是安全门转强制的前提。依赖:AI 分支已合 main(75f942b)。
P1(紧接其后)
- 【L】framework 业务 106 视图(pm/hr/oa/dm)engineclass delta 移植启动:A1 真实大头。机制①
EngineclassDelta注册表 + 用户管理 Delta 移植方法论已就位可复用。依赖:S1 止损评审定处置方式(见 §6)。 - 【L】人走五环 v2:ALTER 改已有表(引擎现零迁移路径)+ 主子表/审批/组合 tabs recipe 扩面(路线图 M7)。须作为新 recipe 增量加入 blueprint,不得绕过门禁。依赖:v1(75f942b/d1fd6ed)+ 引擎 ALTER 安全通道(#2)。
- 【✅ 大部完成 2026-06-26】流程审批闭环:协办/转阅/BPMN流程图/会签/会签进度/监控按钮/xerces修复 全部已做并合 main(
c95eaee)。仅剩:客户 BPMN 真实流转(外部依赖)+ 流程定义 Modeler(=B3,S1 拍板)。amis 列表入口按钮接线此前已 live(228 页 openApprovalDrawer)。 - 【M】AI 链与人工链部署包统一:
DeploymentPackageBuilder下沉(platform-metadata 与 platform-ai 各一份)+ 净新标准页运行时 DELETE/回滚端点 + publish 写角色菜单授权(现仅 INSERT sys_menu,非超管不可见)。影响人走五环 v1 完整可用。
P2(立项 / 排期)
- 【L】报表系统 A3 立项:套打 JOR(45) + 图表 ECharts + 打印 + 报表菜单树路由(与 B6 报表设计器同根,体量大独立立项)。
- 【M】附件 A4 补完:图片预览 + 老附件物理文件迁移(修下载 403)+ DOCUMENT 全生命周期。
- 【L】生产上线工程化 A10:生产构建 / 单源托管(Nginx 或 Spring 伴服 dist + /api)/ 数据迁移 runbook 执行 / 性能并发 / 灰度。客户最终交付硬门,越早打通越好。
- 【M】生产级 UI/UE 组件体系 B4 补完:选择框统一 / 主子表宿主 / 树编辑 Drawer / 审批待办(L1/L2/设计中心已上线,补 P1-P4 模式骨架)。
6. 待拍板决策(决定后续排期)
- 153 定制视图终判三选一(分期交付 / 引第三方甘特组件 / 扩预算):158.75 人日 ≈ 7.56 人月,超 3 人月止损线,卡 S1 止损评审会。framework 47 已大幅推进,但业务 106 是主体,处置方式直接决定工期。
- ②面 in-app AI employees / 平台内置生成 LLM 是否立项及时点:v1 红线 = 平台进程内不内置生成 LLM(AI 走①面外部 agent + Skills + CLI)。②面何时启动、是否触碰对外口径红线待产品决策。
- type100(116) / type101(10) 列表选择框死页:运行时由
/api/picker/{dialogid}/list承接、不读这些 schema;是彻底停转还是留待低代码处理。 - onEvent 声明式面板(M5)自动化率目标与人工兜底边界:逻辑编排 = b 声明式 80% 主干 + 人工 20% 兜底 + c AI 增量(D3),架构标最高不确定环;S3 自动化率 <80% 触发工期重估。
- 对外口径统一:人走五环 + AI①面已交付,客户演示/报价如何呈现「AI 辅助」而不越「严禁承诺 AI 全自动开发」红线。
- 邮件全家桶(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/ web63d46af)。前置条件: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) HIGHPickerController.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)+ 全语料编译零加固回归。(mergeeba9ce1)- 生产上线 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 权威已闭可达面);EditGridScriptControllerview_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——baseapplication.yml加hikari.connection-init-sql: SET statement_timeout='${EIP4_DB_STATEMENT_TIMEOUT:120s}'(dev/local 继承、prod 无 profile 亦继承 base,可环境变量放宽/设 0 关闭);③ 连接池maximum-pool-size5→20(prod 继承 base 受益)。验证:PaginationTest3/3 +FlowControllerTest(含新「perPage 超大封顶」集成测试,经真实executeGet路径) +PickerControllerTest无回归=68/68 绿;SET statement_timeout='120s'经真实 PG(localhost:5433)执行SHOW=2min 确认语法/取值正确;application.ymlYAML 解析校验通过。残留(独立较大项,未做):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 真验(mergef7675c9);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(merge97a0eb1,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 启用、不污染单测);④ baseapplication.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:60assumeTrue(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=ArchitectureRulesTest6/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 全绿 + 全 reactormvn 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翻成 amissetValue,但核实 amissetValue(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.ts4 测试 +tsc -b干净 +vitest18 文件/77 测试全绿。 - ✅【已完成 2026-06-24·eip4-web】【B2】删
api/schema.tsoverlay 死代码:核实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 架构分析与改进建议》)。