Merge branch 'feat/p0p1-impl' into main
Some checks failed
ci / build-test-parity (push) Has been cancelled

P0②引擎ALTER安全通道+安全门enforced+审计 / P1⑥运行时DELETE+菜单授权 / 对抗审查收口4major / 06-21文档对齐

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-21 15:31:52 +08:00
36 changed files with 1184 additions and 76 deletions

View File

@@ -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 全自动开发 / 人力大幅下降」**。线上变更一律输出人工部署包、由人工复核后发布。

View File

@@ -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

View File

@@ -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

View File

@@ -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`(零依赖,可复跑)

View File

@@ -1,3 +1,5 @@
> 📦 **归档候选(2026-06-21)**:M0-C5 一次性 amis fork 构建预演(被 `M0交付/M0剩余项状态登记` 引用,物理归档前先改该引用)。
# C5 任务:amis 6.13.0 Fork 构建预演报告
**任务编号**:EIP4 M0 – C5

View File

@@ -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 浏览器抽验。

View File

@@ -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/<dialogid>/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/<dialogid>/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 `<layout>` 的 `<div location>` 槽位排版 + 隐藏未布局字段(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/<dialogid>/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②/P1④/P1⑥/P1⑤ 已实施 + 对抗审查 + 全验证(见总览 §9;提交于分支 `feat/p0p1-impl`,未 push)**。
- **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 是否纳入本期。
- 部署/重转/导入 recipe、踩坑见「用户管理-Delta移植」§4 与本仓 `scripts/run-dev.sh`。

View File

@@ -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.

View File

@@ -1,3 +1,5 @@
> ✅ **已完成·归档候选(2026-06-21)**:processCoreService 桥接 bean 已端到端实证落地。可后续 `git mv` 入 `docs/归档/`。
# 提交审批端到端 — processCoreService 桥接 bean 设计(MVP)
> 日期:2026-06-14

View File

@@ -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 功能的模板再泛化。

View File

@@ -1,3 +1,5 @@
> ✅ **已完成·归档候选(2026-06-21)**:菜单树模式 + 字段级树选择框已修复 live 验收。可后续 `git mv` 入 `docs/归档/`。
# 菜单维护改老系统模式 + 字段级树选择框修复 — 实施计划
日期:2026-06-15

View File

@@ -1,3 +1,5 @@
> ✅ **已完成·归档候选(2026-06-21)**:Phase 0-4 全部实现 + live 验收。仍可作 WfTemplate 驱动审批机制参考;可后续 `git mv` 入 `docs/归档/`。
# WfTemplate 驱动审批界面 — 完整实现方案
日期:2026-06-16

View File

@@ -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 文档」。每里程碑落地后回写状态。

View File

@@ -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 闭环(写失败测试 → 跑红 → 最小实现 → 跑绿 → 提交),不要跳过红/绿步骤,不要批量合并任务。

View File

@@ -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 共识),具体数值/形态待真实数据校准

View File

@@ -1,3 +1,5 @@
> ⚠️ **已被取代(2026-06-21)**:本文口径停在 06-17。最新进度权威见 [项目进度与路线-总览-2026-06-21.md](项目进度与路线-总览-2026-06-21.md)。本文保留作历史快照,勿据以判进度。
# EIP3 → EIP4 迁移:项目进度与路线总览
> 维护日期:2026-06-17 | 性质:全项目进度盘点 + 剩余工作路线(A 兼容 / B 新功能)。

View File

@@ -0,0 +1,168 @@
# 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 实施。代码**已提交两仓特性分支 `feat/p0p1-impl`(未 push)**:eip4-platform 4 提交(docs / P0② / P0②b+P1⑥ / 对抗审查修复)、eip4-web 1 提交(P1④+P1⑤)。后端改动 `mvn -pl platform-app -am package` 重建 jar + 重启 8094 验证(已执行)。验收脚本:`scripts/p0-alter-acceptance.sh`、`scripts/p1-6-acceptance.sh`。
| 项 | 状态 | 交付 + 证据 |
|---|---|---|
| **P0② AI 门禁 + 引擎 ALTER 安全通道** | ✅ 完成·已验证 | (a) `AlterTableSqlGuard`(legacy-core,只允许 加列/同族扩长/改可空,拒 DROP/RENAME/SET NOT NULL/多语句/小写绕过)+ `DataDicService.executeAlterSql` 通道 + `MetaController POST /api/meta/entity/{table}/attributes` 加列端点(saveAttr 元数据 + 受控 ALTER 物理表 + evictByTable + 补索引);(b) `PageSchemaController` `?strict` 分流 + `GET /api/page/schema/overlay/audit` 白名单对账端点;(c) `AiAgentService.applyLocalRelease` 织入 `AiToolRegistry.check`(安全门 advisory→**enforced**,非本机/越权写路径 403)。**单测**:Guard 15/0、alter DDL 2/0、安全门 22/0(含新 FORBIDDEN 测试,112 基线无回归)、strict+审计 28/0。**真库 e2e**:建实体→加 4 列(数值/整型/字符串/引用)→元数据齐 + psql 物理列全生效 + 负控(重复列/不存在表/DROP 形态拒)全绿。 |
| **P1④ 人走五环 v2 · 改表加列** | ✅ 完成·浏览器 E2E | 前端 `meta.ts alterEntity` + `ModelerPage` 行内「加字段」Dialog(复用 FieldTable);打破「v1 只建新不改表」。**build 绿**(tsc 无错)+ **vitest 73/73**。**浏览器 E2E**:`five-ring.spec.ts` 新增「改已有表加列(建模器加字段→元数据落库)」,与五环/主子表共 **5/5 绿**。recipe 扩面(M7 新页型)暂缓。 |
| **P1⑥ 运行时 DELETE + 菜单授权** | ✅ 完成·真库 e2e | `PageSchemaWriter.deleteStandard` + `DELETE /api/page/schema/{tpl}/standard`(@Transactional 对称撤销:删 schema+overlay+软删菜单+清 sys_role_menu);`MenuRegistrar.grantToRoles` + `PublishOrchestrator.grantMenuRoles` + `DesignFeatureController.publish` 透传 roleIds(缺省 warning)。**单测**:PageSchemaWriter 6/0、MenuRegistrar 4/0、PageSchemaController 28/0、DeploymentPackageBuilder 1/0(无回归)。**真库 e2e**:发布带 roleIds→授权写 sys_role_menu ✓、无 roleIds→warning 负控 ✓、DELETE 对称撤销(计数全对)+ GET→404 + psql 核对授权落库/清除 ✓。部署包下沉(builder unify)暂缓(纯重构、回归风险高、可见价值低)。 |
| **P1⑤ 审批列表入口** | 🟡 接线完成·e2e 验证(运行时阻塞) | 列表入口接线**已 live**:228 个 sys_page_schema 含 `openApprovalDrawer` 按钮(psql 实证名实一致)+ 既有单测(registerApprovalAction 5/converter)。**浏览器 E2E**:新增 `approval-list-entry.spec.ts`(纯 mock)验证生产主路径「转换列表页按钮→选中行→openApprovalDrawer→AppShell→ApprovalDrawer 抽屉打开」1/1 绿。**外部阻塞**:点同意后真实流程流转/候选人计算需客户 BPMN(act 库 dev 不可达);BPMN 流程图编辑器=B3 级另案。 |
| **P1③ framework 业务 106 视图** | 🔴 未启动·待拍板 | 卡 S1 止损评审(§6 待拍板①:分期/第三方/扩预算),需客户决策方向,非本次。 |
**对抗审查收口(2026-06-21)**:实施完成后用 3-lens workflow 对自己的 P0②/P1⑥ 代码做对抗审查,揪出并修复 **4 major + 多 minor 真 bug**——①Guard 移除 ALTER COLUMN TYPE(静态守卫拿不到旧尺寸,缩短 `varchar(1)`/`numeric(1,0)` 会截断/溢出存量数据);②`addAttributes` 校验-写分离 + `@Transactional` + ALTER 失败抛异常(防孤儿元数据,PG 事务性 DDL 一起回滚);③`createEntity` 检查 `executeCreateSql` 返回值 + `@Transactional`(引擎拒建表不再静默成功);④`AiToolRegistry.isLocalEnv/isProductionEnv` 改 URI host 精确解析(防 `http://127.0.0.1.evil.com` 伪本地前缀绕过安全门);⑤`grantToRoles` 改 `INSERT...WHERE NOT EXISTS`(**实证 `sys_role_menu` 无唯一约束→`ON CONFLICT DO NOTHING` 不去重→重复发布插重复行**)+ `deleteStandard` trim/isactive 过滤 + `publish` roleIds 只接 String + `columnSqlType` 空 refTable 抛错。修复后全单测 + 双真库验收(含幂等 [2b])+ 浏览器 e2e 6/6 全绿。overlay 审计端点实跑:dev 库仅 1 overlay 用 `dialog`/`submit`(白名单偏窄,非存量页问题)。
**红线遵守**:引擎 ALTER 经 `AlterTableSqlGuard` 白名单(defense-in-depth:控制层 + 保真层双校验),只加列/恒可空、移除 TYPE 变更,杜绝破坏性 DDL;DDL 仍收口保真层单点;net-new 标准层删除收口 `PageSchemaWriter`,不裸 JDBC 旁路。
**仍待(按优先级)**:P0②余项(存量 overlay 白名单 strict 化推进,审计端点已提供对账数据)/ P1④ recipe 扩面 M7 / P1⑥ 部署包下沉统一(已查:两生成器**当前逻辑等价无 bug**,统一是防未来漂移的纯重构,需改 AI 黄金测试,低优先)/ P1⑤ 真实流转(依赖客户 BPMN)/ **P1③ framework 业务 106 视图(双重阻塞:待 S1 拍板 + EIP-3.0 源码仓本地未克隆,无法分析迁移)**。
---
*本文为人工可读的进度权威;逐视图细目见 framework backlog + TODO,方法论/部署 recipe 见用户管理 Delta 移植交接文档,特性设计见 plans/ 下 06-19/06-20 三份 design。*

