feat(compat): 批次 25 补齐官方大屏 52 条端点(blade-visual 53/53)

官方大屏设计器(jnpf-visualdata)8 个 Controller / 53 条端点,此前本仓
只有 1 条「恒失败」占位 ⇒ 真实缺口 52 条,本批全部补齐。

三源对照:官方后端源码(8 Controller)+ 官方 PostgreSQL DDL(9 张
blade_visual* 表)+ 官方前端 api(jnpf-web-datascreen-vue3/src/api/**)。

关键设计:
- 列族是 Blade 系(id / is_deleted / create_time),与本仓其它契约面的
  f_ 列族不同 ⇒ 不复用 compat::res 引擎,另建 BRes 专用层;DDL 逐字照官方。
- 分页用官方 VisualPageVO(records/current/size/total/pages),不是 PageListVO;
  入参只认 size(默认 10)/ current,官方 VisualPaginationModel 没有
  pageSize / currentPage。
- 官方形状不统一照抄:category/list、visual/category、db/db-list、
  map/lazy-list 返裸数组;visual/copy 返裸 id;visual/Selector 是两级树。
- 删除走 query 的 ids(逗号分隔);软删只对 3 张有 is_deleted 的表,
  其余 6 张官方是物理删。
- 需要外部通道的(外部库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 /
  导入导出 / 地图数据源)⇒ 明确业务失败,绝不返假连接成功 / 假 geojson。

新增:platform/compat/visualdata.rs、tests/visualdata_it.rs(11 条)、
scripts/official-visualdata-sources.json(53 条出处)、db/schema.sql 追加
9 张表、sspf_store::db::VISUALDATA_TABLES。

验证:cargo test --workspace 695 passed / 0 failed;verify --smoke 14 步
全绿;check-contract PASS=10(契约 1040 条,官方台账覆盖 1026/1031);
check-citations PASS=4(1264 条引文)。
This commit is contained in:
admin committed 2026-11-03 10:56:03 +08:00
1 parent 6956af5f34
commit 11fd85f8a0
14 files changed
+3612 -19

No files matched your search

+20
View File
@@ -28,3 +28,23 @@
- **诚实失败(6 类)**:扫码票据 / OAuth provider / 地图服务 / 账号注销规则 / SaaS 邀请 ⇒ 一律 400 + 人话,不返假 URL / 假坐标 / 假成功。
- **数字**:契约 988 条(面 B 958,+40);官方台账 974/979(772/202/5);test **684 passed / 0 failed**(基线 673+11);verify --smoke 14 步全绿;check-contract PASS=10;check-citations PASS=4(1202 条引文)。
- **文档**:`docs/known-limitations.md` §J(9 条降级/口径说明);`HANDOFF.md` §0-0-quater。
### 10:00–11:20 批次 25:官方大屏(`jnpf-visualdata` / blade-visual)52 条端点
- **触发**:用户「大屏 你也对照 数据库 前端 api 后端源码 做了吧」⇒ 大屏族必须**三源对照**:官方后端源码 + 官方 PostgreSQL DDL + 官方前端 api。
- **三源定位**:后端 `~/Desktop/workspace/jnpf/jnpf-java-boot/jnpf-visualdata/**`(**8 个 Controller**);DDL `~/Desktop/workspace/jnpf/7.0/database/PostgreSQL/JNPF-PostgreSQL.sql`(**9 张 `blade_visual*` 表**);前端 `jnpf/7.0-jnpf-web-datascreen-vue3` **只在 git-code MCP 里** ⇒ 已浅克隆到 `~/Desktop/workspace/jnpf/7.0/frontend/web/jnpf-web-datascreen-vue3`(引文闸门要能解析 `src/api/<file>.js:<行号>`)。
- **缺口**:官方 53 条,本仓原有 1 条(`visual/Selector`,且是「恒失败」占位)⇒ **真实缺口 52 条**。
- 🔴 **最关键的设计决策 —— 列族不同**:官方大屏是 **Blade 系**(`id` / `is_deleted` / `create_time`),本仓其它契约面是 **JNPF 系**(`f_id` / `f_delete_mark` / `f_creator_time`)⇒ **不能复用 `compat::res` 引擎**(那套写死 `f_` 列族)⇒ 新建 `BRes` 专用层。DDL 里**故意逐字照官方**(不改名),这样「逐列对照官方 DDL」才成立。
- 🔴 **官方形状不统一是既有事实,照抄不改**:分页族用 **`VisualPageVO`**(`{records,current,size,total,pages}`,**不是** `PageListVO`);`category/list` / `visual/category` / `db/db-list` / `map/lazy-list` 返**裸数组**;`visual/copy` 返**裸 id 字符串**;`visual/Selector` 是 `{list:[…]}` 的**两级树**(官方逻辑「分类下没有大屏就不输出该分类」照抄)。
- 🔴 **分页入参名也是官方的**:`size`(默认 **10**)/ `current`(默认 1)—— 不是 `pageSize`(20)/`currentPage`。官方 `VisualPaginationModel` **没有**后两个字段 ⇒ 本仓**只认** `size`/`current`(收了反而让「照抄官方」失真)。
- 🔴 **两处 Java 字段名 ≠ 物理列名**:MAP 的 `level` ↔ 列 `map_level`;RECORD 的 `sql` ↔ 列 `fsql`。投影时显式改名。
- 🔴 **软删只 3 张表**:`blade_visual` / `blade_visual_category` / `blade_visual_db` 有 `is_deleted`;其余 6 张官方是**物理删**。
- 🔴 **踩坑 1(真 bug)**:`INSERT has more expressions than target columns` —— `create()` 里 `cols` 写了 `id` 但 `slots` 从第 2 个值开始 ⇒ 列数比值数多 1;且 `create_time` 只 push 了 slot 没 push column。**凡是拼 `INSERT INTO t (cols) VALUES (...)` ⇒ `cols` 与 `slots` 必须同步 push**。
- 🔴 **踩坑 2(真 bug)**:`syntax error at or near "COALESCE"` —— 软删谓词写成裸表达式却被拼在 `WHERE id = $1` **后面**(漏 `AND`)⇒ PG 当关键字起始。**软删谓词要么自带 `AND`,要么放进 `conds[]` 用 `AND` 连接(二选一,别混)**。
- 🔴 **踩坑 3(真 bug)**:官方 `title` 是 **`like` 不是 `eq`**(`VisualServiceImpl.java:49`);`assetsName` / `globalName` / `name` 全同款 ⇒ 过滤必须 ILIKE + 两端 `%`。改 `page()` 的 `extra_conds` 成 `(列, 算子, 值)` 三元组。
- 🔴 **测试隔离**:所有用例共用同一个 pglite 实例(用 `LOCK` 串行)⇒ 断言 `total==0` 会被别的用例数据污染 ⇒ 用**不存在的 title 过滤**来隔离,不要依赖空库。
- 🔴 **CC6 硬约束**:handler 函数体内必须**字面**出现 `guard(&state, &headers, CONST)` 才会被推导出点权限码 ⇒ **包一层自定义函数就推不出**(判为「无」守卫)。52 个 handler 全部内联写。
- **新增**:`platform/compat/visualdata.rs`(52 handler,约 2000 行)、`tests/visualdata_it.rs`(**11 条**)、`scripts/official-visualdata-sources.json`(**53 条**出处)、`db/schema.sql` 追加 9 张表、`sspf_store::db::VISUALDATA_TABLES`(9 张,孤儿 DDL 闸门放行)。
- **诚实失败(8 类)**:外部数据库连接 / 动态 SQL / 任意 URL 转发(proxy、GetApiData)/ 文件服务(put-file、图片列表)/ 导入导出 / 地图数据源 ⇒ 一律 400 + 人话,不返假连接成功、假 geojson、假链接。
- **数字**:契约 **1040** 条(面 B 1010,+52);官方台账覆盖 **1026/1031**(implemented 815 / partial 211 / absent 5);test **695 passed / 0 failed**(基线 684+11);verify --smoke 14 步全绿(793.9s);check-contract PASS=10;check-citations PASS=4(1264 条引文)。
- **文档**:`docs/known-limitations.md` §K(9 条降级/口径);`HANDOFF.md` §0-0-quinque。
+80
View File
@@ -138,6 +138,86 @@ SMTP/IMAP、Excel 导入导出、文件上传/打包/预览 —— 一律 `400`
---
## 0-0-quinque. 2026-11-03 批次 25:**官方大屏**(blade-visual,53 条)
用户提「大屏 你也对照 数据库 前端 api 后端源码 做了吧」⇒ 补官方**大屏设计器**
(`jnpf-visualdata`)这一族。**这一族本仓此前只有 1 条占位**(`visual/Selector`,
而且是「恒失败」实现)⇒ 真实缺口 **52 条**。
🔴 **这一族必须三源对照**(用户明确要求,且三者缺一不可):
| 源 | 位置 | 作用 |
|---|---|---|
| 后端源码 | `jnpf-java-boot/jnpf-visualdata/**`(**8 个 Controller**) | 路径 / 方法 / 返回形状 |
| 数据库 | `7.0/database/PostgreSQL/JNPF-PostgreSQL.sql`(**9 张 `blade_visual*` 表**) | 列名 / 类型 / 主键 |
| 前端 api | `7.0-jnpf-web-datascreen-vue3/src/api/*.js`(**9 个文件**) | 请求形状 / 入参位置(query vs body) |
🔴 **前端仓只在 git-code MCP 里**(`jnpf/7.0-jnpf-web-datascreen-vue3`),本地没有
⇒ 已浅克隆到 `~/Desktop/workspace/jnpf/7.0/frontend/web/jnpf-web-datascreen-vue3`
(引文闸门能解析 `src/api/<file>.js:<行号>`)。`axios.js:68` 正是
`config.url = configUrl + '/visual/proxy'` —— 行号已核对。
🔴 **列族是 Blade 系,不是本仓的 JNPF 系**(**故意不改名**,好让「逐列对照官方 DDL」成立):
| | 本仓其它契约面 | 官方大屏 |
|---|---|---|
| 主键 | `f_id` | `id` |
| 软删 | `f_delete_mark` | `is_deleted`(**只有 3 张表有**) |
| 审计时间 | `f_creator_time` | `create_time` |
⇒ **不能复用 `compat::res` 通用资源引擎**(那套写死了 `f_` 列族)⇒ 新建
`BRes` 专用层(`src/backend/src/platform/compat/visualdata.rs`,约 2000 行)。
🔴 **官方形状不统一是既有事实,照抄不改**:
| 端点 | 官方返回 |
|---|---|
| `GET /visual/list` 等分页族 | **`VisualPageVO`** = `{records, current, size, total, pages}`(**不是** `PageListVO`) |
| `GET /category/list` / `GET /visual/category` / `GET /db/db-list` | **裸数组** |
| `GET /map/lazy-list` | **裸数组** |
| `GET /map/data` | **裸字符串**(官方 Java 返回类型是 `String`,不是 `ActionResult`) |
| `POST /visual/GetApiData` / `POST /visual/proxy` | **裸字符串** |
| `GET /visual/Selector` | **`ListVO`** = `{list:[…]}`(分类 → 大屏**两级树**) |
| `POST /visual/save` | `{id}` |
| `POST /visual/copy` | **裸 id 字符串** |
🔴 **分页入参名也是官方的**:`size`(默认 **10**)/ `current`(默认 1)
(`VisualPagination.java:21/24`)—— **不是**本仓常用的 `pageSize`(20) / `currentPage`。
🔴 **两处 Java 字段名 ≠ 物理列名**(投影时显式改名):
- `blade_visual_map.map_level` ⇒ VO 字段 **`level`**
- `blade_visual_record.fsql` ⇒ VO 字段 **`sql`**
🔴 **删除走 query**(`ids` 逗号分隔,**不在 body**)—— 前端 `delObj(id)` 是
`params: {ids: id}`,官方 Java 是 `@RequestParam("ids")`。
软删只对 `blade_visual` / `blade_visual_category` / `blade_visual_db` 三张表,
其余 6 张官方是**物理删**。
🔴 **新增**:`src/backend/src/platform/compat/visualdata.rs`(52 个新 handler)、
`src/backend/tests/visualdata_it.rs`(**11 条**集成测试)、
`scripts/official-visualdata-sources.json`(53 条出处台账)、
`src/backend/db/schema.sql` 追加 9 张 `blade_visual*` 表(DDL **逐字照官方**)、
`crates/sspf-store/src/db.rs` 新增 `VISUALDATA_TABLES`(9 张,孤儿 DDL 闸门自动放行)。
### 🔴 本批次踩到的三个真 bug(写完测试才暴露)
| # | 坑 | 真相 | 怎么发现的 |
|---|---|---|---|
| 1 | **`INSERT has more expressions than target columns`** | `create()` 里 `cols` 写了 `id` 但 `slots` 从第 2 个值开始 ⇒ 列数比值数多 1;另外 `create_time` 只 push 了 slot 没 push column | `visualdata_it.rs` 全线 `code=500` |
| 2 | **`syntax error at or near "COALESCE"`** | 软删谓词写成裸表达式,却被拼在 `WHERE id = $1` **后面**(没 `AND`)⇒ PG 把 `COALESCE` 当关键字起始 | `visualdata_bare_array_shapes` 报 500 |
| 3 | **官方 `title` 是 `like` 不是 `eq`** | 官方 `VisualServiceImpl.java:49` 是 `queryWrapper.lambda().like(...)`;`assetsName` / `globalName` / `name` 全部同款 ⇒ 过滤必须 ILIKE + 两端 `%` | 写「按 title 过滤命中 0 行」时发现 |
🔴 **一个口径澄清**(`paging_of` 的注释曾与代码不符,已改注释):
官方 `VisualPaginationModel` **没有** `pageSize` / `currentPage` 字段
⇒ 本仓**只认** `size` / `current`(收了别的名字反而让「照抄官方」失真)。
⇒ 复验:`cargo test --workspace` **695 passed / 0 failed**(基线 684 + 11);
`verify.sh --smoke` **14 步全绿**(793.9s);`check-contract` **PASS=10**
(契约 **1040** 条 / 官方台账覆盖 **1026/1031**,implemented 815 / partial 211 / absent 5);
`check-citations` **PASS=4**(1258 条引文全定位);`[ENDPOINT]` 面 B **1010** 条(+52)。
---
## 0. ⚠️ 修正上一版口径(很重要)
上一版说「跑 pnpm 必须 `dangerouslyDisableSandbox`」。**这条不完整**:真正拦住 fs 的是
+26 -3
View File
@@ -151,6 +151,26 @@ pub const TEAMWORK_TABLES: [&str; 3] = [
"ext_document_share",
];
/// 🔴 **大屏(blade-visual)的表**(批次 25)。
///
/// 官方 `jnpf-visualdata` 模块的 **9 张 `blade_visual*` 表**。
/// 与 [`EXTEND_TABLES`] 同性质:契约面固定装置,不是平台表、不是业务包表。
///
/// 🔴 **列族刻意与本仓不同**:官方大屏是 Blade 系(`id` / `is_deleted` / `create_time`),
/// 不是 JNPF 系的 `f_id` / `f_delete_mark` / `f_creator_time` ⇒ **逐字照抄官方 DDL**,
/// 不做改名统一(改了就没法逐列对照官方 DDL)。
pub const VISUALDATA_TABLES: [&str; 9] = [
"blade_visual",
"blade_visual_assets",
"blade_visual_category",
"blade_visual_component",
"blade_visual_config",
"blade_visual_db",
"blade_visual_glob",
"blade_visual_map",
"blade_visual_record",
];
/// `PGLITE_DIR=memory://` 的临时库标记(与 `config::TEMP_DIR_MARKER` 同值)。/// `PGLITE_DIR=memory://` 的临时库标记(与 `config::TEMP_DIR_MARKER` 同值)。
const TEMP_DIR_MARKER: &str = "memory://";
@@ -1343,11 +1363,12 @@ mod tests {
expected.extend_from_slice(&WORKFLOW_TABLES);
expected.extend_from_slice(&EXTEND_TABLES);
expected.extend_from_slice(&TEAMWORK_TABLES);
expected.extend_from_slice(&VISUALDATA_TABLES);
expected.sort();
assert_eq!(
business_names, expected,
"schema.sql 里的非平台表必须恰好是面 A 内嵌 3 + 报表元数据 2 + 流程元数据 24 \
+ extend 示例 15 + teamwork 3(业务包表住 packs/)"
+ extend 示例 16 + teamwork 3 + 大屏 9(业务包表住 packs/)"
);
// 🔴 与 main.rs 的 BASE_TABLES 对账的另一半在那边(孤儿 DDL 闸门)。
@@ -1382,14 +1403,16 @@ mod tests {
+ REPORT_TABLES.len()
+ WORKFLOW_TABLES.len()
+ EXTEND_TABLES.len()
+ TEAMWORK_TABLES.len(),
+ TEAMWORK_TABLES.len()
+ VISUALDATA_TABLES.len(),
"ddl_tables 应解析出 {} 张表({} 平台 + {} 面 A 内嵌业务 + {} 报表元数据 + {} 流程元数据)",
BASE_TABLE_COUNT
+ EMBEDDED_BUSINESS_TABLES.len()
+ REPORT_TABLES.len()
+ WORKFLOW_TABLES.len()
+ EXTEND_TABLES.len()
+ TEAMWORK_TABLES.len(),
+ TEAMWORK_TABLES.len()
+ VISUALDATA_TABLES.len(),
BASE_TABLE_COUNT,
EMBEDDED_BUSINESS_TABLES.len(),
REPORT_TABLES.len(),
+108 -3
View File
@@ -1707,7 +1707,7 @@ B POST /api/visualdev/Dashboard/Notice 登录 platform
B GET /api/visualdev/Dashboard/Email 登录 platform
B GET /api/system/atlas 登录 platform
B GET /api/system/atlas/geojson 登录 platform
B GET /api/blade-visual/visual/Selector 登录 platform
B GET /api/blade-visual/visual/Selector onlineDev.dataScreen platform
B GET /api/Report 登录 platform
B POST /api/Report 登录 platform
B GET /api/Report/Selector 登录 platform
@@ -2137,6 +2137,59 @@ B GET /api/workflow/Engine/FlowBefore/RejectList/{id} 登录 platform
B GET /api/workflow/Engine/FlowBefore/SubFlowInfo/{id} 登录 platform
B POST /api/workflow/Engine/FlowBefore/Cancel/{id} 登录 platform
B GET /api/blade-visual/visual/list onlineDev.dataScreen platform
B GET /api/blade-visual/visual/category onlineDev.dataScreen platform
B GET /api/blade-visual/visual/detail onlineDev.dataScreen platform
B POST /api/blade-visual/visual/save onlineDev.dataScreen platform
B POST /api/blade-visual/visual/update onlineDev.dataScreen platform
B POST /api/blade-visual/visual/remove onlineDev.dataScreen platform
B POST /api/blade-visual/visual/copy onlineDev.dataScreen platform
B POST /api/blade-visual/visual/put-file/{type} onlineDev.dataScreen platform
B GET /api/blade-visual/visual/{type} onlineDev.dataScreen platform
B POST /api/blade-visual/visual/{id}/Actions/ExportData onlineDev.dataScreen platform
B POST /api/blade-visual/visual/Model/Actions/ImportData onlineDev.dataScreen platform
B POST /api/blade-visual/visual/GetApiData onlineDev.dataScreen platform
B POST /api/blade-visual/visual/proxy onlineDev.dataScreen platform
B GET /api/blade-visual/category/page onlineDev.dataScreen platform
B GET /api/blade-visual/category/list onlineDev.dataScreen platform
B GET /api/blade-visual/category/detail onlineDev.dataScreen platform
B POST /api/blade-visual/category/save onlineDev.dataScreen platform
B POST /api/blade-visual/category/update onlineDev.dataScreen platform
B POST /api/blade-visual/category/remove onlineDev.dataScreen platform
B GET /api/blade-visual/assets/list onlineDev.dataScreen platform
B GET /api/blade-visual/assets/detail onlineDev.dataScreen platform
B POST /api/blade-visual/assets/save onlineDev.dataScreen platform
B POST /api/blade-visual/assets/update onlineDev.dataScreen platform
B POST /api/blade-visual/assets/remove onlineDev.dataScreen platform
B GET /api/blade-visual/component/list onlineDev.dataScreen platform
B GET /api/blade-visual/component/detail onlineDev.dataScreen platform
B POST /api/blade-visual/component/save onlineDev.dataScreen platform
B POST /api/blade-visual/component/update onlineDev.dataScreen platform
B POST /api/blade-visual/component/remove onlineDev.dataScreen platform
B GET /api/blade-visual/visual-global/list onlineDev.dataScreen platform
B GET /api/blade-visual/visual-global/detail onlineDev.dataScreen platform
B POST /api/blade-visual/visual-global/save onlineDev.dataScreen platform
B POST /api/blade-visual/visual-global/update onlineDev.dataScreen platform
B POST /api/blade-visual/visual-global/remove onlineDev.dataScreen platform
B GET /api/blade-visual/db/list onlineDev.dataScreen platform
B GET /api/blade-visual/db/db-list onlineDev.dataScreen platform
B GET /api/blade-visual/db/detail onlineDev.dataScreen platform
B POST /api/blade-visual/db/submit onlineDev.dataScreen platform
B POST /api/blade-visual/db/remove onlineDev.dataScreen platform
B POST /api/blade-visual/db/db-test onlineDev.dataScreen platform
B POST /api/blade-visual/db/dynamic-query onlineDev.dataScreen platform
B GET /api/blade-visual/map/lazy-list onlineDev.dataScreen platform
B GET /api/blade-visual/map/detail onlineDev.dataScreen platform
B GET /api/blade-visual/map/data onlineDev.dataScreen platform
B POST /api/blade-visual/map/save onlineDev.dataScreen platform
B POST /api/blade-visual/map/update onlineDev.dataScreen platform
B POST /api/blade-visual/map/remove onlineDev.dataScreen platform
B GET /api/blade-visual/record/list onlineDev.dataScreen platform
B GET /api/blade-visual/record/detail onlineDev.dataScreen platform
B POST /api/blade-visual/record/save onlineDev.dataScreen platform
B POST /api/blade-visual/record/update onlineDev.dataScreen platform
B POST /api/blade-visual/record/remove onlineDev.dataScreen platform
<!-- PACK:BEGIN -->
# 🔴 以下由 `scripts/pack-sync.py` 从 `packs/*` 生成 —— **不许手改**
# (下次同步会被覆盖;改包就够)
@@ -2160,7 +2213,7 @@ B DELETE /api/asset/DataResource/{id} permission.asset.dataResource asset
[FACE]
# face 条数 说明
A 28 面 A 专属(+ 2 条共用 ⇒ 面 A 合计 30 条)
B 958 面 B 专属(官方 JNPF 形状;批次 13 新增 Area 7 + Variate 7;批次 14 新增数据中心 29;批次 15 新增系统服务 39;批次 16 新增权限关系 26;批次 17 新增 onlineDev 78 + Report 23;批次 18 新增 core 22;批次 19 新增 workFlow 104;批次 20 新增 msgCenter 51(前端 50 + 动态路径别名 1);批次 21–23 新增 aiCenter 75 + extend 64 + teamwork 40 + 收尾 4;批次 24 新增官方移动端 40)
B 1010 面 B 专属(官方 JNPF 形状;批次 13 新增 Area 7 + Variate 7;批次 14 新增数据中心 29;批次 15 新增系统服务 39;批次 16 新增权限关系 26;批次 17 新增 onlineDev 78 + Report 23;批次 18 新增 core 22;批次 19 新增 workFlow 104;批次 20 新增 msgCenter 51(前端 50 + 动态路径别名 1);批次 21–23 新增 aiCenter 75 + extend 64 + teamwork 40 + 收尾 4;批次 24 新增官方移动端 40)
AB 2 两面共用(CurrentUser / Authority Data —— 按判别头分流)
[OFFICIAL]
@@ -2748,7 +2801,7 @@ POST /api/visualdev/Dashboard/Notice implemented DashboardController.java:45 面
GET /api/visualdev/Dashboard/Email implemented DashboardController.java:59 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现
GET /api/system/atlas implemented ProvinceAtlasController.java:78 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现
GET /api/system/atlas/geojson partial ProvinceAtlasController.java:121 本仓无省级行政区划 GeoJSON 数据 ⇒ **明确业务失败**
GET /api/blade-visual/visual/Selector partial VisualController.java:288 本仓无 DataV 组件库 ⇒ 恒空列表
GET /api/blade-visual/visual/Selector implemented VisualController.java:288 面 B 已落地(批次 25 大屏):官方 `ListVO`(`{list:[…]}`)**两级树** —— 分类(`blade_visual_category`)→ 大屏(`blade_visual`);官方逻辑「分类下没有大屏就不输出该分类」照抄;大屏的 `category` 字段与分类的 `categoryValue`(转 int)匹配
GET /api/Report implemented api/onlineDev/report.ts:14 面 B 已落地:官方 `/api/Report/*` 在官方是**独立部署的第三方服务**(`jnpf-java-datareport-univer`,端口 32000)⇒ 本仓把报表元数据**就地落库**(`report_template` + `report_version`,表结构照官方 DDL 逐字导入)
POST /api/Report implemented api/onlineDev/report.ts:18 面 B 已落地:官方 `/api/Report/*` 在官方是**独立部署的第三方服务**(`jnpf-java-datareport-univer`,端口 32000)⇒ 本仓把报表元数据**就地落库**(`report_template` + `report_version`,表结构照官方 DDL 逐字导入)
GET /api/Report/Selector implemented api/onlineDev/report.ts:78 面 B 已落地:官方 `/api/Report/*` 在官方是**独立部署的第三方服务**(`jnpf-java-datareport-univer`,端口 32000)⇒ 本仓把报表元数据**就地落库**(`report_template` + `report_version`,表结构照官方 DDL 逐字导入)
@@ -3168,6 +3221,58 @@ GET /api/workflow/Engine/FlowBefore/RecordList/{id} implemented api/workFlow/flo
GET /api/workflow/Engine/FlowBefore/RejectList/{id} implemented api/workFlow/flowBefore.js:197 面 B 已落地:官方**移动端**(`jnpf-app-vue3`)专用端点 —— App 菜单 / App 用户 / 版本号 / 工作日志 / 移动端首页 / 移动端日程 / 组织用户查询 …已按官方 `api/**` 的调用形状实现;工作日志真落库到官方 `ext_work_log` 表;**需要外部通道的**(OAuth provider / 地图服务 / 扫码票据 / 账号注销)⇒ **明确业务失败**,绝不返假 URL / 假状态
GET /api/workflow/Engine/FlowBefore/SubFlowInfo/{id} implemented api/workFlow/flowBefore.js:220 面 B 已落地:官方**移动端**(`jnpf-app-vue3`)专用端点 —— App 菜单 / App 用户 / 版本号 / 工作日志 / 移动端首页 / 移动端日程 / 组织用户查询 …已按官方 `api/**` 的调用形状实现;工作日志真落库到官方 `ext_work_log` 表;**需要外部通道的**(OAuth provider / 地图服务 / 扫码票据 / 账号注销)⇒ **明确业务失败**,绝不返假 URL / 假状态
POST /api/workflow/Engine/FlowBefore/Cancel/{id} partial api/workFlow/flowBefore.js:141 已落地:任务置「已驳回」+ 处理人记录置已处理 + 驳回意见留痕;官方 Flowable 引擎的**流程实例回退**未做
GET /api/blade-visual/visual/list implemented VisualController.java:118 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
GET /api/blade-visual/visual/category implemented VisualController.java:133 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
GET /api/blade-visual/visual/detail implemented VisualController.java:147 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
POST /api/blade-visual/visual/save implemented VisualController.java:164 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
POST /api/blade-visual/visual/update implemented VisualController.java:184 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
POST /api/blade-visual/visual/remove implemented VisualController.java:200 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
POST /api/blade-visual/visual/copy implemented VisualController.java:218 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
POST /api/blade-visual/visual/put-file/{type} partial VisualController.java:241 本仓**无文件服务** ⇒ 明确业务失败;绝不返假链接
GET /api/blade-visual/visual/{type} partial VisualController.java:265 本仓**无文件服务**(无对象存储)⇒ 明确业务失败;绝不返假图片 URL
POST /api/blade-visual/visual/{id}/Actions/ExportData partial VisualController.java:327 本仓**无文件导出服务** ⇒ 明确业务失败
POST /api/blade-visual/visual/Model/Actions/ImportData partial VisualController.java:348 本仓**无文件服务** ⇒ 明确业务失败
POST /api/blade-visual/visual/GetApiData partial VisualController.java:367 官方是**任意 URL 转发**(官方返回类型是裸 `String`)⇒ 本仓不做 SSRF 面 ⇒ 明确业务失败
POST /api/blade-visual/visual/proxy partial VisualController.java:404 官方是**任意 URL 转发**(前端 `axios.js:68` 把带 `headers.proxy` 的请求统一改写到这里)⇒ 本仓不做 SSRF 面 ⇒ 明确业务失败
GET /api/blade-visual/category/page implemented VisualCategoryController.java:57 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
GET /api/blade-visual/category/list implemented VisualCategoryController.java:72 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
GET /api/blade-visual/category/detail implemented VisualCategoryController.java:86 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
POST /api/blade-visual/category/save implemented VisualCategoryController.java:100 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
POST /api/blade-visual/category/update implemented VisualCategoryController.java:119 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
POST /api/blade-visual/category/remove implemented VisualCategoryController.java:141 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
GET /api/blade-visual/assets/list implemented VisualAssetsController.java:47 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
GET /api/blade-visual/assets/detail implemented VisualAssetsController.java:62 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
POST /api/blade-visual/assets/save implemented VisualAssetsController.java:77 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
POST /api/blade-visual/assets/update implemented VisualAssetsController.java:92 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
POST /api/blade-visual/assets/remove implemented VisualAssetsController.java:107 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
GET /api/blade-visual/component/list implemented VisualComponentController.java:51 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
GET /api/blade-visual/component/detail implemented VisualComponentController.java:66 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
POST /api/blade-visual/component/save implemented VisualComponentController.java:81 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
POST /api/blade-visual/component/update implemented VisualComponentController.java:96 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
POST /api/blade-visual/component/remove implemented VisualComponentController.java:111 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
GET /api/blade-visual/visual-global/list implemented VisualGlobController.java:51 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
GET /api/blade-visual/visual-global/detail implemented VisualGlobController.java:66 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
POST /api/blade-visual/visual-global/save implemented VisualGlobController.java:81 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
POST /api/blade-visual/visual-global/update implemented VisualGlobController.java:96 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
POST /api/blade-visual/visual-global/remove implemented VisualGlobController.java:111 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
GET /api/blade-visual/db/list implemented VisualDbController.java:58 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
GET /api/blade-visual/db/db-list implemented VisualDbController.java:72 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
GET /api/blade-visual/db/detail partial VisualDbController.java:86 已落地:数据源字段照官方 `VisualDbInfoVO`;**密码不回传**(官方是 AES 密文,回传也没有可用性)
POST /api/blade-visual/db/submit implemented VisualDbController.java:101 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
POST /api/blade-visual/db/remove implemented VisualDbController.java:121 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
POST /api/blade-visual/db/db-test partial VisualDbController.java:139 本仓**不连外部数据库**(无 JDBC / 无驱动)⇒ 明确业务失败;绝不返「连接成功」的假答案
POST /api/blade-visual/db/dynamic-query partial VisualDbController.java:158 本仓**不执行外部 SQL**(官方是在外部数据源上跑前端传来的 SQL)⇒ 明确业务失败
GET /api/blade-visual/map/lazy-list implemented VisualMapController.java:51 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
GET /api/blade-visual/map/detail implemented VisualMapController.java:73 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
GET /api/blade-visual/map/data partial VisualMapController.java:137 已落地:返回 `blade_visual_map.data` 原文;官方那是**地图服务**(高德/百度)拉下来的 geojson ⇒ 本仓无该通道 ⇒ 没数据时明确业务失败,绝不返假坐标
POST /api/blade-visual/map/save implemented VisualMapController.java:86 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
POST /api/blade-visual/map/update implemented VisualMapController.java:101 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
POST /api/blade-visual/map/remove implemented VisualMapController.java:119 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
GET /api/blade-visual/record/list implemented VisualRecordController.java:51 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
GET /api/blade-visual/record/detail implemented VisualRecordController.java:66 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
POST /api/blade-visual/record/save implemented VisualRecordController.java:81 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
POST /api/blade-visual/record/update implemented VisualRecordController.java:96 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
POST /api/blade-visual/record/remove implemented VisualRecordController.java:111 面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),分类 / 数据源下拉 / 地图懒加载返**裸数组**,`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功
[RULER]
# name 期望断言数(尺子**自己**断言的条数;跑出来的条数对不上 ⇒ 失败)
+19
View File
@@ -146,3 +146,22 @@
| (bg) | **常用菜单(`MenuData/getAppDataList` / `getDataList`)返回**扁平列表**,不是官方那种嵌套树 | 官方 `getAppDataList` 把 `base_module_data`(`f_module_type='App'`)与 `base_module` 求交集后转成树(`TreeDotUtils.convertListToTreeDot`)。本仓已按官方真源(`base_module_data`,**不是** `base_app_data`)取数并带 `parentId`,但**没有在服务端组树** ⇒ 移动端需自己按 `parentId` 拼。代价:前端多一步 |
| (bh) | **`WorkLog/Send` / `Receive` 存的是 user id**(官方 `WorkLogServiceImpl` 用 `UserProvider.getUser().getUserId()`),本仓**同样用 user id**;但本仓没有 `ext_work_log_share` 表 | 一开始误用 `user.account` 会导致「我发出的」永远为空 —— 已由 `mobile_it.rs` 的 `creatorUserId` 断言钉死。代价:跨系统搬运时要注意 id 语义一致 |
| (bi) | **审批驳回落库口径**:任务 `f_status=3`(`TaskStatusEnum.REJECTED`)、处理人 `f_handle_status=0`(`FlowNature.REJECT_COMPLETION`)、留痕 `f_node_status=3`(`NodeStateEnum.REJECT`) | 官方 `FlowNature` 的 `handleStatus` 语义是 **NULL=待办 / 0=拒绝 / 1=通过** ⇒ 待办查询必须判 `f_handle_status IS NULL`(用 `COALESCE(...,0)=0` 会把「已拒绝」也算进待办)。已由 `mobile_it.rs` 的 `flow_before_cancel_writes_official_status_codes` 钉死 |
## K. 官方大屏(批次 25,2026-11-03)
> 官方大屏设计器(`jnpf-visualdata`)**8 个 Controller / 53 条端点**,本批次新增 **52 条**
> (此前只有 1 条「恒失败」占位)。三源对照:官方后端源码 + 官方 PostgreSQL DDL(9 张
> `blade_visual*` 表)+ 官方前端 api(`jnpf-web-datascreen-vue3/src/api/**`)。
> 🔴 **列族是 Blade 系**(`id` / `is_deleted` / `create_time`),与本仓其它契约面的
> `f_` 列族**故意不同名** ⇒ 未复用 `compat::res` 引擎,另建 `BRes` 专用层。
| # | 限制 | 为什么接受 / 代价 |
|---|---|---|
| (bj) | **大屏「数据源连库测试」与「动态 SQL」失败**:`POST /api/blade-visual/db/db-test`、`POST /api/blade-visual/db/dynamic-query` 一律 `code=400` | 本仓没有**外部数据库连接器**(只有内嵌 pglite,且不允许任意 SQL 出口)。返「连接成功」是**假连接** ⇒ 如实失败。代价:大屏的「数据集预览」链路不可用(配置能存,不能试连) |
| (bk) | **大屏「代理 / API 转发」失败**:`POST /api/blade-visual/visual/proxy`、`POST /api/blade-visual/visual/GetApiData` 一律 `code=400` | 官方是**任意 URL 转发**(前端 `src/axios.js:68` 把带 `headers.proxy` 的请求统一改写到 `visual/proxy`)⇒ 本仓**不做 SSRF 面**。代价:大屏的「外部数据源取数」不可用(只能力取本仓内库数据) |
| (bl) | **大屏文件服务全族失败**:`POST /visual/put-file/{type}`、`GET /visual/{type}`、`POST /visual/{id}/Actions/ExportData`、`POST /visual/Model/Actions/ImportData` 一律 `code=400` | 本仓**没有对象存储 / 文件服务**,也没有 Excel / zip 导出库。返假链接(前端会直接 `<img src>`)只会 404 ⇒ 如实失败。代价:大屏的「背景图上传 / 模板导入导出」不可用 |
| (bm) | **大屏地图数据无来源时失败**:`GET /api/blade-visual/map/data` 在 `blade_visual_map.data` 为空时 `code=400` | 本仓没有高德 / 天地图 key,也没有地图服务。返假 geojson 会让 echarts `registerMap` 画出**编造的行政区边界** ⇒ 如实失败。代价:地图组件在没有真实 geojson 数据源时不可用(地图**元数据** CRUD 正常) |
| (bn) | **`GET /map/data` 的响应**在本仓是**信封**(`{code, data: "<geojson 字符串>", msg}`),官方是**裸字符串** body | 官方 Java 返回类型是 `String`(`VisualMapController.java:139`),前端 `src/echart/packages/map/index.vue:145` 取 `res.data` 直接 `registerMap` ⇒ **官方形状要求裸 body**。本仓统一走信封(其余 52 条端点也是)⇒ 官方大屏前端直接接本仓时,`map/data` 需多取一层 `data`。已由 `visualdata_it.rs` 钉死「失败时 `data` 必须是 `null` 且不含 `FeatureCollection`」 |
| (bo) | **大屏「地图懒加载」不按 `parentId` 过滤时返全量** | 官方 `VisualMapServiceImpl.getListWithColnums` 用 `parentId` 过滤 + `hasChild` 标记。本仓照抄了 `hasChildren` / `parentName`,但**根节点**(无 `parentId`)与「全部」两种语义靠前端区分。代价:一次懒加载可能拿到多于一层的节点 |
| (bp) | **大屏权限码只到 `onlineDev.dataScreen`**:官方**没挂** `@SaCheckPermission` 的端点(`assets/list`、`component/list`、`map/lazy-list`、`map/detail`)本仓也**只要求登录** | 照抄官方注解的**有无**(不是照抄语义)。代价:这些端点任何登录用户可读(大屏配置本身不是敏感数据) |
+59 -2
View File
@@ -769,7 +769,7 @@ PARTIAL_NOTES[("GET", "/api/message/Receive")] = (
# 🔴 **端点顺序**:按官方模块分组,组内按路径排 —— 与 `routes.rs` 的注册顺序对齐
# (⇒ 契约读起来与代码读起来同序 ⇒ 人工 review 不用来回跳)。
MODULE_ORDER = ["core", "online_dev", "report", "workflow", "msg_center",
"ai", "extend", "teamwork", "mobile"]
"ai", "extend", "teamwork", "mobile", "visualdata"]
# 🔴 **批次 24:官方移动端**(`jnpf/7.0-jnpf-app-vue3` 的 `api/**`)。
#
@@ -784,6 +784,23 @@ MODULE_ORDER = ["core", "online_dev", "report", "workflow", "msg_center",
_MOBILE_SOURCES = json.load(
open(os.path.join(HERE, "official-mobile-sources.json"), encoding="utf-8"))
# 🔴 **批次 25:官方大屏(blade-visual)**。
#
# 真源是官方 `jnpf-visualdata` 模块(`jnpf-java-boot/jnpf-visualdata`)的
# **8 个 Controller**,共 **53 条** method+path,全部挂在 `/api/blade-visual/*` 下。
#
# 🔴 **三源对照**(本族每条端点都对照过):
# ① 后端源码 = 这份出处台账(`VisualXxxController.java:行号`);
# ② 数据库 = 官方 DDL 的 **9 张 `blade_visual*` 表**;
# ③ 前端 api = 官方大屏设计器前端 **`jnpf-web-datascreen-vue3/src/api/*.js`**
# (9 个文件;它决定了「删除走 query」「大屏新增是 `{visual,config}` 双段」
# 等**入参位置**的细节)。
#
# 🔴 出处行号指向**官方 Java Controller 的 `@XxxMapping` 那一行**
# (逐条由脚本提取,与 `check-citations.sh` 的定位规则一致)。
_VISUALDATA_SOURCES = json.load(
open(os.path.join(HERE, "official-visualdata-sources.json"), encoding="utf-8"))
# 🔴 **批次 21–23**:AI 中心 / extend 示例 / teamwork(文件 + 日程)三族。
# 官方出处直接取官方前端 `api/<dir>/**:行号`(与 `scripts/fe-gap.py` 同一份扫描结果),
# 因为这三族在官方 Java 里分散在 `jnpf-ai-v3` / `jnpf-extend` / `jnpf-file` /
@@ -818,6 +835,13 @@ DEFAULT_NOTES = {
"已按官方 `api/**` 的调用形状实现;工作日志真落库到官方 `ext_work_log` 表;"
"**需要外部通道的**(OAuth provider / 地图服务 / 扫码票据 / 账号注销)"
"⇒ **明确业务失败**,绝不返假 URL / 假状态",
"visualdata": "面 B 已落地:官方**大屏**(`jnpf-visualdata`)8 个 Controller 的 **53 条**"
"端点,按官方 `blade_visual*` **9 张表**(DDL 逐字照官方)真落库;"
"分页用官方 `VisualPageVO`(`{records,current,size,total,pages}`),"
"分类 / 数据源下拉 / 地图懒加载返**裸数组**,"
"`visual/copy` 返**裸 id**,`visual/Selector` 是**两级树**;"
"**需要外部通道的**(外部数据库连接 / 动态 SQL / 任意 URL 转发 / "
"文件服务 / 导入导出)⇒ **明确业务失败**,绝不返假坐标 / 假连接成功",
}
@@ -937,7 +961,33 @@ PARTIAL_NOTES.update({
"引擎版本 / 节点配置未返(WorkflowListVO 的完整形状)"),
("POST", "/api/workflow/Engine/FlowBefore/Cancel/{id}"): (
"partial", "已落地:任务置「已驳回」+ 处理人记录置已处理 + 驳回意见留痕;"
"官方 Flowable 引擎的**流程实例回退**未做"),
"官方 Flowable 引擎的**流程实例回退**未做"),
# ---- 批次 25:官方大屏(blade-visual)----
("POST", "/api/blade-visual/db/db-test"): (
"partial", "本仓**不连外部数据库**(无 JDBC / 无驱动)⇒ 明确业务失败;"
"绝不返「连接成功」的假答案"),
("POST", "/api/blade-visual/db/dynamic-query"): (
"partial", "本仓**不执行外部 SQL**(官方是在外部数据源上跑前端传来的 SQL)⇒ 明确业务失败"),
("POST", "/api/blade-visual/visual/proxy"): (
"partial", "官方是**任意 URL 转发**(前端 `axios.js:68` 把带 `headers.proxy` 的请求"
"统一改写到这里)⇒ 本仓不做 SSRF 面 ⇒ 明确业务失败"),
("POST", "/api/blade-visual/visual/GetApiData"): (
"partial", "官方是**任意 URL 转发**(官方返回类型是裸 `String`)⇒ 本仓不做 SSRF 面 ⇒ 明确业务失败"),
("GET", "/api/blade-visual/visual/{type}"): (
"partial", "本仓**无文件服务**(无对象存储)⇒ 明确业务失败;绝不返假图片 URL"),
("POST", "/api/blade-visual/visual/put-file/{type}"): (
"partial", "本仓**无文件服务** ⇒ 明确业务失败;绝不返假链接"),
("POST", "/api/blade-visual/visual/{id}/Actions/ExportData"): (
"partial", "本仓**无文件导出服务** ⇒ 明确业务失败"),
("POST", "/api/blade-visual/visual/Model/Actions/ImportData"): (
"partial", "本仓**无文件服务** ⇒ 明确业务失败"),
("GET", "/api/blade-visual/map/data"): (
"partial", "已落地:返回 `blade_visual_map.data` 原文;官方那是**地图服务**"
"(高德/百度)拉下来的 geojson ⇒ 本仓无该通道 ⇒ 没数据时明确业务失败,"
"绝不返假坐标"),
("GET", "/api/blade-visual/db/detail"): (
"partial", "已落地:数据源字段照官方 `VisualDbInfoVO`;**密码不回传**"
"(官方是 AES 密文,回传也没有可用性)"),
})
@@ -952,6 +1002,13 @@ def official_entry(mod, key, path):
raise SystemExit("移动端没有官方出处可登记:%s %s" % (method, path))
status, note = PARTIAL_NOTES.get(key, ("implemented", DEFAULT_NOTES["mobile"]))
return src, status, note
if mod == "visualdata":
# 🔴 批次 25:官方出处 = 官方 `jnpf-visualdata` 的 `VisualXxxController.java:行号`。
src = _VISUALDATA_SOURCES.get("%s %s" % (method, norm_path(path)))
if not src:
raise SystemExit("大屏没有官方出处可登记:%s %s" % (method, path))
status, note = PARTIAL_NOTES.get(key, ("implemented", DEFAULT_NOTES["visualdata"]))
return src, status, note
if mod in ("ai", "extend", "teamwork"):
table = _EXT_SOURCES.get(mod) or {}
src = table.get("%s %s" % (method, norm_path(path)))
+55
View File
@@ -0,0 +1,55 @@
{
"GET /api/blade-visual/assets/detail": "VisualAssetsController.java:62",
"GET /api/blade-visual/assets/list": "VisualAssetsController.java:47",
"GET /api/blade-visual/category/detail": "VisualCategoryController.java:86",
"GET /api/blade-visual/category/list": "VisualCategoryController.java:72",
"GET /api/blade-visual/category/page": "VisualCategoryController.java:57",
"GET /api/blade-visual/component/detail": "VisualComponentController.java:66",
"GET /api/blade-visual/component/list": "VisualComponentController.java:51",
"GET /api/blade-visual/db/db-list": "VisualDbController.java:72",
"GET /api/blade-visual/db/detail": "VisualDbController.java:86",
"GET /api/blade-visual/db/list": "VisualDbController.java:58",
"GET /api/blade-visual/map/data": "VisualMapController.java:137",
"GET /api/blade-visual/map/detail": "VisualMapController.java:73",
"GET /api/blade-visual/map/lazy-list": "VisualMapController.java:51",
"GET /api/blade-visual/record/detail": "VisualRecordController.java:66",
"GET /api/blade-visual/record/list": "VisualRecordController.java:51",
"GET /api/blade-visual/visual-global/detail": "VisualGlobController.java:66",
"GET /api/blade-visual/visual-global/list": "VisualGlobController.java:51",
"GET /api/blade-visual/visual/Selector": "VisualController.java:288",
"GET /api/blade-visual/visual/category": "VisualController.java:133",
"GET /api/blade-visual/visual/detail": "VisualController.java:147",
"GET /api/blade-visual/visual/list": "VisualController.java:118",
"GET /api/blade-visual/visual/{}": "VisualController.java:265",
"POST /api/blade-visual/assets/remove": "VisualAssetsController.java:107",
"POST /api/blade-visual/assets/save": "VisualAssetsController.java:77",
"POST /api/blade-visual/assets/update": "VisualAssetsController.java:92",
"POST /api/blade-visual/category/remove": "VisualCategoryController.java:141",
"POST /api/blade-visual/category/save": "VisualCategoryController.java:100",
"POST /api/blade-visual/category/update": "VisualCategoryController.java:119",
"POST /api/blade-visual/component/remove": "VisualComponentController.java:111",
"POST /api/blade-visual/component/save": "VisualComponentController.java:81",
"POST /api/blade-visual/component/update": "VisualComponentController.java:96",
"POST /api/blade-visual/db/db-test": "VisualDbController.java:139",
"POST /api/blade-visual/db/dynamic-query": "VisualDbController.java:158",
"POST /api/blade-visual/db/remove": "VisualDbController.java:121",
"POST /api/blade-visual/db/submit": "VisualDbController.java:101",
"POST /api/blade-visual/map/remove": "VisualMapController.java:119",
"POST /api/blade-visual/map/save": "VisualMapController.java:86",
"POST /api/blade-visual/map/update": "VisualMapController.java:101",
"POST /api/blade-visual/record/remove": "VisualRecordController.java:111",
"POST /api/blade-visual/record/save": "VisualRecordController.java:81",
"POST /api/blade-visual/record/update": "VisualRecordController.java:96",
"POST /api/blade-visual/visual-global/remove": "VisualGlobController.java:111",
"POST /api/blade-visual/visual-global/save": "VisualGlobController.java:81",
"POST /api/blade-visual/visual-global/update": "VisualGlobController.java:96",
"POST /api/blade-visual/visual/GetApiData": "VisualController.java:367",
"POST /api/blade-visual/visual/Model/Actions/ImportData": "VisualController.java:348",
"POST /api/blade-visual/visual/copy": "VisualController.java:218",
"POST /api/blade-visual/visual/proxy": "VisualController.java:404",
"POST /api/blade-visual/visual/put-file/{}": "VisualController.java:241",
"POST /api/blade-visual/visual/remove": "VisualController.java:200",
"POST /api/blade-visual/visual/save": "VisualController.java:164",
"POST /api/blade-visual/visual/update": "VisualController.java:184",
"POST /api/blade-visual/visual/{}/Actions/ExportData": "VisualController.java:327"
}
+137
View File
@@ -4054,3 +4054,140 @@ CREATE TABLE ext_work_log (
f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL,
PRIMARY KEY (f_id, f_tenant_id)
);
-- ============================================================ 批次 25:大屏(blade-visual)
-- 🔴 官方 `jnpf-visualdata` 模块(`jnpf-java-boot/jnpf-visualdata`)的 **9 张 `blade_visual*` 表**。
-- 🔴 **列族与本仓不同**:官方大屏是 Blade 系(`id` / `is_deleted` / `create_time` / `f_tenant_id`),
-- **不是** JNPF 系的 `f_id` / `f_delete_mark` / `f_creator_time` ⇒ **逐字照抄官方 DDL**,
-- 不做「改名统一」(改名会让「对照官方 DDL」的校验失去意义)。
-- 官方 DDL 真源:`~/Desktop/workspace/jnpf/7.0/database/PostgreSQL/JNPF-PostgreSQL.sql`。
--
-- 🔴 **软删口径**:官方用 `is_deleted INTEGER`(`blade_visual` / `blade_visual_category` /
-- `blade_visual_db` 有这列),`blade_visual_assets` / `blade_visual_component` /
-- `blade_visual_glob` / `blade_visual_map` / `blade_visual_record` **没有** ⇒ 那些表不按软删过滤。
CREATE TABLE blade_visual (
id VARCHAR(64) NOT NULL,
title VARCHAR(255),
background_url TEXT,
category INTEGER,
password VARCHAR(255),
create_user VARCHAR(64),
create_dept VARCHAR(64),
create_time TIMESTAMP(0) WITHOUT TIME ZONE,
update_user VARCHAR(64),
update_time TIMESTAMP(0) WITHOUT TIME ZONE,
status INTEGER NOT NULL,
is_deleted INTEGER NOT NULL,
f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL,
system_id VARCHAR(50),
PRIMARY KEY (id, f_tenant_id)
);
CREATE TABLE blade_visual_assets (
id VARCHAR(64) NOT NULL,
assetsname VARCHAR(100),
assetssize VARCHAR(50),
assetstime TIMESTAMP(0) WITHOUT TIME ZONE,
assetstype VARCHAR(50),
assetsurl VARCHAR(255),
f_tenant_id VARCHAR(50) NOT NULL,
system_id VARCHAR(50),
PRIMARY KEY (id, f_tenant_id)
);
CREATE TABLE blade_visual_category (
id VARCHAR(64) NOT NULL,
category_key VARCHAR(12),
category_value VARCHAR(64),
is_deleted INTEGER DEFAULT 0 NOT NULL,
f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL,
system_id VARCHAR(50),
PRIMARY KEY (id, f_tenant_id)
);
CREATE TABLE blade_visual_component (
id VARCHAR(64) NOT NULL,
name VARCHAR(50),
content TEXT,
type INTEGER,
img VARCHAR(255),
f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL,
system_id VARCHAR(50),
PRIMARY KEY (id, f_tenant_id)
);
CREATE TABLE blade_visual_config (
id VARCHAR(64) NOT NULL,
visual_id VARCHAR(64),
detail TEXT,
component TEXT,
f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL,
PRIMARY KEY (id, f_tenant_id)
);
CREATE TABLE blade_visual_db (
id VARCHAR(64) NOT NULL,
name VARCHAR(100),
driver_class VARCHAR(100),
url VARCHAR(500),
username VARCHAR(50),
password VARCHAR(100),
remark VARCHAR(255),
create_user VARCHAR(64),
create_dept VARCHAR(64),
create_time TIMESTAMP(0) WITHOUT TIME ZONE,
update_user VARCHAR(64),
update_time TIMESTAMP(0) WITHOUT TIME ZONE,
status INTEGER,
is_deleted INTEGER,
f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL,
system_id VARCHAR(50),
PRIMARY KEY (id, f_tenant_id)
);
CREATE TABLE blade_visual_glob (
id VARCHAR(64) NOT NULL,
globalname VARCHAR(255),
globalkey VARCHAR(255),
globalvalue VARCHAR(4000),
f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL,
system_id VARCHAR(50),
PRIMARY KEY (id, f_tenant_id)
);
CREATE TABLE blade_visual_map (
id VARCHAR(64) NOT NULL,
name VARCHAR(255),
data TEXT,
code VARCHAR(20),
map_level INTEGER,
parent_id VARCHAR(64),
parent_code VARCHAR(20),
ancestors VARCHAR(255),
f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL,
PRIMARY KEY (id, f_tenant_id)
);
CREATE TABLE blade_visual_record (
id VARCHAR(64) NOT NULL,
name VARCHAR(255),
url VARCHAR(255),
datatype INTEGER,
datamethod VARCHAR(255),
dataheader VARCHAR(4000),
data VARCHAR(4000),
dataquery VARCHAR(4000),
dataquerytype VARCHAR(255),
dataformatter TEXT,
proxy INTEGER,
wsurl VARCHAR(255),
dbsql VARCHAR(255),
fsql TEXT,
result VARCHAR(255),
mqtturl VARCHAR(255),
mqttconfig TEXT,
f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL,
system_id VARCHAR(50),
PRIMARY KEY (id, f_tenant_id)
);
+7
View File
@@ -905,6 +905,12 @@ fn whitelist_self_check() -> Result<(), String> {
let extend_tables = ssw_platform::platform::db::EXTEND_TABLES;
let teamwork_tables = ssw_platform::platform::db::TEAMWORK_TABLES;
// 🔴 **大屏 blade-visual**(批次 25):官方 `jnpf-visualdata` 的 9 张
// `blade_visual*` 表(逐字照官方 DDL),既不是 `base_*` 平台表、
// 也不是业务 spec 表 ⇒ 与 `EXTEND_TABLES` / `TEAMWORK_TABLES` 同性质。
// 清单真源在 `sspf_store::db::VISUALDATA_TABLES`。
let visualdata_tables = ssw_platform::platform::db::VISUALDATA_TABLES;
for table in &ddl_tables {
if !BASE_TABLES.contains(&table.as_str())
&& !spec_tables.contains(&table.as_str())
@@ -913,6 +919,7 @@ fn whitelist_self_check() -> Result<(), String> {
&& !workflow_tables.contains(&table.as_str())
&& !extend_tables.contains(&table.as_str())
&& !teamwork_tables.contains(&table.as_str())
&& !visualdata_tables.contains(&table.as_str())
{
return Err(format!(
"schema.sql 里的表 {table} 既不是 base_* 表、也没有对应的业务 spec(孤儿 DDL?)"
+1
View File
@@ -32,3 +32,4 @@ pub mod res;
pub mod extend;
pub mod teamwork;
pub mod mobile;
pub mod visualdata;
+4 -10
View File
@@ -3023,16 +3023,10 @@ pub async fn ocr_recognize(
unsupported("OCR 识别(没有 OCR 服务)")
}
/// `GET /api/blade-visual/visual/Selector` —— DataV 可视化选择器。
pub async fn datav_selector(
State(state): State<AppState>,
headers: HeaderMap,
) -> Json<ActionResult> {
if let Err(resp) = require_login_face_b(&state, &headers).await {
return resp;
}
unsupported("DataV 可视化选择器(没有 DataV 组件库)")
}
// 🔴 **`GET /api/blade-visual/visual/Selector` 已迁到 `compat::visualdata::visual_selector`**
// (批次 25):原先这里是「没有 DataV 组件库」的恒失败实现,但官方该端点就是
// 「分类 → 大屏」两级下拉树,数据源 `blade_visual_category` + `blade_visual`
// **本仓两张表都在** ⇒ 能真实实现,不必降级。
// ================================================================ 地图(atlas)
//
File diff suppressed because it is too large. Load diff
+83 -1
View File
@@ -1542,7 +1542,89 @@ pub fn build_router(state: AppState) -> axum::Router<AppState> {
.route("/api/visualdev/Dashboard/Email", get(compat::online_dev::dashboard_email))
.route("/api/system/atlas", get(compat::online_dev::atlas_list))
.route("/api/system/atlas/geojson", get(compat::online_dev::atlas_geojson))
.route("/api/blade-visual/visual/Selector", get(compat::online_dev::datav_selector))
// ---- 大屏 blade-visual(批次 25):官方 `jnpf-visualdata` 8 个 Controller ----
//
// 🔴 **端点全集 53 条,其中 52 条本批新增**(`visual/Selector` 原先挂在
// `compat::online_dev::datav_selector`,是「没有 DataV 组件库」的恒失败实现;
// 本批**改由 `compat::visualdata::visual_selector` 真实实现** —— 官方该端点
// 就是「分类 → 大屏」两级下拉树,数据源是 `blade_visual_category` +
// `blade_visual`,本仓**两张表都在** ⇒ 能做,不必降级)。
//
// 🔴 **官方路径大小写混用,照抄不改**:`visual/Selector`(大写 S)、
// `visual/GetApiData`、`visual/Model/Actions/ImportData`、
// `visual/{id}/Actions/ExportData`。
//
// 🔴 **`matchit` 静态段优先**:`/visual/list`、`/visual/detail`、`/visual/category`、
// `/visual/Selector` 都是**静态段**,`/visual/{type}` 是**参数段**
// ⇒ 两者可共存,不会互相吃掉。
//
// 🔴 **形状**:`VisualPageVO`(`{records,current,size,total,pages}`)是官方大屏
// **专用**的分页形状,**不是**本仓常用的 `PageListVO`(`{pagination,list}`)。
// 另有三处**裸数组**(`category/list`、`visual/category`、`db/db-list`、
// `map/lazy-list`)与两处**裸字符串**(`map/data`、`visual/proxy`、
// `visual/GetApiData`)—— 全部照抄官方,见 `compat/visualdata.rs` 模块头。
//
// ---- 大屏基本信息(`VisualController`,`/api/blade-visual/visual`)----
.route("/api/blade-visual/visual/list", get(compat::visualdata::visual_list))
.route("/api/blade-visual/visual/category", get(compat::visualdata::visual_category))
.route("/api/blade-visual/visual/detail", get(compat::visualdata::visual_detail))
.route("/api/blade-visual/visual/Selector", get(compat::visualdata::visual_selector))
.route("/api/blade-visual/visual/save", post(compat::visualdata::visual_save))
.route("/api/blade-visual/visual/update", post(compat::visualdata::visual_update))
.route("/api/blade-visual/visual/remove", post(compat::visualdata::visual_remove))
.route("/api/blade-visual/visual/copy", post(compat::visualdata::visual_copy))
.route("/api/blade-visual/visual/put-file/{type}", post(compat::visualdata::visual_put_file))
.route("/api/blade-visual/visual/{type}", get(compat::visualdata::visual_files))
.route("/api/blade-visual/visual/{id}/Actions/ExportData", post(compat::visualdata::visual_export))
.route("/api/blade-visual/visual/Model/Actions/ImportData", post(compat::visualdata::visual_import))
.route("/api/blade-visual/visual/GetApiData", post(compat::visualdata::visual_get_api_data))
.route("/api/blade-visual/visual/proxy", post(compat::visualdata::visual_proxy))
// ---- 大屏分类(`VisualCategoryController`,`/api/blade-visual/category`)----
.route("/api/blade-visual/category/page", get(compat::visualdata::category_page))
.route("/api/blade-visual/category/list", get(compat::visualdata::category_list))
.route("/api/blade-visual/category/detail", get(compat::visualdata::category_detail))
.route("/api/blade-visual/category/save", post(compat::visualdata::category_save))
.route("/api/blade-visual/category/update", post(compat::visualdata::category_update))
.route("/api/blade-visual/category/remove", post(compat::visualdata::category_remove))
// ---- 静态资源(`VisualAssetsController`,`/api/blade-visual/assets`)----
.route("/api/blade-visual/assets/list", get(compat::visualdata::assets_list))
.route("/api/blade-visual/assets/detail", get(compat::visualdata::assets_detail))
.route("/api/blade-visual/assets/save", post(compat::visualdata::assets_save))
.route("/api/blade-visual/assets/update", post(compat::visualdata::assets_update))
.route("/api/blade-visual/assets/remove", post(compat::visualdata::assets_remove))
// ---- 大屏组件库(`VisualComponentController`,`/api/blade-visual/component`)----
.route("/api/blade-visual/component/list", get(compat::visualdata::component_list))
.route("/api/blade-visual/component/detail", get(compat::visualdata::component_detail))
.route("/api/blade-visual/component/save", post(compat::visualdata::component_save))
.route("/api/blade-visual/component/update", post(compat::visualdata::component_update))
.route("/api/blade-visual/component/remove", post(compat::visualdata::component_remove))
// ---- 全局变量(`VisualGlobController`,`/api/blade-visual/visual-global`)----
.route("/api/blade-visual/visual-global/list", get(compat::visualdata::glob_list))
.route("/api/blade-visual/visual-global/detail", get(compat::visualdata::glob_detail))
.route("/api/blade-visual/visual-global/save", post(compat::visualdata::glob_save))
.route("/api/blade-visual/visual-global/update", post(compat::visualdata::glob_update))
.route("/api/blade-visual/visual-global/remove", post(compat::visualdata::glob_remove))
// ---- 数据源配置(`VisualDbController`,`/api/blade-visual/db`)----
.route("/api/blade-visual/db/list", get(compat::visualdata::db_list))
.route("/api/blade-visual/db/db-list", get(compat::visualdata::db_select_list))
.route("/api/blade-visual/db/detail", get(compat::visualdata::db_detail))
.route("/api/blade-visual/db/submit", post(compat::visualdata::db_submit))
.route("/api/blade-visual/db/remove", post(compat::visualdata::db_remove))
.route("/api/blade-visual/db/db-test", post(compat::visualdata::db_test))
.route("/api/blade-visual/db/dynamic-query", post(compat::visualdata::db_dynamic_query))
// ---- 大屏地图(`VisualMapController`,`/api/blade-visual/map`)----
.route("/api/blade-visual/map/lazy-list", get(compat::visualdata::map_lazy_list))
.route("/api/blade-visual/map/detail", get(compat::visualdata::map_detail))
.route("/api/blade-visual/map/data", get(compat::visualdata::map_data))
.route("/api/blade-visual/map/save", post(compat::visualdata::map_save))
.route("/api/blade-visual/map/update", post(compat::visualdata::map_update))
.route("/api/blade-visual/map/remove", post(compat::visualdata::map_remove))
// ---- 数据集配置(`VisualRecordController`,`/api/blade-visual/record`)----
.route("/api/blade-visual/record/list", get(compat::visualdata::record_list))
.route("/api/blade-visual/record/detail", get(compat::visualdata::record_detail))
.route("/api/blade-visual/record/save", post(compat::visualdata::record_save))
.route("/api/blade-visual/record/update", post(compat::visualdata::record_update))
.route("/api/blade-visual/record/remove", post(compat::visualdata::record_remove))
// ---- 在线报表(官方 `api/onlineDev/report.ts`,前缀 `/api/Report`)----
//
// 🔴 **官方 `/api/Report/*` 在官方是「独立部署的第三方服务」**
+999
View File
@@ -0,0 +1,999 @@
//! 批次 25 —— **官方大屏**(`jnpf/7.0-jnpf-web-datascreen-vue3` + `jnpf-visualdata`)集成测试。
//!
//! 🔴 **为什么单独一个文件**:大屏设计器前端是**独立仓库**
//! (`7.0-jnpf-web-datascreen-vue3`),不是主 Web 前端 `7.0-jnpf-web-apps-main`
//! ⇒ 「Web 前端 900/900」与「移动端 39/39」两轮都**覆盖不到**它。
//!
//! 🔴 断言四类:
//! ① **路由存在**:53 条大屏路由逐条打一遍(`/visual/{type}` 与 `/visual/list`
//! 这类**静段 / 参数段混排**会让 matchit 冲突 ⇒ `build_app` 直接 panic)。
//! ② **精确形状**:官方大屏的分页是 **`VisualPageVO`**(`{records,current,size,total,pages}`),
//! **不是**本仓常用的 `PageListVO`(`{pagination,list}`)—— 这条最容易做错;
//! 另有四处**裸数组**、一处**裸 id**、一处**两级树**。
//! ③ **落库闭环**:`{visual,config}` 双段新增 ⇒ 两张表都写进去;
//! 删除走 **query 的 `ids`**(官方前端 `delObj` 的写法)。
//! ④ **诚实失败**:外部数据库连接 / 动态 SQL / 任意 URL 转发 / 文件服务
//! ⇒ 必须 `code=400` + `data:null`,**绝不返假坐标 / 假连接成功 / 假链接**。
use std::path::PathBuf;
use std::sync::Arc;
use serde_json::Value;
use ssw_platform::platform::db::Db;
use ssw_platform::platform::seed::first_seed;
use ssw_platform::platform::session::{SessionStore, TicketStore};
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 临时库失败");
ssw_platform::bootstrap::ensure_schema_all(&db)
.await
.expect("ensure_schema_all 失败");
ssw_platform::bootstrap::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
}
fn new_state(db: &Db) -> AppState {
AppState {
config: Arc::new(ssw_platform::platform::config::Config::from_env(PathBuf::from(
"/tmp/ssw-platform-visualdata-it",
))),
db: Arc::new(db.clone()),
sessions: Arc::new(SessionStore::default()),
tickets: Arc::new(TicketStore::default()),
}
}
async fn raw_call(
port: u16,
method: &str,
path: &str,
token: &str,
body: Option<&str>,
) -> (u16, 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
.split_whitespace()
.nth(1)
.and_then(|s| s.parse::<u16>().ok())
.unwrap_or(0);
(status, serde_json::from_str(body.trim()).unwrap_or(Value::Null))
}
async fn call(port: u16, method: &str, path: &str, token: &str, body: Option<&str>) -> Value {
raw_call(port, method, path, token, body).await.1
}
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 v: Value = serde_json::from_str(body.trim()).unwrap_or(Value::Null);
v["data"]["token"]
.as_str()
.expect("登录必须返 token")
.to_string()
}
async fn boot() -> (u16, String) {
let state = new_state(db().await);
let port = serve(state).await;
let token = login(port).await;
(port, token)
}
/// 🔴 **大屏 53 条路由逐条存在性**。
///
/// 🔴 **静段 / 参数段混排**是这一族最大的坑:
/// `/api/blade-visual/visual/list`(静段)与 `/api/blade-visual/visual/{type}`(参数段)
/// 同时注册 —— `matchit` 静态段优先,所以两者可共存;但只要有一条写错
/// (比如把 `/list` 写成 `/{name}/list`)`build_app` 就会 **panic**。
#[tokio::test]
async fn all_visualdata_routes_exist() {
let _g = LOCK.lock().await;
let (port, token) = boot().await;
let probes: Vec<(&str, &str)> = vec![
// ---- 大屏基本信息(`/api/blade-visual/visual`)----
("GET", "/api/blade-visual/visual/list"),
("GET", "/api/blade-visual/visual/category"),
("GET", "/api/blade-visual/visual/detail?id=x"),
("GET", "/api/blade-visual/visual/Selector"),
("POST", "/api/blade-visual/visual/save"),
("POST", "/api/blade-visual/visual/update"),
("POST", "/api/blade-visual/visual/remove?ids=x"),
("POST", "/api/blade-visual/visual/copy?id=x"),
("POST", "/api/blade-visual/visual/put-file/screenShot"),
("GET", "/api/blade-visual/visual/screenShot"),
("POST", "/api/blade-visual/visual/x/Actions/ExportData"),
("POST", "/api/blade-visual/visual/Model/Actions/ImportData"),
("POST", "/api/blade-visual/visual/GetApiData"),
("POST", "/api/blade-visual/visual/proxy"),
// ---- 大屏分类 ----
("GET", "/api/blade-visual/category/page"),
("GET", "/api/blade-visual/category/list"),
("GET", "/api/blade-visual/category/detail?id=x"),
("POST", "/api/blade-visual/category/save"),
("POST", "/api/blade-visual/category/update"),
("POST", "/api/blade-visual/category/remove?ids=x"),
// ---- 静态资源 ----
("GET", "/api/blade-visual/assets/list"),
("GET", "/api/blade-visual/assets/detail?id=x"),
("POST", "/api/blade-visual/assets/save"),
("POST", "/api/blade-visual/assets/update"),
("POST", "/api/blade-visual/assets/remove?ids=x"),
// ---- 大屏组件库 ----
("GET", "/api/blade-visual/component/list"),
("GET", "/api/blade-visual/component/detail?id=x"),
("POST", "/api/blade-visual/component/save"),
("POST", "/api/blade-visual/component/update"),
("POST", "/api/blade-visual/component/remove?ids=x"),
// ---- 全局变量 ----
("GET", "/api/blade-visual/visual-global/list"),
("GET", "/api/blade-visual/visual-global/detail?id=x"),
("POST", "/api/blade-visual/visual-global/save"),
("POST", "/api/blade-visual/visual-global/update"),
("POST", "/api/blade-visual/visual-global/remove?ids=x"),
// ---- 数据源配置 ----
("GET", "/api/blade-visual/db/list"),
("GET", "/api/blade-visual/db/db-list"),
("GET", "/api/blade-visual/db/detail?id=x"),
("POST", "/api/blade-visual/db/submit"),
("POST", "/api/blade-visual/db/remove?ids=x"),
("POST", "/api/blade-visual/db/db-test"),
("POST", "/api/blade-visual/db/dynamic-query"),
// ---- 大屏地图 ----
("GET", "/api/blade-visual/map/lazy-list"),
("GET", "/api/blade-visual/map/detail?id=x"),
("GET", "/api/blade-visual/map/data?id=x"),
("POST", "/api/blade-visual/map/save"),
("POST", "/api/blade-visual/map/update"),
("POST", "/api/blade-visual/map/remove?ids=x"),
// ---- 数据集配置 ----
("GET", "/api/blade-visual/record/list"),
("GET", "/api/blade-visual/record/detail?id=x"),
("POST", "/api/blade-visual/record/save"),
("POST", "/api/blade-visual/record/update"),
("POST", "/api/blade-visual/record/remove?ids=x"),
];
assert_eq!(probes.len(), 53, "大屏路由总数必须是 53 条");
for (method, path) in probes {
let (status, body) = raw_call(port, method, path, &token, None).await;
assert_eq!(
status, 200,
"{method} {path} 必须命中路由,实际 HTTP {status} / {body}"
);
assert_ne!(body["code"], 404, "{method} {path} 未注册: {body}");
}
}
/// 🔴 **未登录必须被挡住**(守卫内联在 handler 里 ⇒ 不是 500,也不是 200 成功)。
#[tokio::test]
async fn visualdata_routes_require_login() {
let _g = LOCK.lock().await;
let (port, _token) = boot().await;
let probes: Vec<(&str, &str)> = vec![
("GET", "/api/blade-visual/visual/list"),
("GET", "/api/blade-visual/visual/category"),
("GET", "/api/blade-visual/visual/Selector"),
("GET", "/api/blade-visual/category/list"),
("GET", "/api/blade-visual/assets/list"),
("GET", "/api/blade-visual/component/list"),
("GET", "/api/blade-visual/visual-global/list"),
("GET", "/api/blade-visual/db/list"),
("GET", "/api/blade-visual/map/lazy-list"),
("GET", "/api/blade-visual/record/list"),
];
for (method, path) in probes {
let (status, body) = raw_call(port, method, path, "", None).await;
assert_eq!(status, 200, "未登录也必须是 HTTP 200 + 信封: {method} {path}");
assert_ne!(
body["code"], 200,
"{method} {path} 未登录竟然放行了: {body}"
);
assert!(
body["code"].as_i64().unwrap_or(0) >= 400,
"{method} {path} 未登录必须返错误码: {body}"
);
}
}
/// 🔴 **分页形状是官方大屏专用的 `VisualPageVO`** —— 不是本仓常用的 `PageListVO`。
///
/// 官方 `VisualPageVO.java:17-47`:`{records, current, size, total, pages}`。
/// 🔴 **入参名也是官方的**:`current` / `size`(**不是** `currentPage` / `pageSize`),
/// 默认 `size=10`(官方 `VisualPagination.java:21`)。
#[tokio::test]
async fn visualdata_paging_shape_is_visual_page_vo() {
let _g = LOCK.lock().await;
let (port, token) = boot().await;
// 🔴 **用不存在的 title 过滤**(官方 `title` 是 `like` 模糊匹配,
// `VisualServiceImpl.java:49`)⇒ 命中 0 行,
// 这样断言 `total`/`pages` 就不受**其它用例已落库数据**的污染
// (所有用例共用同一个 pglite 实例,只是用 LOCK 串行)。
let r = call(
port,
"GET",
"/api/blade-visual/visual/list?current=1&size=5&title=__no_such_visual_9f3a__",
&token,
None,
)
.await;
assert_eq!(r["code"], 200, "大屏分页必须成功: {r}");
let d = &r["data"];
// 🔴 官方形状的 5 个字段一个都不能少。
for k in ["records", "current", "size", "total", "pages"] {
assert!(
d.get(k).is_some(),
"VisualPageVO 缺字段 {k}: {d}"
);
}
assert!(d["records"].is_array(), "records 必须是数组: {d}");
assert_eq!(d["current"], 1, "current 必须是 1: {d}");
assert_eq!(d["size"], 5, "size 必须是 5: {d}");
assert_eq!(d["total"], 0, "过滤后 total 必须是 0: {d}");
assert_eq!(d["pages"], 0, "过滤后 pages 必须是 0: {d}");
// 🔴 **不能**是本仓常用的 `PageListVO`。
assert!(
d.get("pagination").is_none() && d.get("list").is_none(),
concat!(
"官方大屏用 VisualPageVO(records/current/size/total/pages),",
"不是 PageListVO(pagination/list): {0}"
),
d
);
// 🔴 默认每页 10 条(官方 `VisualPagination` 默认值),不是本仓其它面的 20。
let d2 = call(port, "GET", "/api/blade-visual/visual/list", &token, None).await["data"].clone();
assert_eq!(d2["size"], 10, "官方大屏默认每页 10 条: {d2}");
assert_eq!(d2["current"], 1, "官方大屏默认第 1 页: {d2}");
}
/// 🔴 **裸数组 vs 信封**:官方大屏有**四处**返回裸数组,不是 `{list:[…]}`。
#[tokio::test]
async fn visualdata_bare_array_shapes() {
let _g = LOCK.lock().await;
let (port, token) = boot().await;
// `category/list`(官方 `VisualCategoryController.java:72`)
let c = call(port, "GET", "/api/blade-visual/category/list", &token, None).await;
assert_eq!(c["code"], 200, "{c}");
assert!(c["data"].is_array(), "category/list 必须是裸数组: {c}");
// `visual/category`(官方 `VisualController.java:133`)
let vc = call(port, "GET", "/api/blade-visual/visual/category", &token, None).await;
assert_eq!(vc["code"], 200, "{vc}");
assert!(vc["data"].is_array(), "visual/category 必须是裸数组: {vc}");
// `db/db-list`(官方 `VisualDbController.java:72`)—— 只要 3 个字段。
let db = call(port, "GET", "/api/blade-visual/db/db-list", &token, None).await;
assert_eq!(db["code"], 200, "{db}");
assert!(db["data"].is_array(), "db/db-list 必须是裸数组: {db}");
// `map/lazy-list`(官方 `VisualMapController.java:51`)——
// 🔴 官方是 `ActionResult.success(MsgCode.SU005.get(), list)` ⇒ 裸数组,
// **不是** `VisualPageVO`!
let m = call(port, "GET", "/api/blade-visual/map/lazy-list", &token, None).await;
assert_eq!(m["code"], 200, "{m}");
assert!(m["data"].is_array(), "map/lazy-list 必须是裸数组: {m}");
assert!(
m["data"].get("records").is_none(),
"map/lazy-list 是裸数组(不是 VisualPageVO): {m}"
);
}
/// 🔴 **`visual/Selector` 是官方 `ListVO`(`{list:[…]}`)+ 两级树**。
///
/// 官方 `VisualController.java:288-319`:
/// - 外层是 `ListVO`(**不是**裸数组);
/// - 节点是 `{id, fullName, hasChildren, children}`;
/// - 遍历**分类**,把大屏挂到分类下;**分类下没有大屏就不输出该分类**。
#[tokio::test]
async fn visualdata_selector_is_two_level_tree() {
let _g = LOCK.lock().await;
let (port, token) = boot().await;
// 先造一个分类 + 挂一个大屏。
let cat = call(
port,
"POST",
"/api/blade-visual/category/save",
&token,
Some(r#"{"categoryKey":"K1","categoryValue":"7"}"#),
)
.await;
assert_eq!(cat["code"], 200, "分类新增必须成功: {cat}");
let cat_id = cat["data"]["id"].as_str().expect("分类新增必须返 id").to_string();
let vis = call(
port,
"POST",
"/api/blade-visual/visual/save",
&token,
Some(r#"{"visual":{"title":"大屏A","category":7,"status":1,"password":""},
"config":{"detail":"{\"name\":\"大屏A\"}","component":"[]"}}"#),
)
.await;
assert_eq!(vis["code"], 200, "大屏新增必须成功: {vis}");
let vis_id = vis["data"]["id"].as_str().expect("大屏新增必须返 id").to_string();
let s = call(port, "GET", "/api/blade-visual/visual/Selector", &token, None).await;
assert_eq!(s["code"], 200, "{s}");
// 🔴 外层是 `ListVO`。
assert!(s["data"].get("list").is_some(), "Selector 必须是 ListVO: {s}");
let list = s["data"]["list"].as_array().expect("list 必须是数组");
assert_eq!(list.len(), 1, "只有一个有内容的分类 ⇒ 树里 1 个节点: {s}");
let node = &list[0];
assert_eq!(node["id"], cat_id.as_str(), "分类节点 id 必须是分类 id: {s}");
assert_eq!(node["fullName"], "K1", "分类节点 fullName 是 categoryKey: {s}");
assert_eq!(node["hasChildren"], true, "分类节点 hasChildren 必须是 true: {s}");
let children = node["children"].as_array().expect("children 必须是数组: {s}");
assert_eq!(children.len(), 1, "分类下 1 个大屏: {s}");
assert_eq!(children[0]["id"], vis_id.as_str(), "大屏节点 id 必须是大屏 id: {s}");
assert_eq!(children[0]["fullName"], "大屏A", "大屏节点 fullName 是 title: {s}");
assert_eq!(children[0]["hasChildren"], false, "大屏叶子 hasChildren=false: {s}");
assert!(
children[0]["children"].is_null(),
"官方叶子节点的 children 是 null: {s}"
);
// 🔴 **官方逻辑**:「分类下没有大屏就不输出该分类」。
let empty_cat = call(
port,
"POST",
"/api/blade-visual/category/save",
&token,
Some(r#"{"categoryKey":"K2","categoryValue":"9"}"#),
)
.await;
assert_eq!(empty_cat["code"], 200, "{empty_cat}");
let s2 = call(port, "GET", "/api/blade-visual/visual/Selector", &token, None).await;
assert_eq!(
s2["data"]["list"].as_array().map(|a| a.len()),
Some(1),
"空分类不能出现在树里: {s2}"
);
}
/// 🔴 **`{visual, config}` 双段新增 ⇒ 两张表都写进去**(官方前端 `addObj` 的形状)。
///
/// 官方 `VisualCrform` = `{visual: VisualCrModel, config: VisualConfigCrForm}`;
/// `blade_visual` 与 `blade_visual_config` **两张表一次提交**。
#[tokio::test]
async fn visualdata_save_is_dual_section_and_persists() {
let _g = LOCK.lock().await;
let (port, token) = boot().await;
let r = call(
port,
"POST",
"/api/blade-visual/visual/save",
&token,
Some(r#"{"visual":{"title":"双段大屏","category":3,"status":1,"password":"pw"},
"config":{"detail":"{\"name\":\"双段大屏\",\"width\":1920}","component":"[]"}}"#),
)
.await;
assert_eq!(r["code"], 200, "双段新增必须成功: {r}");
let id = r["data"]["id"].as_str().expect("必须返 id").to_string();
// `blade_visual` 写进去了。
let detail = call(
port,
"GET",
&format!("/api/blade-visual/visual/detail?id={id}"),
&token,
None,
)
.await;
assert_eq!(detail["code"], 200, "{detail}");
let d = &detail["data"];
// 🔴 官方 `VisualInfoVO` = `{visual, config}` **双段**。
assert!(d.get("visual").is_some(), "详情必须有 visual 段: {d}");
assert!(d.get("config").is_some(), "详情必须有 config 段: {d}");
assert_eq!(d["visual"]["id"], id.as_str(), "visual.id 必须是主键: {d}");
assert_eq!(d["visual"]["title"], "双段大屏", "visual.title 必须是标题: {d}");
assert_eq!(d["visual"]["category"], 3, "visual.category 必须是分类: {d}");
assert_eq!(d["visual"]["status"], 1, "visual.status 必须是发布状态: {d}");
// 🔴 `config` 段的 `visualId` 指向大屏 id。
assert_eq!(
d["config"]["visualId"], id.as_str(),
"config.visualId 必须指向大屏 id: {d}"
);
assert!(
d["config"]["detail"].as_str().unwrap_or("").contains("1920"),
"config.detail 必须是原文: {d}"
);
// 🔴 **落库闭环**:库里真的有一行,且 `blade_visual_config` 也有一行。
let db = db().await;
let rows = db
.query_json_params(
"SELECT id AS \"id\", title AS \"title\" FROM blade_visual WHERE id = $1::text",
&[&id],
)
.await
.expect("查 blade_visual 失败");
assert_eq!(rows.len(), 1, "blade_visual 必须落库: {rows:?}");
assert_eq!(rows[0]["title"], "双段大屏", "落库的 title 必须对: {rows:?}");
let cfg = db
.query_json_params(
"SELECT id AS \"id\", visual_id AS \"visualId\" FROM blade_visual_config \
WHERE visual_id = $1::text",
&[&id],
)
.await
.expect("查 blade_visual_config 失败");
assert_eq!(cfg.len(), 1, "blade_visual_config 必须落库: {cfg:?}");
// 🔴 删除走 **query 的 `ids`**(官方前端 `delObj` 的写法),且连带删 config。
let del = call(
port,
"POST",
&format!("/api/blade-visual/visual/remove?ids={id}"),
&token,
None,
)
.await;
assert_eq!(del["code"], 200, "删除必须成功: {del}");
let left = db
.query_json_params(
"SELECT id AS \"id\" FROM blade_visual WHERE id = $1::text",
&[&id],
)
.await
.expect("查 blade_visual 失败");
assert_eq!(left.len(), 1, "软删后行还在(is_deleted=1): {left:?}");
let deleted = db
.query_json_params(
"SELECT is_deleted AS \"d\" FROM blade_visual WHERE id = $1::text",
&[&id],
)
.await
.expect("查 is_deleted 失败");
assert_eq!(
deleted[0]["d"], 1,
"blade_visual 有 is_deleted 列 ⇒ 官方是软删: {deleted:?}"
);
let cfg_left = db
.query_json_params(
"SELECT id AS \"id\" FROM blade_visual_config WHERE visual_id = $1::text",
&[&id],
)
.await
.expect("查 blade_visual_config 失败");
assert_eq!(
cfg_left.len(), 0,
"官方删大屏会连带删 config: {cfg_left:?}"
);
}
/// 🔴 **`visual/copy` 返回裸 id 字符串**(官方 `ActionResult.success(msg, id)`)。
///
/// 🔴 官方还会把标题加 `_复制` 后缀。
#[tokio::test]
async fn visualdata_copy_returns_bare_id() {
let _g = LOCK.lock().await;
let (port, token) = boot().await;
let r = call(
port,
"POST",
"/api/blade-visual/visual/save",
&token,
Some(r#"{"visual":{"title":"待复制","category":1,"status":1},"config":{"detail":"{}","component":"[]"}}"#),
)
.await;
assert_eq!(r["code"], 200, "{r}");
let id = r["data"]["id"].as_str().expect("必须返 id").to_string();
let c = call(
port,
"POST",
&format!("/api/blade-visual/visual/copy?id={id}"),
&token,
None,
)
.await;
assert_eq!(c["code"], 200, "复制必须成功: {c}");
// 🔴 官方返的是**裸 id 字符串**(不是 `{id:…}` 对象)。
let new_id = c["data"]
.as_str()
.unwrap_or_else(|| panic!("copy 必须返裸 id 字符串: {c}"));
assert!(!new_id.is_empty(), "复制的 id 不能为空: {c}");
assert_ne!(new_id, id, "复制出来必须是新 id: {c}");
// 🔴 官方:标题加 `_复制`。
let d = call(
port,
"GET",
&format!("/api/blade-visual/visual/detail?id={new_id}"),
&token,
None,
)
.await;
assert_eq!(
d["data"]["visual"]["title"], "待复制_复制",
"官方复制会加 _复制 后缀: {d}"
);
}
/// 🔴 **其余七族的标准 CRUD 闭环**(assets / component / glob / db / map / record / category)。
#[tokio::test]
async fn visualdata_families_crud_round_trip() {
let _g = LOCK.lock().await;
let (port, token) = boot().await;
// ---- 分类 ----
let c = call(
port,
"POST",
"/api/blade-visual/category/save",
&token,
Some(r#"{"categoryKey":"CK","categoryValue":"12"}"#),
)
.await;
assert_eq!(c["code"], 200, "分类新增: {c}");
let cid = c["data"]["id"].as_str().expect("必须返 id").to_string();
// 🔴 官方查重:「模块值已存在」⇒ 失败。
let dup = call(
port,
"POST",
"/api/blade-visual/category/save",
&token,
Some(r#"{"categoryKey":"CK2","categoryValue":"12"}"#),
)
.await;
assert_ne!(dup["code"], 200, "模块值重复必须被拒: {dup}");
assert!(
dup["msg"].as_str().unwrap_or("").contains("已存在"),
"重复分类的报错要说「已存在」: {dup}"
);
let cd = call(
port,
"GET",
&format!("/api/blade-visual/category/detail?id={cid}"),
&token,
None,
)
.await;
assert_eq!(cd["data"]["categoryKey"], "CK", "分类详情: {cd}");
assert_eq!(cd["data"]["categoryValue"], "12", "分类详情: {cd}");
// ---- 静态资源 ----
let a = call(
port,
"POST",
"/api/blade-visual/assets/save",
&token,
Some(r#"{"assetsName":"bg1.png","assetsSize":"12KB","assetsType":"image","assetsUrl":"/x/bg1.png"}"#),
)
.await;
assert_eq!(a["code"], 200, "静态资源新增: {a}");
let aid = a["data"]["id"].as_str().expect("必须返 id").to_string();
let ad = call(
port,
"GET",
&format!("/api/blade-visual/assets/detail?id={aid}"),
&token,
None,
)
.await;
assert_eq!(ad["data"]["assetsName"], "bg1.png", "静态资源详情: {ad}");
assert_eq!(ad["data"]["assetsType"], "image", "静态资源详情: {ad}");
// ---- 组件库 ----
let k = call(
port,
"POST",
"/api/blade-visual/component/save",
&token,
Some(r#"{"name":"柱状图","content":"{}","type":1,"img":"/c/bar.png"}"#),
)
.await;
assert_eq!(k["code"], 200, "组件新增: {k}");
let kid = k["data"]["id"].as_str().expect("必须返 id").to_string();
let kd = call(
port,
"GET",
&format!("/api/blade-visual/component/detail?id={kid}"),
&token,
None,
)
.await;
assert_eq!(kd["data"]["name"], "柱状图", "组件详情: {kd}");
assert_eq!(kd["data"]["type"], 1, "组件详情 type: {kd}");
// ---- 全局变量 ----
let g = call(
port,
"POST",
"/api/blade-visual/visual-global/save",
&token,
Some(r##"{"globalName":"主题色","globalKey":"themeColor","globalValue":"#1890ff"}"##),
)
.await;
assert_eq!(g["code"], 200, "全局变量新增: {g}");
let gid = g["data"]["id"].as_str().expect("必须返 id").to_string();
let gd = call(
port,
"GET",
&format!("/api/blade-visual/visual-global/detail?id={gid}"),
&token,
None,
)
.await;
assert_eq!(gd["data"]["globalKey"], "themeColor", "全局变量详情: {gd}");
assert_eq!(gd["data"]["globalValue"], "#1890ff", "全局变量详情: {gd}");
// ---- 数据源(`submit` 一个端点兼增改)----
let dbs = call(
port,
"POST",
"/api/blade-visual/db/submit",
&token,
Some(r#"{"name":"业务库","driverClass":"org.postgresql.Driver","url":"jdbc:postgresql://x/y","username":"u","password":"p","remark":"备注"}"#),
)
.await;
assert_eq!(dbs["code"], 200, "数据源新增: {dbs}");
let dbid = dbs["data"]["id"].as_str().expect("必须返 id").to_string();
let dbd = call(
port,
"GET",
&format!("/api/blade-visual/db/detail?id={dbid}"),
&token,
None,
)
.await;
assert_eq!(dbd["data"]["name"], "业务库", "数据源详情: {dbd}");
assert_eq!(dbd["data"]["driverClass"], "org.postgresql.Driver", "数据源详情: {dbd}");
// 🔴 密码**不回传**(官方是 AES 密文,回传也没用)。
assert!(
dbd["data"]["password"].is_null() || dbd["data"]["password"] == "",
"数据源详情不该回传密码: {dbd}"
);
// 🔴 `db-list` 只给 3 个字段(官方 `VisualDbSelectVO`)。
let dbl = call(port, "GET", "/api/blade-visual/db/db-list", &token, None).await;
let item = dbl["data"]
.as_array()
.and_then(|a| a.iter().find(|r| r["id"] == dbid.as_str()))
.unwrap_or_else(|| panic!("db-list 必须含新建的数据源: {dbl}"));
assert_eq!(item["name"], "业务库", "db-list name: {dbl}");
assert!(item.get("url").is_none(), "db-list 不该给 url: {dbl}");
assert!(item.get("username").is_none(), "db-list 不该给 username: {dbl}");
// 🔴 `submit` 带 id ⇒ 变成「改」。
let upd = call(
port,
"POST",
"/api/blade-visual/db/submit",
&token,
Some(&format!(
r#"{{"id":"{dbid}","name":"业务库2","driverClass":"org.postgresql.Driver","url":"jdbc:postgresql://x/y"}}"#
)),
)
.await;
assert_eq!(upd["code"], 200, "数据源改: {upd}");
let dbd2 = call(
port,
"GET",
&format!("/api/blade-visual/db/detail?id={dbid}"),
&token,
None,
)
.await;
assert_eq!(dbd2["data"]["name"], "业务库2", "submit 带 id 必须走更新: {dbd2}");
// ---- 地图(`level` 字段对应列 `map_level`)----
let mp = call(
port,
"POST",
"/api/blade-visual/map/save",
&token,
Some(r#"{"name":"广东","code":"440000","level":1,"data":"{\"type\":\"FeatureCollection\"}"}"#),
)
.await;
assert_eq!(mp["code"], 200, "地图新增: {mp}");
let mpid = mp["data"]["id"].as_str().expect("必须返 id").to_string();
let mpd = call(
port,
"GET",
&format!("/api/blade-visual/map/detail?id={mpid}"),
&token,
None,
)
.await;
assert_eq!(mpd["data"]["name"], "广东", "地图详情: {mpd}");
assert_eq!(mpd["data"]["code"], "440000", "地图详情 code: {mpd}");
// 🔴 官方列是 `map_level`,VO 字段是 `level` ⇒ 投影必须改名。
assert_eq!(mpd["data"]["level"], 1, "地图 level 必须来自 map_level: {mpd}");
// 🔴 `map/data` 返**裸字符串**(官方 `entity.getData()`)。
let md = call(
port,
"GET",
&format!("/api/blade-visual/map/data?id={mpid}"),
&token,
None,
)
.await;
assert_eq!(md["code"], 200, "{md}");
assert!(
md["data"].as_str().unwrap_or("").contains("FeatureCollection"),
"map/data 必须返裸字符串(原文): {md}"
);
// ---- 数据集(Java 字段 `sql` ↔ 列 `fsql`)----
let r = call(
port,
"POST",
"/api/blade-visual/record/save",
&token,
Some(r#"{"name":"订单集","url":"/api/x","dataType":1,"dataMethod":"get","sql":"select 1","dbsql":"db1"}"#),
)
.await;
assert_eq!(r["code"], 200, "数据集新增: {r}");
let rid = r["data"]["id"].as_str().expect("必须返 id").to_string();
let rd = call(
port,
"GET",
&format!("/api/blade-visual/record/detail?id={rid}"),
&token,
None,
)
.await;
assert_eq!(rd["data"]["name"], "订单集", "数据集详情: {rd}");
assert_eq!(rd["data"]["dataType"], 1, "数据集 dataType: {rd}");
// 🔴 Java 字段 `sql` 落在列 `fsql`。
assert_eq!(rd["data"]["sql"], "select 1", "数据集 sql 字段: {rd}");
assert_eq!(rd["data"]["dbsql"], "db1", "数据集 dbsql 字段: {rd}");
}
/// 🔴 **诚实失败**:需要外部通道的端点必须 `code=400` + `data:null`。
///
/// 🔴 官方这七条在官方是**真的**去干活的(连外部数据库 / 转发任意 URL /
/// 读写文件服务)⇒ 本仓**明确失败**,绝不返「连接成功」「假 geojson」「假链接」。
#[tokio::test]
async fn visualdata_external_channel_endpoints_fail_honestly() {
let _g = LOCK.lock().await;
let (port, token) = boot().await;
let probes: Vec<(&str, &str, &str)> = vec![
// 连外部数据库
(
"POST",
"/api/blade-visual/db/db-test",
r#"{"name":"x","driverClass":"org.postgresql.Driver","url":"jdbc:postgresql://127.0.0.1:1/x","username":"u","password":"p"}"#,
),
// 在外部数据源上执行 SQL
(
"POST",
"/api/blade-visual/db/dynamic-query",
r#"{"id":"x","sql":"select 1"}"#,
),
// 任意 URL 转发
(
"POST",
"/api/blade-visual/visual/proxy",
r#"{"url":"http://127.0.0.1:1/x","method":"get","headers":{},"params":{},"data":{}}"#,
),
(
"POST",
"/api/blade-visual/visual/GetApiData",
r#"{"url":"http://127.0.0.1:1/x","method":"get","headers":{},"params":{}}"#,
),
// 文件服务
(
"POST",
"/api/blade-visual/visual/put-file/screenShot",
r#"{"file":"x"}"#,
),
(
"GET",
"/api/blade-visual/visual/screenShot",
"",
),
(
"POST",
"/api/blade-visual/visual/x/Actions/ExportData",
"",
),
(
"POST",
"/api/blade-visual/visual/Model/Actions/ImportData",
r#"{"file":"x"}"#,
),
];
for (method, path, body) in probes {
let (status, r) = raw_call(
port,
method,
path,
&token,
if body.is_empty() { None } else { Some(body) },
)
.await;
assert_eq!(status, 200, "{method} {path} 必须是 HTTP 200 + 信封: {r}");
assert_eq!(
r["code"], 400,
"{method} {path} 必须明确业务失败(code=400),不能返假成功: {r}"
);
assert!(
r["data"].is_null(),
"{method} {path} 失败时 data 必须是 null: {r}"
);
let msg = r["msg"].as_str().unwrap_or("");
assert!(
!msg.is_empty(),
"{method} {path} 失败必须给人话(msg 不能空): {r}"
);
}
}
/// 🔴 **地图数据没有来源时必须明确失败**,不能返假坐标。
#[tokio::test]
async fn visualdata_map_data_without_source_fails() {
let _g = LOCK.lock().await;
let (port, token) = boot().await;
// 造一个**没有 data** 的地图。
let mp = call(
port,
"POST",
"/api/blade-visual/map/save",
&token,
Some(r#"{"name":"空地图","code":"000000","level":1}"#),
)
.await;
assert_eq!(mp["code"], 200, "{mp}");
let mpid = mp["data"]["id"].as_str().expect("必须返 id").to_string();
let md = call(
port,
"GET",
&format!("/api/blade-visual/map/data?id={mpid}"),
&token,
None,
)
.await;
assert_eq!(md["code"], 400, "没有地图数据必须明确失败: {md}");
assert!(md["data"].is_null(), "失败时 data 必须是 null: {md}");
assert!(
!md["msg"].as_str().unwrap_or("").contains("FeatureCollection"),
"绝不能返假 geojson: {md}"
);
}
/// 🔴 **地图懒加载的父子关系**:只有根节点进根列表,`hasChildren` 要对。
#[tokio::test]
async fn visualdata_map_lazy_list_is_parent_child_aware() {
let _g = LOCK.lock().await;
let (port, token) = boot().await;
let parent = call(
port,
"POST",
"/api/blade-visual/map/save",
&token,
Some(r#"{"name":"中国","code":"100000","level":1}"#),
)
.await;
assert_eq!(parent["code"], 200, "{parent}");
let pid = parent["data"]["id"].as_str().expect("必须返 id").to_string();
let child = call(
port,
"POST",
"/api/blade-visual/map/save",
&token,
Some(&format!(
r#"{{"name":"广东","code":"440000","level":2,"parentId":"{pid}"}}"#
)),
)
.await;
assert_eq!(child["code"], 200, "{child}");
// 根列表:只有 `parentId` 为空的那条。
let roots = call(port, "GET", "/api/blade-visual/map/lazy-list", &token, None).await;
let arr = roots["data"].as_array().expect("必须是裸数组");
let me = arr.iter().find(|r| r["id"] == pid.as_str());
assert!(me.is_some(), "根列表必须含父节点: {roots}");
let me = me.unwrap();
assert_eq!(me["hasChildren"], true, "有子节点 ⇒ hasChildren=true: {roots}");
assert_eq!(me["name"], "中国", "节点 name: {roots}");
// 懒加载子节点:`parentId` 传父 id。
let kids = call(
port,
"GET",
&format!("/api/blade-visual/map/lazy-list?parentId={pid}"),
&token,
None,
)
.await;
let karr = kids["data"].as_array().expect("必须是裸数组");
assert_eq!(karr.len(), 1, "父节点下 1 个子节点: {kids}");
assert_eq!(karr[0]["id"], child["data"]["id"].as_str().unwrap(), "子节点 id: {kids}");
assert_eq!(karr[0]["hasChildren"], false, "叶子 hasChildren=false: {kids}");
// 🔴 官方会填 `parentName`(父节点名)。
assert_eq!(karr[0]["parentName"], "中国", "官方会填 parentName: {kids}");
}