动态低代码页面数据权限测试规格
1. 测试目标
- 验证低代码动态 CRUD 在
FOLLOW_SYSTEM 策略下复用当前登录人的系统角色数据范围。
- 验证默认
TENANT 策略保持历史兼容，只做租户隔离和逻辑删除过滤。
- 验证读写接口都由后端追加权限条件，前端只负责配置和展示。
- 验证角色数据范围新旧编码兼容，历史角色升级后不会被错误解释。
2. 基础测试数据
建议准备一张低代码业务表，至少包含以下列：
| 列名 |
用途 |
id |
主键 |
tenant_id |
租户隔离 |
create_by |
本人数据范围 |
org_id |
业务归属组织 |
create_dept |
创建部门兜底组织字段 |
region_code |
行政区划数据范围 |
parent_id |
树形父级 |
del_flag |
逻辑删除 |
低代码模型策略：
- 兼容策略：
dataScope=TENANT。
- 系统策略：
dataScope=FOLLOW_SYSTEM，字段映射为 userColumn=create_by、orgColumn=org_id、regionColumn=region_code、tenantColumn=tenant_id、logicDeleteColumn=del_flag。
3. 角色范围矩阵
| 角色数据范围 |
预期条件 |
验收点 |
1 全部 |
不追加组织、本人、区划条件 |
仍保留动态仓储的租户和逻辑删除基础过滤 |
2 本租户 |
tenant_id = 当前租户 |
可见同租户数据，不跨租户 |
3 本组织 |
org_id IN 当前用户组织 |
只看本组织数据 |
4 本组织及子组织 |
org_id IN 当前组织及所有子组织 |
子组织数据可见，兄弟组织不可见 |
5 个人 |
create_by = 当前用户 |
无自定义组织 ID 时按个人执行 |
5 自定义组织兼容 |
org_id IN sys_role_data_scope |
存在自定义组织 ID 时按旧枚举 CUSTOM 执行 |
6 本租户兼容 |
tenant_id = 当前租户 |
兼容旧后端枚举 |
7 行政区划 |
region_code = 当前区划 OR 直接下级区划 |
省级用户视为全部；市级及以下匹配本级和下级 |
4. 接口验收用例
| 场景 |
接口 |
预期 |
| 单表分页 |
GET /ai/crud/{configKey}/page |
返回结果满足当前角色数据范围 |
| Join 分页 |
GET /ai/crud/{configKey}/page，带 Join 运行时配置 |
按主表别名 t0 追加权限条件 |
| 树形查询 |
GET /ai/crud/{configKey}/tree |
只返回有权限节点，并补齐导航祖先节点 |
| 详情 |
GET /ai/crud/{configKey}/{id} |
越权 ID 返回无权限或不存在业务异常 |
| 编辑 |
PUT /ai/crud/{configKey} |
越权 ID 影响行数为 0 时返回业务异常 |
| 删除 |
DELETE /ai/crud/{configKey}/{id} |
越权 ID 不允许删除 |
| 批量删除 |
前端批量触发单条删除接口 |
任一越权记录不能静默成功 |
| 自定义查询 |
POST /ai/custom-query/{configKey}/execute |
字段白名单和动态数据权限同时生效 |
| 导出 |
POST /ai/crud/{configKey}/export |
导出结果与分页权限结果一致 |
5. 发布校验用例
| 场景 |
预期 |
FOLLOW_SYSTEM 缺少 tenantColumn |
发布失败并提示缺少租户字段映射 |
FOLLOW_SYSTEM 缺少 userColumn |
发布失败并提示缺少本人数据权限字段 |
FOLLOW_SYSTEM 缺少 orgColumn |
发布失败并提示缺少组织数据权限字段 |
| 配置字段存在于模型但真实表列不存在 |
发布失败并提示字段不存在 |
SYSTEM_DATA_SCOPE 历史值 |
保存、发布、运行时归一化为 FOLLOW_SYSTEM |
| 默认空策略 |
归一化为 TENANT，不改变历史页面行为 |
6. 树形与组织筛选用例
| 场景 |
预期 |
| 左树右表选择父级并勾选查询子级 |
查询值扩展为父级和子级集合 |
| 查询子级结果超出角色范围 |
与系统权限取交集，不扩大可见范围 |
| 补齐祖先节点 |
返回 _scopeAncestor=true、_dataScopeWritable=false |
| 操作补齐祖先节点 |
前端阻断编辑、删除、添加下级；后端写接口仍按权限条件校验 |
7. 验证命令
cd forge
JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home mvn -pl forge-admin-server -am compile -DskipTests
cd ../forge-admin-ui
source ~/.nvm/nvm.sh && nvm use v20.19.0
pnpm exec eslint src/components/ai-form/AiCrudPage.vue src/components/lowcode-builder/model/model-schema.js src/components/lowcode-builder/model/LowcodeModelDesigner.vue src/views/ai/lowcode-builder.vue src/views/ai/lowcode-models.vue
pnpm build
8. 当前验证结果
- 后端 Maven 编译通过。
- 前端定向 ESLint 通过。
- 前端 build 通过；存在既有 UnoCSS missing-icon、CSS
// 注释、动态导入提示和 chunk-size warning，不阻断产物生成。
- 接口级角色矩阵需在具备真实用户、角色、组织、区划和低代码业务数据的环境中回归。
