Files
eip4-platform/docs/项目进度与路线-总览-2026-06-21.md
zhengwr 8df60e810c docs(总览): 标记 B4(isAdminProfile 收口)完成
B4 代码在 eip4-web 分支 feat/arch-review-followup(commit 768ffa8);本提交仅同步总览 §10 B4 状态为已完成。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-24 11:20:24 +08:00

39 KiB
Raw Blame History

EIP3 → EIP4 项目进度与路线 · 总览(2026-06-21)

维护日期:2026-06-21 | 性质:全项目进度盘点 + 剩余工作路线(A 兼容 / B 新能力)+ 下一步。 本文取代 项目进度与路线-总览-2026-06-17.md(口径刷新至 06-21,新增「06-17→06-21 增量交付」一节)。 配套权威: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。
  • 项目仍在 dev 环境,生产上线工程化(A10)未起步。

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;缺 amis 列表入口按钮接线、BPMN 流程图、流程定义 Modeler、监控按钮(撤回/结束/高级)、客户 BPMN 部署(前置①)
A3 报表系统(339) 🟠 基本列表;套打 JOR(45) / 图表 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 部署上线工程化 🔴 仍 dev(web 5173 + 后端 8093);生产构建 / 数据迁移 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 缺的流程定义 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. 【M】流程审批闭环收尾:amis 列表入口按钮接线 + BPMN 流程图 + 监控按钮(撤回/结束/高级)+ 客户 BPMN 部署。基础设施已全建,缺最后一公里。依赖:客户提供 BPMN(外部)。
  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-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 进度前后自相矛盾)。

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,只允许 加列/同族扩长/改可空,拒 DROP/RENAME/SET NOT NULL/多语句/小写绕过)+ DataDicService.executeAlterSql 通道 + MetaController POST /api/meta/entity/{table}/attributes 加列端点(saveAttr 元数据 + 受控 ALTER 物理表 + evictByTable + 补索引);(b) PageSchemaController ?strict 分流 + GET /api/page/schema/overlay/audit 白名单对账端点;(c) AiAgentService.applyLocalRelease 织入 AiToolRegistry.check(安全门 advisory→enforced,非本机/越权写路径 403)。单测:Guard 15/0、alter DDL 2/0、安全门 22/0(含新 FORBIDDEN 测试,112 基线无回归)、strict+审计 28/0。真库 e2e:建实体→加 4 列(数值/整型/字符串/引用)→元数据齐 + psql 物理列全生效 + 负控(重复列/不存在表/DROP 形态拒)全绿。
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 — 安全/工程止血(可达攻陷面 + 零回归防护)

三条安全项强耦合(都靠「非 prod permitAll / prod 仅 authenticated」放大),建议作为一个「安全基线」批次一起做。

项 严重度 证据(file:line) 建议
RCE — /api/script/execute + /api/poc/write-test 🔴 critical 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 🔴 critical 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 同样生效) 🔴 critical EntityController.java:222-241 客户端 asUser/roles(无 @Profile 的 @RequestParam)优先于 :247 JWT 绑定的 UserSession.get(),直驱 DataPrivilegeServiceImpl 行级数据权限,不校验是否等于 JWT 主体 asUser/roles 测试通道 @Profile("!prod") 硬隔离;prod 引擎身份只能来自 JWT;确需 impersonation 须校验调用者持 IMPERSONATE 角色
CI 孤儿=自动回归实质为零 🔴 critical(工程) eip4-platform/.github/workflows/ci.yml 是 GitHub Actions 语法但 origin=git.latent.chat(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】

  • Flyway 平台表迁移未实现 · medium · L:架构设计.md:36 承诺 Flyway,全仓零命中;SYS_* 建表散落 bootstrap/*_upsert.sql/CLI 内嵌(bootstrap-ai-agent.sql 两份易漂移)。→ 引入 Flyway 收敛为 V{n}__*.sql 单一真相。
  • 4 进程交付无 compose/Dockerfile/Nginx 配置 · medium · L:find docker-compose* 零命中,切流/回滚仅停留文档。→ 补 deploy/(compose 四服务 + 健康检查 + nginx.conf 切流 upstream + .env.example)。
  • ✅【已完成 2026-06-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 依赖,留作后续(避免现在加依赖)。

【验证体系】

  • 逐行对拍框架已冻结 · high · M:parity-reports/ 全是 20260611 时间戳,对拍 main 末次提交 0611,11 天引擎/转换器改动从未重拍;--discover/--realprivilege 从不在 CI 跑。→ 接夜间 job + 基线锁定(本次 vs 上次 diff,非 0 即阻断)。
  • 保真层引擎核心无单测 + 集成测试静默跳过 · 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:AiAgentService.validateRenderPlanGate:987-1085 纯字段校验,Playwright 全是注释,READY_FOR_HUMAN_REVIEW 不含渲染证据。→ 新增 headless render runner 真跑 renderTests 后回写 runEvidence。
  • AiAgentService(1846 LOC)SRP 严重违反 · high · L:~28 public 入口 + 内联 9+ validate*Gate + 部署/回滚 SQL 生成 + 运行记录映射揉一类。→ 门禁抽 AiDraftGateValidator、SQL 抽 AiDeploymentSqlBuilder、持久化抽 AiRunStore,主类收敛为薄编排门面。
  • 【采纳自原文档 A1/A3】platform-metadata 过厚(31 Controller / 4 Service / 0 Repository)+ Controller 互注入 · medium · L:EntityController.java:46/:398 直接注入并调用 PickerController。→ 抽 PickerService/ReferenceResolutionService 切断互注入;建 web/service/repository 分层(与 ArchUnit 合并做)。
  • 前端 scriptCommands 联动静默哑火 · medium · M:scriptCommands.ts:60-117 把 setRequired/setOptions/setFilter 翻成 amis 未注册的 setValue 非标准 arg → 运行时 no-op、不报错、单测只断翻译形状。「动态必填/动态选项/数据过滤」可能整类失效。→ 改走 amis 真支持机制 + 补真实 DOM 断言 e2e。
  • WritePrivilegeChecker 复杂规则 fail-open(读写权限不对称)· medium · M:WritePrivilegeChecker.java:156-159 对部门集合/范围比较类规则 default 放行,而读侧对同类型生成真实约束 → 若客户库含此类写规则可越权 update/delete。→ 不支持类型改 fail-closed。

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 测试全绿。
  • 【B2】删 api/schema.ts:65-102 overlay 死代码(零调用,真相在 editor/overlayApi.ts);【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 为准。


本文为人工可读的进度权威;逐视图细目见 framework backlog + TODO,方法论/部署 recipe 见用户管理 Delta 移植交接文档,特性设计见 plans/ 下 06-19/06-20 三份 design。架构改进待办见 §10(2026-06-24 并入,取代已删除的《EIP4 架构分析与改进建议》)。