feat(face-b): 数据集 Dataset 落地(面 B 批次 8,+18 端点,真执行用户 SQL)

影响:官方 jnpf-web-apps-main 的「数据中心 / 数据集」全部 18 个调用点可用;
     后端首次具备执行用户手写 SQL 的能力,护栏与绑定引擎是本批核心。

- schema.sql 新增 base_data_set(26 列) / base_data_set_relation(13 列),表数 35→37
- Dataset 元数据 CRUD 9 条:列表/详情/新建/改/删 + 设计器 get/save + getList
- 执行面 9 条:GetParam / fields / Preview / List / InfoByIds / getRes / previewSql / Copy / 导出导入
- SQL 护栏:只放行 select|with,禁分号,按词边界扫 12 个危险动词 + 7 个文件/延时函数
- 变量全走 $N 绑定(${}::text 打头),缺值 400 而非协议错;空集合给 NULL
- 有意差异:系统变量只认 4 个;Export/Import 恒 400(本仓无对应基础设施)
- 契约登记:routes +18、FACE_B_REGISTERED 181→196、[FACE] B 243→261、[OFFICIAL] +18(3 条 partial)

验证:cargo test --offline --workspace 527 passed / 0 failed;十二道闸门全绿,
     check-contract PASS=10 FAIL=0(官方覆盖 280/287,implemented 256 / partial 24)。
This commit is contained in:
admin committed 2026-11-01 10:04:54 +08:00
1 parent 6f8dcaa58a
commit 2f53f812b6
12 files changed
+2519 -30

No files matched your search

