From 624ffe8a1569be4108dbdfdccc52e2d180a6e76a Mon Sep 17 00:00:00 2001 From: zhengwr Date: Sun, 21 Jun 2026 13:56:14 +0800 Subject: [PATCH 1/5] =?UTF-8?q?docs:=2006-21=20=E8=BF=9B=E5=BA=A6=E6=96=87?= =?UTF-8?q?=E6=A1=A3=E5=AF=B9=E9=BD=90=20+=20P0/P1=20=E5=AE=9E=E6=96=BD?= =?UTF-8?q?=E8=AE=B0=E5=BD=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 新建 项目进度与路线-总览-2026-06-21(取代06-17版),刷新A/B矩阵+增量交付+下一步+§9实施记录 - README 索引刷新到06-21;旧总览+14份过时/已完成文档加状态横幅;落地路线图回写里程碑 Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/AI_AGENT_AUTO_DEVELOPMENT.md | 2 + docs/AI_AGENT_Nocobase_SOURCE_REVIEW.md | 2 + docs/AI_AGENT_PAGE_BLUEPRINT_CONTRACT.md | 2 + docs/C3压测基线.md | 2 + docs/C5构建预演报告.md | 2 + docs/CRUD-QA-发现与剩余-2026-06-14.md | 2 + docs/README.md | 154 +++++++++------- .../2026-06-14-onEvent脚本挂回修复-plan.md | 2 + docs/plans/2026-06-14-提交审批桥接-design.md | 2 + .../plans/2026-06-14-新闻管理垂直切片-plan.md | 2 + ...5-菜单维护树模式重建与树选择框修复-plan.md | 2 + ...-16-WfTemplate驱动审批界面-完整实现方案.md | 2 + .../2026-06-19-EIP4开发平台-落地执行路线图.md | 4 + .../2026-06-20-人走五环建新功能-实施计划.md | 2 + docs/组件设计体系-design-2026-06-15.md | 2 + docs/项目进度与路线-总览-2026-06-17.md | 2 + docs/项目进度与路线-总览-2026-06-21.md | 166 ++++++++++++++++++ 17 files changed, 289 insertions(+), 63 deletions(-) create mode 100644 docs/项目进度与路线-总览-2026-06-21.md diff --git a/docs/AI_AGENT_AUTO_DEVELOPMENT.md b/docs/AI_AGENT_AUTO_DEVELOPMENT.md index 4131f6b..bafd330 100644 --- a/docs/AI_AGENT_AUTO_DEVELOPMENT.md +++ b/docs/AI_AGENT_AUTO_DEVELOPMENT.md @@ -1,3 +1,5 @@ +> 📌 **现状以总览为准(2026-06-21)**:正文若称「只覆盖最简单 CRUD recipe」已过时——现已有 maintenance-crud / tree-crud / master-detail-v1 多类 recipe。**对外口径红线仍有效**(AI 辅助 + 人审、非全自动开发)。进度见 [总览-2026-06-21](项目进度与路线-总览-2026-06-21.md) B2。 + # AI Agent 辅助开发运行说明(生成草稿 + 本地验证 + 人工复核发布) > **能力边界(对外口径,红线)**:本能力是「**AI 辅助生成草稿 + 人工复核发布**」,**不是** AI 全自动开发。当前只覆盖最简单的 CRUD recipe,存量复杂场景未取得数据;按《EIP3架构决策会纪要》红线,**严禁在报价/合同中承诺「AI 全自动开发 / 人力大幅下降」**。线上变更一律输出人工部署包、由人工复核后发布。 diff --git a/docs/AI_AGENT_Nocobase_SOURCE_REVIEW.md b/docs/AI_AGENT_Nocobase_SOURCE_REVIEW.md index c649b0a..df9cde6 100644 --- a/docs/AI_AGENT_Nocobase_SOURCE_REVIEW.md +++ b/docs/AI_AGENT_Nocobase_SOURCE_REVIEW.md @@ -1,3 +1,5 @@ +> 📌 **现状以总览为准(2026-06-21)**:本文系修订前快照,P3 等进度表述前后不一致(P3-1「进行中」vs P3-2/P4/P5「第一版完成」);AI 确定性五环生产线已合 main。以 [总览-2026-06-21](项目进度与路线-总览-2026-06-21.md) B2 + `AI_AGENT_Nocobase_ADOPTION_PLAN.md` 为准。 + # NocoBase 源码级对照和 EIP4 修订 日期:2026-06-17 diff --git a/docs/AI_AGENT_PAGE_BLUEPRINT_CONTRACT.md b/docs/AI_AGENT_PAGE_BLUEPRINT_CONTRACT.md index 5d747b0..c251c5e 100644 --- a/docs/AI_AGENT_PAGE_BLUEPRINT_CONTRACT.md +++ b/docs/AI_AGENT_PAGE_BLUEPRINT_CONTRACT.md @@ -1,3 +1,5 @@ +> 📌 **现状以总览为准(2026-06-21)**:正文若将 master-detail 列为「未来 TODO / 未覆盖」已过时——`master-detail-v1.yaml` recipe 已存在并交付(含派生/聚合/引用联动)。进度见 [总览-2026-06-21](项目进度与路线-总览-2026-06-21.md) §2。 + # AI Agent Page Blueprint Contract 日期:2026-06-17 diff --git a/docs/C3压测基线.md b/docs/C3压测基线.md index 641130f..ccf2d56 100644 --- a/docs/C3压测基线.md +++ b/docs/C3压测基线.md @@ -1,3 +1,5 @@ +> 📦 **归档候选(2026-06-21)**:M0 一次性本地压测基线(被 `M0交付/M0剩余项状态登记` 引用,物理归档前先改该引用)。 + # C3 压测基线 v1(M0 交付物) > 版本 v1.0(2026-06-10)| 工具:`eip4-platform/tools/loadtest/load_p95.py`(零依赖,可复跑) diff --git a/docs/C5构建预演报告.md b/docs/C5构建预演报告.md index f3ea1b5..a0ccbc9 100644 --- a/docs/C5构建预演报告.md +++ b/docs/C5构建预演报告.md @@ -1,3 +1,5 @@ +> 📦 **归档候选(2026-06-21)**:M0-C5 一次性 amis fork 构建预演(被 `M0交付/M0剩余项状态登记` 引用,物理归档前先改该引用)。 + # C5 任务:amis 6.13.0 Fork 构建预演报告 **任务编号**:EIP4 M0 – C5 diff --git a/docs/CRUD-QA-发现与剩余-2026-06-14.md b/docs/CRUD-QA-发现与剩余-2026-06-14.md index 527afb0..509a311 100644 --- a/docs/CRUD-QA-发现与剩余-2026-06-14.md +++ b/docs/CRUD-QA-发现与剩余-2026-06-14.md @@ -1,3 +1,5 @@ +> ✅ **已完成·归档候选(2026-06-21)**:单次 CRUD QA dogfooding 清单,多数缺口已处理(对齐 `2ecda94`)。注:被 `通用模板全类型可用性…06-16` 引用,物理归档前先改该引用。 + # CRUD 全面 QA 发现与剩余问题清单(2026-06-14) > 来源:本会话 dogfooding + 2 个并行只读巡检 agent(25 业务实体读 / 1241 编辑表单)+ 写流 QA(18 个 _ADD)+ playwright 浏览器抽验。 diff --git a/docs/README.md b/docs/README.md index bac74cd..22f84f1 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,58 +1,63 @@ # EIP4 迁移项目 — 文档索引与状态总览 -> 维护日期:2026-06-17 | **本文是 `docs/` 的唯一入口与状态权威。** 被取代的历史状态/审计快照已移入 `归档/`。 +> 维护日期:2026-06-21 | **本文是 `docs/` 的唯一入口与状态权威。** 被取代的历史状态/审计快照已移入 `归档/`。 > -> **为什么需要本文**:项目历史上随方法论演进(源码 parity → 宣称交付 → 数据驱动重审 → XML 审计 → **engineclass Java delta**)产出了多份「framework 视图状态/parity」文档,结论互相冲突——尤其 `归档/framework系统管理视图-实现交付报告`(宣称「16 视图已交付」)是「以为做了很多」错觉的来源,实为 demo 级、未逐功能验收。**以本文 + 下方两份现行权威为准,其余归档勿再据以判断进度。** +> **进度权威看这份**:`项目进度与路线-总览-2026-06-21.md`(A/B 矩阵 + 06-17→06-21 增量交付 + 下一步 + 待拍板决策)。本 README 只做「文档地图 + 模块完成度」,进度细节以总览为准。 +> +> **为什么需要本文**:项目历史上随方法论演进(源码 parity → 宣称交付 → 数据驱动重审 → XML 审计 → engineclass Java delta → **人走五环低代码平台 / AI 确定性生产线**)产出了多份状态文档,结论可能互相冲突。**以本文 + 总览-2026-06-21 + 下方现行权威为准,归档/历史目录勿再据以判断进度。** --- -## 0. 一句话现状 +## 0. 一句话现状(2026-06-21) -**横向地基铺得较全**(转换器通用能力 / 保真层 / 审批基础设施 / 写路径 / 机制①),但**纵向"按系统模块做到 parity 验收"目前只有「用户管理」1 个完成**。其余 ~45 个 framework 定制视图 + 业务模块,多处于"转换器产出了通用页、但 engineclass 的 Java 定制 delta 未移植 / 未逐功能验收"。详见 §1;当前逐项执行队列见 `framework定制视图-TODO-2026-06-17.md`。 +**横向地基铺得较全**(转换器通用能力 / 保真层 / 审批基础设施 / 写路径 / 机制① / 元数据+写真相门禁);**A 兼容线**纵向「按模块做到 parity 验收」目前只有「用户管理」1 个完成,framework 其余约 38 视图待写、**业务 106 视图是最大未动块**;**B 新能力线本期破局**——「人走五环建新功能」低代码平台 v1 全链交付合 main、设计器选型(amis-editor)拍板 + DesignerPage 全闭环、AI 确定性五环生产线合 main。仍在 dev,生产上线(A10)未起步。 -> **本会话进展(2026-06-17 续)**:三个**全站通用**保真修复 + Wave A 两项已 push origin/main `1b69f8b..fb8a37d`;用户选择框最新回归标准 amis `picker`(`eip4-web b0537f8`、`eip4-platform 0d6fab4`)。详见 §1.3 横向能力(real-first 流解析 / 树编辑布局保真 / 搜索时间段过滤 / 标准 picker 接线)与 §1.1(功能模板下载 ✅、枚举组 ✅、日志组 🟡)。 +> **06-17→06-21 增量**(详见总览 §2):人走五环后端全链 + 前端编排壳/建模器、DesignerPage 闭环(解除 P1 头号阻塞)、主子表四件套、AI 五环生产线合 main + 写路径对齐、附件双态、framework P2 移植一批。两仓 origin/main 已 push(platform `75f942b` / web `d1fd6ed`)。 --- ## 1. 模块完成度(诚实口径) -档位说明:✅ parity 完成(逐功能验收过) | 🟡 demo 级(有页/端点但未 parity 验收) | 🟠 通用页已产·engineclass delta 未移植 | ❌ bespoke 未起步 | 🔵 横向能力(跨模块共用,非单模块) +档位:✅ parity 完成(逐功能验收过)| 🟡 demo 级(有页/端点未 parity 验收)| 🟠 通用页已产·engineclass delta 未移植 | ❌ bespoke 未起步 | 🔵 横向能力 | 🆕 本期新能力 ### 1.1 纵向(系统模块 / framework 定制视图) | 模块组 | 代表视图 | 档位 | 备注 | |---|---|---|---| -| **用户管理** | 用户管理 629463ae | ✅ | 列表/设置主岗位/查看菜单/主部门主岗位树选/picker 显名/filterscript 级联,逐字段 dogfood 验收。剩:编辑页 org picker 查询条件、导出 Excel | -| RBAC/组织 | 用户组/角色/菜单维护/部门/数据权限授权 | 🟡 | 2026-06-14 搭了 CRUD 端点 + amis 后台页,但 demo 级、未对照旧版逐功能验收 | +| **用户管理** | 用户管理 | ✅ | 列表/设置主岗位/查看菜单/主部门主岗位树选/picker 显名/filterscript 级联,逐字段 dogfood 验收(`bf7bb25/0d6fab4/17c449c`)。剩:编辑页 org picker 查询条件、导出 Excel | +| RBAC/组织 | 用户组/角色/菜单维护/部门/数据权限授权 | 🟡 | CRUD 端点 + amis 后台页已建,demo 级未对照旧版逐功能验收 | | RBAC/组织 | 岗位管理/分公司岗位管理 | 🟠 | 通用页在;engineclass「设置(岗位↔用户 picker)」未移植 | -| 元数据/平台工具 | 实体/服务流/视图管理/功能管理/自动编号/定时任务/数据导入配置 | 🟠 | 通用页在;重写服务/设计器/脚本编辑器等重度 delta 未移植 | -| 元数据/平台工具 | 功能模板下载(设置 13accf09/管理 0246d4bd) | ✅ | `b5fe995`/`3276774`:去右表单「添加」按钮 + 标题「编辑模板附件」+ 布局保真;`ffd8c31`:补 `VIEW_TEMPLATEID` 门控,未关联模板节点不显示附件编辑/保存 | -| 元数据/平台工具 | 实体分类-枚举组 b114351f | ✅ | 已核对:EIP4 树端点 PK 唯一+去重+全量建树,天然规避老 UUID 防重逻辑,无需移植 | -| 流程/审批 | 待办/已办/我的发起任务 | 🟡 | 已办 `FinishTaskComponentNew` 两个模板已浏览器验收只读详情;待办 `TaskComponentNew` 两个模板已验列表/查看详细/处理抽屉/遮罩层级,未点最终同意/拒绝,处理后刷新仍待专门测试数据或用户确认。我的发起任务的查看/撤回未接。 | -| 流程/审批 | 查看审批/流程监控/流程定义/审批表单删除 | ❌🟠 | 查看审批=bespoke 未起步;流程定义=Flowable Modeler 另案 | -| 消息/邮件 | 收到/已发送消息、短消息 | 🟠 | 列表页在(有删除);查看弹窗/发送/已读联动未接 | -| 消息/邮件 | 电子邮件全家桶(收件箱/发件箱/配置) | ❌ | 等同独立 webmail 子系统,另案立项 | -| picker 控件 | 用户选择框×4 / 流程选择框 | 🟡 | 用户选择框×4 最新已切回标准 amis `picker`(单选默认,`multiple: true` 为多选,数据源 `/api/picker//list`;旧 schema 由 web 兼容过滤器兜底归一);流程选择框已接 `transfer-picker` + `ProcessSelectController`。均已页面烟测,仍待真实业务保存/权限差异验收。 | -| 日志/历史 | 系统日志/登录历史/登录操作 | 🟡 | `17c449c` 删除按钮组已接(机制①+LogController systemLogManager);列表经 real-first 修通(原 SYS_USERLOGIN_HISTORY_SEARCH 报 createtime 缺列);时间段过滤已通。剩:登录操作列表 VIEW_SYS_USERLOGINFO 此库缺视图 | -| 其它 bespoke | 个人设置/工作日历/报表 | ❌ | 无 XML,逐个从零 | +| 元数据/平台工具 | 实体/服务流/视图管理/功能管理/自动编号 | 🟠 | 通用页在;重写服务/设计器/脚本编辑器重度 delta 未移植 | +| 元数据/平台工具 | 数据导入配置 / 定时任务「设置提醒人」 | 🟡 | `DataImportConfigController` / `ScheduleJobNotifyController` 已落(c9e4d35);调度运行时未起步 | +| 元数据/平台工具 | 脚本编辑器 / 工作日历 | 🟡 | framework P2 批次已移植(57c3412…d218c2b) | +| 元数据/平台工具 | 功能模板下载 / 实体分类-枚举组 | ✅ | 已核对验收 | +| 流程/审批 | 待办/已办/我发起的任务 | 🟡 | 列表/查看/处理抽屉/审批历史抽屉已浏览器验收;缺最终同意/拒绝点击验、列表入口按钮接线 | +| 流程/审批 | 查看审批/流程监控/流程定义/BPMN 图 | ❌🟠 | 监控部分移植;流程定义 = Flowable Modeler 另案(B3);客户 BPMN 部署 = 前置① | +| 消息/邮件 | 收到/已发送消息、短消息 | 🟠→🟡 | 短消息发送 + 消息详情已移植(16393c1 等);已读联动未接 | +| 消息/邮件 | 电子邮件全家桶(webmail) | ❌ | 独立子系统,另案立项(A5) | +| picker 控件 | 用户选择框×4 / 流程选择框 | 🟡 | 已切回标准 amis `picker`(单/多选靠 `multiple`),数据源 `/api/picker//list`;流程选择框接 `transfer-picker`。已烟测,待真实业务保存/权限验收 | +| 日志/历史 | 系统日志/登录历史 | 🟡 | 删除按钮组 + real-first 列表 + 时间段过滤已通;剩登录操作列表此库缺视图 | +| 其它 bespoke | 个人设置/工作日历/报表 | 🟠❌ | 工作日历已移植;个人设置/报表(A3)未起步 | -> framework 定制视图共 46 个,逐视图清单与移植项见 **`framework定制视图-engineclass移植backlog-2026-06-17.md`**(主 backlog)。 +> framework 定制视图共 46 个,逐视图清单见 **`framework定制视图-engineclass移植backlog-2026-06-17.md`**(主 backlog),当前执行队列见 **`framework定制视图-TODO-2026-06-17.md`**(活清单·三态)。 -### 1.2 业务模块(pm/hr/oa/dm 的 153 个定制视图) +### 1.2 业务模块(pm/hr/oa/dm 的 106 个定制视图) -另一条线,多数走 bespoke 重写或通用模板,绝大部分未做。处置口径见 `M0交付/153定制视图处置清单v1.md`(历史)。 +另一条线,源码在 `EIP-3.0` 仓(3.1G),**基本未动 = A 兼容线最大块**。处置口径卡 S1 止损评审(见总览 §6 待拍板①)。 -### 1.3 🔵 横向能力(已就绪,跨模块共用) +### 1.3 🆕 本期新能力(人走五环 / AI / 设计器) -- **转换器通用能力**:navigation 按钮、type=101 树形选择框、picker 引用列显名、filterscript 级联(组织→部门→岗位,已收口静态可达部分)、title 修正、colspan 栅格、A0 控件(密码/附件/日期)、EditGrid 子表递归。 -- **🆕 树编辑表单布局保真**(`3276774`):type=3 可编辑树 master-detail 现按 view_page `` 的 `
` 槽位排版 + 隐藏未布局字段(VERSION/主键/引用 id 等绑提交但不显示)——与 EDITFORM 同口径 `buildFormBody`,修「树编辑泄露隐藏字段 + 裸列名标签」。影响 41 可编辑树页。 -- **🆕 搜索时间段过滤**(`fb8a37d`,全站通用):amis `input-date(time)-range` 的 `"起,止"` 串在保真层读流路径(NAMED_READ/SYNTHESIZED)转 `DateTime[]`,接通引擎 GeneralPO 区间查询 `(col>=起 AND col<=止)`;认 unix 秒/毫秒/格式化;只碰 DATE/TIME 列(零回归)。修「操作日志等时间段查不动」。 -- **🆕 用户选择框全家接线(最新口径)**:旧 `UserSelectWindow` / `UserOrgSelectWindow` 四个 dialogid 已由转换器接到 amis 标准 `picker`,单选/多选只通过 `multiple` 区分;数据源走统一 `/api/picker//list`,表格弹窗保留搜索、分页、显名与 checkbox 多选。`eip4-web` 兼容过滤器会把历史 `user-transfer-picker` schema 归一成同一标准 picker。已页面烟测查询单选与业务表单多选;真实业务保存、ALL 互斥、权限差异和考勤源仍按 TODO 逐页验收。 -- **🆕 流程选择框接线**:旧 `ProcessSelectDialog` 已由转换器接到 amis 内建 `transfer-picker`,后端 `/api/process-select/options|search` 维持旧值口径(流程名即提交值),数据源优先 Flowable Model/ProcDef,本地 dev 无模型时回退历史流程名。`919477da` 流程代理授权页面已页面烟测,保存闭环待验。 -- **🆕 real-first 流解析**(`abc32af`):`_SEARCH` 优先真实 serviceflow(忠实旧引擎,无运行时合成兜底覆盖),统一所有操作读存储流。修约 107 列表打不开(无 createtime)+ 157 排序错;A/B 新修 33。 -- **机制①** `EngineclassDelta`:engineclass FQN → 工具栏按钮注册表(REGISTRY)**+ 整页改写器(MUTATORS,`b5fe995`,覆盖非 crud 加按钮类 delta:移除/改写默认页元素)**。 -- **审批基础设施**:后端 `ApprovalController`(approval-meta/business-data/action)+ `TodoController`(trace)+ BusinessRecordLoader/WfTemplateService/StatusWriteback;前端 `ApprovalDrawer.tsx`(业务表单+轨迹+动态按钮+提交)。**已建成,缺的是 amis 列表页的入口按钮接线。** -- **保真层/写路径**:JUEL(jakarta.el JSR-223)跨流条件求值、增删改查 + 提交审批桥(ProcessCoreServiceBridge)、PG 升级、Flowable 升级。 +- **人走五环建新功能 v1**:NocoBase 式建模器 + 实时设计器,五环(元数据→表→设计→实现→发布)+ AI①面入口 + 主子表四件套,全链交付合 main(platform `75f942b` / web `d1fd6ed`)。v1 限简单 CRUD/树 recipe + 只建新不改表。设计权威:`plans/2026-06-20-人走五环建新功能-NocoBase式-design.md`。 +- **B1 设计器**:amis-editor 选型拍板(D1);DesignerPage 全闭环上线(`2278cbc` 等),原 P1 头号阻塞解除。 +- **B2 AI 模块**:确定性(非 LLM)五环增量生产线合 main,终点恒人审、平台不内置生成 LLM;契约见 `AI_AGENT_*.md` + `skills/`。 + +### 1.4 🔵 横向能力(已就绪,跨模块共用) + +- 转换器通用能力:navigation 按钮、type=101 树选、picker 显名、filterscript 级联、colspan 栅格、A0 控件、EditGrid 子表递归、树编辑 layout 保真、搜索时间段过滤、`_SEARCH` real-first 流解析。 +- 机制① `EngineclassDelta`:engineclass FQN → 工具栏按钮注册表 + 整页改写器。 +- 审批基础设施:`ApprovalController` / `TodoController` / `ApprovalDrawer.tsx` / WfTemplate 驱动审批(缺列表入口接线)。 +- 保真层/写路径:JUEL 跨流条件求值、增删改查 + 提交审批桥(ProcessCoreServiceBridge)、`PageSchemaWriter` 单一写真相(M3a `d3b8846`)、PG/Flowable 升级。 +- AI 门禁五件套:page-recipe / typed-page-schema / amis-schema / local-smoke / render-plan(已接 putOverlay,只严格约束 AI 草稿)。 --- @@ -60,48 +65,71 @@ | 文档 | 用途 | |---|---| -| **`项目进度与路线-总览-2026-06-17.md`** | **全项目进度盘点 + 剩余工作路线**(A 兼容 / B 新功能 + 关键路径 + 待拍板决策) | -| **`framework定制视图-TODO-2026-06-17.md`** | **当前活 TODO**:已改/已提交/待验/下一批优先级;每次修完必须回写 commit 与验证。 | -| **`framework定制视图-engineclass移植backlog-2026-06-17.md`** | 46 个 framework 定制视图迁移**主 backlog**(verdict/移植项/优先级 P1-P3) | -| **`用户管理-Delta移植-实现过程与踩坑-2026-06-17.md`** | 方法论 + 机制① + 踩坑 + filterscript 级联收口(首个端到端案例 + 会话交接) | -| `组件设计体系-design-2026-06-15.md` | 全站 UI/UE 组件设计体系(已设计、未实现) | -| `通用模板全类型可用性-通盘盘点与收口计划-2026-06-16.md` | **通用模板**(非定制,~1363 个)覆盖与收口(与定制视图是两条线) | +| **`项目进度与路线-总览-2026-06-21.md`** | **全项目进度权威**:A/B 矩阵 + 增量交付 + 下一步 + 待拍板决策 | +| `架构设计.md` | 双层制架构 / 工程结构 / 选型 / 红线(架构基线) | +| `迁移手册.md` | 双层制纪律 + 踩坑四栏制(知识转移手册) | +| `plans/2026-06-19-EIP4开发平台-架构方向-design.md` | 开发平台方向级 design(锁定 D1-D7) | +| `plans/2026-06-20-人走五环建新功能-NocoBase式-design.md` | 主特性「人走五环」设计定型 | +| `plans/2026-06-19-EIP4开发平台-落地执行路线图.md` | 活路线图(M0-M8,状态随里程碑回写) | +| `AI_AGENT_AUTO_DEVELOPMENT.md` + `AI_AGENT_PAGE_BLUEPRINT_CONTRACT.md` / `AI_AGENT_REPAIR_CONTRACT.md` / `AI_AGENT_Nocobase_ADOPTION_PLAN.md` + `skills/` | AI Agent 对外口径红线 + 编译/修复/采纳契约 + Skills 目录 | +| `framework定制视图-TODO-2026-06-17.md` | A 兼容线**活清单**(Done/In-Progress/待验三态),每次修完回写 | +| `framework定制视图-engineclass移植backlog-2026-06-17.md` | 46 framework 视图迁移**主 backlog**(verdict/移植项/优先级) | +| `用户管理-Delta移植-实现过程与踩坑-2026-06-17.md` | engineclass Delta 移植方法论 + 机制① + 踩坑(首个端到端案例 + 交接) | +| `通用模板全类型可用性-通盘盘点与收口计划-2026-06-16.md` | **通用模板**(~1363)覆盖与收口(与定制视图两条线) | +| `组件设计体系-design-2026-06-15.md` | 全站 UI/UE 组件设计体系(落地状态以总览 B4 为准) | | `客户沟通清单v1.md` | 商务/客户侧依赖卡点 | -| `plans/2026-06-16-WfTemplate驱动审批界面-完整实现方案.md` | 审批界面实现方案(对应基础设施 🔵 已建) | -| `决策与盘点/` | 架构决策报告/会纪要/客户库盘点(历史参考,奠基性) | -| `P0-PG升级/`、`P3-Flowable升级/` | PG / Flowable 升级 runbook | +| `决策与盘点/EIP3架构决策{报告,会纪要}.md` | 奠基性决策 + 对外口径红线来源 | +| `P0-PG升级/`、`P3-Flowable升级/` | PG / Flowable 升级 runbook(生产切流执行依据) | | `研究/` | 服务流分派、通知保存老vs新机制 trace(专题研究) | --- -## 3. 全文档索引(含归档) +## 3. 全文档索引(含状态分级) -| 文档 | 状态 | 取代它的 / 备注 | +状态:现行·权威 | 现行 | 活清单 | **已完成·归档候选**(一次性 plan/报告,已落地,可后续 `git mv` 入 `归档/`)| 已归档 | 历史 + +| 文档 | 状态 | 备注 | |---|---|---| -| README.md(本文) | 现行 | 唯一状态入口 | -| framework定制视图-TODO-2026-06-17 | 现行·活清单 | 当前执行队列,记录已改提交、待验项、下一批 | -| framework定制视图-engineclass移植backlog-2026-06-17 | 现行·权威 | framework 视图主 backlog | -| 用户管理-Delta移植-…-2026-06-17 | 现行·权威 | 方法论+交接 | -| 组件设计体系-design-2026-06-15 | 现行 | — | -| 通用模板全类型可用性-…-2026-06-16 | 现行 | 通用模板线 | -| 客户沟通清单v1 | 现行 | 商务线 | -| `归档/framework系统管理视图-功能点Parity对照与实现计划-2026-06-16`(84K) | 已归档 | 被 engineclass backlog 取代 | -| `归档/framework系统管理视图-实现交付报告-2026-06-17` | 已归档 | ⚠️「16 视图已交付」=demo 级,被数据驱动重审纠正;勿据此判进度 | -| `归档/framework系统管理视图-数据驱动Parity重审与修复队列-2026-06-17` | 已归档 | 被 engineclass backlog 取代 | -| `归档/framework定制视图-转换页审计-2026-06-17` | 已归档 | XML 审计(自评不可靠),被 engineclass backlog 取代 | -| `归档/EIP4-架构与缺口现状-2026-06-13`(34K) | 已归档 | 06-13 快照,早于 engineclass 重定性 + 06-14~17 全部工作 | -| `归档/转换器覆盖度审计-2026-06-13` | 已归档 | 06-13 缺口快照 | -| `归档/F2-17-审计基线-2026-06-13-升级` | 已归档 | 自动审计快照(历史) | -| `归档/F2-17-组件真实性审计-修复后复测`(06-12) | 已归档 | 自动审计快照(历史) | -| `归档/F2-17-组件真实性审计基线`(06-12) | 已归档 | 自动审计快照(历史) | -| `归档/F2-12-UI走查清单`(06-11/12) | 已归档 | UI 走查(历史) | -| `归档/未完成工作清单`(06-12) | 已归档 | 早期清单,已被多轮取代 | -| M0交付/、P1/、PoC证据/ 子目录 | 历史 | 阶段交付/简报/证据(保留备查,不反映当前进度) | +| `项目进度与路线-总览-2026-06-21` | 现行·权威 | 进度唯一入口 | +| `项目进度与路线-总览-2026-06-17` | 已被取代 | 被 06-21 总览取代(顶部已加横幅) | +| `README.md`(本文) | 现行·权威 | 文档地图 + 模块完成度 | +| `架构设计`、`迁移手册` | 现行·权威 | 架构基线 | +| `plans/2026-06-19-EIP4开发平台-架构方向-design` | 现行·权威 | 方向 D1-D7 | +| `plans/2026-06-20-人走五环建新功能-NocoBase式-design` | 现行·权威 | 主特性设计 | +| `plans/2026-06-19-EIP4开发平台-落地执行路线图` | 现行·活路线图 | 里程碑状态已回写本期进展 | +| `plans/2026-06-20-人走五环建新功能-实施计划` | 现行(执行已收尾) | 24 TDD 任务全完成 + 合 main(顶部已加横幅) | +| `AI_AGENT_AUTO_DEVELOPMENT` / `PAGE_BLUEPRINT_CONTRACT` / `REPAIR_CONTRACT` / `Nocobase_ADOPTION_PLAN` / `Nocobase_SOURCE_REVIEW` | 现行·权威 | AI 契约族;前 4 份正文个别过时点已加横幅 | +| `skills/`(eip4-ai-feature-development / env-manage / release-manage) | 现行·权威 | AI Agent Skills 目录 | +| `framework定制视图-TODO-2026-06-17` | 现行·活清单 | 执行队列 | +| `framework定制视图-engineclass移植backlog-2026-06-17` | 现行·权威 | framework 主 backlog(开头有 agent 思考噪声待清) | +| `用户管理-Delta移植-…-2026-06-17` | 现行·权威 | 方法论 + 交接 | +| `组件设计体系-design-2026-06-15` | 现行(落地状态见总览 B4) | 顶部已加横幅 | +| `通用模板全类型可用性-…-2026-06-16` | 现行 | 通用模板线(§七运行库现状需复核) | +| `客户沟通清单v1` | 现行 | 商务线(部分卡点随本期交付已消解) | +| `决策与盘点/`(架构决策报告/会纪要/客户库盘点/源码预核查/报表迁移方案/EIP4前端实施计划) | 现行·权威 + 历史盘点混放 | 决策报告/会纪要 = 现行权威红线来源;06-10 一次性盘点报告(源码预核查/客户库盘点/报表迁移方案)= 历史 | +| `plans/2026-06-14-onEvent脚本挂回修复-plan` | 已完成·归档候选 | onEvent seq 映射已修上线 | +| `plans/2026-06-14-提交审批桥接-design` | 已完成·归档候选 | processCoreService 桥已端到端实证 | +| `plans/2026-06-14-新闻管理垂直切片-plan` | 已完成·归档候选 | 新闻收藏已修上线 | +| `plans/2026-06-15-菜单维护树模式重建与树选择框修复-plan` | 已完成·归档候选 | 菜单树/树选已修 live 验收 | +| `plans/2026-06-16-WfTemplate驱动审批界面-完整实现方案` | 已完成·归档候选 | Phase0-4 全做完(仍可作机制参考) | +| `CRUD-QA-发现与剩余-2026-06-14` | 已完成·归档候选 | 单次 dogfooding,多数缺口已处理(被通用模板收口引用,移动前先改引用) | +| `C3压测基线` / `C5构建预演报告` | 已完成·归档候选 | M0 一次性本地基线/构建预演(被 M0交付/M0剩余项登记 引用) | +| `归档/`(framework parity/交付报告/数据驱动重审/转换页审计/EIP4-架构与缺口现状-06-13/转换器覆盖度审计-06-13/F2-12/F2-17 三件套/未完成工作清单) | 已归档 | 历史快照,**勿据以判进度** | +| `M0交付/`(153 处置清单 v1 / 153 终判证据包 / M0 剩余项登记) | 历史 | M0 阶段交付,已被 engineclass backlog + 终判取代 | +| `P1/`(F1/F2-x/F3/F4/P1-P4 简报 共 ~22 份) | 历史 | 阶段交付简报(部分已被后续重做取代,如审批 UI/选择窗),保留备查 | +| `决策与盘点/EIP3工程化实施计划` / `EIP3路线A-PoC执行方案` | 历史 | 早期工程化/PoC 方案 | + +> eip4-web 仓另有 `docs/F1-4扫描报告.md`、`docs/P4脚手架报告.md`(06-11 一次性早期快照,建议 web 仓建 `docs/归档/` 归入)。 --- ## 4. 下一步指引 -- framework 定制视图优先级见 backlog §5:P1 = 岗位·主岗位·查看菜单按钮组 / 查看审批 / 任务按钮 / 消息查看 / 短消息;用户选择框全家、流程选择框已进入业务逐页验收队列。 -- **主攻方向待拍板**(候选:RBAC/组织模块组做到 parity | 全模块完成度审计 | 广度优先铺基线 | 任务/审批簇接线)。 +> 完整优先级排序见 `项目进度与路线-总览-2026-06-21.md` §5。摘要: + +- **P0**:① 文档对齐(本次进行中);② AI 门禁余项收口(overlay 白名单清零 / 引擎 ALTER 安全通道 / 安全门转 enforced)。 +- **P1**:③ framework 业务 106 视图移植启动(卡 S1 止损评审);④ 人走五环 v2(ALTER 改表 + recipe 扩面 M7);⑤ 流程审批闭环收尾(列表入口 + BPMN 图 + 客户部署);⑥ AI/人工链部署包统一 + 运行时 DELETE/回滚 + publish 菜单授权。 +- **P2**:报表 A3 立项 / 附件 A4 补完 / 生产上线 A10 / 生产级 UI B4 补完。 +- **待拍板**(总览 §6):153 终判三选一、②面 AI/内置 LLM 立项、type100/101 死页停转或留、onEvent 面板自动化率边界、对外口径统一、webmail 是否纳入本期。 + - 部署/重转/导入 recipe、踩坑见「用户管理-Delta移植」§4 与本仓 `scripts/run-dev.sh`。 diff --git a/docs/plans/2026-06-14-onEvent脚本挂回修复-plan.md b/docs/plans/2026-06-14-onEvent脚本挂回修复-plan.md index a97b584..7747849 100644 --- a/docs/plans/2026-06-14-onEvent脚本挂回修复-plan.md +++ b/docs/plans/2026-06-14-onEvent脚本挂回修复-plan.md @@ -1,3 +1,5 @@ +> ✅ **已完成·归档候选(2026-06-21)**:onEvent seq 映射已修复上线,计划执行完毕。可后续 `git mv` 入 `docs/归档/`。 + # onEvent 脚本挂回修复(按钮联动 / 表单只读联动)Implementation Plan > **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. diff --git a/docs/plans/2026-06-14-提交审批桥接-design.md b/docs/plans/2026-06-14-提交审批桥接-design.md index 10f5b73..c032095 100644 --- a/docs/plans/2026-06-14-提交审批桥接-design.md +++ b/docs/plans/2026-06-14-提交审批桥接-design.md @@ -1,3 +1,5 @@ +> ✅ **已完成·归档候选(2026-06-21)**:processCoreService 桥接 bean 已端到端实证落地。可后续 `git mv` 入 `docs/归档/`。 + # 提交审批端到端 — processCoreService 桥接 bean 设计(MVP) > 日期:2026-06-14 diff --git a/docs/plans/2026-06-14-新闻管理垂直切片-plan.md b/docs/plans/2026-06-14-新闻管理垂直切片-plan.md index a000890..5463ac8 100644 --- a/docs/plans/2026-06-14-新闻管理垂直切片-plan.md +++ b/docs/plans/2026-06-14-新闻管理垂直切片-plan.md @@ -1,3 +1,5 @@ +> ✅ **已完成·归档候选(2026-06-21)**:新闻管理切片已修复上线 + live 验收。可后续 `git mv` 入 `docs/归档/`。 + # 新闻管理 功能垂直切片 全 parity Implementation Plan > **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans / superpowers:subagent-driven-development 逐任务实施。每条修复 TDD + 浏览器端到端对老系统验收,修完作为其余 ~150 功能的模板再泛化。 diff --git a/docs/plans/2026-06-15-菜单维护树模式重建与树选择框修复-plan.md b/docs/plans/2026-06-15-菜单维护树模式重建与树选择框修复-plan.md index 5d0d21f..f813b9c 100644 --- a/docs/plans/2026-06-15-菜单维护树模式重建与树选择框修复-plan.md +++ b/docs/plans/2026-06-15-菜单维护树模式重建与树选择框修复-plan.md @@ -1,3 +1,5 @@ +> ✅ **已完成·归档候选(2026-06-21)**:菜单树模式 + 字段级树选择框已修复 live 验收。可后续 `git mv` 入 `docs/归档/`。 + # 菜单维护改老系统模式 + 字段级树选择框修复 — 实施计划 日期:2026-06-15 diff --git a/docs/plans/2026-06-16-WfTemplate驱动审批界面-完整实现方案.md b/docs/plans/2026-06-16-WfTemplate驱动审批界面-完整实现方案.md index 22569e9..fa7d9eb 100644 --- a/docs/plans/2026-06-16-WfTemplate驱动审批界面-完整实现方案.md +++ b/docs/plans/2026-06-16-WfTemplate驱动审批界面-完整实现方案.md @@ -1,3 +1,5 @@ +> ✅ **已完成·归档候选(2026-06-21)**:Phase 0-4 全部实现 + live 验收。仍可作 WfTemplate 驱动审批机制参考;可后续 `git mv` 入 `docs/归档/`。 + # WfTemplate 驱动审批界面 — 完整实现方案 日期:2026-06-16 diff --git a/docs/plans/2026-06-19-EIP4开发平台-落地执行路线图.md b/docs/plans/2026-06-19-EIP4开发平台-落地执行路线图.md index 633e9cd..73545e5 100644 --- a/docs/plans/2026-06-19-EIP4开发平台-落地执行路线图.md +++ b/docs/plans/2026-06-19-EIP4开发平台-落地执行路线图.md @@ -1,3 +1,7 @@ +> 🔄 **里程碑状态回写(2026-06-21)**:正文部分表述已被本期进展推进,以此处与 [总览-2026-06-21](../项目进度与路线-总览-2026-06-21.md) 为准。 +> - ✅ **M0**(L1 主题 token)已上线;✅ **M-Gate**(渲染冒烟 `4b564c6`)已做;✅ **M3a**(单一写真相 `PageSchemaWriter` `d3b8846`)已做;✅ **DesignerPage 全闭环**(`2278cbc` 等,原 §1/§2「DesignerPage 打不开」已解除);✅ **人走五环 v1** 全链交付合 main;✅ **两仓已 push origin/main**(`75f942b`/`d1fd6ed`,§5「push = 用户决策」已完成);🟡 **M7** recipe 扩面部分(master-detail-v1 已做,余待 v2)。 +> - 🔴 仍未起步:**M4**(引擎 ALTER 安全通道)、**M5**(onEvent 声明式面板)、**M8**(CLI NocoBase 化 + 安全 Part2)、**M1 生产单源托管**(dev 反代已通,生产托管 = A10)。 + # EIP4 开发平台 · 落地执行路线图 > 日期 2026-06-19 | 活计划,配套《2026-06-19-EIP4开发平台-架构方向-design.md》(方向+锁定决策 D1-D7)。本文是该 design doc 承诺的「另立 plan 文档」。每里程碑落地后回写状态。 diff --git a/docs/plans/2026-06-20-人走五环建新功能-实施计划.md b/docs/plans/2026-06-20-人走五环建新功能-实施计划.md index 84bc623..da58ff7 100644 --- a/docs/plans/2026-06-20-人走五环建新功能-实施计划.md +++ b/docs/plans/2026-06-20-人走五环建新功能-实施计划.md @@ -1,3 +1,5 @@ +> ✅ **执行已收尾(2026-06-21)**:24 个 TDD 任务全部实现 + live 验收 + 合入 origin/main 两仓(eip4-platform `75f942b` / eip4-web `d1fd6ed`),主子表四件套全完。本文转为已交付特性的实现记录;当前进度见 [总览-2026-06-21](../项目进度与路线-总览-2026-06-21.md) §2/§4。 + # 人走五环建新功能 · NocoBase 式(建模器 + 实时设计器)实施计划 > **For Claude:** REQUIRED SUB-SKILL: 用 `superpowers:executing-plans`(或 `superpowers:subagent-driven-development`)逐任务执行本计划。每个 Task 都是 TDD 闭环(写失败测试 → 跑红 → 最小实现 → 跑绿 → 提交),不要跳过红/绿步骤,不要批量合并任务。 diff --git a/docs/组件设计体系-design-2026-06-15.md b/docs/组件设计体系-design-2026-06-15.md index 0afbc64..c79f380 100644 --- a/docs/组件设计体系-design-2026-06-15.md +++ b/docs/组件设计体系-design-2026-06-15.md @@ -1,3 +1,5 @@ +> 📌 **落地状态以总览为准(2026-06-21)**:本文「未开始/未实现」等表述已过时——L1 主题(amis-theme.css §10-15 密度/按钮/弹窗)、L2 行选中、设计中心 DesignCenterPage 已上线。当前落地状态见 [总览-2026-06-21](项目进度与路线-总览-2026-06-21.md) B4。 + # EIP4 组件设计体系 — 设计文档 > 日期:2026-06-15 状态:设计已成形(brainstorm 共识),具体数值/形态待真实数据校准 diff --git a/docs/项目进度与路线-总览-2026-06-17.md b/docs/项目进度与路线-总览-2026-06-17.md index 91ee9a0..b233ef0 100644 --- a/docs/项目进度与路线-总览-2026-06-17.md +++ b/docs/项目进度与路线-总览-2026-06-17.md @@ -1,3 +1,5 @@ +> ⚠️ **已被取代(2026-06-21)**:本文口径停在 06-17。最新进度权威见 [项目进度与路线-总览-2026-06-21.md](项目进度与路线-总览-2026-06-21.md)。本文保留作历史快照,勿据以判进度。 + # EIP3 → EIP4 迁移:项目进度与路线总览 > 维护日期:2026-06-17 | 性质:全项目进度盘点 + 剩余工作路线(A 兼容 / B 新功能)。 diff --git a/docs/项目进度与路线-总览-2026-06-21.md b/docs/项目进度与路线-总览-2026-06-21.md new file mode 100644 index 0000000..712ab1e --- /dev/null +++ b/docs/项目进度与路线-总览-2026-06-21.md @@ -0,0 +1,166 @@ +# 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(紧接其后) + +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. **【M】流程审批闭环收尾**:amis 列表入口按钮接线 + BPMN 流程图 + 监控按钮(撤回/结束/高级)+ 客户 BPMN 部署。*基础设施已全建,缺最后一公里。依赖:客户提供 BPMN(外部)。* +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-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 实施。代码改动**未 commit**(待审阅);后端改动需 `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 待拍板①:分期/第三方/扩预算),需客户决策方向,非本次。 | + +**红线遵守**:引擎 ALTER 经 `AlterTableSqlGuard` 白名单(defense-in-depth:控制层 + 保真层双校验),只加列/恒可空,杜绝破坏性 DDL;DDL 仍收口保真层单点;net-new 标准层删除收口 `PageSchemaWriter`,不裸 JDBC 旁路。 + +**仍待(按优先级)**:P0②余项(存量 overlay 白名单 strict 化推进,审计端点已提供对账数据)/ P1④ recipe 扩面 M7 / P1⑥ 部署包下沉统一 / P1⑤ 真实流转(依赖客户 BPMN)/ P1③(待 S1 拍板)。 + +--- + +*本文为人工可读的进度权威;逐视图细目见 framework backlog + TODO,方法论/部署 recipe 见用户管理 Delta 移植交接文档,特性设计见 plans/ 下 06-19/06-20 三份 design。* From 8b28595f9e31f6a8a762db481c6f5bde258f2fbc Mon Sep 17 00:00:00 2001 From: zhengwr Date: Sun, 21 Jun 2026 13:56:14 +0800 Subject: [PATCH 2/5] =?UTF-8?q?feat(P0=E2=91=A1):=20=E5=BC=95=E6=93=8EALTE?= =?UTF-8?q?R=E5=AE=89=E5=85=A8=E9=80=9A=E9=81=93=20+=20AI=E5=AE=89?= =?UTF-8?q?=E5=85=A8=E9=97=A8enforced?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - AlterTableSqlGuard(legacy-core,纯静态白名单):只允许 加列/同族扩长/改可空, 拒 DROP COLUMN/RENAME/SET NOT NULL/多语句/跨族/小写绕过;放legacy-core避免反向依赖 - DataDicService.executeAlterSql 受控通道(过Guard再execute,defense-in-depth) - MetaController POST /api/meta/entity/{table}/attributes 加列端点 (saveAttr元数据+alterAddColumnDdl镜像appendColumnDdl类型映射+evictByTable+补索引,恒可空) - AiAgentService.applyLocalRelease 织入 AiToolRegistry.check:安全门 advisory→enforced (local.apply工具身份,非本机/越权写路径403) - 单测 Guard15/alter2/gate22(112基线无回归);scripts/p0-alter-acceptance.sh 真库验收 Co-Authored-By: Claude Opus 4.8 (1M context) --- .../platform/ai/service/AiAgentService.java | 10 ++ .../ai/service/AiAgentServiceTest.java | 11 ++ .../dataDic/service/DataDicService.java | 7 + .../dataDic/service/AlterTableSqlGuard.java | 106 ++++++++++++ .../dataDic/service/DataDicServiceImpl.java | 12 ++ .../service/AlterTableSqlGuardTest.java | 151 ++++++++++++++++++ .../platform/metadata/web/MetaController.java | 110 +++++++++++++ .../metadata/web/MetaControllerAlterTest.java | 52 ++++++ scripts/p0-alter-acceptance.sh | 71 ++++++++ 9 files changed, 530 insertions(+) create mode 100644 platform-legacy-core/src/main/java/com/dsasp/server/dataDic/service/AlterTableSqlGuard.java create mode 100644 platform-legacy-core/src/test/java/com/dsasp/server/dataDic/service/AlterTableSqlGuardTest.java create mode 100644 platform-metadata/src/test/java/com/eip4/platform/metadata/web/MetaControllerAlterTest.java create mode 100644 scripts/p0-alter-acceptance.sh diff --git a/platform-ai/src/main/java/com/eip4/platform/ai/service/AiAgentService.java b/platform-ai/src/main/java/com/eip4/platform/ai/service/AiAgentService.java index 465a169..4180145 100644 --- a/platform-ai/src/main/java/com/eip4/platform/ai/service/AiAgentService.java +++ b/platform-ai/src/main/java/com/eip4/platform/ai/service/AiAgentService.java @@ -406,6 +406,16 @@ public class AiAgentService { public AiApplyRun applyLocalRelease(String taskId, String changeSetId, String baseUrl) { getTask(taskId); + // P0②(c) 安全门 enforced:把 AiToolRegistry 策略引擎织入真实写路径。此前 check() 仅挂在 + // /api/ai/tools/check-access 咨询端点(只读返决策),写路径仅靠 requireAdmin + localhost 兜底, + // scope/localOnly/productionWrite 策略形同 advisory。这里以 local.apply 工具身份过门: + // targetEnv=baseUrl,非本机 / 越权 → 403,localReleaseExecutor.apply 不被触发。 + AiToolAccessDecision gate = toolRegistry.check(new AiToolAccessRequest( + "agent-developer", "local.apply", List.of("ai:local:apply"), baseUrl, false)); + if (gate == null || !gate.allowed()) { + throw new ResponseStatusException(HttpStatus.FORBIDDEN, + "本地应用被安全门拒绝: " + (gate == null ? "no-decision" : String.join("; ", gate.blockers()))); + } AiChangeSet changeSet = findChangeSet(taskId, changeSetId); if (!"READY_FOR_REVIEW".equals(changeSet.status())) { throw new ResponseStatusException(HttpStatus.CONFLICT, "变更包状态不可本地应用: " + changeSet.status()); diff --git a/platform-ai/src/test/java/com/eip4/platform/ai/service/AiAgentServiceTest.java b/platform-ai/src/test/java/com/eip4/platform/ai/service/AiAgentServiceTest.java index a29c709..1669640 100644 --- a/platform-ai/src/test/java/com/eip4/platform/ai/service/AiAgentServiceTest.java +++ b/platform-ai/src/test/java/com/eip4/platform/ai/service/AiAgentServiceTest.java @@ -48,6 +48,17 @@ class AiAgentServiceTest { assertEquals(3, service.listAudit(task.id()).size()); } + @Test + @DisplayName("P0②(c) 安全门 enforced:非本机 baseUrl 的本地应用被拒(FORBIDDEN),写路径不被触发") + void localApplyRejectedForNonLocalBaseUrl() { + AiAgentService service = newService(); + var task = service.createTask("安全门测试"); + // 非本机 targetEnv → AiToolRegistry.check 不通过(local-only + production-write 拦截) + var ex = assertThrows(ResponseStatusException.class, + () -> service.applyLocalRelease(task.id(), "any-change-set", "http://prod-host:9000")); + assertEquals(org.springframework.http.HttpStatus.FORBIDDEN, ex.getStatusCode()); + } + @Test @DisplayName("无效 schema 草稿会阻止生成变更包") void invalidSchemaBlocksChangeSet() throws Exception { diff --git a/platform-legacy-core/src/main/java/com/dsasp/server/common/dataDic/service/DataDicService.java b/platform-legacy-core/src/main/java/com/dsasp/server/common/dataDic/service/DataDicService.java index 7629257..1462a4a 100644 --- a/platform-legacy-core/src/main/java/com/dsasp/server/common/dataDic/service/DataDicService.java +++ b/platform-legacy-core/src/main/java/com/dsasp/server/common/dataDic/service/DataDicService.java @@ -101,6 +101,13 @@ public interface DataDicService { * @return */ public String executeCreateSql(String sql); + + /** + * 受控变更实体表结构(只允许 加列 / 同族扩长 / 改可空,经 AlterTableSqlGuard 白名单校验)。 + * @param sql ALTER 语句 + * @return null=成功;非空=失败原因 + */ + public String executeAlterSql(String sql); /** * get entity by table name diff --git a/platform-legacy-core/src/main/java/com/dsasp/server/dataDic/service/AlterTableSqlGuard.java b/platform-legacy-core/src/main/java/com/dsasp/server/dataDic/service/AlterTableSqlGuard.java new file mode 100644 index 0000000..ac35de1 --- /dev/null +++ b/platform-legacy-core/src/main/java/com/dsasp/server/dataDic/service/AlterTableSqlGuard.java @@ -0,0 +1,106 @@ +package com.dsasp.server.dataDic.service; + +import java.util.Locale; +import java.util.regex.Pattern; + +/** + * P0② 引擎 ALTER 安全通道守卫(纯静态 / 无 Spring 依赖,便于单测)。 + * + *