View File

@@ -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());

View File

@@ -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) {

View File

@@ -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 {

View File

@@ -102,6 +102,13 @@ public interface DataDicService {
*/
public String executeCreateSql(String sql);
/**
* 受控变更实体表结构(只允许 加列 / 同族扩长 / 改可空,经 AlterTableSqlGuard 白名单校验)。
* @param sql ALTER 语句
* @return null=成功;非空=失败原因
*/
public String executeAlterSql(String sql);
/**
* get entity by table name
* @param tableName

View File

@@ -0,0 +1,103 @@
package com.dsasp.server.dataDic.service;
import java.util.Locale;
import java.util.regex.Pattern;
/**
* P0② 引擎 ALTER 安全通道守卫(纯静态 / 无 Spring 依赖,便于单测)。
*
* <p>保真层(com.dsasp.*)的 DDL 此前只接受 CREATE({@code DataDicServiceImpl.executeCreateSql}),
* 完全不支持 ALTER。本守卫把 ALTER 从「完全不可达」收窄为「只允许 加列 / 同族扩长 / 改可空」
* 的最小安全集,显式拒绝一切破坏性 / 不可逆 DDL。
*
* <p>放在 legacy-core(而非 platform-metadata)以避免 legacy-core→metadata 的反向(循环)依赖:
* 引擎层 {@code executeAlterSql} 与控制层 {@code MetaController} 都引用本类,形成 defense-in-depth
* 双层校验。
*
* <p>受控形态(标识符大小写敏感,必须大写,匹配引擎建表正则;类型 token 小写,匹配
* {@code MetaController.appendColumnDdl} 的输出):
* <ul>
* <li>{@code ALTER TABLE <T> ADD COLUMN <C> <type>} — 加列(可带 REFERENCES 引用,恒可空)</li>
* <li>{@code ALTER TABLE <T> ALTER COLUMN <C> DROP NOT NULL} — 改可空</li>
* </ul>
* 其余(DROP COLUMN / RENAME / SET NOT NULL / ALTER COLUMN TYPE / 多语句 / 子查询 / 注释 / 小写绕过)
* 一律抛 {@link IllegalArgumentException}。
*
* <p><b>为何不放行 ALTER COLUMN TYPE「扩长」</b>:纯静态守卫拿不到旧列定义,无法判断新尺寸是否 ≥ 旧尺寸,
* 因此无法区分「扩长」与「缩短」——后者会截断存量数据 / 整表报错。故 TYPE 变更一律拒绝;若将来需扩长,
* 须在 {@code MetaController} 层读旧列长度/精度后断言 new ≥ old 再生成 DDL,而非放给本守卫。
*/
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 + ")?)";
private static final Pattern ADD_COLUMN = Pattern.compile(
"ALTER TABLE (" + TABLE + ") ADD COLUMN (" + COLUMN + ") " + ADD_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",
" TYPE ", // ALTER COLUMN TYPE「扩长/缩短」静态守卫无法判尺寸,一律拒(见类注释)
};
/**
* 校验并归一化一条 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()
|| DROP_NOT_NULL.matcher(s).matches()) {
return s;
}
throw new IllegalArgumentException(
"非受控的 ALTER 形态(只允许 加列 / 改可空): " + sql);
}
}

View File

@@ -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() {

View File

@@ -0,0 +1,155 @@
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"));
}
// ---------- 拒绝:ALTER COLUMN TYPE(静态守卫无法判尺寸,一律拒) ----------
@Test
@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)"));
}
// ---------- 允许:改可空 ----------
@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));
}
}

View File

@@ -72,6 +72,36 @@ public class MenuRegistrar {
return menuId;
}
/**
* P1⑥:给菜单授权角色(写 sys_role_menu)。发布后若不授权,非超管(无 sys_role_menu 行)看不见新功能。
*
* <p><b>幂等实现</b>:{@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(不写库)
*/
public int grantToRoles(String menuId, List<String> 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) SELECT ?, ?"
+ " WHERE NOT EXISTS (SELECT 1 FROM sys_role_menu WHERE TRIM(roleid)=? AND TRIM(menuid)=?)",
roleId.trim(), mid, roleId.trim(), mid);
}
return granted;
}
private ParentMenu ensureNewFeatureParent() {
List<String> existingDir = jdbcTemplate.queryForList(
"SELECT TRIM(sys_menu_id) FROM sys_menu WHERE name='" + NEW_FEATURE_DIR

View File

@@ -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<String> 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,

View File

@@ -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");

View File

@@ -395,6 +395,20 @@ public class DesignFeatureController {
String menuId = publishOrchestrator.registerMenu(templateId, menuName, parentMenuId, operator);
data.put("menuId", menuId);
// P1⑥:可选 roleIds 给菜单授权(写 sys_role_menu);缺省则新功能仅超管可见,返 warning。
// 只接 String 元素(滤掉 null/非字符串,避免 String.valueOf 把 null→"null" 写脏授权);
// warning 依据「是否传了 roleIds」而非「本次新增数」——否则重复发布(已授权→新增0)会误报。
List<String> roleIds = body.get("roleIds") instanceof List<?> rs
? 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 (roleIds.isEmpty()) {
data.put("menuVisibilityWarning",
"未指定 roleIds,新功能菜单仅超管可见;请到「角色菜单授权」为业务角色授权");
}
boolean generatePkg = !(Boolean.FALSE.equals(body.get("generateDeploymentPackage")));
@SuppressWarnings("unchecked")
List<String> flowsForPkg = (List<String>) data.get("flows");

View File

@@ -71,6 +71,7 @@ public class MetaController {
@Operation(summary = "创建实体:写入 SYS_ENTITY/SYS_ENTITYATTRIBUTE 元数据并动态创建物理表")
@PostMapping("/api/meta/entity")
@org.springframework.transaction.annotation.Transactional
public Map<String, Object> createEntity(@RequestBody Map<String, Object> 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<String> indexes = indexEnhancer.enhanceForNewEntity(table);
@@ -275,6 +282,100 @@ public class MetaController {
return resp;
}
@Operation(summary = "为已建实体加列(ALTER ADD COLUMN):写 SYS_ENTITYATTRIBUTE 元数据 + 受控 ALTER 物理表(只加列,恒可空)")
@PostMapping("/api/meta/entity/{table}/attributes")
@org.springframework.transaction.annotation.Transactional
public Map<String, Object> addAttributes(@PathVariable String table, @RequestBody Map<String, Object> 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<Map<String, Object>> attrs = (List<Map<String, Object>>) req.get("attributes");
if (attrs == null || attrs.isEmpty()) {
return err("attributes 为空");
}
// ── 校验全部列(不写库)── 任一不合法原子返回 err;此时尚无写入,无回滚问题。
for (Map<String, Object> 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);
}
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<String, Object> attrTpl = loadAttrTemplate(idOf(tplEnt));
List<String> added = new ArrayList<>();
for (Map<String, Object> 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);
} 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)。失败抛异常 → 事务回滚。
String alterErr = dataDicService.executeAlterSql(ddl);
if (alterErr != null) {
throw new org.springframework.web.server.ResponseStatusException(
org.springframework.http.HttpStatus.BAD_REQUEST, "加列失败[" + col + "]: " + alterErr);
}
added.add(col);
}
// 失效 POInfo + 白名单缓存,使后续读写立即拿到新列(免重启)
cacheInvalidator.evictByTable(t);
// 新外键列补索引(IF NOT EXISTS 幂等)
List<String> indexes = indexEnhancer.enhanceForNewEntity(t);
Map<String, Object> 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 +550,36 @@ 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(不可为空,否则产无效 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) {
if (value instanceof Number n && n.intValue() > 0) {
return n.intValue();

View File

@@ -177,6 +177,7 @@ public class PageSchemaController {
@PutMapping("/api/page/schema/{templateId}/overlay")
public ResponseEntity<Map<String, Object>> 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<Map<String, Object>> auditOverlay() {
requireAdmin();
List<Map<String, Object>> 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<Map<String, Object>> offenders = new java.util.ArrayList<>();
java.util.Set<String> distinct = new java.util.TreeSet<>();
for (Map<String, Object> row : rows) {
TypedPageSchemaReport report = typedSchemaValidator.validate(String.valueOf(row.get("schema_json")));
List<String> bad = report.usedComponents().stream()
.filter(c -> !componentRegistry.supportsComponent(c))
.sorted().toList();
if (!bad.isEmpty()) {
Map<String, Object> o = new LinkedHashMap<>();
o.put("templateId", String.valueOf(row.get("template_id")));
o.put("unsupportedComponents", bad);
offenders.add(o);
distinct.addAll(bad);
}
}
Map<String, Object> 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,48 @@ 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<Map<String, Object>> deleteStandard(@PathVariable String templateId) {
requireAdmin();
String operator = currentUserId();
// 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<String> menuIds = jdbcTemplate.queryForList(
"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)=? AND isactive=1",
now, operator, tpl);
// 2. 删标准层(收口 PageSchemaWriter,不裸 JDBC) + overlay
int standard = pageSchemaWriter.deleteStandard(tpl, operator);
int overlay = 0;
try {
overlay = jdbcTemplate.update("DELETE FROM sys_page_schema_overlay WHERE template_id = ?", tpl);
} 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<String, Object> 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 头)。 */

View File

@@ -59,4 +59,43 @@ class MenuRegistrarTest {
org.mockito.ArgumentMatchers.contains("UPDATE sys_menu"),
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 grantToRolesInsertsPerRoleIdempotent() {
JdbcTemplate jdbc = mock(JdbcTemplate.class);
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(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
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(), any(), any(), any(), any());
}
}

View File

@@ -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());
}
}

View File

@@ -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} 一致,且<b>每一种生成形态都能通过 {@code AlterTableSqlGuard} 白名单</b>
* (生成器只产守卫批准的 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));
}
}

View File

@@ -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

View File

@@ -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; }

View File

@@ -0,0 +1,74 @@
#!/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 "[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']")
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; }