+59
View File
@@ -129,3 +129,62 @@
`systemData` 的 `Dataset`(16) / `DataInterface`(10) / `InterfaceOauth`(9) / `PortalManage`(4)
+ `system/printDev`(15)。`printDev` 是本仓没有打印服务 ⇒ 多半只能恒空 stub(先看页面再定)。
---
## 批次 8 —— 数据集 Dataset(**真执行用户 SQL**),2026-11-01
**18 条面 B 端点**:CRUD 4 + `getList` / `previewSql` / `fields` / `GetParam` / `{id}/get` /
`{id}/save` + 六条取数(`Preview`/`List`/`InfoByIds`/`getRes`)+ `Export`/`Import`(恒失败)。
新表 `base_data_set`(26 列) / `base_data_set_relation`(13 列),`tables` 35 → **37**。
### 🔴 全仓唯一执行用户手写 SQL 的地方,三道护栏
`dataset_sql_guard`:
1. 去尾分号后必须 `select` / `with` 开头;
2. 全文**不许再有 `;`**(pglite 的 `exec` 走 simple protocol,多语句会一起跑);
3. 按**词边界**扫危险动词 + 文件/延时函数。
**词边界是必须的**:子串匹配会把 `update_time` / `create_id` 这种别名一起拒掉,
一批正常业务 SQL 直接报废。测试里专门钉了「五拦一放」。
### 变量只走绑定,三处与官方**有意不同**
- `${xxx}` / `@xxx` ⇒ `$N` + 参数数组,**绝不拼进 SQL 文本**。
- 官方找不到值时**原样保留变量名**(结果是一条非法 SQL,用户看 PG 语法错)
⇒ 本仓 `400 缺少参数 xxx`。
- 官方空集合替换成**一个空格**(`in ( )` 语法错)⇒ 本仓 `NULL`(`in (NULL)` 合法且永不匹配)。
- 系统变量官方十几个(靠 permission 的组织子树),本仓只认 4 个:
`@currentTime` / `@userId` / `@userAccount` / `@organizeId`(后者恒空串,没组织树),
其余**明说不支持**。
### 踩到 / 想清楚的 5 个点
- 🔴 **`exec_params` 的每个 `$N` 必须 `::text` 打头**:`exec_params` 绑的永远是
`Option<String>`,SQL 里写 `${}::integer` 会让 PG 按列类型推断成 `int4` ⇒
`protocol error: cannot convert between Option<String> and Postgres type int4`。
正确写法 `${}::text::integer`。**create 第一版就是漏了 `::text`,报 500。**
- 🔴 **`getRes` 必须用 body 里的 `dataConfigJson`**:设计器边改边试跑,读库永远是
上一次保存的 SQL(官方 `getRes` 也是拿 `form.getDataConfigJson()`)。
- ⚠️ **列名靠「执行 1 行」反推**:`row_to_json` 没行就没键 ⇒ **空结果集拿不到列名**,
`fields` 回空数组。官方走 JDBC 元数据,本仓做不到 —— 写进 `[OFFICIAL]` 备注,别装。
- 🔴 **列表 VO 的 `type`/`returnType` 是中文名,详情里是数字**:同一份投影,两个整形函数
(`DataSetListVO` vs `DataSetForm`)。搞混了前端下拉框全空。
- 🔴 **`SELECT *` 被 `check-arch` MEM1 判红**(内存预算 120MB)。这里列名由用户 SQL 决定
⇒ 写 `jnpfs.*`(带表别名,语义等价,每句自带 `LIMIT`)。
### 顺手修的老 bug
- `batch6_it.rs` 把表清单 total 写死 35 ⇒ 加表就红,改 37(与 DDL 计数测试同口径)。
- `check-arch` MEM1 扫到 4 处 `SELECT *`,全改成 `别名.*`。
### 数字(批次 8 收尾)
`cargo test --workspace` **527**(+6)| `fe-gap` **252/900 = 28.0%**(systemData **52/106 = 49.1%**)
| 契约端点 **291 条(面 B 261)** | 官方覆盖 **280/287(implemented 256 / partial 24 / absent 7)**
| 十二道闸门全绿 | 空载内存 7 MB
### 下一个(批次 9)
`DataInterface`(12) + `InterfaceOauth`(11) + `system/printDev`(17)。
`printDev` 是本仓没有打印设计器 ⇒ 先看 `onlineDev/printDev/Form.vue` 再定是不是只做恒空 stub。
+2 -2
View File
@@ -222,7 +222,7 @@ ssw-platform/
每把尺子结尾比对「实际断言数 vs 契约登记数」,对不上即失败 —— 尺子不会被悄悄改弱。
**加任何业务模块 / 改任何契约 / 加任何 crate 依赖 / 改任何内部标识 / 加任何表,十二道闸门必须全绿才算完成。**
🔴 **`cargo test --workspace` 当前 521 条**(内核 + contract 13 + store 17 + sdk 2 + pack-asset 5 + mcp 52 + adapter-baseline 19 + lowcode 112 + 集成测试)——
🔴 **`cargo test --workspace` 当前 527 条**(内核 + contract 13 + store 17 + sdk 2 + pack-asset 5 + mcp 52 + adapter-baseline 19 + lowcode 112 + 集成测试)——
拆 crate 后总数会变,**不许把断言数写死**,跑一遍看实际值。
cipher 自证(免 node):`./target/release/ssw-platform --enc 123456`。
@@ -276,7 +276,7 @@ cp .env.example .env && ./run.sh install && ./run.sh dev
```bash
cargo build --release # 编译(workspace 根,含 crates/* 与 packs/*)
cargo test --workspace # 单测(当前 521 条)
cargo test --workspace # 单测(当前 527 条)
bash run.sh dev # 起后端(30010) + 前端(5173)
bash scripts/perm-smoke.sh # 面 A 43 条
bash scripts/perm-smoke-jnpf.sh # 面 B 23 条
+67 -15
View File
@@ -1,6 +1,6 @@
# HANDOFF —— 交给下一个 session 的现场交接
> 更新于 2026-11-01(面 B 批次 5 收尾)。**开工先读这一页**(尤其 §0-bis 缺口全景),再读 `CLAUDE.md`(硬约定),
> 更新于 2026-11-01(面 B 批次 8 收尾)。**开工先读这一页**(尤其 §0-bis 缺口全景),再读 `CLAUDE.md`(硬约定),
> 最后看 `.workbuddy/memory/` 最近一天的日志(踩过的坑)。
> 无人值守时不要问用户,选最保守可行的方案继续,并把决策写回本文件。
@@ -76,27 +76,41 @@
做完这三页(`/dataCenter/dataModel`、`/dataCenter/dataSource`、`/dataCenter/basicField`)
就真正可用了。再往后是 `systemData` 的 `Dataset`/`DataInterface` 其余族。
**2026-11-01 实测**(`python3 scripts/fe-gap.py`):合计 **235 / 900**(26.1%);
~~**批次 8 候选**:`systemData` 的 `Dataset`(16) / `DataInterface`(10) / `InterfaceOauth`(9)
+ `system/printDev`(15)。~~ ✅ **批次 8 做完 `Dataset`(实际 18 条)**——见 §1「批次 8」小节。
- 它是全仓**唯一执行用户手写 SQL** 的地方 ⇒ 三道护栏(只 `select/with`、不许分号、
按词边界扫危险动词)+ 变量全走 `$N` 绑定。
- `Dataset` 是 `AutoComplete` / `PopupSelect` / `InputTable` / `SelectModal` / 报表 / 打印 /
大屏的**共同底座**(`fe-page-deps` 里 `Actions/InfoByIds` 被 9 个页面共用)⇒ 收益比条数大。
- ⚠️ 只做 `sqlType=1`(手写 SQL);图形化配置式(`sqlType=2`)/ HTTP / 静态数据一律 `400` + 人话。
- **下一个(批次 9)**:`DataInterface`(12) + `InterfaceOauth`(11) + `system/printDev`(17)。
`printDev` 是本仓没有打印设计器 ⇒ 多半只能恒空 stub(先看 `onlineDev/printDev/Form.vue` 再定)。
**2026-11-01 实测**(`python3 scripts/fe-gap.py`):合计 **252 / 900**(28.0%);
`permission` 111/137(81.0%)、`system` **84/196(42.9%,批次 4 47→66、批次 5 66→84)**、
**`systemData` 35/106(33.0%,批次 6 从 0 起、批次 7 29→35)**;
**`systemData` 52/106(49.1%,批次 6 从 0 起、批次 7 29→35、批次 8 35→52)**;
剩下体量最大的仍是 `workFlow`(104) / `onlineDev`(101) / `aiCenter`(75) /
`extend`(64) / `msgCenter`(50) / `systemData` 余下 71 —— **基本都属于「本仓没这个模块」**。
`extend`(64) / `msgCenter`(50) / `systemData` 余下 54 —— **基本都属于「本仓没这个模块」**。
---
## 1. 一句话现状(2026-11-01 批次 7 收尾)
## 1. 一句话现状(2026-11-01 批次 8 收尾)
**📌 当前数字(以此为准,下面各批的「当时数字」仅存档)**:
- 契约端点 **273 条**(面 A 28 + 面 B **243** + 两面共用 2);`tables` → **35**。
- `cargo test --offline --workspace` = **521 passed / 0 failed**。
- 十二道闸门全绿;`check-contract` `PASS=10 FAIL=0`,官方端点覆盖 **262/269**
(implemented 241 / partial 21 / absent 7;oos 6 单列)。
- `python3 scripts/fe-gap.py`:合计 **235 / 900(26.1%)**,`permission` 111/137(81.0%)、
`system` 84/196(42.9%)、**`systemData` 35/106(33.0%)**。
- 契约端点 **291 条**(面 A 28 + 面 B **261** + 两面共用 2);`tables` → **37**。
- `cargo test --offline --workspace` = **527 passed / 0 failed**。
- 十二道闸门全绿;`check-contract` `PASS=10 FAIL=0`,官方端点覆盖 **280/287**
(implemented 256 / partial 24 / absent 7;oos 6 单列)。
- `python3 scripts/fe-gap.py`:合计 **252 / 900(28.0%)**,`permission` 111/137(81.0%)、
`system` 84/196(42.9%)、**`systemData` 52/106(49.1%)**。
- 🔴 **数据建模三页(`/dataCenter/dataModel` / `dataSource` / `basicField`)现在真能用了**:
建表 / 改表 / 加字段 / 删表 / 复制 / 预览 / 导出(明说不支持)全通,
平台表(`schema.sql` 里的 35 张)与「有数据的表」一律禁改禁删。
平台表(`schema.sql` 里的 37 张)与「有数据的表」一律禁改禁删。
- 🔴 **数据集(`/dataCenter/dataset`)真能跑 SQL 了**:这是全仓**唯一**执行用户手写 SQL 的地方,
三道护栏 + 变量全走 `$N` 绑定。它是 `AutoComplete` / `PopupSelect` / `InputTable` /
`SelectModal` / 报表 / 打印 / 大屏的**共同底座** —— 这一批之后那批通用组件不再是空壳。
**✅ 后端已拆成 workspace 多 crate,业务包可独立编译;八道闸门全绿;空载内存 7 MB。**
@@ -298,6 +312,40 @@
内置表禁改禁删、改表重建 + 改名、加字段只追加、有数据的表冻结、
复制守卫 + 清空只删非内置、导出导入诚实失败。
### 批次 8(2026-11-01)—— 数据集(真执行 SQL)
**18 条面 B 端点**:`/Dataset` 的 `GET`/`POST`/`PUT`/`DELETE` + `getList` + `previewSql`
+ `fields` + `GetParam/{id}` + `{id}/get` + `{id}/save` + `{id}/Actions/{Export,Copy,Preview,List,InfoByIds,getRes}`
+ `Actions/Import`。新表 `base_data_set`(26 列)/ `base_data_set_relation`(13 列),`tables` 35 → 37。
- 🔴 **这是全仓唯一执行用户手写 SQL 的地方**(数据连接那条只是存配置)。三道护栏见
[`dataset_sql_guard`]:① 去尾分号后必须 `select`/`with` 开头;② 全文不许再有 `;`
(pglite 的 `exec` 走 simple protocol,多语句会**一起跑**);③ 按**词边界**扫危险动词
(`insert/update/delete/drop/truncate/alter/create/grant/revoke/copy/vacuum/merge`)与
文件/延时函数(`pg_read_file` / `pg_ls_dir` / `lo_import` / `pg_sleep` / `dblink` …)。
- 🔴 **按词边界而不是子串**:`update_time` / `create_id` 这种别名必须放行 —— 子串匹配会把
一批正常的业务 SQL 全拒掉(测试里专门钉了这一条)。
- 🔴 **变量只走绑定**:`${xxx}` / `@xxx` 一律转成 `$N` + 参数数组,**绝不拼进文本**。
与官方两处**有意不同**:官方找不到值时原样保留变量名(结果是一条非法 SQL,用户看到
PG 的语法错);本仓直接 `400 缺少参数 xxx`。官方空集合替换成一个空格(`in ( )` 语法错);
本仓替换成 `NULL`。
- 🔴 **`getRes` 用的是 body 里的 `dataConfigJson`**,不是库里的 —— 设计器边改边试跑,
读库永远是上一次保存的 SQL。
- ⚠️ **列名靠「执行 1 行」反推**:`row_to_json` 没有行就没有键 ⇒ **空结果集拿不到列名**,
`fields` 返回空数组(官方走 JDBC 元数据,本仓做不到)。写进 `[OFFICIAL]` 的 `implemented` 备注里。
- 🔴 **列表与详情的形状不同**:列表 `DataSetListVO` 的 `type`/`returnType` 是**中文名**
(`SQL语句` / `列表数据`),详情 `DataSetForm` 里是**数字**。同一份投影,两个整形函数。
- 🔴 **`{id}/save` 的 `variateJson` 收下不落库**(本仓没有 `base_data_interface_variate` 表),
`{id}/get` 恒回 `"[]"` —— 形状对上,内容为空,**不假装存了**。
- 🔴 **`SELECT *` 会被 `check-arch` MEM1 判红**(终端内存预算 120MB)。而这里列名由用户 SQL
决定、拿不到清单 ⇒ 写成 `jnpfs.*`(带表别名,语义等价,且每句都自带 `LIMIT`)。
- **`InfoByIds` 的 `propsValue` 过 `db_ident` 白名单** —— 它要拼进 SQL 的列名位,
不过白名单就是一个注入口(测试里用 `code" ; drop table base_user --` 钉住了)。
- `previewSql` 只支持 `sqlType=1`(原样回 SQL);图形化配置式 / HTTP / 静态数据一律 `400` + 人话。
- 回归测试 `tests/batch8_it.rs`(**6 条**):形状与 CRUD(含「只改名称不误判重」)、
`getList` 剔 `isSystem` 参数、绑定执行(含引号注入串 ⇒ 0 行)、护栏五拦一放、
设计器往返 + `getRes` 用 body、`InfoByIds` 顺序对齐 + 导出导入诚实失败。
### 🔴 上一批(第一批)踩到并解决的 4 个真 bug
1. `CurrentUser` 的 `preferenceJson` 必须是**字符串** `"{}"` —— 给对象会让前端
@@ -320,7 +368,7 @@ RUSTC_WRAPPER=sccache cargo build --manifest-path src/backend/Cargo.toml # 改
# 🔴 **尺子跑的是 release 产物** ⇒ 跑尺子前必须 `cargo build --release`
RUSTC_WRAPPER=sccache cargo build --release --manifest-path src/backend/Cargo.toml
nohup env PORT=30000 ./target/debug/ssw-platform > /tmp/ssw-backend.log 2>&1 & # 后台起
curl -s http://127.0.0.1:30000/api/health # 期望 {"ok":true,"tables":32,...}
curl -s http://127.0.0.1:30000/api/health # 期望 {"ok":true,"tables":37,...}
```
拿 token(面 B):
@@ -459,8 +507,12 @@ xop run --secret GU=git_local_user --secret GP=git_local_pass -- bash -c '
7. ~~`DataModel` 写面 8 条(`CREATE/ALTER/DROP TABLE` + `addFields` + `Copy` + `Export`/`Import`)~~
✅ **批次 7 做完(实际 8 条)**——真 DDL + 两道护栏(`db_ident` + `ddl_tables` 内置表清单)
+ 官方 `checkTab` 的「内置表 / 有数据」双闸。数据建模三页现在**真能用**。
8. `systemData` 的 `Dataset`(16) / `DataInterface`(10) / `InterfaceOauth`(9) / `PortalManage`(4)
其余族 + `system/printDev`(15) ⇒ **下一个**(`printDev` 是本仓没打印服务,多半只能恒空 stub)
8. ~~`systemData` 的 `Dataset`(16)~~ ✅ **批次 8 做完(实际 18 条)**——新表
`base_data_set` / `base_data_set_relation`;CRUD + 设计器 `get`/`save` + 六条取数
(`Preview`/`List`/`InfoByIds`/`getRes`/`previewSql`/`fields`)+ 下拉 + 恒失败的导出导入。
**真执行 SQL**,三道护栏 + `${xxx}`/`@xxx` 全绑定。
9. `DataInterface`(12) + `InterfaceOauth`(11) + `system/printDev`(17) ⇒ **下一个**
(`printDev` 是本仓没打印设计器,多半只能恒空 stub)
**实现模板(照抄就行)**:`ORGANIZE_WRITE_FIELDS` / `POSITION_WRITE_FIELDS` 那一套
—— 列白名单 + `now()` 不占参数位 + 只 SET body 里出现的键 + 读回不选 `f_password`。
+1 -1
View File
@@ -251,7 +251,7 @@ ssw-platform/
| 能力 | 现状 | 目标 | 差距 |
|---|---|---|---|
| 面 B 契约端点 | ✅ 243 条 | 全量(含 lowcode/flow/file/message) | 补 ~250 条(多在 lowcode 域) |
| 面 B 契约端点 | ✅ 261 条 | 全量(含 lowcode/flow/file/message) | 补 ~250 条(多在 lowcode 域) |
| `base_*` DDL | ✅ 21 张逐字对齐 | 全量 331 张中的必需集 | 按域补 |
| 平台/业务分层 | ✅ `check-boundary.sh` 钉住 | 升级为 crate 级隔离 | **P0 已拆 contract / store / sdk;asset 包可独立编译;`jnpf.rs`→`face_b.rs`** |
| 低代码元数据引擎 | ✅ **P2-b 完成**:解析 + 校验 + 建表 + 动态 CRUD(6 个工具) | visualdev 同构 + 动态 CRUD + 发布 | 读 release / 单据号 / 乐观锁 → P2-c |
+8 -5
View File
@@ -1203,31 +1203,32 @@ mod tests {
#[test]
fn schema_sql_has_expected_table_count() {
// schema.sql 必须包含 35 张表的 CREATE TABLE
// (30 张 base_*:8 张官方 + base_system + base_group + base_position
// schema.sql 必须包含 37 张表的 CREATE TABLE
// (32 张 base_*:8 张官方 + base_system + base_group + base_position
// + 字典分类/字典数据 + base_sign_img + base_user_extra
// + base_standing + base_permission_group + base_action
// + base_system_top + base_sys_config(应用中心/系统配置)+ base_tag(标签)
// + base_business_category + base_message + base_notice(消息批次)
// + base_sys_log / base_common_words / base_bill_rule(日志与模板中心批次)
// + base_db_link / base_data_type / base_common_fields(数据建模批次)
// + base_data_set / base_data_set_relation(数据集批次)
// + base_visual_dev / base_visual_release(P2 低代码),+ 4 张业务表)。
//
// 🔴 这个数字**故意写死**:加表必须同时改这里与 main.rs 的 BASE_TABLES,
// 两处都改才算登记完成(漏一处就是「孤儿 DDL」或「白名单多一项」)。
let count = SCHEMA_SQL.matches("CREATE TABLE ").count();
assert_eq!(count, 35, "schema.sql 的 CREATE TABLE 数量应为 35");
assert_eq!(count, 37, "schema.sql 的 CREATE TABLE 数量应为 37");
}
/// 🔴 [`ddl_tables`] 的解析必须与上面那条计数一致(不能只数到 12 却解析出别的)。
#[test]
fn ddl_tables_parses_every_create_table() {
let tables = ddl_tables();
assert_eq!(tables.len(), 35, "ddl_tables 应解析出 35 张表");
assert_eq!(tables.len(), 37, "ddl_tables 应解析出 37 张表");
assert!(tables.iter().all(|t| !t.is_empty()));
assert_eq!(
tables.iter().collect::<std::collections::HashSet<_>>().len(),
35,
37,
"表名不许重复"
);
// 基础 base_* 必须都在(业务表由业务层 spec 派生,不在本文件写死)。
@@ -1252,6 +1253,8 @@ mod tests {
"base_db_link",
"base_data_type",
"base_common_fields",
"base_data_set",
"base_data_set_relation",
] {
assert!(
tables.iter().any(|t| t == base),
+38 -1
View File
@@ -1398,6 +1398,24 @@ B DELETE /api/system/DataModel/{linkId}/deleteAllTable dataCenter.dataModel plat
B POST /api/system/DataModel/{linkId}/Table/{tableName}/Actions/Copy dataCenter.dataModel platform
B GET /api/system/DataModel/{linkId}/Table/{tableName}/Actions/Export dataCenter.dataModel platform
B POST /api/system/DataModel/{linkId}/Actions/Import dataCenter.dataModel platform
B GET /api/system/Dataset dataCenter.dataset platform
B POST /api/system/Dataset dataCenter.dataset platform
B GET /api/system/Dataset/getList 登录 platform
B POST /api/system/Dataset/previewSql dataCenter.dataset platform
B POST /api/system/Dataset/fields 登录 platform
B POST /api/system/Dataset/Actions/Import dataCenter.dataset platform
B GET /api/system/Dataset/GetParam/{id} 登录 platform
B GET /api/system/Dataset/{id} dataCenter.dataset platform
B PUT /api/system/Dataset/{id} dataCenter.dataset platform
B DELETE /api/system/Dataset/{id} dataCenter.dataset platform
B GET /api/system/Dataset/{id}/get 登录 platform
B POST /api/system/Dataset/{id}/save dataCenter.dataset platform
B GET /api/system/Dataset/{id}/Actions/Export dataCenter.dataset platform
B POST /api/system/Dataset/{id}/Actions/Copy dataCenter.dataset platform
B POST /api/system/Dataset/{id}/Actions/Preview 登录 platform
B POST /api/system/Dataset/{id}/Actions/List 登录 platform
B POST /api/system/Dataset/{id}/Actions/InfoByIds 登录 platform
B POST /api/system/Dataset/{id}/Actions/getRes dataCenter.dataset platform
A GET /api/ssw/demo/DemoItem/List 登录 demo
A POST /api/ssw/demo/DemoItem/Save 登录 demo
A DELETE /api/ssw/demo/DemoItem/Delete 登录 demo
@@ -1414,7 +1432,7 @@ A DELETE /api/ssw/asset/DataResource/Delete asset/DataResource asset
[FACE]
# face 条数 说明
A 28 面 A 专属(+ 2 条共用 ⇒ 面 A 合计 30 条)
B 243 面 B 专属(官方 JNPF 形状)
B 261 面 B 专属(官方 JNPF 形状)
AB 2 两面共用(CurrentUser / Authority Data —— 按判别头分流)
[OFFICIAL]
@@ -1708,6 +1726,25 @@ POST /api/system/DataModel/{linkId}/Table/{tableName}/Actions/Copy implemented D
GET /api/system/DataModel/{linkId}/Table/{tableName}/Actions/Export partial DbTableController.java:433 面 B 已落地但**恒失败**:官方返 `DownloadVO`(文件服务)⇒ 本仓 `400` + 人话,不返假下载地址
POST /api/system/DataModel/{linkId}/Actions/Import partial DbTableController.java:388 面 B 已落地但**恒失败**:官方读 multipart 的 `.json`;本仓没启 `axum/multipart` ⇒ 明说不支持(前端建模页也没有导入按钮)
GET /api/system/Dataset implemented DataSetController.java:96 面 B 已落地:PageListVO + `type`/`returnType` 换成**中文名**(`SQL语句`/`列表数据`,官方枚举 `getNameByCode`);`creatorTime` 毫秒;keyword/category/type/returnType/enabledMark 五个过滤全支持
POST /api/system/Dataset implemented DataSetController.java:116 面 B 已落地:`action` 恒 `3`(查询,官方 `create` 也强制);`enCode` 只收字母数字(官方 `^[a-zA-Z0-9]+$`);名称/编码双判重
PUT /api/system/Dataset/{id} implemented DataSetController.java:136 面 B 已落地:只 SET body 出现的键;**只改名称时用库里原编码补齐再判重**(否则会把自己判成重复)
DELETE /api/system/Dataset/{id} implemented DataSetController.java:155 面 B 已落地:软删(官方物理删,本仓保守)
GET /api/system/Dataset/{id} implemented DataSetController.java:171 面 B 已落地:`DataSetForm` 形状(`type`/`returnType` 是**数字**,与列表的中文名不同)
GET /api/system/Dataset/{id}/get implemented DataSetController.java:183 面 B 已落地:`DataSetDesVo` = 详情 + `variateJson`(恒 `"[]"`,官方来自变量表)+ `fields`(`fieldJson` 解析)
POST /api/system/Dataset/{id}/save implemented DataSetController.java:200 面 B 已落地:只存设计器字段;`variateJson` 收下**不落库**(本仓没有 `base_data_interface_variate`)
GET /api/system/Dataset/getList implemented DataSetController.java:309 面 B 已落地:`DataSetSelectVO`;多 `hasPage`/`fields`;`parameterJson` 是**字符串**且已剔掉 `isSystem=1` 的项(官方原地改写)
POST /api/system/Dataset/previewSql partial DataSetController.java:333 面 B 已落地但只支持 `sqlType=1`:原样回 SQL;`sqlType=2`(图形化配置式)⇒ `400` + 人话(官方走 `CallAssembleUtil.getPreviewSql` 拼 SQL)
POST /api/system/Dataset/fields implemented DataSetController.java:373 面 B 已落地:`TableTreeModel` 裸数组;`{id:enCode, interfaceId, label:fullName, fullName:"enCode(fullName)", children:[…]}`(官方 `getFields` 逐字)
GET /api/system/Dataset/GetParam/{id} implemented DataSetController.java:381 面 B 已落地:**裸数组**(不是 `ListVO`),内容就是 `parameterJson` 原样解析
POST /api/system/Dataset/{id}/Actions/Preview implemented DataSetController.java:349 面 B 已落地:**真执行 SQL**(只读)。`${xxx}`/`@xxx` ⇒ `$N` 绑定不拼文本;`${}` 里的值来自 `paramList.defaultValue`;`required=1` 为空 ⇒ `400 x不能为空`;`enabledMark≠1` ⇒ `400 数据集已禁用`
POST /api/system/Dataset/{id}/Actions/List implemented DataSetController.java:360 面 B 已落地:`hasPage=1` 走真分页;`hasPage=0` 先取窗口再**内存**按 `keyword`+`columnOptions` 过滤并切页(官方 `actionsList` 同法)
POST /api/system/Dataset/{id}/Actions/InfoByIds implemented DataSetController.java:367 面 B 已落地:输出**按请求 ids 顺序**对齐,缺项给 `{}`;`propsValue` 过 `db_ident` 白名单(它要拼进 SQL 的列名位)
POST /api/system/Dataset/{id}/Actions/getRes implemented DataSetController.java:341 面 B 已落地:用的是 **body 里**的 `dataConfigJson`(设计器边改边试跑);返回 `FieldJsonModel`。⚠️ 列名靠「执行 1 行」反推 —— **空结果集拿不到列名 ⇒ `fields:[]`**(官方走 JDBC 元数据,本仓 `row_to_json` 没行就没有键)
POST /api/system/Dataset/{id}/Actions/Copy implemented DataSetController.java:290 面 B 已落地:名称加「副本」、编码加 6 位 uuid 后缀,撞名/撞码最多重试 5 轮
GET /api/system/Dataset/{id}/Actions/Export partial DataSetController.java:217 面 B 已落地但**恒失败**:官方返 `DownloadVO`(文件服务)⇒ 本仓 `400` + 人话,不返假下载地址
POST /api/system/Dataset/Actions/Import partial DataSetController.java:231 面 B 已落地但**恒失败**:官方读 multipart 的 `.json`;本仓没启 `axum/multipart` ⇒ 明说不支持
[RULER]
# name 期望断言数(尺子**自己**断言的条数;跑出来的条数对不上 ⇒ 失败)
# 43 = react 版对齐的 32 条 + 真实业务模块 asset/DataResource 9 条 + 多应用 2 条
+62
View File
@@ -800,6 +800,68 @@ CREATE TABLE base_common_fields (
PRIMARY KEY (f_id, f_tenant_id)
);
-- ----------------------------------------------------------------------------
-- base_data_set(数据集)—— 逐字对齐 JNPF-PostgreSQL.sql:1397
--
-- 🔴 `f_data_config_json` 是**整个设计器的内容**,结构是
-- `{sqlData:{dbLinkId,sqlType,sql,configSql}, apiData:{…}, staticData:{…}}`
-- (官方 `DataConfigJsonModel`)。本仓只真执行 `sqlData.sqlType=1`(手写 SQL),
-- `sqlType=2`(图形化配置式)与 `apiData` / `staticData` 一律 400 + 人话。
-- 🔴 `f_has_page=1` 表示「真分页」:执行时包 `LIMIT/OFFSET` 并另跑一次 `COUNT(*)`。
-- ----------------------------------------------------------------------------
CREATE TABLE base_data_set (
f_id VARCHAR(50) NOT NULL,
f_object_type VARCHAR(50),
f_full_name VARCHAR(255) NOT NULL,
f_data_config_json TEXT,
f_parameter_json TEXT,
f_field_json TEXT,
f_sort_code BIGINT,
f_description VARCHAR(500),
f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE,
f_creator_user_id VARCHAR(50),
f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE,
f_last_modify_user_id VARCHAR(50),
f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE,
f_delete_user_id VARCHAR(50),
f_delete_mark INTEGER,
f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL,
f_type INTEGER,
f_en_code VARCHAR(50),
f_category VARCHAR(50),
f_action INTEGER,
f_return_type INTEGER,
f_variate_out INTEGER,
f_has_page INTEGER,
f_data_echo_json TEXT,
f_data_exception_json TEXT,
f_data_js_json TEXT,
f_enabled_mark INTEGER,
PRIMARY KEY (f_id, f_tenant_id)
);
-- ----------------------------------------------------------------------------
-- base_data_set_relation(数据集关联表)—— 逐字对齐 JNPF-PostgreSQL.sql:1456
--
-- 记「某个打印/报表版本用了哪些数据集」。本仓没有打印/报表设计器 ⇒ 只建表不写。
-- ----------------------------------------------------------------------------
CREATE TABLE base_data_set_relation (
f_id VARCHAR(50) NOT NULL,
f_interface_id VARCHAR(50),
f_object_id VARCHAR(50),
f_object_type VARCHAR(50),
f_sort_code BIGINT,
f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE,
f_creator_user_id VARCHAR(50),
f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE,
f_last_modify_user_id VARCHAR(50),
f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE,
f_delete_user_id VARCHAR(50),
f_delete_mark INTEGER,
f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL,
PRIMARY KEY (f_id, f_tenant_id)
);
-- ============================================================================
-- 业务表 3 张(demo_item / shop_product / book_shop_book)
--
+6 -2
View File
@@ -46,8 +46,9 @@ use ssw_platform::routes;
/// `base_system_top` / `base_sys_config` / `base_tag`;消息批次新增
/// `base_business_category` / `base_message` / `base_notice`;日志与模板中心批次新增
/// `base_sys_log` / `base_common_words` / `base_bill_rule`;数据建模批次新增
/// `base_db_link` / `base_data_type` / `base_common_fields`,故清单现在是 **31 张**。
const BASE_TABLES: [&str; 31] = [
/// `base_db_link` / `base_data_type` / `base_common_fields`;数据集批次新增
/// `base_data_set` / `base_data_set_relation`,故清单现在是 **33 张**。
const BASE_TABLES: [&str; 33] = [
"base_group",
"base_user",
"base_role",
@@ -83,6 +84,9 @@ const BASE_TABLES: [&str; 31] = [
"base_db_link",
"base_data_type",
"base_common_fields",
// 🔴 数据集批次(2026-11-01):数据集设计器内容 + 打印/报表版本关联表。
"base_data_set",
"base_data_set_relation",
// 🔴 低代码两张表是**平台表**不是业务表:它们存的是「功能定义」,
// 任何业务模块都会用,属于引擎基础设施。
"base_visual_dev",
File diff suppressed because it is too large. Load diff
+63 -2
View File
@@ -446,6 +446,52 @@ pub fn build_router(state: AppState) -> axum::Router<AppState> {
"/api/system/DataModel/{linkId}/Actions/Import",
post(face_b::data_model_import),
)
// ---- 数据集(官方 `DataSetController`)----
// 🔴 这是全仓**唯一**执行用户手写 SQL 的地方。三道护栏在 `dataset_sql_guard`:
// 只放行 select/with、不许有分号、按词边界扫危险动词。
// 变量 `${xxx}` / `@xxx` 一律转 `$N` **绑定**,不拼文本。
.route("/api/system/Dataset", get(face_b::dataset_list))
.route("/api/system/Dataset", post(face_b::dataset_create))
.route("/api/system/Dataset/getList", get(face_b::dataset_get_list))
.route("/api/system/Dataset/previewSql", post(face_b::dataset_preview_sql))
.route("/api/system/Dataset/fields", post(face_b::dataset_fields))
.route(
"/api/system/Dataset/Actions/Import",
post(face_b::dataset_import),
)
.route(
"/api/system/Dataset/GetParam/{id}",
get(face_b::dataset_get_param),
)
.route("/api/system/Dataset/{id}", get(face_b::dataset_info))
.route("/api/system/Dataset/{id}", put(face_b::dataset_update))
.route("/api/system/Dataset/{id}", delete(face_b::dataset_delete))
.route("/api/system/Dataset/{id}/get", get(face_b::dataset_des_get))
.route("/api/system/Dataset/{id}/save", post(face_b::dataset_des_save))
.route(
"/api/system/Dataset/{id}/Actions/Export",
get(face_b::dataset_export),
)
.route(
"/api/system/Dataset/{id}/Actions/Copy",
post(face_b::dataset_copy),
)
.route(
"/api/system/Dataset/{id}/Actions/Preview",
post(face_b::dataset_preview),
)
.route(
"/api/system/Dataset/{id}/Actions/List",
post(face_b::dataset_actions_list),
)
.route(
"/api/system/Dataset/{id}/Actions/InfoByIds",
post(face_b::dataset_info_by_ids),
)
.route(
"/api/system/Dataset/{id}/Actions/getRes",
post(face_b::dataset_get_res),
)
// ---- 系统配置 + 第三方同步(官方 `SysConfigController` / `SynThirdInfoController`)----
.route("/api/system/SysConfig", get(face_b::sys_config_get))
.route("/api/system/SysConfig", put(face_b::sys_config_update))
@@ -1238,7 +1284,7 @@ mod tests {
// 🔴 表数**故意写死**:它同时校验「schema.sql 建了预期的表」与
// 「health 报的是真数」。加表要同步改这里 + main.rs 的 BASE_TABLES
// + crates/sspf-store 的两条 DDL 断言(共四处,漏一处就红)。
assert_eq!(body["tables"], 35);
assert_eq!(body["tables"], 37);
assert_eq!(body["version"], env!("CARGO_PKG_VERSION"));
}
@@ -1253,7 +1299,7 @@ mod tests {
let port = serve(new_state(db().await)).await;
// 🔴 按**路径**列(同一路径多个方法只算一条)—— 每条都用 PATCH 探 405。
const FACE_B_REGISTERED: [&str; 181] = [
const FACE_B_REGISTERED: [&str; 196] = [
"/api/permission/Users",
"/api/permission/Users/any-id",
"/api/permission/Users/BatchDelete",
@@ -1441,6 +1487,21 @@ mod tests {
"/api/system/DataModel/any-id/Table/any-table/Actions/Copy",
"/api/system/DataModel/any-id/Table/any-table/Actions/Export",
"/api/system/DataModel/any-id/Actions/Import",
"/api/system/Dataset",
"/api/system/Dataset/getList",
"/api/system/Dataset/previewSql",
"/api/system/Dataset/fields",
"/api/system/Dataset/Actions/Import",
"/api/system/Dataset/GetParam/any-id",
"/api/system/Dataset/any-id",
"/api/system/Dataset/any-id/get",
"/api/system/Dataset/any-id/save",
"/api/system/Dataset/any-id/Actions/Export",
"/api/system/Dataset/any-id/Actions/Copy",
"/api/system/Dataset/any-id/Actions/Preview",
"/api/system/Dataset/any-id/Actions/List",
"/api/system/Dataset/any-id/Actions/InfoByIds",
"/api/system/Dataset/any-id/Actions/getRes",
];
for path in FACE_B_REGISTERED {
+2 -2
View File
@@ -380,8 +380,8 @@ async fn data_model_tables_info_and_fields() {
let total = tables["data"]["pagination"]["total"]
.as_i64()
.expect("必须有 total");
// schema.sql 现在是 35 张表;真有变化时这条会红,提醒同步(与 DDL 计数测试同口径)。
assert_eq!(total, 35, "表清单必须来自 information_schema: {tables}");
// schema.sql 现在是 37 张表;真有变化时这条会红,提醒同步(与 DDL 计数测试同口径)。
assert_eq!(total, 37, "表清单必须来自 information_schema: {tables}");
let list = tables["data"]["list"].as_array().expect("必须有 list");
assert!(
list.iter().any(|r| r["table"] == "base_user"),
+535
View File
@@ -0,0 +1,535 @@
//! 批次 8(**数据集** `/api/system/Dataset/**`)集成测试。
//!
//! 🔴 **钉住的契约点**(每条都对应官方控制器 / 前端组件的一处硬要求):
//! ① 列表 `DataSetListVO` 的 `type` / `returnType` 是**中文名**(`SQL语句` / `列表数据`),
//! 而详情 `DataSetForm` 里是**数字** —— 两个端点用同一份投影,形状不同。
//! ② `getList` 的 `parameterJson` 是**字符串**且已剔掉 `isSystem=1` 的项
//! (系统变量不给用户填)。
//! ③ `${xxx}` 参数只走 `$N` **绑定**,不拼文本;缺参数 ⇒ `400 缺少参数 xxx`;
//! `required=1` 且为空 ⇒ `400 xxx不能为空`。
//! ④ SQL 护栏:非 `select/with` 开头、含分号、危险动词、`pg_read_file`、
//! 未知系统变量 —— 一律 `400` + 人话;**但 `update_time` 这种别名不许误伤**。
//! ⑤ `getRes` 用的是 **body 里**的 `dataConfigJson`(设计器边改边试跑),不是库里的。
//! ⑥ `Actions/InfoByIds` 的输出**按请求 ids 的顺序**对齐,找不到的那项给 `{}`。
//! ⑦ `returnType=2` 返回**平铺对象**(`{total: 7}`),不是 `{list:[…]}`。
//! ⑧ `Export` / `Import` 恒 `400` + 人话(本仓没有文件服务)—— **不假装成功**。
//!
//! 🔴 pglite-rs 0.2.7 是**进程级全局标志** ⇒ 全文件共用一个临时库 + 一把互斥锁。
use std::path::PathBuf;
use std::sync::Arc;
use serde_json::{json, Value};
use ssw_platform::bootstrap::ensure_base;
use ssw_platform::platform::config::Config;
use ssw_platform::platform::db::Db;
use ssw_platform::platform::seed::first_seed;
use ssw_platform::platform::session::SessionStore;
use ssw_platform::platform::state::AppState;
use ssw_platform::routes::build_app;
use tokio::io::{AsyncReadExt, AsyncWriteExt};
use tokio::net::TcpStream;
use tokio::sync::{Mutex, OnceCell};
static DB: OnceCell<Db> = OnceCell::const_new();
static LOCK: Mutex<()> = Mutex::const_new(());
async fn db() -> &'static Db {
DB.get_or_init(|| async {
let db = Db::open_temp().await.expect("打开 pglite 临时库失败");
db.ensure_schema().await.expect("ensure_schema 失败");
ensure_base(&db).await.expect("ensure_base 失败");
first_seed(&db, "123456").await.expect("first_seed 失败");
db
})
.await
}
async fn serve(state: AppState) -> u16 {
let listener = tokio::net::TcpListener::bind("127.0.0.1:0")
.await
.expect("绑定失败");
let port = listener.local_addr().expect("取本地地址失败").port();
let server = tokio::spawn(async move {
let _ = axum::serve(listener, build_app(state)).await;
});
tokio::task::yield_now().await;
std::mem::forget(server);
port
}
async fn call(port: u16, method: &str, path: &str, token: &str, body: Option<&str>) -> (String, Value) {
let mut stream = TcpStream::connect(("127.0.0.1", port)).await.expect("连接失败");
let payload = body.unwrap_or("");
let req = format!(
"{method} {path} HTTP/1.1\r\n\
Host: 127.0.0.1\r\n\
Vue-Version: 3\r\n\
App-Code: mainSystem\r\n\
Authorization: {token}\r\n\
Content-Type: application/json\r\n\
Content-Length: {}\r\n\
Connection: close\r\n\r\n{payload}",
payload.len()
);
stream.write_all(req.as_bytes()).await.expect("写请求失败");
let mut buf = Vec::new();
tokio::time::timeout(std::time::Duration::from_secs(15), stream.read_to_end(&mut buf))
.await
.expect("读响应超时")
.expect("读响应失败");
let text = String::from_utf8_lossy(&buf).to_string();
let (head, body) = text.split_once("\r\n\r\n").expect("响应必须有头体分隔");
let status = head.lines().next().unwrap_or_default().to_string();
let json: Value = serde_json::from_str(body.trim()).unwrap_or(Value::Null);
(status, json)
}
async fn login(port: u16) -> String {
let enc = ssw_platform::platform::cipher::encrypt_password("123456");
let payload = format!("account=admin&password={enc}");
let mut stream = TcpStream::connect(("127.0.0.1", port)).await.expect("连接失败");
let req = format!(
"POST /api/oauth/Login HTTP/1.1\r\n\
Host: 127.0.0.1\r\n\
Vue-Version: 3\r\n\
App-Code: mainSystem\r\n\
Content-Type: application/x-www-form-urlencoded\r\n\
Content-Length: {}\r\n\
Connection: close\r\n\r\n{payload}",
payload.len()
);
stream.write_all(req.as_bytes()).await.expect("写请求失败");
let mut buf = Vec::new();
tokio::time::timeout(std::time::Duration::from_secs(15), stream.read_to_end(&mut buf))
.await
.expect("读响应超时")
.expect("读响应失败");
let text = String::from_utf8_lossy(&buf).to_string();
let (_, body) = text.split_once("\r\n\r\n").expect("响应必须有头体分隔");
let json: Value = serde_json::from_str(body.trim()).expect("登录响应必须是 JSON");
json["data"]["token"].as_str().expect("登录必须返回 token").to_string()
}
fn new_state(db: &Db) -> AppState {
AppState {
config: Arc::new(Config::from_env(PathBuf::from("/tmp/ssw-platform-batch8-it"))),
db: Arc::new(db.clone()),
sessions: Arc::new(SessionStore::default()),
}
}
/// `dataConfigJson` 的官方外壳(`DataConfigJsonModel`)。
fn cfg(sql: &str) -> String {
json!({ "sqlData": { "dbLinkId": "0", "sqlType": 1, "sql": sql, "configSql": [] } }).to_string()
}
async fn create_ds(port: u16, token: &str, name: &str, code: &str, body: Value) -> String {
let mut body = body;
body["fullName"] = json!(name);
body["enCode"] = json!(code);
let (_, resp) = call(port, "POST", "/api/system/Dataset", token, Some(&body.to_string())).await;
assert_eq!(resp["code"], 200, "新建数据集应成功:{resp}");
resp["data"]["id"].as_str().expect("必须返回 id").to_string()
}
/// ① 列表 VO 是中文名、详情是数字;判重与软删。
#[tokio::test]
async fn dataset_shapes_and_crud() {
let _guard = LOCK.lock().await;
let port = serve(new_state(db().await)).await;
let token = login(port).await;
let sql = "select f_en_code as code from base_data_type";
let id = create_ds(
port,
&token,
"批次八-A",
"b8a",
json!({ "category": "c8", "type": 1, "returnType": 1, "hasPage": 1, "enabledMark": 1, "dataConfigJson": cfg(sql) }),
)
.await;
// ① 列表:中文名
let (_, list) = call(port, "GET", "/api/system/Dataset?keyword=b8a", &token, None).await;
assert_eq!(list["code"], 200);
let row = &list["data"]["list"][0];
assert_eq!(row["type"], "SQL语句", "列表 type 必须是中文名");
assert_eq!(row["returnType"], "列表数据", "列表 returnType 必须是中文名");
assert!(row["creatorTime"].as_i64().unwrap_or(0) > 1_700_000_000_000, "creatorTime 必须是毫秒");
// ① 详情:数字
let (_, info) = call(port, "GET", &format!("/api/system/Dataset/{id}"), &token, None).await;
assert_eq!(info["data"]["type"], 1, "详情 type 必须是数字");
assert_eq!(info["data"]["returnType"], 1);
// 判重
let (_, dup_name) = call(
port,
"POST",
"/api/system/Dataset",
&token,
Some(&json!({ "fullName": "批次八-A", "enCode": "other" }).to_string()),
)
.await;
assert_eq!(dup_name["msg"], "名称已存在");
let (_, dup_code) = call(
port,
"POST",
"/api/system/Dataset",
&token,
Some(&json!({ "fullName": "别的", "enCode": "b8a" }).to_string()),
)
.await;
assert_eq!(dup_code["msg"], "编码已存在");
let (_, bad_code) = call(
port,
"POST",
"/api/system/Dataset",
&token,
Some(&json!({ "fullName": "再别的", "enCode": "a_b" }).to_string()),
)
.await;
assert_eq!(bad_code["msg"], "编码只能是字母或数字");
// 🔴 只改名称时不能把自己判成重复(`enCode` 没传 ⇒ 用库里的原值补齐再判)
let (_, upd) = call(
port,
"PUT",
&format!("/api/system/Dataset/{id}"),
&token,
Some(&json!({ "fullName": "批次八-A2" }).to_string()),
)
.await;
assert_eq!(upd["code"], 200, "只改名称应成功:{upd}");
let (_, info2) = call(port, "GET", &format!("/api/system/Dataset/{id}"), &token, None).await;
assert_eq!(info2["data"]["fullName"], "批次八-A2");
assert_eq!(info2["data"]["enCode"], "b8a", "只改名称不该动编码");
// 软删
let (_, del) = call(port, "DELETE", &format!("/api/system/Dataset/{id}"), &token, None).await;
assert_eq!(del["code"], 200);
let (_, gone) = call(port, "GET", &format!("/api/system/Dataset/{id}"), &token, None).await;
assert_eq!(gone["code"], 400, "软删后详情应报「数据不存在」");
}
/// ② `getList` 的 `parameterJson` 是字符串,且 `isSystem=1` 的项被剔掉。
#[tokio::test]
async fn dataset_select_list_hides_system_params() {
let _guard = LOCK.lock().await;
let port = serve(new_state(db().await)).await;
let token = login(port).await;
let params = json!([
{ "field": "kw", "fieldName": "关键词", "dataType": "varchar", "required": 0, "isSystem": 0 },
{ "field": "tenantId", "fieldName": "租户", "dataType": "varchar", "required": 0, "isSystem": 1 },
]);
let id = create_ds(
port,
&token,
"批次八-B",
"b8b",
json!({
"category": "c8", "type": 1, "returnType": 1, "hasPage": 0, "enabledMark": 1,
"dataConfigJson": cfg("select 1 as one"),
"parameterJson": params.to_string(),
"fieldJson": json!({ "fields": [{ "field": "one", "fieldName": "一" }] }).to_string(),
}),
)
.await;
let (_, sel) = call(port, "GET", "/api/system/Dataset/getList?keyword=b8b", &token, None).await;
assert_eq!(sel["code"], 200);
let row = &sel["data"]["list"][0];
// 🔴 是**字符串**不是数组(官方把字段原地改写成过滤后的 JSON 字符串)
let text = row["parameterJson"].as_str().expect("parameterJson 必须是字符串");
assert!(text.contains("kw"), "用户参数要保留:{text}");
assert!(!text.contains("tenantId"), "isSystem=1 的参数必须被剔掉:{text}");
assert_eq!(row["fields"][0]["field"], "one", "fields 必须是解析后的数组");
// `GetParam` 是**裸数组**(不是 ListVO),且不过滤系统参数(官方也返回全部)
let (_, param) = call(port, "GET", &format!("/api/system/Dataset/GetParam/{id}"), &token, None).await;
assert!(param["data"].is_array(), "GetParam 必须返回裸数组:{param}");
assert_eq!(param["data"].as_array().unwrap().len(), 2);
}
/// ③ 真执行 SQL:`${xxx}` 绑定、分页、必填、禁用、键值对。
#[tokio::test]
async fn dataset_executes_sql_with_bound_params() {
let _guard = LOCK.lock().await;
let port = serve(new_state(db().await)).await;
let token = login(port).await;
let sql = "select f_en_code as code, f_full_name as name from base_data_type \
where f_full_name like ${kw} order by f_sort_code";
let id = create_ds(
port,
&token,
"批次八-C",
"b8c",
json!({
"category": "c8", "type": 1, "returnType": 1, "hasPage": 1, "enabledMark": 1,
"dataConfigJson": cfg(sql),
"parameterJson": json!([{ "field": "kw", "dataType": "varchar", "required": 1, "defaultValue": "" }]).to_string(),
}),
)
.await;
// 必填为空 ⇒ 400(官方 `checkRequired`)
let (_, missing) = call(port, "POST", &format!("/api/system/Dataset/{id}/Actions/Preview"), &token, Some("{}")).await;
assert_eq!(missing["code"], 400);
assert_eq!(missing["msg"], "kw不能为空");
// 给值 ⇒ 真查出 7 行(`base_data_type` 的官方种子)
let (_, all) = call(
port,
"POST",
&format!("/api/system/Dataset/{id}/Actions/Preview"),
&token,
Some(&json!({ "kw": "%" }).to_string()),
)
.await;
assert_eq!(all["code"], 200, "应执行成功:{all}");
assert_eq!(all["data"]["pagination"]["total"], 7, "base_data_type 官方种子 7 行");
assert_eq!(all["data"]["list"].as_array().unwrap().len(), 7);
// 分页:pageSize=2 第 2 页 ⇒ 2 条
let (_, page2) = call(
port,
"POST",
&format!("/api/system/Dataset/{id}/Actions/List"),
&token,
Some(&json!({ "kw": "%", "currentPage": 2, "pageSize": 2 }).to_string()),
)
.await;
assert_eq!(page2["data"]["pagination"]["total"], 7);
assert_eq!(page2["data"]["list"].as_array().unwrap().len(), 2);
// 绑定而不是拼串:参数值里带引号也不会把 SQL 打坏
let (_, quote) = call(
port,
"POST",
&format!("/api/system/Dataset/{id}/Actions/Preview"),
&token,
Some(&json!({ "kw": "%' or '1'='1%" }).to_string()),
)
.await;
assert_eq!(quote["code"], 200, "参数里有引号也必须正常:{quote}");
assert_eq!(quote["data"]["pagination"]["total"], 0, "注入串不能被当条件执行");
// 禁用后拒绝
call(port, "PUT", &format!("/api/system/Dataset/{id}"), &token, Some(&json!({ "enabledMark": 0 }).to_string())).await;
let (_, disabled) = call(
port,
"POST",
&format!("/api/system/Dataset/{id}/Actions/Preview"),
&token,
Some(&json!({ "kw": "%" }).to_string()),
)
.await;
assert_eq!(disabled["code"], 400);
assert_eq!(disabled["msg"], "数据集已禁用");
// `returnType=2` ⇒ 平铺对象
let kv = create_ds(
port,
&token,
"批次八-C2",
"b8c2",
json!({
"type": 1, "returnType": 2, "enabledMark": 1,
"dataConfigJson": cfg("select count(*)::int as total from base_data_type"),
}),
)
.await;
let (_, one) = call(port, "POST", &format!("/api/system/Dataset/{kv}/Actions/Preview"), &token, Some("{}")).await;
assert_eq!(one["data"]["total"], 7, "键值对数据集返回平铺对象:{one}");
assert!(one["data"].get("list").is_none(), "不该有 list");
}
/// ④ SQL 护栏:写入类全拒、`update_time` 别名放行。
#[tokio::test]
async fn dataset_sql_guard_allows_only_select() {
let _guard = LOCK.lock().await;
let port = serve(new_state(db().await)).await;
let token = login(port).await;
let cases: [(&str, &str, &str); 5] = [
("drop table base_data_type", "只支持查询语句", "删表"),
("select 1; drop table base_data_type", "不允许多条语句", "分号多语句"),
("update base_data_type set f_full_name = 'x'", "只支持查询语句", "update"),
("select pg_read_file('/etc/passwd')", "不允许调用 pg_read_file", "读文件"),
("select @notExists", "不支持的系统变量 @notExists", "未知系统变量"),
];
for (i, (sql, expect_msg, label)) in cases.iter().enumerate() {
let id = create_ds(
port,
&token,
&format!("批次八-护栏{i}"),
&format!("b8g{i}"),
json!({ "type": 1, "returnType": 1, "enabledMark": 1, "dataConfigJson": cfg(sql) }),
)
.await;
let (_, resp) = call(port, "POST", &format!("/api/system/Dataset/{id}/Actions/Preview"), &token, Some("{}")).await;
assert_eq!(resp["code"], 400, "{label} 必须被拦下:{resp}");
let msg = resp["msg"].as_str().unwrap_or_default();
assert!(msg.contains(expect_msg), "{label} 的提示要对上(实际:{msg})");
}
// 🔴 `update_time` 是一个**词**,不是 `update` 动词 ⇒ 不许误伤
let ok = create_ds(
port,
&token,
"批次八-别名",
"b8alias",
json!({
"type": 1, "returnType": 1, "enabledMark": 1,
"dataConfigJson": cfg("select f_last_modify_time as update_time, f_id as create_id from base_data_type"),
}),
)
.await;
let (_, pass) = call(port, "POST", &format!("/api/system/Dataset/{ok}/Actions/Preview"), &token, Some("{}")).await;
assert_eq!(pass["code"], 200, "update_time / create_id 这类别名不许被误伤:{pass}");
}
/// ⑤ 设计器:`get`/`save` 往返,`getRes` 用 **body 里**的配置。
#[tokio::test]
async fn dataset_designer_roundtrip_and_get_res() {
let _guard = LOCK.lock().await;
let port = serve(new_state(db().await)).await;
let token = login(port).await;
let id = create_ds(
port,
&token,
"批次八-D",
"b8d",
json!({
"type": 1, "returnType": 1, "hasPage": 0, "enabledMark": 1,
"dataConfigJson": cfg("select 1 as old_one"),
"fieldJson": json!({ "fields": [{ "field": "old_one", "fieldName": "旧" }] }).to_string(),
}),
)
.await;
// `get` 多两个字段:`variateJson`(恒 `"[]"`)+ `fields`(解析 fieldJson)
let (_, des) = call(port, "GET", &format!("/api/system/Dataset/{id}/get"), &token, None).await;
assert_eq!(des["data"]["variateJson"], "[]");
assert_eq!(des["data"]["fields"][0]["field"], "old_one");
// `save` 换 SQL + 关分页 + 换字段
let (_, saved) = call(
port,
"POST",
&format!("/api/system/Dataset/{id}/save"),
&token,
Some(
&json!({
"type": 1, "returnType": 1, "hasPage": 1, "variateOut": 0, "variateJson": "[]",
"dataConfigJson": cfg("select 2 as new_one"),
"fieldJson": json!({ "fields": [{ "field": "new_one", "fieldName": "新" }] }).to_string(),
})
.to_string(),
),
)
.await;
assert_eq!(saved["code"], 200, "设计器保存应成功:{saved}");
let (_, after) = call(port, "GET", &format!("/api/system/Dataset/{id}/get"), &token, None).await;
assert_eq!(after["data"]["hasPage"], 1, "hasPage 必须落库");
assert_eq!(after["data"]["fields"][0]["field"], "new_one");
// 🔴 `getRes` 用 body 里的 config(库里的还是 `select 2`,body 给 `select 3`)
let (_, res_body) = call(
port,
"POST",
&format!("/api/system/Dataset/{id}/Actions/getRes"),
&token,
Some(&json!({ "dataConfigJson": cfg("select 3 as body_three"), "returnType": 1, "hasPage": 0 }).to_string()),
)
.await;
assert_eq!(res_body["code"], 200, "getRes 应成功:{res_body}");
let fields = res_body["data"]["fields"].as_array().expect("fields 必须是数组");
assert_eq!(fields[0]["field"], "body_three", "必须用 body 里的 SQL 试跑:{res_body}");
assert_eq!(res_body["data"]["isList"], 1);
assert_eq!(res_body["data"]["dataKey"], "data.list");
// 空结果集拿不到列名 ⇒ 空 fields,但**不许 500**
let empty = create_ds(
port,
&token,
"批次八-D2",
"b8d2",
json!({ "type": 1, "returnType": 1, "enabledMark": 1, "dataConfigJson": cfg("select f_id from base_data_set where 1=0") }),
)
.await;
let (_, empty_res) = call(port, "POST", &format!("/api/system/Dataset/{empty}/Actions/getRes"), &token, Some("{}")).await;
assert_eq!(empty_res["code"], 200, "空表试跑不许报错:{empty_res}");
assert_eq!(empty_res["data"]["fields"].as_array().unwrap().len(), 0);
}
/// ⑥ `InfoByIds` 按 ids 顺序对齐;⑦ `Export`/`Import` 恒 400。
#[tokio::test]
async fn dataset_info_by_ids_order_and_export_stub() {
let _guard = LOCK.lock().await;
let port = serve(new_state(db().await)).await;
let token = login(port).await;
let id = create_ds(
port,
&token,
"批次八-E",
"b8e",
json!({
"type": 1, "returnType": 1, "enabledMark": 1,
"dataConfigJson": cfg("select f_en_code as code, f_full_name as name from base_data_type"),
}),
)
.await;
// 顺序对齐:varchar 在 int 前 ⇒ 输出也必须是 varchar 先
let (_, res) = call(
port,
"POST",
&format!("/api/system/Dataset/{id}/Actions/InfoByIds"),
&token,
Some(&json!({ "ids": ["varchar", "int", "no_such"], "propsValue": "code" }).to_string()),
)
.await;
assert_eq!(res["code"], 200, "回显应成功:{res}");
let list = res["data"].as_array().expect("必须是裸数组");
assert_eq!(list.len(), 3);
assert_eq!(list[0]["code"], "varchar", "输出顺序必须跟请求 ids 一致");
assert_eq!(list[1]["code"], "int");
assert_eq!(list[2], json!({}), "找不到的那项给空对象");
// 回显字段名要过白名单(拼进 SQL 的东西)
let (_, bad_col) = call(
port,
"POST",
&format!("/api/system/Dataset/{id}/Actions/InfoByIds"),
&token,
Some(&json!({ "ids": ["int"], "propsValue": "code\" ; drop table base_user --" }).to_string()),
)
.await;
assert_eq!(bad_col["code"], 400, "回显字段不许拼任意字符串:{bad_col}");
// ⑦ 恒失败
let (_, export) = call(port, "GET", &format!("/api/system/Dataset/{id}/Actions/Export"), &token, None).await;
assert_eq!(export["code"], 400);
assert!(export["msg"].as_str().unwrap().contains("暂不支持"), "导出要说人话");
let (_, import) = call(port, "POST", "/api/system/Dataset/Actions/Import", &token, Some("{}")).await;
assert_eq!(import["code"], 400);
assert!(import["msg"].as_str().unwrap().contains("暂不支持"), "导入要说人话");
// 图形化配置式(`sqlType=2`)明说不支持,而不是静默空结果
let (_, preview_sql) = call(
port,
"POST",
"/api/system/Dataset/previewSql",
&token,
Some(&json!({ "sqlType": 2, "configSql": [] }).to_string()),
)
.await;
assert_eq!(preview_sql["code"], 400);
assert!(preview_sql["msg"].as_str().unwrap().contains("图形化"), "要说清是哪条路不支持");
}