保真层(com.dsasp.*)的 DDL 此前只接受 CREATE({@code DataDicServiceImpl.executeCreateSql}), + * 完全不支持 ALTER。本守卫把 ALTER 从「完全不可达」收窄为「只允许 加列 / 同族扩长 / 改可空」 + * 的最小安全集,显式拒绝一切破坏性 / 不可逆 DDL。 + * + *

放在 legacy-core(而非 platform-metadata)以避免 legacy-core→metadata 的反向(循环)依赖: + * 引擎层 {@code executeAlterSql} 与控制层 {@code MetaController} 都引用本类,形成 defense-in-depth + * 双层校验。 + * + *

受控形态(标识符大小写敏感,必须大写,匹配引擎建表正则;类型 token 小写,匹配 + * {@code MetaController.appendColumnDdl} 的输出): + *

    + *
  • {@code ALTER TABLE ADD COLUMN } — 加列(可带 REFERENCES 引用)
  • + *
  • {@code ALTER TABLE ALTER COLUMN TYPE } — 同族扩长
  • + *
  • {@code ALTER TABLE ALTER COLUMN DROP NOT NULL} — 改可空
  • + *
+ * 其余(DROP COLUMN / RENAME / SET NOT NULL / 跨族类型转换 / 多语句 / 子查询 / 注释 / 小写绕过) + * 一律抛 {@link IllegalArgumentException}。 + */ +public final class AlterTableSqlGuard { + + private AlterTableSqlGuard() { + } + + /** 表名/列名规则与 MetaController 建表白名单一致(大写起头,大写数字下划线)。 */ + private static final String TABLE = "[A-Z][A-Z0-9_]{2,40}"; + private static final String COLUMN = "[A-Z][A-Z0-9_]{1,60}"; + + /** 加列允许的引擎类型(对齐 appendColumnDdl:字符串/数值/整型/时间戳/定长/引用列)。 */ + private static final String ADD_TYPE = + "(?:character varying\\(\\d{1,4}\\)" + + "|numeric\\(\\d{1,2},\\d{1,2}\\)" + + "|integer" + + "|bigint" + + "|character\\(36\\)(?: REFERENCES " + TABLE + ")?)"; + + /** 扩长只允许同族(varchar 改宽 / numeric 改精度),不允许跨族(varchar→int 会丢数据)。 */ + private static final String WIDEN_TYPE = + "(?:character varying\\(\\d{1,4}\\)|numeric\\(\\d{1,2},\\d{1,2}\\))"; + + private static final Pattern ADD_COLUMN = Pattern.compile( + "ALTER TABLE (" + TABLE + ") ADD COLUMN (" + COLUMN + ") " + ADD_TYPE); + private static final Pattern ALTER_TYPE = Pattern.compile( + "ALTER TABLE (" + TABLE + ") ALTER COLUMN (" + COLUMN + ") TYPE " + WIDEN_TYPE); + private static final Pattern DROP_NOT_NULL = Pattern.compile( + "ALTER TABLE (" + TABLE + ") ALTER COLUMN (" + COLUMN + ") DROP NOT NULL"); + + /** + * 注意:不含 " NOT NULL"(会误伤合法的 "DROP NOT NULL");ADD COLUMN ... NOT NULL 由 + * 「不匹配任何受控形态」自然拒绝。"SET NOT NULL" 明确列出(不会误伤 DROP NOT NULL)。 + */ + private static final String[] DENY_TOKENS = { + "--", "/*", "*/", " USING ", "(SELECT", " SELECT ", + " DROP COLUMN", " RENAME ", " SET NOT NULL", " SET DEFAULT", + " DROP TABLE", " DROP CONSTRAINT", " ADD CONSTRAINT", + }; + + /** + * 校验并归一化一条 ALTER 语句。 + * + * @param sql 原始 SQL + * @return 归一后的安全 SQL(折叠空白、去尾分号),可直接交给 jdbcTemplate.execute + * @throws IllegalArgumentException 非白名单 / 危险 / 非受控形态 + */ + public static String guard(String sql) { + if (sql == null) { + throw new IllegalArgumentException("ALTER 脚本为空"); + } + String s = sql.strip(); + if (s.endsWith(";")) { + s = s.substring(0, s.length() - 1).strip(); + } + s = s.replaceAll("\\s+", " "); + if (s.isEmpty()) { + throw new IllegalArgumentException("ALTER 脚本为空"); + } + // 单语句:折叠后不得再含分号(分号注入第二句) + if (s.indexOf(';') >= 0) { + throw new IllegalArgumentException("只允许单条 ALTER 语句: " + sql); + } + String upper = s.toUpperCase(Locale.ROOT); + if (!upper.startsWith("ALTER TABLE ")) { + throw new IllegalArgumentException("只允许 ALTER TABLE 语句: " + sql); + } + for (String bad : DENY_TOKENS) { + if (upper.contains(bad)) { + throw new IllegalArgumentException("ALTER 含禁止操作 [" + bad.trim() + "]: " + sql); + } + } + // 必须精确匹配三种受控形态之一(整串 matches,标识符大小写敏感) + if (ADD_COLUMN.matcher(s).matches() + || ALTER_TYPE.matcher(s).matches() + || DROP_NOT_NULL.matcher(s).matches()) { + return s; + } + throw new IllegalArgumentException( + "非受控的 ALTER 形态(只允许 加列 / 同族扩长 / 改可空): " + sql); + } +} diff --git a/platform-legacy-core/src/main/java/com/dsasp/server/dataDic/service/DataDicServiceImpl.java b/platform-legacy-core/src/main/java/com/dsasp/server/dataDic/service/DataDicServiceImpl.java index 27e05ee..ad5a06f 100644 --- a/platform-legacy-core/src/main/java/com/dsasp/server/dataDic/service/DataDicServiceImpl.java +++ b/platform-legacy-core/src/main/java/com/dsasp/server/dataDic/service/DataDicServiceImpl.java @@ -204,6 +204,18 @@ public class DataDicServiceImpl implements DataDicService { return "非合法的创建表脚本"; } + @Override + public String executeAlterSql(String sql) { + String safe; + try { + safe = AlterTableSqlGuard.guard(sql); + } catch (IllegalArgumentException e) { + return e.getMessage(); + } + jdbcTemplate.execute(safe); + return null; + } + @OriginServiceMethod(name="新增实体的默认属性", type = "dataDic" , description = "新增实体,默认产生createby,updatby,createtime,updatetime,version,isactive,orgid,departid") @Override public GeneralPOJO getTableDefaultAttribute() { diff --git a/platform-legacy-core/src/test/java/com/dsasp/server/dataDic/service/AlterTableSqlGuardTest.java b/platform-legacy-core/src/test/java/com/dsasp/server/dataDic/service/AlterTableSqlGuardTest.java new file mode 100644 index 0000000..4f60d78 --- /dev/null +++ b/platform-legacy-core/src/test/java/com/dsasp/server/dataDic/service/AlterTableSqlGuardTest.java @@ -0,0 +1,151 @@ +package com.dsasp.server.dataDic.service; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertThrows; + +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; + +/** + * P0② 引擎 ALTER 安全通道守卫。保真层(com.dsasp.*)的 DDL 此前只接受 CREATE + * (DataDicServiceImpl.executeCreateSql),完全不支持 ALTER。本守卫把 ALTER 从 + * 「完全不可达」收窄为「只允许 加列 / 同族扩长 / 改可空」的最小安全集,显式拒绝 + * 一切破坏性/不可逆 DDL(DROP COLUMN / RENAME / SET NOT NULL / 多语句 / 跨族类型 / + * 小写绕过 / 子查询)。规则与 MetaController.appendColumnDdl 的类型映射对齐。 + */ +class AlterTableSqlGuardTest { + + // ---------- 允许:加列 ---------- + @Test + @DisplayName("加列:numeric/varchar/integer/bigint/character(36) 五类引擎类型通过,返回归一 SQL") + void addColumnAllowedTypes() { + assertEquals("ALTER TABLE EIP4_X ADD COLUMN AMOUNT numeric(18,6)", + AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ADD COLUMN AMOUNT numeric(18,6)")); + assertEquals("ALTER TABLE EIP4_X ADD COLUMN NAME character varying(200)", + AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ADD COLUMN NAME character varying(200)")); + assertEquals("ALTER TABLE EIP4_X ADD COLUMN QTY integer", + AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ADD COLUMN QTY integer")); + assertEquals("ALTER TABLE EIP4_X ADD COLUMN WHEN_AT bigint", + AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ADD COLUMN WHEN_AT bigint")); + assertEquals("ALTER TABLE EIP4_X ADD COLUMN CODE character(36)", + AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ADD COLUMN CODE character(36)")); + } + + @Test + @DisplayName("加引用列:character(36) REFERENCES 目标表 通过") + void addReferenceColumnAllowed() { + assertEquals("ALTER TABLE EIP4_ORDER ADD COLUMN CUSTOMERID character(36) REFERENCES EIP4_CUSTOMER", + AlterTableSqlGuard.guard( + "ALTER TABLE EIP4_ORDER ADD COLUMN CUSTOMERID character(36) REFERENCES EIP4_CUSTOMER")); + } + + // ---------- 允许:同族扩长 ---------- + @Test + @DisplayName("扩长:ALTER COLUMN ... TYPE varchar(n) / numeric(p,s) 通过") + void widenTypeAllowed() { + assertEquals("ALTER TABLE EIP4_X ALTER COLUMN NAME TYPE character varying(400)", + AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ALTER COLUMN NAME TYPE character varying(400)")); + assertEquals("ALTER TABLE EIP4_X ALTER COLUMN AMOUNT TYPE numeric(20,8)", + AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ALTER COLUMN AMOUNT TYPE numeric(20,8)")); + } + + // ---------- 允许:改可空 ---------- + @Test + @DisplayName("改可空:ALTER COLUMN ... DROP NOT NULL 通过") + void dropNotNullAllowed() { + assertEquals("ALTER TABLE EIP4_X ALTER COLUMN NAME DROP NOT NULL", + AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ALTER COLUMN NAME DROP NOT NULL")); + } + + @Test + @DisplayName("空白容错:首尾空白 + 单个结尾分号 被归一掉,内部多空格折叠") + void whitespaceNormalized() { + assertEquals("ALTER TABLE EIP4_X ADD COLUMN AMOUNT numeric(18,6)", + AlterTableSqlGuard.guard(" ALTER TABLE EIP4_X ADD COLUMN AMOUNT numeric(18,6) ; ")); + } + + // ---------- 拒绝:破坏性/不可逆 ---------- + @Test + @DisplayName("拒绝:DROP COLUMN(丢数据)") + void rejectDropColumn() { + assertThrows(IllegalArgumentException.class, + () -> AlterTableSqlGuard.guard("ALTER TABLE EIP4_X DROP COLUMN NAME")); + } + + @Test + @DisplayName("拒绝:RENAME(破坏引用)") + void rejectRename() { + assertThrows(IllegalArgumentException.class, + () -> AlterTableSqlGuard.guard("ALTER TABLE EIP4_X RENAME COLUMN NAME TO NAME2")); + } + + @Test + @DisplayName("拒绝:SET NOT NULL(收紧约束,对存量数据不可逆)") + void rejectSetNotNull() { + assertThrows(IllegalArgumentException.class, + () -> AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ALTER COLUMN NAME SET NOT NULL")); + } + + @Test + @DisplayName("拒绝:ADD COLUMN ... NOT NULL(有数据的表加非空列会失败)") + void rejectAddColumnNotNull() { + assertThrows(IllegalArgumentException.class, + () -> AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ADD COLUMN NAME character varying(200) NOT NULL")); + } + + @Test + @DisplayName("拒绝:跨族类型转换(varchar→int 会丢数据/报错)") + void rejectCrossFamilyTypeChange() { + assertThrows(IllegalArgumentException.class, + () -> AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ALTER COLUMN QTY TYPE integer")); + } + + // ---------- 拒绝:注入/越权 ---------- + @Test + @DisplayName("拒绝:多语句(分号注入第二句)") + void rejectMultiStatement() { + assertThrows(IllegalArgumentException.class, + () -> AlterTableSqlGuard.guard( + "ALTER TABLE EIP4_X ADD COLUMN NAME integer; DROP TABLE EIP4_X")); + } + + @Test + @DisplayName("拒绝:DROP TABLE / CREATE 等非 ALTER 语句") + void rejectNonAlter() { + assertThrows(IllegalArgumentException.class, + () -> AlterTableSqlGuard.guard("DROP TABLE EIP4_X")); + assertThrows(IllegalArgumentException.class, + () -> AlterTableSqlGuard.guard("CREATE TABLE EIP4_X (EIP4_X_ID character(36))")); + } + + @Test + @DisplayName("拒绝:小写绕过(标识符必须大写,匹配引擎建表规则)") + void rejectLowercaseBypass() { + assertThrows(IllegalArgumentException.class, + () -> AlterTableSqlGuard.guard("alter table eip4_x add column amount numeric(18,6)")); + // 表名小写 + assertThrows(IllegalArgumentException.class, + () -> AlterTableSqlGuard.guard("ALTER TABLE eip4x ADD COLUMN AMOUNT integer")); + } + + @Test + @DisplayName("拒绝:子查询 / USING 强转 / 注释") + void rejectSubqueryAndUsing() { + assertThrows(IllegalArgumentException.class, + () -> AlterTableSqlGuard.guard( + "ALTER TABLE EIP4_X ALTER COLUMN QTY TYPE integer USING (SELECT 1)")); + assertThrows(IllegalArgumentException.class, + () -> AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ADD COLUMN NAME integer -- drop")); + } + + @Test + @DisplayName("拒绝:未知类型 / 空 / null") + void rejectUnknownTypeAndEmpty() { + assertThrows(IllegalArgumentException.class, + () -> AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ADD COLUMN ID money(1)")); + assertThrows(IllegalArgumentException.class, + () -> AlterTableSqlGuard.guard(" ")); + assertThrows(IllegalArgumentException.class, + () -> AlterTableSqlGuard.guard(null)); + } +} diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/web/MetaController.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/MetaController.java index b589542..ee6fd43 100644 --- a/platform-metadata/src/main/java/com/eip4/platform/metadata/web/MetaController.java +++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/MetaController.java @@ -275,6 +275,89 @@ public class MetaController { return resp; } + @Operation(summary = "为已建实体加列(ALTER ADD COLUMN):写 SYS_ENTITYATTRIBUTE 元数据 + 受控 ALTER 物理表(只加列,恒可空)") + @PostMapping("/api/meta/entity/{table}/attributes") + public Map addAttributes(@PathVariable String table, @RequestBody Map req) { + Properties ctx = UserSession.getAdmin(); + String t = table.toUpperCase(); + if (!t.matches("[A-Z][A-Z0-9_]{2,40}")) { + return err("tablename 不合法: " + t); + } + Entity ent = (Entity) dataDicService.getSYSEntityByTableName(t); + if (ent == null) { + return err("实体不存在: " + t); + } + String entityId = idOf(ent); + @SuppressWarnings("unchecked") + List> attrs = (List>) req.get("attributes"); + if (attrs == null || attrs.isEmpty()) { + return err("attributes 为空"); + } + // saveAttr 载体:沿用 createEntity 的 SYS_USERGROUP.NAME 属性行模板 + Entity tplEnt = (Entity) dataDicService.getSYSEntityByTableName("SYS_USERGROUP"); + Map attrTpl = loadAttrTemplate(idOf(tplEnt)); + + List added = new ArrayList<>(); + for (Map a : attrs) { + String col = String.valueOf(a.get("column")).toUpperCase(); + if (!col.matches("[A-Z][A-Z0-9_]{1,60}")) { + return err("字段名不合法: " + col); + } + Integer exists = jdbcTemplate.queryForObject( + "SELECT COUNT(*) FROM SYS_ENTITYATTRIBUTE WHERE ENTITYID=? AND COLUMNNAME=?", + Integer.class, entityId, col); + if (exists != null && exists > 0) { + return err("字段已存在: " + col); + } + String type = String.valueOf(a.getOrDefault("type", "string")); + String display = String.valueOf(a.getOrDefault("display", col)); + // ALTER 加列一律可空:对有数据的表加 NOT NULL 列会失败,故忽略 mandatory。 + String ddl; + if ("reference".equals(type)) { + String refTable = a.get("referenceTable") == null + ? null : String.valueOf(a.get("referenceTable")).toUpperCase(); + if (refTable == null || dataDicService.getSYSEntityByTableName(refTable) == null) { + return err("引用目标实体不存在: " + refTable); + } + String referenceId = findOrCreateReference(refTable, col, ctx); + saveAttr(attrTpl, entityId, col, display, referenceId, 36, false, false, ctx); + ddl = alterAddColumnDdl(t, col, referenceId, 36, refTable); + } else { + String ref = switch (type) { + case "integer" -> "INTEGER"; + case "number" -> "DECIMAL"; + case "date" -> "DATE"; + case "datetime" -> "TIME"; + case "boolean" -> "BOOLEAN"; + default -> "NVARCHAR"; + }; + Integer len = "NVARCHAR".equals(ref) + ? (a.get("length") instanceof Number n ? n.intValue() : 100) : null; + saveAttr(attrTpl, entityId, col, display, ref, len, false, false, ctx); + ddl = alterAddColumnDdl(t, col, ref, len, null); + } + // 受控 ALTER:经 AlterTableSqlGuard 白名单(defense-in-depth,executeAlterSql 内也再校验) + String alterErr = dataDicService.executeAlterSql(ddl); + if (alterErr != null) { + return err("加列失败[" + col + "]: " + alterErr); + } + added.add(col); + } + // 失效 POInfo + 白名单缓存,使后续读写立即拿到新列(免重启) + cacheInvalidator.evictByTable(t); + // 新外键列补索引(IF NOT EXISTS 幂等) + List indexes = indexEnhancer.enhanceForNewEntity(t); + + Map resp = new LinkedHashMap<>(); + resp.put("status", 0); + resp.put("msg", "altered"); + resp.put("data", Map.of( + "tablename", t, + "addedColumns", added, + "indexCount", indexes.size())); + return resp; + } + /** * P1-4 手动失效 POInfo + 白名单缓存(C1 坑 3 修复的运维出口)。 * 元数据被旁路写入(直改 SYS_ENTITYATTRIBUTE 等)后调用本接口,使变更立即生效,无需重启。 @@ -449,6 +532,33 @@ public class MetaController { } } + /** + * 生成单列 ALTER ADD COLUMN(P0②/P1④:已建实体加列)。恒可空——有数据的表加 NOT NULL 列会失败。 + * 类型映射镜像 {@link #appendColumnDdl}(NVARCHAR→varchar / INTEGER|BOOLEAN→integer / + * DECIMAL|MONEY→numeric(18,6) / DATE|TIME→bigint / CHAR|引用→character(36))。 + * 结果须经 {@code AlterTableSqlGuard} 白名单后才执行。 + */ + static String alterAddColumnDdl(String table, String col, String ref, Integer len, String refTable) { + return "ALTER TABLE " + table + " ADD COLUMN " + col + " " + columnSqlType(ref, len, refTable); + } + + static String columnSqlType(String ref, Integer len, String refTable) { + if ("NVARCHAR".equals(ref) || "CODE".equals(ref)) { + int n = len != null && len > 0 ? len : 100; + return "character varying(" + n + ")"; + } else if ("INTEGER".equals(ref) || "BOOLEAN".equals(ref) || "ENUMERATE".equals(ref)) { + return "integer"; + } else if ("DECIMAL".equals(ref) || "MONEY".equals(ref)) { + return "numeric(18,6)"; + } else if ("DATE".equals(ref) || "TIME".equals(ref)) { + return "bigint"; + } else if ("CHAR".equals(ref)) { + return "character(36)"; + } + // 引用列:ref=SYS_REFERENCE_ID(uuid),外键指向 refTable + return "character(36) REFERENCES " + (refTable != null ? refTable : ""); + } + private static int positiveInt(Object value, int defaultValue) { if (value instanceof Number n && n.intValue() > 0) { return n.intValue(); diff --git a/platform-metadata/src/test/java/com/eip4/platform/metadata/web/MetaControllerAlterTest.java b/platform-metadata/src/test/java/com/eip4/platform/metadata/web/MetaControllerAlterTest.java new file mode 100644 index 0000000..c10e203 --- /dev/null +++ b/platform-metadata/src/test/java/com/eip4/platform/metadata/web/MetaControllerAlterTest.java @@ -0,0 +1,52 @@ +package com.eip4.platform.metadata.web; + +import static org.junit.jupiter.api.Assertions.assertDoesNotThrow; +import static org.junit.jupiter.api.Assertions.assertEquals; + +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; + +import com.dsasp.server.dataDic.service.AlterTableSqlGuard; + +/** + * P0②/P1④ 加列 DDL 生成 + 安全契约。验证 {@code MetaController.alterAddColumnDdl} 的类型映射 + * 与 {@code appendColumnDdl} 一致,且每一种生成形态都能通过 {@code AlterTableSqlGuard} 白名单 + * (生成器只产守卫批准的 DDL,杜绝控制器侧生成出守卫会拒的语句)。 + */ +class MetaControllerAlterTest { + + @Test + @DisplayName("加列 DDL 按引擎类型映射生成,且全部通过 ALTER 安全守卫") + void alterAddColumnDdlMatchesEngineTypesAndPassesGuard() { + assertGuarded("ALTER TABLE EIP4_X ADD COLUMN AMOUNT numeric(18,6)", + MetaController.alterAddColumnDdl("EIP4_X", "AMOUNT", "DECIMAL", null, null)); + assertGuarded("ALTER TABLE EIP4_X ADD COLUMN NAME character varying(200)", + MetaController.alterAddColumnDdl("EIP4_X", "NAME", "NVARCHAR", 200, null)); + // NVARCHAR 缺长度 → 默认 100(对齐 appendColumnDdl) + assertGuarded("ALTER TABLE EIP4_X ADD COLUMN NICK character varying(100)", + MetaController.alterAddColumnDdl("EIP4_X", "NICK", "NVARCHAR", null, null)); + assertGuarded("ALTER TABLE EIP4_X ADD COLUMN QTY integer", + MetaController.alterAddColumnDdl("EIP4_X", "QTY", "INTEGER", null, null)); + assertGuarded("ALTER TABLE EIP4_X ADD COLUMN FLAG integer", + MetaController.alterAddColumnDdl("EIP4_X", "FLAG", "BOOLEAN", null, null)); + assertGuarded("ALTER TABLE EIP4_X ADD COLUMN HAPPENED bigint", + MetaController.alterAddColumnDdl("EIP4_X", "HAPPENED", "DATE", null, null)); + assertGuarded("ALTER TABLE EIP4_X ADD COLUMN CREATED_AT bigint", + MetaController.alterAddColumnDdl("EIP4_X", "CREATED_AT", "TIME", null, null)); + } + + @Test + @DisplayName("引用列加列:外键指向目标表,通过安全守卫") + void referenceColumnPointsAtTargetTableAndPassesGuard() { + String referenceUuid = "11111111-1111-1111-1111-111111111111"; + assertGuarded("ALTER TABLE EIP4_ORDER ADD COLUMN CUSTOMERID character(36) REFERENCES EIP4_CUSTOMER", + MetaController.alterAddColumnDdl("EIP4_ORDER", "CUSTOMERID", referenceUuid, 36, "EIP4_CUSTOMER")); + } + + private static void assertGuarded(String expectedDdl, String actualDdl) { + assertEquals(expectedDdl, actualDdl); + // 安全契约:生成的每条 ALTER 都必须被守卫接受(否则真实加列时会被引擎层拒) + assertEquals(expectedDdl, assertDoesNotThrow(() -> AlterTableSqlGuard.guard(actualDdl), + "生成的 ALTER 应通过安全守卫: " + actualDdl)); + } +} diff --git a/scripts/p0-alter-acceptance.sh b/scripts/p0-alter-acceptance.sh new file mode 100644 index 0000000..6d16c15 --- /dev/null +++ b/scripts/p0-alter-acceptance.sh @@ -0,0 +1,71 @@ +#!/usr/bin/env bash +# P0② 引擎 ALTER 安全通道 · 端到端验收 +# +# 证明:已建实体经 POST /api/meta/entity/{table}/attributes 加列后, +# ① 元数据(SYS_ENTITYATTRIBUTE)有新列;② 物理表真的 ALTER 加了列(psql 直查 information_schema); +# ③ 受控守卫拒绝重复列/不存在的表(负控)。 +# +# 用法(先以 dev profile 起 8094,见 scripts/run-dev.sh / five-ring-acceptance.sh): +# BASE=http://localhost:8094 bash scripts/p0-alter-acceptance.sh +set -uo pipefail +BASE=${BASE:-http://localhost:8094} +ACCT=${ACCT:-admin}; PW=${PW:-111111} +PGURL=${PGURL:-postgresql://zhengwr@localhost:5433/eip4dev} +TS=$(date +%s) +TABLE="EIP4PT_ALT${TS}" +TBL_LC=$(echo "$TABLE" | tr '[:upper:]' '[:lower:]') +FAIL=0 +jqpy() { python3 -c "import sys,json;d=json.load(sys.stdin,strict=False);print(eval(\"d$1\"))" 2>/dev/null; } +say() { echo "$@"; } +ok() { echo " ✓ $*"; } +bad() { echo " ✗ $*"; FAIL=1; } + +TOK=$(curl -s -X POST "$BASE/api/auth/login" -H 'Content-Type: application/json' \ + -d "{\"account\":\"$ACCT\",\"password\":\"$PW\"}" | jqpy "['token']") +H=(-H "Authorization: Bearer $TOK" -H 'Content-Type: application/json') +[ -n "${TOK:-}" ] && [ "$TOK" != "None" ] && ok "login token len=${#TOK}" || { bad "login 失败"; exit 1; } + +say "[1] 建实体 $TABLE(仅 TITLE)" +ST=$(curl -s -X POST "$BASE/api/meta/entity" "${H[@]}" -d "{ + \"tablename\":\"$TABLE\",\"name\":\"ALTER验收\", + \"attributes\":[{\"column\":\"TITLE\",\"display\":\"标题\",\"type\":\"string\",\"length\":200,\"mandatory\":true}]}" | jqpy "['status']") +[ "$ST" = "0" ] && ok "建表 status=0" || bad "建表失败 status=$ST" + +say "[2] 加列:AMOUNT(number)/QTY(integer)/NOTE(string,len 300)/OWNER(reference→SYS_USER)" +R=$(curl -s -X POST "$BASE/api/meta/entity/$TABLE/attributes" "${H[@]}" -d '{ + "attributes":[{"column":"AMOUNT","display":"金额","type":"number"}, + {"column":"QTY","display":"数量","type":"integer"}, + {"column":"NOTE","display":"备注","type":"string","length":300}, + {"column":"OWNER","display":"负责人","type":"reference","referenceTable":"SYS_USER"}]}') +ST=$(echo "$R" | jqpy "['status']") +ADDED=$(echo "$R" | jqpy "['data']['addedColumns']") +[ "$ST" = "0" ] && ok "加列 status=0 added=$ADDED" || bad "加列失败: $R" + +say "[3] 元数据核对:GET attributes 含新列" +COLS=$(curl -s "$BASE/api/meta/entity/$TABLE/attributes" "${H[@]}" | python3 -c "import sys,json;d=json.load(sys.stdin);print(' '.join(c['column'] for c in d['data']['columns']))" 2>/dev/null) +for c in AMOUNT QTY NOTE OWNER; do + echo "$COLS" | grep -q "$c" && ok "元数据有列 $c" || bad "元数据缺列 $c (cols=$COLS)" +done + +say "[4] 物理表核对:psql 直查 information_schema(证明 ALTER 真生效)" +if command -v psql >/dev/null 2>&1; then + PHYS=$(psql "$PGURL" -At -c "SELECT column_name||':'||data_type FROM information_schema.columns WHERE table_schema='eip3' AND table_name='$TBL_LC' AND column_name IN ('amount','qty','note','owner') ORDER BY column_name;" 2>/dev/null) + echo "$PHYS" | grep -q "amount:numeric" && ok "物理列 amount numeric" || bad "物理列 amount 缺/类型错: $PHYS" + echo "$PHYS" | grep -q "qty:integer" && ok "物理列 qty integer" || bad "物理列 qty 缺/类型错" + echo "$PHYS" | grep -qE "note:character varying" && ok "物理列 note varchar" || bad "物理列 note 缺/类型错" + echo "$PHYS" | grep -qE "owner:character" && ok "物理列 owner character(36)" || bad "物理列 owner 缺/类型错" +else + echo " (psql 不可用,跳过物理核对)" +fi + +say "[5] 负控:重复加 AMOUNT → 拒;加到不存在的表 → 拒" +ST=$(curl -s -X POST "$BASE/api/meta/entity/$TABLE/attributes" "${H[@]}" -d '{"attributes":[{"column":"AMOUNT","type":"number"}]}' | jqpy "['status']") +[ "$ST" != "0" ] && ok "重复列被拒 status=$ST" || bad "重复列未被拒" +ST=$(curl -s -X POST "$BASE/api/meta/entity/EIP4PT_NOPE${TS}/attributes" "${H[@]}" -d '{"attributes":[{"column":"X","type":"number"}]}' | jqpy "['status']") +[ "$ST" != "0" ] && ok "不存在的表被拒 status=$ST" || bad "不存在的表未被拒" + +say "[6] 清理" +curl -s -X DELETE "$BASE/api/meta/entity/$TABLE" "${H[@]}" >/dev/null && ok "删除 $TABLE" + +echo "" +[ "$FAIL" = "0" ] && echo "[完成] P0② 引擎 ALTER 安全通道 端到端验收 ✅ 全绿" || { echo "[失败] 存在未通过项 ✗"; exit 1; } From ccbed824988d545c542be90342e4d8894ebe8184 Mon Sep 17 00:00:00 2001 From: zhengwr Date: Sun, 21 Jun 2026 13:56:14 +0800 Subject: [PATCH 3/5] =?UTF-8?q?feat(P0=E2=91=A1b/P1=E2=91=A5):=20overlay?= =?UTF-8?q?=E5=AE=A1=E8=AE=A1+strict=E5=88=86=E6=B5=81=20+=20=E8=BF=90?= =?UTF-8?q?=E8=A1=8C=E6=97=B6DELETE=20+=20publish=E8=8F=9C=E5=8D=95?= =?UTF-8?q?=E6=8E=88=E6=9D=83?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - PageSchemaController: ?strict分流(白名单外组件可选400,默认warn不破存量) + GET /api/page/schema/overlay/audit 白名单对账(只读advisory) - 运行时DELETE: PageSchemaWriter.deleteStandard + DELETE /api/page/schema/{tpl}/standard (@Transactional对称撤销:删schema+overlay+软删菜单+清sys_role_menu) - 菜单授权: MenuRegistrar.grantToRoles(复用sys_role_menu ON CONFLICT范式) + PublishOrchestrator.grantMenuRoles + DesignFeatureController.publish透传roleIds(缺省warning) - 单测 PageSchemaWriter6/MenuRegistrar4/PageSchemaController28/DeploymentPackageBuilder1无回归 scripts/p1-6-acceptance.sh 真库验收(授权落库+负控+DELETE级联+GET404) Co-Authored-By: Claude Opus 4.8 (1M context) --- .../metadata/publish/MenuRegistrar.java | 25 ++++++ .../metadata/publish/PublishOrchestrator.java | 5 ++ .../metadata/schema/PageSchemaWriter.java | 18 ++++ .../metadata/web/DesignFeatureController.java | 12 +++ .../metadata/web/PageSchemaController.java | 83 +++++++++++++++++++ .../metadata/publish/MenuRegistrarTest.java | 26 ++++++ .../metadata/schema/PageSchemaWriterTest.java | 21 +++++ .../web/PageSchemaControllerTest.java | 25 +++++- scripts/p1-6-acceptance.sh | 68 +++++++++++++++ 9 files changed, 279 insertions(+), 4 deletions(-) create mode 100644 scripts/p1-6-acceptance.sh diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/publish/MenuRegistrar.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/publish/MenuRegistrar.java index 5c58d87..63dcf9b 100644 --- a/platform-metadata/src/main/java/com/eip4/platform/metadata/publish/MenuRegistrar.java +++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/publish/MenuRegistrar.java @@ -72,6 +72,31 @@ public class MenuRegistrar { return menuId; } + /** + * P1⑥:给菜单授权角色(写 sys_role_menu)。发布后若不授权,非超管(无 sys_role_menu 行)看不见新功能。 + * 复用 {@code AdminWriteController.setRoleMenus} 的 {@code (roleid,menuid) ON CONFLICT DO NOTHING} 幂等范式。 + * + * @param menuId 菜单 id + * @param roleIds 授权角色 id 列表 + * @param operator 操作人(审计) + * @return 实际写入(授权)的角色数;menuId/roleIds 为空则 0(不写库) + */ + public int grantToRoles(String menuId, List roleIds, String operator) { + if (menuId == null || menuId.isBlank() || roleIds == null || roleIds.isEmpty()) { + return 0; + } + int granted = 0; + for (String roleId : roleIds) { + if (roleId == null || roleId.isBlank()) { + continue; + } + granted += jdbcTemplate.update( + "INSERT INTO sys_role_menu(roleid, menuid) VALUES(?,?) ON CONFLICT DO NOTHING", + roleId.trim(), menuId.trim()); + } + return granted; + } + private ParentMenu ensureNewFeatureParent() { List existingDir = jdbcTemplate.queryForList( "SELECT TRIM(sys_menu_id) FROM sys_menu WHERE name='" + NEW_FEATURE_DIR diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/publish/PublishOrchestrator.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/publish/PublishOrchestrator.java index 2d2fb35..723fb74 100644 --- a/platform-metadata/src/main/java/com/eip4/platform/metadata/publish/PublishOrchestrator.java +++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/publish/PublishOrchestrator.java @@ -47,6 +47,11 @@ public class PublishOrchestrator { return menuRegistrar.register(templateId, menuName, parentMenuId, operator); } + /** P1⑥:给已注册菜单授权角色(写 sys_role_menu),返回授权角色数(roleIds 空则 0)。 */ + public int grantMenuRoles(String menuId, List roleIds, String operator) { + return menuRegistrar.grantToRoles(menuId, roleIds, operator); + } + /** generateDeploymentPackage != false 时生成 production 人审部署包;否则返回 null。 */ public DeploymentPackage buildDeploymentPackage(String entityId, String tableName, String templateId, String menuName, String menuId, diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/schema/PageSchemaWriter.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/schema/PageSchemaWriter.java index 9ba6dc1..5298565 100644 --- a/platform-metadata/src/main/java/com/eip4/platform/metadata/schema/PageSchemaWriter.java +++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/schema/PageSchemaWriter.java @@ -77,6 +77,24 @@ public class PageSchemaWriter { return etag; } + /** + * 删除标准层页面 schema(运行时撤销净新页)。对称 {@link #upsertStandard},删除也收口唯一写口, + * 不走裸 JDBC 旁路。 + * + * @param templateId 页面模板 id + * @param operator 操作者标识(审计) + * @return 受影响行数(0 = 不存在,幂等) + */ + public int deleteStandard(String templateId, String operator) { + if (templateId == null || templateId.isBlank()) { + throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "templateId 不能为空"); + } + int n = jdbcTemplate.update("DELETE FROM sys_page_schema WHERE template_id = ?", templateId); + log.info("[standard-delete] operator={} templateId={} deleted={}", + operator == null || operator.isBlank() ? "UNKNOWN" : operator, templateId, n); + return n; + } + static String sha256(String text) { try { MessageDigest digest = MessageDigest.getInstance("SHA-256"); diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/web/DesignFeatureController.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/DesignFeatureController.java index 523153d..d05e5a7 100644 --- a/platform-metadata/src/main/java/com/eip4/platform/metadata/web/DesignFeatureController.java +++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/DesignFeatureController.java @@ -395,6 +395,18 @@ public class DesignFeatureController { String menuId = publishOrchestrator.registerMenu(templateId, menuName, parentMenuId, operator); data.put("menuId", menuId); + // P1⑥:可选 roleIds 给菜单授权(写 sys_role_menu);缺省则新功能仅超管可见,返 warning。 + @SuppressWarnings("unchecked") + List roleIds = body.get("roleIds") instanceof List rs + ? rs.stream().map(String::valueOf).filter(s -> !s.isBlank()).toList() + : List.of(); + int grantedRoles = publishOrchestrator.grantMenuRoles(menuId, roleIds, operator); + data.put("grantedRoleCount", grantedRoles); + if (grantedRoles == 0) { + data.put("menuVisibilityWarning", + "未指定 roleIds,新功能菜单仅超管可见;请到「角色菜单授权」为业务角色授权"); + } + boolean generatePkg = !(Boolean.FALSE.equals(body.get("generateDeploymentPackage"))); @SuppressWarnings("unchecked") List flowsForPkg = (List) data.get("flows"); diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/web/PageSchemaController.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/PageSchemaController.java index d766e74..91b042a 100644 --- a/platform-metadata/src/main/java/com/eip4/platform/metadata/web/PageSchemaController.java +++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/PageSchemaController.java @@ -177,6 +177,7 @@ public class PageSchemaController { @PutMapping("/api/page/schema/{templateId}/overlay") public ResponseEntity> putOverlay( @PathVariable String templateId, + @RequestParam(defaultValue = "false") boolean strict, @RequestBody String schemaJsonRaw) { requireAdmin(); @@ -193,6 +194,13 @@ public class PageSchemaController { // 以后若把 AI 写路径收口到本端点,再按来源加 strict 分流参数。 TypedPageSchemaReport validation = typedSchemaValidator.validate(schemaJsonRaw); if (!validation.valid()) { + if (strict) { + // P0②(b) strict 分流:AI 写路径/净新页可选严格,白名单外组件直接 400。 + // 默认 strict=false 保留设计器存量页只告警不阻断的现状(存量 13 类组件会触雷)。 + log.warn("[F4-L1][putOverlay][strict] 拒绝白名单外 schema templateId={}: {}", templateId, validation.issues()); + return ResponseEntity.badRequest() + .body(fail("typed schema 校验失败(strict)", validationData(validation))); + } log.warn("[F4-L1][putOverlay] typed-recipe 校验 {} 项告警(设计器路径不阻断)templateId={}: {}", validation.issues().size(), templateId, validation.issues()); } @@ -240,6 +248,43 @@ public class PageSchemaController { return ResponseEntity.ok(ok("overlay 保存成功", data)); } + @Operation(summary = "overlay 白名单对账(只读 advisory):列出使用 typed 白名单外组件的 overlay 模板", + description = "P0②(b)。扫 sys_page_schema_overlay,对每行跑 typed 校验,聚合 PageComponentRegistry 白名单外组件;" + + "不阻断,供逐步 strict 化(?strict=true)的决策依据。") + @GetMapping("/api/page/schema/overlay/audit") + public ResponseEntity> auditOverlay() { + requireAdmin(); + List> rows; + try { + rows = jdbcTemplate.queryForList( + "SELECT template_id, schema_json::text AS schema_json FROM sys_page_schema_overlay ORDER BY template_id"); + } catch (DataAccessException ex) { + return ResponseEntity.status(HttpStatus.SERVICE_UNAVAILABLE) + .body(fail("overlay 表不可用:" + ex.getMessage())); + } + List> offenders = new java.util.ArrayList<>(); + java.util.Set distinct = new java.util.TreeSet<>(); + for (Map row : rows) { + TypedPageSchemaReport report = typedSchemaValidator.validate(String.valueOf(row.get("schema_json"))); + List bad = report.usedComponents().stream() + .filter(c -> !componentRegistry.supportsComponent(c)) + .sorted().toList(); + if (!bad.isEmpty()) { + Map o = new LinkedHashMap<>(); + o.put("templateId", String.valueOf(row.get("template_id"))); + o.put("unsupportedComponents", bad); + offenders.add(o); + distinct.addAll(bad); + } + } + Map data = new LinkedHashMap<>(); + data.put("overlayCount", rows.size()); + data.put("offenderCount", offenders.size()); + data.put("distinctUnsupportedComponents", new java.util.ArrayList<>(distinct)); + data.put("offenders", offenders); + return ResponseEntity.ok(ok("overlay 白名单对账(advisory)", data)); + } + // ================================================================ PUT standard(写标准层·净新页/设计中心新建/AI 产物) @Operation(summary = "写入/更新标准层页面 schema(净新页/设计中心新建/AI 产物,仅管理员)", @@ -297,6 +342,44 @@ public class PageSchemaController { return ResponseEntity.ok(ok("overlay 已删除,已还原标准版", null)); } + @Operation(summary = "删除标准层净新页(运行时撤销,仅管理员)", + description = "P1⑥:对称撤销 publish 写入——删 sys_page_schema 标准层 + overlay + 软删关联菜单 + 清 sys_role_menu 授权。" + + "默认不删服务流(流可能被多页/引擎复用)。事务内执行,半删不残留。幂等。") + @DeleteMapping("/api/page/schema/{templateId}/standard") + @org.springframework.transaction.annotation.Transactional + public ResponseEntity> deleteStandard(@PathVariable String templateId) { + requireAdmin(); + String operator = currentUserId(); + // 1. 关联菜单(view_templateid=该页),清角色授权 + 软删菜单(对称 publish 的菜单注册/授权) + List menuIds = jdbcTemplate.queryForList( + "SELECT sys_menu_id FROM sys_menu WHERE TRIM(view_templateid)=?", String.class, templateId); + int roleMenu = 0; + for (String mid : menuIds) { + roleMenu += jdbcTemplate.update("DELETE FROM sys_role_menu WHERE TRIM(menuid)=?", mid.trim()); + } + long now = System.currentTimeMillis(); + int menus = jdbcTemplate.update( + "UPDATE sys_menu SET isactive=0, updatetime=?, updateby=? WHERE TRIM(view_templateid)=?", + now, operator, templateId); + // 2. 删标准层(收口 PageSchemaWriter,不裸 JDBC) + overlay + int standard = pageSchemaWriter.deleteStandard(templateId, operator); + int overlay = 0; + try { + overlay = jdbcTemplate.update("DELETE FROM sys_page_schema_overlay WHERE template_id = ?", templateId); + } catch (DataAccessException ex) { + log.debug("[deleteStandard] overlay 表不可用(忽略): {}", ex.getMessage()); + } + log.info("[deleteStandard] operator={} templateId={} standard={} overlay={} menus={} roleMenu={}", + operator, templateId, standard, overlay, menus, roleMenu); + Map data = new LinkedHashMap<>(); + data.put("templateId", templateId); + data.put("standardDeleted", standard); + data.put("overlayDeleted", overlay); + data.put("menusSoftDeleted", menus); + data.put("roleMenuCleared", roleMenu); + return ResponseEntity.ok(ok("净新页已删除(schema+overlay+菜单+授权)", data)); + } + // ================================================================ 内部工具 /** 构造统一 schema 响应(含 ETag/304 + X-Schema-Layer 头)。 */ diff --git a/platform-metadata/src/test/java/com/eip4/platform/metadata/publish/MenuRegistrarTest.java b/platform-metadata/src/test/java/com/eip4/platform/metadata/publish/MenuRegistrarTest.java index 39710c4..a2328d7 100644 --- a/platform-metadata/src/test/java/com/eip4/platform/metadata/publish/MenuRegistrarTest.java +++ b/platform-metadata/src/test/java/com/eip4/platform/metadata/publish/MenuRegistrarTest.java @@ -59,4 +59,30 @@ class MenuRegistrarTest { org.mockito.ArgumentMatchers.contains("UPDATE sys_menu"), eq("演示功能改名"), eq("TPL-1"), any(), eq("admin"), eq("MENU-EXIST")); } + + @Test + void grantToRolesInsertsPerRole() { + JdbcTemplate jdbc = mock(JdbcTemplate.class); + String insert = "INSERT INTO sys_role_menu(roleid, menuid) VALUES(?,?) ON CONFLICT DO NOTHING"; + when(jdbc.update(eq(insert), eq("R1"), eq("M9"))).thenReturn(1); + when(jdbc.update(eq(insert), eq("R2"), eq("M9"))).thenReturn(1); + + MenuRegistrar reg = new MenuRegistrar(jdbc); + int granted = reg.grantToRoles("M9", List.of("R1", "R2"), "admin"); + + assertThat(granted).isEqualTo(2); + verify(jdbc, times(1)).update(eq(insert), eq("R1"), eq("M9")); + verify(jdbc, times(1)).update(eq(insert), eq("R2"), eq("M9")); + } + + @Test + void grantToRolesEmptyIsNoOp() { + JdbcTemplate jdbc = mock(JdbcTemplate.class); + MenuRegistrar reg = new MenuRegistrar(jdbc); + + assertThat(reg.grantToRoles("M9", List.of(), "admin")).isZero(); + assertThat(reg.grantToRoles(" ", List.of("R1"), "admin")).isZero(); + assertThat(reg.grantToRoles("M9", List.of(" "), "admin")).isZero(); + verify(jdbc, times(0)).update(anyString(), anyString(), anyString()); + } } diff --git a/platform-metadata/src/test/java/com/eip4/platform/metadata/schema/PageSchemaWriterTest.java b/platform-metadata/src/test/java/com/eip4/platform/metadata/schema/PageSchemaWriterTest.java index 1c67018..aaa9cad 100644 --- a/platform-metadata/src/test/java/com/eip4/platform/metadata/schema/PageSchemaWriterTest.java +++ b/platform-metadata/src/test/java/com/eip4/platform/metadata/schema/PageSchemaWriterTest.java @@ -79,4 +79,25 @@ class PageSchemaWriterTest { assertEquals(HttpStatus.BAD_REQUEST, e2.getStatusCode()); assertTrue(e2.getReason() != null); } + + @Test + @DisplayName("5. deleteStandard 删标准层一次,返回受影响行数(幂等,P1⑥)") + void deleteStandardRemovesAndReturnsCount() { + JdbcTemplate jdbc = mock(JdbcTemplate.class); + when(jdbc.update(anyString(), eq(TID))).thenReturn(1); + PageSchemaWriter writer = new PageSchemaWriter(jdbc); + + assertEquals(1, writer.deleteStandard(TID, "admin")); + verify(jdbc).update(eq("DELETE FROM sys_page_schema WHERE template_id = ?"), eq(TID)); + } + + @Test + @DisplayName("6. deleteStandard 空 templateId → 400,不写库") + void deleteStandardBlankRejected() { + JdbcTemplate jdbc = mock(JdbcTemplate.class); + PageSchemaWriter writer = new PageSchemaWriter(jdbc); + ResponseStatusException e = assertThrows(ResponseStatusException.class, + () -> writer.deleteStandard(" ", "admin")); + assertEquals(HttpStatus.BAD_REQUEST, e.getStatusCode()); + } } diff --git a/platform-metadata/src/test/java/com/eip4/platform/metadata/web/PageSchemaControllerTest.java b/platform-metadata/src/test/java/com/eip4/platform/metadata/web/PageSchemaControllerTest.java index 5ba0c64..60709c1 100644 --- a/platform-metadata/src/test/java/com/eip4/platform/metadata/web/PageSchemaControllerTest.java +++ b/platform-metadata/src/test/java/com/eip4/platform/metadata/web/PageSchemaControllerTest.java @@ -288,7 +288,7 @@ class PageSchemaControllerTest { // 注入 ADMIN 上下文 setAdminSession(); - var resp = c.putOverlay(TID, SCHEMA_OVERLAY); + var resp = c.putOverlay(TID, false, SCHEMA_OVERLAY); assertEquals(HttpStatus.OK, resp.getStatusCode()); assertEquals(0, resp.getBody().get("status")); assertTrue(resp.getBody().get("data") != null); @@ -309,7 +309,7 @@ class PageSchemaControllerTest { org.springframework.web.server.ResponseStatusException ex = org.junit.jupiter.api.Assertions.assertThrows( org.springframework.web.server.ResponseStatusException.class, - () -> c.putOverlay(TID, " ")); + () -> c.putOverlay(TID, false, " ")); assertEquals(org.springframework.http.HttpStatus.BAD_REQUEST, ex.getStatusCode()); clearSession(); } @@ -360,7 +360,7 @@ class PageSchemaControllerTest { org.springframework.web.server.ResponseStatusException ex = org.junit.jupiter.api.Assertions.assertThrows( org.springframework.web.server.ResponseStatusException.class, - () -> c.putOverlay(TID, SCHEMA_OVERLAY)); + () -> c.putOverlay(TID, false, SCHEMA_OVERLAY)); assertEquals(HttpStatus.FORBIDDEN, ex.getStatusCode()); clearSession(); } @@ -431,7 +431,7 @@ class PageSchemaControllerTest { + "\"onEvent\":{\"click\":{\"actions\":[{\"actionType\":\"setValue\"}]}}}]," + "\"filter\":{\"type\":\"form\",\"body\":[{\"type\":\"search-box\"}]}}}"; - var resp = c.putOverlay(TID, legacyPage); + var resp = c.putOverlay(TID, false, legacyPage); assertEquals(HttpStatus.OK, resp.getStatusCode(), "设计器编辑存量页应放行保存,不被 AI 作用域的 typed-recipe 白名单阻断"); @@ -441,6 +441,23 @@ class PageSchemaControllerTest { clearSession(); } + @Test + @DisplayName("20b. PUT overlay ?strict=true:白名单外组件(search-box) 直接 400,不写库(P0②b)") + void putOverlayStrictRejectsUnsupported() { + JdbcTemplate jdbc = mock(JdbcTemplate.class); + PageSchemaController c = new PageSchemaController(jdbc); + setAdminSession(); + String legacyPage = "{\"type\":\"page\",\"body\":{\"type\":\"crud\"," + + "\"filter\":{\"type\":\"form\",\"body\":[{\"type\":\"search-box\"}]}}}"; + + var resp = c.putOverlay(TID, true, legacyPage); + + assertEquals(HttpStatus.BAD_REQUEST, resp.getStatusCode(), + "strict=true 时白名单外组件应 400"); + verify(jdbc, org.mockito.Mockito.never()).update(anyString(), any(), any(), any(), any(), any(), any()); + clearSession(); + } + // ── M3a 标准层写端点(净新页/设计中心新建/AI 产物,单一写真相) ────────────── @Test diff --git a/scripts/p1-6-acceptance.sh b/scripts/p1-6-acceptance.sh new file mode 100644 index 0000000..4f78836 --- /dev/null +++ b/scripts/p1-6-acceptance.sh @@ -0,0 +1,68 @@ +#!/usr/bin/env bash +# P1⑥ · 端到端验收:① publish 菜单授权(写 sys_role_menu) ② 运行时 DELETE 净新页(对称撤销 schema+overlay+菜单+授权) +# +# 用法:先以 dev profile 起 8094,再 BASE=http://localhost:8094 bash scripts/p1-6-acceptance.sh +set -uo pipefail +BASE=${BASE:-http://localhost:8094} +ACCT=${ACCT:-admin}; PW=${PW:-111111} +PGURL=${PGURL:-postgresql://zhengwr@localhost:5433/eip4dev} +TS=$(date +%s) +TABLE="EIP4PT_P16${TS}" +ROLE="EIP4PT_TROLE${TS}" +FAIL=0 +jqpy() { python3 -c "import sys,json;d=json.load(sys.stdin,strict=False);print(eval(\"d$1\"))" 2>/dev/null; } +ok() { echo " ✓ $*"; } +bad() { echo " ✗ $*"; FAIL=1; } +pg() { PGOPTIONS='-c search_path=eip3' psql "$PGURL" -At -c "$1" 2>/dev/null; } + +TOK=$(curl -s -X POST "$BASE/api/auth/login" -H 'Content-Type: application/json' \ + -d "{\"account\":\"$ACCT\",\"password\":\"$PW\"}" | jqpy "['token']") +H=(-H "Authorization: Bearer $TOK" -H 'Content-Type: application/json') +[ -n "${TOK:-}" ] && [ "$TOK" != "None" ] && ok "login len=${#TOK}" || { bad "login 失败"; exit 1; } + +echo "[1] 建实体 + recipe 编译 + 发布(带 roleIds=[$ROLE])" +EID=$(curl -s -X POST "$BASE/api/meta/entity" "${H[@]}" -d "{\"tablename\":\"$TABLE\",\"name\":\"P16演示\",\"attributes\":[{\"column\":\"TITLE\",\"display\":\"标题\",\"type\":\"string\",\"length\":100,\"mandatory\":true}]}" | jqpy "['data']['entityId']") +TID=$(curl -s -X POST "$BASE/api/design/recipe/compile" "${H[@]}" -d "{\"tableName\":\"$TABLE\",\"recipe\":\"maintenance-crud-v1\",\"title\":\"P16演示\",\"displayField\":\"TITLE\"}" | jqpy "['data']['templateId']") +[ -n "$TID" ] && [ "$TID" != "None" ] && ok "compile templateId=$TID" || bad "compile 失败" +PUB=$(curl -s -X POST "$BASE/api/design/publish" "${H[@]}" -d "{\"entityId\":\"$EID\",\"tableName\":\"$TABLE\",\"templateId\":\"$TID\",\"menuName\":\"P16演示\",\"roleIds\":[\"$ROLE\"],\"generateDeploymentPackage\":false}") +MENUID=$(echo "$PUB" | jqpy "['data']['menuId']") +GRANTED=$(echo "$PUB" | jqpy "['data']['grantedRoleCount']") +[ "$GRANTED" = "1" ] && ok "发布授权 grantedRoleCount=1 menuId=$MENUID" || bad "授权数应=1,实=$GRANTED" + +echo "[2] 菜单授权落库:psql 查 sys_role_menu" +N=$(pg "SELECT count(*) FROM sys_role_menu WHERE TRIM(roleid)='$ROLE' AND TRIM(menuid)='$MENUID';") +[ "$N" = "1" ] && ok "sys_role_menu 有 ($ROLE,$MENUID)" || bad "sys_role_menu 缺授权行(n=$N)" + +echo "[3] 发布无 roleIds → warning(负控)" +TABLE2="${TABLE}B" +EID2=$(curl -s -X POST "$BASE/api/meta/entity" "${H[@]}" -d "{\"tablename\":\"$TABLE2\",\"name\":\"P16B\",\"attributes\":[{\"column\":\"TITLE\",\"type\":\"string\",\"length\":100,\"mandatory\":true}]}" | jqpy "['data']['entityId']") +TID2=$(curl -s -X POST "$BASE/api/design/recipe/compile" "${H[@]}" -d "{\"tableName\":\"$TABLE2\",\"recipe\":\"maintenance-crud-v1\",\"title\":\"P16B\",\"displayField\":\"TITLE\"}" | jqpy "['data']['templateId']") +WARN=$(curl -s -X POST "$BASE/api/design/publish" "${H[@]}" -d "{\"entityId\":\"$EID2\",\"tableName\":\"$TABLE2\",\"templateId\":\"$TID2\",\"menuName\":\"P16B\",\"generateDeploymentPackage\":false}" | jqpy "['data'].get('menuVisibilityWarning','')") +[ -n "$WARN" ] && ok "无 roleIds 返 warning(仅超管可见)" || bad "无 roleIds 应返 warning" + +echo "[4] 运行时 DELETE 净新页 $TID(对称撤销)" +DEL=$(curl -s -X DELETE "$BASE/api/page/schema/$TID/standard" "${H[@]}") +SD=$(echo "$DEL" | jqpy "['data']['standardDeleted']") +MD=$(echo "$DEL" | jqpy "['data']['menusSoftDeleted']") +RM=$(echo "$DEL" | jqpy "['data']['roleMenuCleared']") +{ [ "$SD" -ge 1 ] 2>/dev/null && ok "standardDeleted=$SD"; } || bad "standardDeleted 应≥1(实=$SD)" +{ [ "$MD" -ge 1 ] 2>/dev/null && ok "menusSoftDeleted=$MD"; } || bad "menusSoftDeleted 应≥1(实=$MD)" +{ [ "$RM" -ge 1 ] 2>/dev/null && ok "roleMenuCleared=$RM"; } || bad "roleMenuCleared 应≥1(实=$RM)" + +echo "[5] DELETE 后核对:GET schema=404、菜单 isactive=0、授权已清" +CODE=$(curl -s -o /dev/null -w "%{http_code}" "$BASE/api/page/schema/$TID" "${H[@]}") +[ "$CODE" = "404" ] && ok "GET schema → 404(standard 已删)" || bad "GET schema 应 404,实=$CODE" +N=$(pg "SELECT count(*) FROM sys_menu WHERE TRIM(view_templateid)='$TID' AND isactive=1;") +[ "$N" = "0" ] && ok "菜单已软删(isactive=1 行=0)" || bad "菜单未软删(active=$N)" +N=$(pg "SELECT count(*) FROM sys_role_menu WHERE TRIM(roleid)='$ROLE';") +[ "$N" = "0" ] && ok "授权已清(sys_role_menu 行=0)" || bad "授权未清(n=$N)" + +echo "[6] 清理" +for T in "$TABLE" "$TABLE2"; do curl -s -X DELETE "$BASE/api/meta/entity/$T" "${H[@]}" >/dev/null; done +pg "DELETE FROM sys_role_menu WHERE TRIM(roleid) IN ('$ROLE');" >/dev/null +pg "DELETE FROM sys_page_schema WHERE template_id IN ('$TID','$TID2');" >/dev/null +pg "UPDATE sys_menu SET isactive=0 WHERE TRIM(view_templateid) IN ('$TID','$TID2');" >/dev/null +ok "清理完成" + +echo "" +[ "$FAIL" = "0" ] && echo "[完成] P1⑥ 菜单授权 + 运行时DELETE 端到端验收 ✅ 全绿" || { echo "[失败] 存在未通过项 ✗"; exit 1; } From 46ff5c57799e56e2d33f327b9b257b90147ad8fc Mon Sep 17 00:00:00 2001 From: zhengwr Date: Sun, 21 Jun 2026 14:15:29 +0800 Subject: [PATCH 4/5] =?UTF-8?q?fix(P0=E2=91=A1/P1=E2=91=A5):=20=E5=AF=B9?= =?UTF-8?q?=E6=8A=97=E5=AE=A1=E6=9F=A5=E6=94=B6=E5=8F=A3=204=20major=20+?= =?UTF-8?q?=20minor?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 对抗审查 workflow(3 lens)揪出并修复: - [major] AlterTableSqlGuard 移除 ALTER COLUMN TYPE:静态守卫拿不到旧尺寸,无法 保证扩长(varchar(1)/numeric(1,0) 缩短会截断/溢出存量数据),一律拒;扩长须由 MetaController 比对旧列长度后再生成 - [major] addAttributes 校验-写分离 + @Transactional + ALTER 失败抛异常: 杜绝「元数据写了但物理表没加」孤儿(PG 事务性 DDL 一起回滚) - [major] createEntity 检查 executeCreateSql 返回值 + @Transactional:引擎拒建表 不再静默成功 - [major] AiToolRegistry isLocalEnv/isProductionEnv 改 URI host 精确解析:防 http://127.0.0.1.evil.com / localhost.evil.com 伪本地前缀绕过安全门 - [minor] deleteStandard templateId trim + 菜单查询限 isactive=1(两表口径一致, 不连带删历史同 templateId 菜单/授权) - [minor] publish roleIds 只接 String 元素(滤 null/非串);warning 改依据 roleIds.isEmpty()(重复发布不误报) - [minor] menuauth grantToRoles 改 INSERT...WHERE NOT EXISTS(sys_role_menu 无 唯一约束,ON CONFLICT 不去重,重复发布会插重复行)+ columnSqlType 空 refTable 抛错 全单测绿(Failures=0)、p0-alter/p1-6 真库验收绿(含幂等+负控)、浏览器 e2e 6/6 绿 Co-Authored-By: Claude Opus 4.8 (1M context) --- .../platform/ai/service/AiToolRegistry.java | 39 ++++++++++++--- .../dataDic/service/AlterTableSqlGuard.java | 21 ++++---- .../service/AlterTableSqlGuardTest.java | 18 ++++--- .../metadata/publish/MenuRegistrar.java | 13 +++-- .../metadata/web/DesignFeatureController.java | 8 +-- .../platform/metadata/web/MetaController.java | 49 +++++++++++++------ .../metadata/web/PageSchemaController.java | 16 +++--- .../metadata/publish/MenuRegistrarTest.java | 27 +++++++--- scripts/p1-6-acceptance.sh | 6 +++ 9 files changed, 136 insertions(+), 61 deletions(-) diff --git a/platform-ai/src/main/java/com/eip4/platform/ai/service/AiToolRegistry.java b/platform-ai/src/main/java/com/eip4/platform/ai/service/AiToolRegistry.java index 1cd9bee..1138eb3 100644 --- a/platform-ai/src/main/java/com/eip4/platform/ai/service/AiToolRegistry.java +++ b/platform-ai/src/main/java/com/eip4/platform/ai/service/AiToolRegistry.java @@ -153,17 +153,40 @@ public final class AiToolRegistry { } private static boolean isLocalEnv(String targetEnv) { - return targetEnv.isBlank() - || targetEnv.equals("local") - || targetEnv.equals("dev") - || targetEnv.startsWith("localhost") - || targetEnv.startsWith("127.0.0.1") - || targetEnv.startsWith("http://localhost") - || targetEnv.startsWith("http://127.0.0.1"); + if (targetEnv.isBlank() || targetEnv.equals("local") || targetEnv.equals("dev")) { + return true; + } + // 解析 host 精确比对,而非 startsWith 前缀:防 http://127.0.0.1.evil.com / http://localhost.evil.com + // 这类「伪本地」域名绕过(对抗审查 major)。与下游 AiLocalReleaseExecutor.safeLocalBase 同口径。 + String host = hostOf(targetEnv); + return host.equals("localhost") || host.equals("127.0.0.1") + || host.equals("::1") || host.equals("0:0:0:0:0:0:0:1"); } private static boolean isProductionEnv(String targetEnv) { - return targetEnv.equals("prod") || targetEnv.equals("production") || targetEnv.contains("prod"); + if (targetEnv.equals("prod") || targetEnv.equals("production")) { + return true; + } + // 只看 host 段含 prod,不再对整 URL/path contains('prod')(避免 http://localhost:8084/prod-test 误判) + return hostOf(targetEnv).contains("prod"); + } + + /** 从 targetEnv(URL 或裸 host[:port])解析出小写 host(去 IPv6 方括号);解析失败返空串。 */ + private static String hostOf(String targetEnv) { + try { + String s = targetEnv.contains("://") ? targetEnv : "http://" + targetEnv; + String host = java.net.URI.create(s).getHost(); + if (host == null) { + return ""; + } + host = host.toLowerCase(Locale.ROOT); + if (host.startsWith("[") && host.endsWith("]")) { + host = host.substring(1, host.length() - 1); + } + return host; + } catch (RuntimeException e) { + return ""; + } } private static String text(String value) { diff --git a/platform-legacy-core/src/main/java/com/dsasp/server/dataDic/service/AlterTableSqlGuard.java b/platform-legacy-core/src/main/java/com/dsasp/server/dataDic/service/AlterTableSqlGuard.java index ac35de1..eb01c27 100644 --- a/platform-legacy-core/src/main/java/com/dsasp/server/dataDic/service/AlterTableSqlGuard.java +++ b/platform-legacy-core/src/main/java/com/dsasp/server/dataDic/service/AlterTableSqlGuard.java @@ -17,12 +17,15 @@ import java.util.regex.Pattern; *

受控形态(标识符大小写敏感,必须大写,匹配引擎建表正则;类型 token 小写,匹配 * {@code MetaController.appendColumnDdl} 的输出): *

    - *
  • {@code ALTER TABLE ADD COLUMN } — 加列(可带 REFERENCES 引用)
  • - *
  • {@code ALTER TABLE ALTER COLUMN TYPE } — 同族扩长
  • + *
  • {@code ALTER TABLE ADD COLUMN } — 加列(可带 REFERENCES 引用,恒可空)
  • *
  • {@code ALTER TABLE ALTER COLUMN DROP NOT NULL} — 改可空
  • *
- * 其余(DROP COLUMN / RENAME / SET NOT NULL / 跨族类型转换 / 多语句 / 子查询 / 注释 / 小写绕过) + * 其余(DROP COLUMN / RENAME / SET NOT NULL / ALTER COLUMN TYPE / 多语句 / 子查询 / 注释 / 小写绕过) * 一律抛 {@link IllegalArgumentException}。 + * + *

为何不放行 ALTER COLUMN TYPE「扩长」:纯静态守卫拿不到旧列定义,无法判断新尺寸是否 ≥ 旧尺寸, + * 因此无法区分「扩长」与「缩短」——后者会截断存量数据 / 整表报错。故 TYPE 变更一律拒绝;若将来需扩长, + * 须在 {@code MetaController} 层读旧列长度/精度后断言 new ≥ old 再生成 DDL,而非放给本守卫。 */ public final class AlterTableSqlGuard { @@ -41,14 +44,8 @@ public final class AlterTableSqlGuard { + "|bigint" + "|character\\(36\\)(?: REFERENCES " + TABLE + ")?)"; - /** 扩长只允许同族(varchar 改宽 / numeric 改精度),不允许跨族(varchar→int 会丢数据)。 */ - private static final String WIDEN_TYPE = - "(?:character varying\\(\\d{1,4}\\)|numeric\\(\\d{1,2},\\d{1,2}\\))"; - private static final Pattern ADD_COLUMN = Pattern.compile( "ALTER TABLE (" + TABLE + ") ADD COLUMN (" + COLUMN + ") " + ADD_TYPE); - private static final Pattern ALTER_TYPE = Pattern.compile( - "ALTER TABLE (" + TABLE + ") ALTER COLUMN (" + COLUMN + ") TYPE " + WIDEN_TYPE); private static final Pattern DROP_NOT_NULL = Pattern.compile( "ALTER TABLE (" + TABLE + ") ALTER COLUMN (" + COLUMN + ") DROP NOT NULL"); @@ -60,6 +57,7 @@ public final class AlterTableSqlGuard { "--", "/*", "*/", " USING ", "(SELECT", " SELECT ", " DROP COLUMN", " RENAME ", " SET NOT NULL", " SET DEFAULT", " DROP TABLE", " DROP CONSTRAINT", " ADD CONSTRAINT", + " TYPE ", // ALTER COLUMN TYPE「扩长/缩短」静态守卫无法判尺寸,一律拒(见类注释) }; /** @@ -94,13 +92,12 @@ public final class AlterTableSqlGuard { throw new IllegalArgumentException("ALTER 含禁止操作 [" + bad.trim() + "]: " + sql); } } - // 必须精确匹配三种受控形态之一(整串 matches,标识符大小写敏感) + // 必须精确匹配两种受控形态之一(整串 matches,标识符大小写敏感) if (ADD_COLUMN.matcher(s).matches() - || ALTER_TYPE.matcher(s).matches() || DROP_NOT_NULL.matcher(s).matches()) { return s; } throw new IllegalArgumentException( - "非受控的 ALTER 形态(只允许 加列 / 同族扩长 / 改可空): " + sql); + "非受控的 ALTER 形态(只允许 加列 / 改可空): " + sql); } } diff --git a/platform-legacy-core/src/test/java/com/dsasp/server/dataDic/service/AlterTableSqlGuardTest.java b/platform-legacy-core/src/test/java/com/dsasp/server/dataDic/service/AlterTableSqlGuardTest.java index 4f60d78..2dd4beb 100644 --- a/platform-legacy-core/src/test/java/com/dsasp/server/dataDic/service/AlterTableSqlGuardTest.java +++ b/platform-legacy-core/src/test/java/com/dsasp/server/dataDic/service/AlterTableSqlGuardTest.java @@ -39,14 +39,18 @@ class AlterTableSqlGuardTest { "ALTER TABLE EIP4_ORDER ADD COLUMN CUSTOMERID character(36) REFERENCES EIP4_CUSTOMER")); } - // ---------- 允许:同族扩长 ---------- + // ---------- 拒绝:ALTER COLUMN TYPE(静态守卫无法判尺寸,一律拒) ---------- @Test - @DisplayName("扩长:ALTER COLUMN ... TYPE varchar(n) / numeric(p,s) 通过") - void widenTypeAllowed() { - assertEquals("ALTER TABLE EIP4_X ALTER COLUMN NAME TYPE character varying(400)", - AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ALTER COLUMN NAME TYPE character varying(400)")); - assertEquals("ALTER TABLE EIP4_X ALTER COLUMN AMOUNT TYPE numeric(20,8)", - AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ALTER COLUMN AMOUNT TYPE numeric(20,8)")); + @DisplayName("拒绝:ALTER COLUMN TYPE —— 拿不到旧尺寸无法保证扩长,缩短会截断数据,一律拒(对抗审查 major)") + void rejectTypeChange() { + // 即便看似「扩长」也拒(无法保证 new>=old) + assertThrows(IllegalArgumentException.class, + () -> AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ALTER COLUMN NAME TYPE character varying(400)")); + // 「缩短」反例:varchar(1) 截断存量;numeric(1,0) 溢出 + assertThrows(IllegalArgumentException.class, + () -> AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ALTER COLUMN NAME TYPE character varying(1)")); + assertThrows(IllegalArgumentException.class, + () -> AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ALTER COLUMN AMT TYPE numeric(1,0)")); } // ---------- 允许:改可空 ---------- diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/publish/MenuRegistrar.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/publish/MenuRegistrar.java index 63dcf9b..94792f7 100644 --- a/platform-metadata/src/main/java/com/eip4/platform/metadata/publish/MenuRegistrar.java +++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/publish/MenuRegistrar.java @@ -74,25 +74,30 @@ public class MenuRegistrar { /** * P1⑥:给菜单授权角色(写 sys_role_menu)。发布后若不授权,非超管(无 sys_role_menu 行)看不见新功能。 - * 复用 {@code AdminWriteController.setRoleMenus} 的 {@code (roleid,menuid) ON CONFLICT DO NOTHING} 幂等范式。 + * + *

幂等实现:{@code sys_role_menu} 无唯一约束/索引(实测),故 {@code ON CONFLICT DO NOTHING} + * 不去重——重复发布会插重复行。这里改用 {@code INSERT ... SELECT ... WHERE NOT EXISTS} 保证幂等 + * (已存在则插 0 行)。返回值只计真正新增的授权数。 * * @param menuId 菜单 id * @param roleIds 授权角色 id 列表 * @param operator 操作人(审计) - * @return 实际写入(授权)的角色数;menuId/roleIds 为空则 0(不写库) + * @return 实际新增(授权)的角色数;menuId/roleIds 为空则 0(不写库) */ public int grantToRoles(String menuId, List roleIds, String operator) { if (menuId == null || menuId.isBlank() || roleIds == null || roleIds.isEmpty()) { return 0; } + String mid = menuId.trim(); int granted = 0; for (String roleId : roleIds) { if (roleId == null || roleId.isBlank()) { continue; } granted += jdbcTemplate.update( - "INSERT INTO sys_role_menu(roleid, menuid) VALUES(?,?) ON CONFLICT DO NOTHING", - roleId.trim(), menuId.trim()); + "INSERT INTO sys_role_menu(roleid, menuid) SELECT ?, ?" + + " WHERE NOT EXISTS (SELECT 1 FROM sys_role_menu WHERE TRIM(roleid)=? AND TRIM(menuid)=?)", + roleId.trim(), mid, roleId.trim(), mid); } return granted; } diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/web/DesignFeatureController.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/DesignFeatureController.java index d05e5a7..82994fe 100644 --- a/platform-metadata/src/main/java/com/eip4/platform/metadata/web/DesignFeatureController.java +++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/DesignFeatureController.java @@ -396,13 +396,15 @@ public class DesignFeatureController { data.put("menuId", menuId); // P1⑥:可选 roleIds 给菜单授权(写 sys_role_menu);缺省则新功能仅超管可见,返 warning。 - @SuppressWarnings("unchecked") + // 只接 String 元素(滤掉 null/非字符串,避免 String.valueOf 把 null→"null" 写脏授权); + // warning 依据「是否传了 roleIds」而非「本次新增数」——否则重复发布(已授权→新增0)会误报。 List roleIds = body.get("roleIds") instanceof List rs - ? rs.stream().map(String::valueOf).filter(s -> !s.isBlank()).toList() + ? rs.stream().filter(String.class::isInstance).map(String.class::cast) + .map(String::trim).filter(s -> !s.isEmpty()).toList() : List.of(); int grantedRoles = publishOrchestrator.grantMenuRoles(menuId, roleIds, operator); data.put("grantedRoleCount", grantedRoles); - if (grantedRoles == 0) { + if (roleIds.isEmpty()) { data.put("menuVisibilityWarning", "未指定 roleIds,新功能菜单仅超管可见;请到「角色菜单授权」为业务角色授权"); } diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/web/MetaController.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/MetaController.java index ee6fd43..e6e936d 100644 --- a/platform-metadata/src/main/java/com/eip4/platform/metadata/web/MetaController.java +++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/MetaController.java @@ -71,6 +71,7 @@ public class MetaController { @Operation(summary = "创建实体:写入 SYS_ENTITY/SYS_ENTITYATTRIBUTE 元数据并动态创建物理表") @PostMapping("/api/meta/entity") + @org.springframework.transaction.annotation.Transactional public Map createEntity(@RequestBody Map req) { Properties ctx = UserSession.getAdmin(); String table = String.valueOf(req.get("tablename")).toUpperCase(); @@ -169,7 +170,13 @@ public class MetaController { // 动态建表前先清刚保存实体/属性带来的 POInfo 缓存,保证后续读写立即拿到新字段。 cacheInvalidator.evictByEntityId(entityId, table); String ddl = createTableDdl(table, created, refTargets); - dataDicService.executeCreateSql(ddl); + // 检查 DDL 返回值:引擎判非法时返回非空错误串。@Transactional + 抛异常 → 回滚已写的实体/属性 + // 元数据(对抗审查 major:否则元数据建好但物理表不存在,运行时 list 500)。 + String ddlErr = dataDicService.executeCreateSql(ddl); + if (ddlErr != null) { + throw new org.springframework.web.server.ResponseStatusException( + org.springframework.http.HttpStatus.BAD_REQUEST, "建表失败: " + ddlErr); + } // P1-5:建表后按元数据补索引(外键 uuid 列 + UPDATETIME),引擎只建表不建索引 List indexes = indexEnhancer.enhanceForNewEntity(table); @@ -277,6 +284,7 @@ public class MetaController { @Operation(summary = "为已建实体加列(ALTER ADD COLUMN):写 SYS_ENTITYATTRIBUTE 元数据 + 受控 ALTER 物理表(只加列,恒可空)") @PostMapping("/api/meta/entity/{table}/attributes") + @org.springframework.transaction.annotation.Transactional public Map addAttributes(@PathVariable String table, @RequestBody Map req) { Properties ctx = UserSession.getAdmin(); String t = table.toUpperCase(); @@ -293,11 +301,8 @@ public class MetaController { if (attrs == null || attrs.isEmpty()) { return err("attributes 为空"); } - // saveAttr 载体:沿用 createEntity 的 SYS_USERGROUP.NAME 属性行模板 - Entity tplEnt = (Entity) dataDicService.getSYSEntityByTableName("SYS_USERGROUP"); - Map attrTpl = loadAttrTemplate(idOf(tplEnt)); - List added = new ArrayList<>(); + // ── 校验全部列(不写库)── 任一不合法原子返回 err;此时尚无写入,无回滚问题。 for (Map a : attrs) { String col = String.valueOf(a.get("column")).toUpperCase(); if (!col.matches("[A-Z][A-Z0-9_]{1,60}")) { @@ -309,16 +314,28 @@ public class MetaController { if (exists != null && exists > 0) { return err("字段已存在: " + col); } - String type = String.valueOf(a.getOrDefault("type", "string")); - String display = String.valueOf(a.getOrDefault("display", col)); - // ALTER 加列一律可空:对有数据的表加 NOT NULL 列会失败,故忽略 mandatory。 - String ddl; - if ("reference".equals(type)) { + if ("reference".equals(String.valueOf(a.getOrDefault("type", "string")))) { String refTable = a.get("referenceTable") == null ? null : String.valueOf(a.get("referenceTable")).toUpperCase(); if (refTable == null || dataDicService.getSYSEntityByTableName(refTable) == null) { return err("引用目标实体不存在: " + refTable); } + } + } + + // ── 写库 + 受控 ALTER ── @Transactional + PG 事务性 DDL:任一列 ALTER 失败抛异常 → 整批 + // (元数据 saveAttr + 已执行的 ALTER)回滚,杜绝「元数据写了但物理表没加」的孤儿(对抗审查 major)。 + Entity tplEnt = (Entity) dataDicService.getSYSEntityByTableName("SYS_USERGROUP"); + Map attrTpl = loadAttrTemplate(idOf(tplEnt)); + List added = new ArrayList<>(); + for (Map a : attrs) { + String col = String.valueOf(a.get("column")).toUpperCase(); + String type = String.valueOf(a.getOrDefault("type", "string")); + String display = String.valueOf(a.getOrDefault("display", col)); + // ALTER 加列一律可空:对有数据的表加 NOT NULL 列会失败,故忽略 mandatory。 + String ddl; + if ("reference".equals(type)) { + String refTable = String.valueOf(a.get("referenceTable")).toUpperCase(); String referenceId = findOrCreateReference(refTable, col, ctx); saveAttr(attrTpl, entityId, col, display, referenceId, 36, false, false, ctx); ddl = alterAddColumnDdl(t, col, referenceId, 36, refTable); @@ -336,10 +353,11 @@ public class MetaController { saveAttr(attrTpl, entityId, col, display, ref, len, false, false, ctx); ddl = alterAddColumnDdl(t, col, ref, len, null); } - // 受控 ALTER:经 AlterTableSqlGuard 白名单(defense-in-depth,executeAlterSql 内也再校验) + // 受控 ALTER:经 AlterTableSqlGuard 白名单(defense-in-depth)。失败抛异常 → 事务回滚。 String alterErr = dataDicService.executeAlterSql(ddl); if (alterErr != null) { - return err("加列失败[" + col + "]: " + alterErr); + throw new org.springframework.web.server.ResponseStatusException( + org.springframework.http.HttpStatus.BAD_REQUEST, "加列失败[" + col + "]: " + alterErr); } added.add(col); } @@ -555,8 +573,11 @@ public class MetaController { } else if ("CHAR".equals(ref)) { return "character(36)"; } - // 引用列:ref=SYS_REFERENCE_ID(uuid),外键指向 refTable - return "character(36) REFERENCES " + (refTable != null ? refTable : ""); + // 引用列:ref=SYS_REFERENCE_ID(uuid),外键指向 refTable(不可为空,否则产无效 DDL) + if (refTable == null || refTable.isBlank()) { + throw new IllegalStateException("引用列缺目标表,无法生成 ALTER: ref=" + ref); + } + return "character(36) REFERENCES " + refTable; } private static int positiveInt(Object value, int defaultValue) { diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/web/PageSchemaController.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/PageSchemaController.java index 91b042a..28c9c04 100644 --- a/platform-metadata/src/main/java/com/eip4/platform/metadata/web/PageSchemaController.java +++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/PageSchemaController.java @@ -350,22 +350,26 @@ public class PageSchemaController { public ResponseEntity> deleteStandard(@PathVariable String templateId) { requireAdmin(); String operator = currentUserId(); - // 1. 关联菜单(view_templateid=该页),清角色授权 + 软删菜单(对称 publish 的菜单注册/授权) + // templateId 统一 trim:sys_page_schema 用精确 template_id=?,sys_menu 用 TRIM(view_templateid)=?, + // 两表对 templateId 的口径保持一致,避免一表命中另一表不命中的半删(对抗审查 minor)。 + String tpl = templateId == null ? "" : templateId.trim(); + // 1. 关联菜单(只取 active),清角色授权 + 软删菜单(对称 publish 的菜单注册/授权)。 + // 限 isactive=1 避免连带删历史已停用的同 templateId 菜单及其授权(对抗审查 minor)。 List menuIds = jdbcTemplate.queryForList( - "SELECT sys_menu_id FROM sys_menu WHERE TRIM(view_templateid)=?", String.class, templateId); + "SELECT sys_menu_id FROM sys_menu WHERE TRIM(view_templateid)=? AND isactive=1", String.class, tpl); int roleMenu = 0; for (String mid : menuIds) { roleMenu += jdbcTemplate.update("DELETE FROM sys_role_menu WHERE TRIM(menuid)=?", mid.trim()); } long now = System.currentTimeMillis(); int menus = jdbcTemplate.update( - "UPDATE sys_menu SET isactive=0, updatetime=?, updateby=? WHERE TRIM(view_templateid)=?", - now, operator, templateId); + "UPDATE sys_menu SET isactive=0, updatetime=?, updateby=? WHERE TRIM(view_templateid)=? AND isactive=1", + now, operator, tpl); // 2. 删标准层(收口 PageSchemaWriter,不裸 JDBC) + overlay - int standard = pageSchemaWriter.deleteStandard(templateId, operator); + int standard = pageSchemaWriter.deleteStandard(tpl, operator); int overlay = 0; try { - overlay = jdbcTemplate.update("DELETE FROM sys_page_schema_overlay WHERE template_id = ?", templateId); + overlay = jdbcTemplate.update("DELETE FROM sys_page_schema_overlay WHERE template_id = ?", tpl); } catch (DataAccessException ex) { log.debug("[deleteStandard] overlay 表不可用(忽略): {}", ex.getMessage()); } diff --git a/platform-metadata/src/test/java/com/eip4/platform/metadata/publish/MenuRegistrarTest.java b/platform-metadata/src/test/java/com/eip4/platform/metadata/publish/MenuRegistrarTest.java index a2328d7..fdbbd89 100644 --- a/platform-metadata/src/test/java/com/eip4/platform/metadata/publish/MenuRegistrarTest.java +++ b/platform-metadata/src/test/java/com/eip4/platform/metadata/publish/MenuRegistrarTest.java @@ -60,19 +60,32 @@ class MenuRegistrarTest { eq("演示功能改名"), eq("TPL-1"), any(), eq("admin"), eq("MENU-EXIST")); } + // 幂等 INSERT...SELECT...WHERE NOT EXISTS(sys_role_menu 无唯一约束,ON CONFLICT 不去重) + private static final String GRANT_SQL = + "INSERT INTO sys_role_menu(roleid, menuid) SELECT ?, ?" + + " WHERE NOT EXISTS (SELECT 1 FROM sys_role_menu WHERE TRIM(roleid)=? AND TRIM(menuid)=?)"; + @Test - void grantToRolesInsertsPerRole() { + void grantToRolesInsertsPerRoleIdempotent() { JdbcTemplate jdbc = mock(JdbcTemplate.class); - String insert = "INSERT INTO sys_role_menu(roleid, menuid) VALUES(?,?) ON CONFLICT DO NOTHING"; - when(jdbc.update(eq(insert), eq("R1"), eq("M9"))).thenReturn(1); - when(jdbc.update(eq(insert), eq("R2"), eq("M9"))).thenReturn(1); + when(jdbc.update(eq(GRANT_SQL), eq("R1"), eq("M9"), eq("R1"), eq("M9"))).thenReturn(1); + when(jdbc.update(eq(GRANT_SQL), eq("R2"), eq("M9"), eq("R2"), eq("M9"))).thenReturn(1); MenuRegistrar reg = new MenuRegistrar(jdbc); int granted = reg.grantToRoles("M9", List.of("R1", "R2"), "admin"); assertThat(granted).isEqualTo(2); - verify(jdbc, times(1)).update(eq(insert), eq("R1"), eq("M9")); - verify(jdbc, times(1)).update(eq(insert), eq("R2"), eq("M9")); + verify(jdbc, times(1)).update(eq(GRANT_SQL), eq("R1"), eq("M9"), eq("R1"), eq("M9")); + verify(jdbc, times(1)).update(eq(GRANT_SQL), eq("R2"), eq("M9"), eq("R2"), eq("M9")); + } + + @Test + void grantToRolesAlreadyGrantedCountsZero() { + JdbcTemplate jdbc = mock(JdbcTemplate.class); + // WHERE NOT EXISTS 命中 → 插 0 行(幂等) + when(jdbc.update(eq(GRANT_SQL), any(), any(), any(), any())).thenReturn(0); + MenuRegistrar reg = new MenuRegistrar(jdbc); + assertThat(reg.grantToRoles("M9", List.of("R1"), "admin")).isZero(); } @Test @@ -83,6 +96,6 @@ class MenuRegistrarTest { assertThat(reg.grantToRoles("M9", List.of(), "admin")).isZero(); assertThat(reg.grantToRoles(" ", List.of("R1"), "admin")).isZero(); assertThat(reg.grantToRoles("M9", List.of(" "), "admin")).isZero(); - verify(jdbc, times(0)).update(anyString(), anyString(), anyString()); + verify(jdbc, times(0)).update(anyString(), any(), any(), any(), any()); } } diff --git a/scripts/p1-6-acceptance.sh b/scripts/p1-6-acceptance.sh index 4f78836..18141e3 100644 --- a/scripts/p1-6-acceptance.sh +++ b/scripts/p1-6-acceptance.sh @@ -33,6 +33,12 @@ echo "[2] 菜单授权落库:psql 查 sys_role_menu" N=$(pg "SELECT count(*) FROM sys_role_menu WHERE TRIM(roleid)='$ROLE' AND TRIM(menuid)='$MENUID';") [ "$N" = "1" ] && ok "sys_role_menu 有 ($ROLE,$MENUID)" || bad "sys_role_menu 缺授权行(n=$N)" +echo "[2b] 重复发布(同 roleIds)→ 授权幂等(sys_role_menu 无唯一约束,须不产生重复行)" +GRANTED2=$(curl -s -X POST "$BASE/api/design/publish" "${H[@]}" -d "{\"entityId\":\"$EID\",\"tableName\":\"$TABLE\",\"templateId\":\"$TID\",\"menuName\":\"P16演示\",\"roleIds\":[\"$ROLE\"],\"generateDeploymentPackage\":false}" | jqpy "['data']['grantedRoleCount']") +[ "$GRANTED2" = "0" ] && ok "重复发布 grantedRoleCount=0(幂等)" || bad "重复发布应=0(实=$GRANTED2)" +N=$(pg "SELECT count(*) FROM sys_role_menu WHERE TRIM(roleid)='$ROLE' AND TRIM(menuid)='$MENUID';") +[ "$N" = "1" ] && ok "sys_role_menu 仍仅 1 行(无重复)" || bad "重复授权产生重复行(n=$N)" + echo "[3] 发布无 roleIds → warning(负控)" TABLE2="${TABLE}B" EID2=$(curl -s -X POST "$BASE/api/meta/entity" "${H[@]}" -d "{\"tablename\":\"$TABLE2\",\"name\":\"P16B\",\"attributes\":[{\"column\":\"TITLE\",\"type\":\"string\",\"length\":100,\"mandatory\":true}]}" | jqpy "['data']['entityId']") From 2d1e9d143b1546c32c37487b741865f636ab10a2 Mon Sep 17 00:00:00 2001 From: zhengwr Date: Sun, 21 Jun 2026 15:29:00 +0800 Subject: [PATCH 5/5] =?UTF-8?q?docs:=20=C2=A79/README=20=E5=9B=9E=E5=86=99?= =?UTF-8?q?=E2=80=94=E2=80=94=E5=B7=B2=E6=8F=90=E4=BA=A4=E5=88=86=E6=94=AF?= =?UTF-8?q?=20+=20=E5=AF=B9=E6=8A=97=E5=AE=A1=E6=9F=A5=E4=BF=AE=E5=A4=8D?= =?UTF-8?q?=20+=20P1=E2=91=A2=E5=8F=8C=E9=87=8D=E9=98=BB=E5=A1=9E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - §9 实施记录:代码已提交 feat/p0p1-impl(改"未commit");补对抗审查4major修复 + overlay审计实跑发现 + 部署包下沉调查结论(两生成器现等价无bug) - §9/README:P1③ framework业务106 标双重阻塞(待S1拍板 + EIP-3.0源码本地未克隆) - README §4:P0②/P1④/P1⑥/P1⑤ 标✅已实施(指向总览§9) Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/README.md | 6 +++--- docs/项目进度与路线-总览-2026-06-21.md | 8 +++++--- 2 files changed, 8 insertions(+), 6 deletions(-) diff --git a/docs/README.md b/docs/README.md index 22f84f1..79f375a 100644 --- a/docs/README.md +++ b/docs/README.md @@ -125,10 +125,10 @@ ## 4. 下一步指引 -> 完整优先级排序见 `项目进度与路线-总览-2026-06-21.md` §5。摘要: +> 完整优先级排序见 `项目进度与路线-总览-2026-06-21.md` §5;**P0②/P1④/P1⑥/P1⑤ 已实施 + 对抗审查 + 全验证(见总览 §9;提交于分支 `feat/p0p1-impl`,未 push)**。 -- **P0**:① 文档对齐(本次进行中);② AI 门禁余项收口(overlay 白名单清零 / 引擎 ALTER 安全通道 / 安全门转 enforced)。 -- **P1**:③ framework 业务 106 视图移植启动(卡 S1 止损评审);④ 人走五环 v2(ALTER 改表 + recipe 扩面 M7);⑤ 流程审批闭环收尾(列表入口 + BPMN 图 + 客户部署);⑥ AI/人工链部署包统一 + 运行时 DELETE/回滚 + publish 菜单授权。 +- **P0**:① 文档对齐 ✅;② AI 门禁余项 —— 引擎 ALTER 安全通道 ✅ / 安全门 enforced ✅ / overlay 审计端点 ✅;存量 overlay 白名单 strict 化推进 待续。 +- **P1**:③ framework 业务 106 视图 —— **双重阻塞:卡 S1 止损评审 + EIP-3.0 源码本地未克隆,无法分析迁移**;④ 人走五环 v2 改表加列 ✅(recipe 扩面 M7 待续);⑤ 流程审批列表入口 e2e ✅(真实流转依赖客户 BPMN、BPMN 图另案);⑥ 运行时 DELETE ✅ + publish 菜单授权 ✅(部署包下沉统一待续,已查两生成器现逻辑等价无 bug)。 - **P2**:报表 A3 立项 / 附件 A4 补完 / 生产上线 A10 / 生产级 UI B4 补完。 - **待拍板**(总览 §6):153 终判三选一、②面 AI/内置 LLM 立项、type100/101 死页停转或留、onEvent 面板自动化率边界、对外口径统一、webmail 是否纳入本期。 diff --git a/docs/项目进度与路线-总览-2026-06-21.md b/docs/项目进度与路线-总览-2026-06-21.md index 712ab1e..a27c82c 100644 --- a/docs/项目进度与路线-总览-2026-06-21.md +++ b/docs/项目进度与路线-总览-2026-06-21.md @@ -147,7 +147,7 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁 ## 9. P0/P1 实施记录(2026-06-21 续·已落地 + E2E 验证) -> 本节记录文档对齐之后启动的 P0/P1 实施。代码改动**未 commit**(待审阅);后端改动需 `mvn -pl platform-app -am package` 重建 jar + 重启 8094 验证(已执行)。验收脚本:`scripts/p0-alter-acceptance.sh`、`scripts/p1-6-acceptance.sh`。 +> 本节记录文档对齐之后启动的 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`。 | 项 | 状态 | 交付 + 证据 | |---|---|---| @@ -157,9 +157,11 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁 | **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 待拍板①:分期/第三方/扩预算),需客户决策方向,非本次。 | -**红线遵守**:引擎 ALTER 经 `AlterTableSqlGuard` 白名单(defense-in-depth:控制层 + 保真层双校验),只加列/恒可空,杜绝破坏性 DDL;DDL 仍收口保真层单点;net-new 标准层删除收口 `PageSchemaWriter`,不裸 JDBC 旁路。 +**对抗审查收口(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`(白名单偏窄,非存量页问题)。 -**仍待(按优先级)**:P0②余项(存量 overlay 白名单 strict 化推进,审计端点已提供对账数据)/ P1④ recipe 扩面 M7 / P1⑥ 部署包下沉统一 / P1⑤ 真实流转(依赖客户 BPMN)/ P1③(待 S1 拍板)。 +**红线遵守**:引擎 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 源码仓本地未克隆,无法分析迁移)**。 ---