From b957a11b4cdd5265897ec47da1876d1309c14235 Mon Sep 17 00:00:00 2001 From: admin Date: Tue, 3 Nov 2026 10:56:03 +0800 Subject: [PATCH] =?UTF-8?q?feat(compat):=20=E6=89=B9=E6=AC=A1=2025=20?= =?UTF-8?q?=E8=A1=A5=E9=BD=90=E5=AE=98=E6=96=B9=E5=A4=A7=E5=B1=8F=2052=20?= =?UTF-8?q?=E6=9D=A1=E7=AB=AF=E7=82=B9=EF=BC=88blade-visual=2053/53?= =?UTF-8?q?=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 官方大屏设计器(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 条引文)。 --- .workbuddy/memory/2026-11-03.md | 20 + HANDOFF.md | 80 + crates/sspf-store/src/db.rs | 29 +- docs/contract.md | 111 +- docs/known-limitations.md | 19 + scripts/gen-contract-endpoints.py | 61 +- scripts/official-visualdata-sources.json | 55 + src/backend/db/schema.sql | 137 ++ src/backend/src/main.rs | 7 + src/backend/src/platform/compat/mod.rs | 1 + src/backend/src/platform/compat/online_dev.rs | 14 +- src/backend/src/platform/compat/visualdata.rs | 2014 +++++++++++++++++ src/backend/src/routes.rs | 84 +- src/backend/tests/visualdata_it.rs | 999 ++++++++ 14 files changed, 3612 insertions(+), 19 deletions(-) create mode 100644 scripts/official-visualdata-sources.json create mode 100644 src/backend/src/platform/compat/visualdata.rs create mode 100644 src/backend/tests/visualdata_it.rs diff --git a/.workbuddy/memory/2026-11-03.md b/.workbuddy/memory/2026-11-03.md index 5133fb7..1beb892 100644 --- a/.workbuddy/memory/2026-11-03.md +++ b/.workbuddy/memory/2026-11-03.md @@ -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/.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。 diff --git a/HANDOFF.md b/HANDOFF.md index d954dcc..fde4f61 100644 --- a/HANDOFF.md +++ b/HANDOFF.md @@ -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/.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 的是 diff --git a/crates/sspf-store/src/db.rs b/crates/sspf-store/src/db.rs index 1bac95f..ed8c7c6 100644 --- a/crates/sspf-store/src/db.rs +++ b/crates/sspf-store/src/db.rs @@ -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(), diff --git a/docs/contract.md b/docs/contract.md index b1f841d..77b5355 100644 --- a/docs/contract.md +++ b/docs/contract.md @@ -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 + # 🔴 以下由 `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 期望断言数(尺子**自己**断言的条数;跑出来的条数对不上 ⇒ 失败) diff --git a/docs/known-limitations.md b/docs/known-limitations.md index 5f81de2..c678444 100644 --- a/docs/known-limitations.md +++ b/docs/known-limitations.md @@ -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 导出库。返假链接(前端会直接 ``)只会 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: "", 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`)本仓也**只要求登录** | 照抄官方注解的**有无**(不是照抄语义)。代价:这些端点任何登录用户可读(大屏配置本身不是敏感数据) | + diff --git a/scripts/gen-contract-endpoints.py b/scripts/gen-contract-endpoints.py index 1c8369e..6e71433 100644 --- a/scripts/gen-contract-endpoints.py +++ b/scripts/gen-contract-endpoints.py @@ -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//**:行号`(与 `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))) diff --git a/scripts/official-visualdata-sources.json b/scripts/official-visualdata-sources.json new file mode 100644 index 0000000..d67b257 --- /dev/null +++ b/scripts/official-visualdata-sources.json @@ -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" +} diff --git a/src/backend/db/schema.sql b/src/backend/db/schema.sql index 699e8b4..338974a 100644 --- a/src/backend/db/schema.sql +++ b/src/backend/db/schema.sql @@ -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) +); diff --git a/src/backend/src/main.rs b/src/backend/src/main.rs index 758c6b5..64517ee 100644 --- a/src/backend/src/main.rs +++ b/src/backend/src/main.rs @@ -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?)" diff --git a/src/backend/src/platform/compat/mod.rs b/src/backend/src/platform/compat/mod.rs index 50be057..82035ca 100644 --- a/src/backend/src/platform/compat/mod.rs +++ b/src/backend/src/platform/compat/mod.rs @@ -32,3 +32,4 @@ pub mod res; pub mod extend; pub mod teamwork; pub mod mobile; +pub mod visualdata; diff --git a/src/backend/src/platform/compat/online_dev.rs b/src/backend/src/platform/compat/online_dev.rs index 0dd378f..5709165 100644 --- a/src/backend/src/platform/compat/online_dev.rs +++ b/src/backend/src/platform/compat/online_dev.rs @@ -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, - headers: HeaderMap, -) -> Json { - 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) // diff --git a/src/backend/src/platform/compat/visualdata.rs b/src/backend/src/platform/compat/visualdata.rs new file mode 100644 index 0000000..5046d80 --- /dev/null +++ b/src/backend/src/platform/compat/visualdata.rs @@ -0,0 +1,2014 @@ +//! visualdata —— 官方**大屏(DataScreen / blade-visual)**契约面(批次 25)。 +//! +//! 🔴 **三源对照**(本模块的每个端点都同时对照过这三个真源): +//! +//! | 源 | 位置 | 作用 | +//! |---|---|---| +//! | 后端源码 | `jnpf-java-boot/jnpf-visualdata/**`(8 个 Controller) | 端点路径 + 方法 + 返回形状 | +//! | 数据库 | `7.0/database/PostgreSQL/JNPF-PostgreSQL.sql`(9 张 `blade_visual*` 表) | 列名 / 类型 / 主键 | +//! | 前端 api | `jnpf-web-datascreen-vue3/src/api/*.js`(9 个文件) | 请求形状 / 入参位置(query vs body) | +//! +//! 🔴 **前端 api 的关键约定**(`7.0-jnpf-web-datascreen-vue3/src/api/**`): +//! - **删除走 query**:`delObj(id)` ⇒ `POST {base}/remove` + `params: {ids: id}` +//! (`ids` 在 **query**,不在 body!)—— 官方 Java 也是 `@RequestParam("ids")`。 +//! - **大屏新增是双段结构**:`POST {base}/save` 的 body 是 +//! `{visual: {password, category, status, title}, config: {detail, component}}` +//! ⇒ `blade_visual` 与 `blade_visual_config` **两张表一次提交**。 +//! - **前端只消费 `visual/proxy`**:`src/axios.js:68` 把带 `headers.proxy` 的请求 +//! 统一改写成 `POST {api}/visual/proxy`,body 是 `{url, method, headers, params, data}`。 +//! +//! 🔴 **列族与本仓不同**(**故意不改名**): +//! 官方大屏是 Blade 系(`id` / `is_deleted` / `create_time`), +//! 本仓其它契约面是 JNPF 系(`f_id` / `f_delete_mark` / `f_creator_time`)。 +//! ⇒ 本模块**不用** `compat::res` 引擎(那套写死了 `f_` 列族), +//! 而是**逐字照官方 DDL** 写 SQL ⇒ 「对照官方 DDL 逐列比对」才成立。 +//! +//! 🔴 **形状不统一是官方的既有事实,照抄不改**: +//! | 端点 | 官方返回 | +//! |---|---| +//! | `GET /visual/list` 等分页族 | **`VisualPageVO`** = `{records, current, size, total, pages}` | +//! | `GET /category/list`、`GET /visual/category`、`GET /db/db-list` | **裸数组** | +//! | `GET /map/lazy-list` | **裸数组**(`ActionResult.success(MsgCode.SU005.get(), list)`) | +//! | `GET /map/data` | **裸字符串**(`entity.getData()`,**不是信封**) | +//! | `POST /visual/GetApiData`、`POST /visual/proxy` | **裸字符串**(`String` 返回类型) | +//! | `GET /visual/Selector` | **`ListVO`** = `{list:[…]}`(分类 → 大屏两级树) | +//! | `POST /visual/save` | `{id}`(官方 `Map` 只放 id) | +//! | `POST /visual/copy` | **裸 id 字符串**(`ActionResult.success(msg, entity.getId())`) | +//! +//! 🔴 **诚实降级**(本仓没有的能力,一律**明确失败**,绝不返假值): +//! - `db/db-test`(连外部数据库)、`db/dynamic-query`(执行外部 SQL)⇒ 失败; +//! - `visual/proxy`、`visual/GetApiData`(转发外部 HTTP)⇒ 失败; +//! - `visual/put-file/{type}`(文件服务)、`GET /visual/{type}`(图片列表)⇒ 失败; +//! - `visual/{id}/Actions/ExportData`(导出 zip)、`visual/Model/Actions/ImportData`(导入)⇒ 失败。 + +use axum::body::Bytes; +use axum::extract::{Path, RawQuery, State}; +use axum::http::HeaderMap; +use axum::Json; +use serde_json::{json, Map, Value}; + +use crate::platform::envelope::{code, fail, ok, ActionResult}; +use crate::platform::ids::new_uuid; +use crate::platform::state::AppState; + +use super::helper::{db_error, guard, list_vo, params_of, parse_body, qv}; + +// ================================================================ 常量 + +/// 🔴 官方 `@SaCheckPermission("onlineDev.dataScreen")`(8 个 Controller 里逐条照抄)。 +/// +/// 🔴 **官方没挂这个注解的端点不挂**:例如 +/// `VisualAssetsController.list`(分页)、`VisualComponentController.list`、 +/// `VisualMapController.list` / `.info` 都没注解 ⇒ 本仓也**只要求登录**。 +const EN_DATA_SCREEN: &str = "onlineDev.dataScreen"; + +/// 官方 `VisualPagination` 默认值:`size = 10` / `current = 1`。 +/// +/// 🔴 **注意与本仓其它契约面的 `pageSize=20` 不同** —— 官方大屏用 10。 +const PAGE_SIZE_DEFAULT: i64 = 10; + +/// 官方 `VisualPagination` 的入参名 —— 官方前端传的是 `current` / `size` +/// (`VisualPagination.java:21/24`),**不是**本仓常用的 `currentPage` / `pageSize`。 +/// +/// 🔴 **只认官方形态**(`size` / `current`):本仓其它契约面的 `pageSize` / `currentPage` +/// 在官方大屏里**不存在**(官方 `VisualPaginationModel` 没有这两个字段), +/// 收了反而会让「照抄官方」的形状失真 ⇒ 这里只读 `size` / `current`。 +fn paging_of(raw: &RawQuery) -> (i64, i64) { + let size = qv(raw, "size") + .parse::() + .ok() + .filter(|n| *n > 0) + .unwrap_or(PAGE_SIZE_DEFAULT); + let current = qv(raw, "current") + .parse::() + .ok() + .filter(|n| *n > 0) + .unwrap_or(1); + (current, size) +} + +/// 官方 `VisualPageVO` —— `{records, current, size, total, pages}`。 +/// +/// 🔴 **不是**本仓常用的 `PageListVO`(`{pagination, list}`)—— 官方大屏用自己的形状。 +fn visual_page_vo(current: i64, size: i64, total: i64, records: Vec) -> Value { + let pages = if total > 0 { + if total % size == 0 { + total / size + } else { + total / size + 1 + } + } else { + 0 + }; + json!({ + "records": records, + "current": current, + "size": size, + "total": total, + "pages": pages, + }) +} + +/// 本仓没有的能力 ⇒ 明确失败(**绝不返假数据**)。 +fn unsupported(what: &str) -> Json { + fail(code::FAIL, format!("本极简引擎不支持{what}")) +} + +/// 🔴 **哪几张表有 `is_deleted` 列**(官方 Blade 系的软删标记)。 +/// +/// 官方 `blade_visual` / `blade_visual_category` / `blade_visual_db` 三张有, +/// 其余 6 张(`_assets` / `_component` / `_config` / `_glob` / `_map` / `_record`)**没有** +/// ⇒ 那 6 张官方是**物理删**。 +fn has_is_deleted(table: &str) -> bool { + matches!( + table, + "blade_visual" | "blade_visual_category" | "blade_visual_db" + ) +} + +/// 🔴 **哪几张表有 Blade 系审计列**(`create_user` / `create_time`)。 +fn has_audit_cols(table: &str) -> bool { + matches!(table, "blade_visual" | "blade_visual_db") +} + +/// 软删谓词。 +/// +/// 🔴 **只有 3 张表有 `is_deleted`**(见 [`has_is_deleted`]), +/// 其余 6 张**没有这列** ⇒ 不加这个谓词(加了 SQL 直接报列不存在)。 +/// +/// ⚠️ 返回值**自带 `AND`**(`info()` 里拼在 `WHERE id = $1` 之后, +/// `all()` 里拼在 `WHERE 1 = 1` 之后 —— 两处都要求它是连接词,不能是裸表达式)。 +fn deleted_where(table: &str) -> &'static str { + if has_is_deleted(table) { + " AND COALESCE(is_deleted, 0) = 0" + } else { + "" + } +} + +/// 🔴 **Blade 列族**的资源声明(与 `compat::res` 的 `f_` 列族不同)。 +struct BRes { + table: &'static str, + /// 投影片段(**已含** `id AS "id"` 与全部官方 VO 字段的别名)。 + projection: &'static str, + /// 写白名单:`(JSON 键, 列名, 是否整数)`。 + fields: &'static [(&'static str, &'static str, bool)], + /// 关键词搜索列(空 = 不支持)。 + keyword: &'static [&'static str], + /// 排序片段(不含 `ORDER BY`)。 + order: &'static str, +} + +/// 把 JSON 值转成绑定文本。 +fn param_of(v: &Value) -> Option { + match v { + Value::Null => None, + Value::String(s) => Some(s.clone()), + Value::Bool(b) => Some(if *b { "1".to_string() } else { "0".to_string() }), + Value::Number(n) => Some(n.to_string()), + other => Some(other.to_string()), + } +} + +/// 投影:补上 `id AS "id"`(官方 VO 都带 `id`)。 +fn projection(res: &BRes) -> String { + format!("id AS \"id\", {}", res.projection) +} + +/// 查列表(分页)⇒ 官方 `VisualPageVO`。 +async fn page( + state: &AppState, + res: &BRes, + raw: &RawQuery, + extra_conds: &[(&str, &str, String)], +) -> Result { + let (current, size) = paging_of(raw); + let mut values: Vec> = Vec::new(); + let mut conds: Vec = vec!["1 = 1".to_string()]; + + let deleted = deleted_where(res.table); + if !deleted.is_empty() { + // `conds` 之间用 ` AND ` 连接 ⇒ 这里放**裸谓词**(不能带 `AND`)。 + conds.push("COALESCE(is_deleted, 0) = 0".to_string()); + } + + for (col, op, val) in extra_conds { + if val.is_empty() { + continue; + } + values.push(Some(val.clone())); + match *op { + // 🔴 官方 `title` 是 **`like` 模糊匹配**(`VisualServiceImpl.java:49` + // `queryWrapper.lambda().like(VisualEntity::getTitle, pagination.getTitle())`) + // ⇒ 必须 ILIKE + 两端 %,不是等值。 + "like" => conds.push(format!( + "COALESCE({col}, '') ILIKE ${}::text", + values.len() + )), + _ => conds.push(format!("CAST({col} AS text) = ${}::text", values.len())), + } + } + + let keyword = qv(raw, "keyword"); + if !keyword.trim().is_empty() && !res.keyword.is_empty() { + values.push(Some(format!("%{}%", keyword.trim()))); + let at = values.len(); + let ors = res + .keyword + .iter() + .map(|c| format!("COALESCE({c}, '') ILIKE ${at}::text")) + .collect::>() + .join(" OR "); + conds.push(format!("({ors})")); + } + + let where_sql = conds.join(" AND "); + let count_sql = format!( + "SELECT COUNT(*)::bigint AS \"total\" FROM {} WHERE {where_sql}", + res.table + ); + let total = state + .db + .query_json_params(&count_sql, ¶ms_of(&values)) + .await? + .first() + .and_then(|r| r.get("total")) + .and_then(Value::as_i64) + .unwrap_or(0); + + values.push(Some(size.to_string())); + let limit_at = values.len(); + values.push(Some(((current - 1) * size).to_string())); + let offset_at = values.len(); + let sql = format!( + "SELECT {} FROM {} WHERE {where_sql} ORDER BY {} \ + LIMIT ${limit_at}::text::integer OFFSET ${offset_at}::text::integer", + projection(res), + res.table, + res.order + ); + let rows = state.db.query_json_params(&sql, ¶ms_of(&values)).await?; + Ok(visual_page_vo(current, size, total, rows)) +} + +/// 查详情(软删的不算)。 +async fn info(state: &AppState, res: &BRes, id: &str) -> Result, crate::platform::db::pglite::Error> { + let deleted = deleted_where(res.table); + let sql = format!( + "SELECT {} FROM {} WHERE id = $1::text{} LIMIT 1", + projection(res), + res.table, + deleted + ); + Ok(state + .db + .query_json_params(&sql, &[&id.trim()]) + .await? + .into_iter() + .next()) +} + +/// 不分页的全量列表。 +async fn all(state: &AppState, res: &BRes) -> Result, crate::platform::db::pglite::Error> { + let deleted = deleted_where(res.table); + let sql = format!( + "SELECT {} FROM {} WHERE 1 = 1{} ORDER BY {}", + projection(res), + res.table, + deleted, + res.order + ); + state.db.query_json_params(&sql, &[]).await +} + +/// 新增 ⇒ 新 id。 +/// +/// 🔴 **Blade 列族的审计列**:官方表用 `create_user` / `create_time` / `update_user` / +/// `update_time`(**不是** `f_creator_user_id` / `f_creator_time`)。 +async fn create( + state: &AppState, + res: &BRes, + obj: &Map, + user: &str, +) -> Result { + let id = obj + .get("id") + .and_then(Value::as_str) + .map(str::trim) + .filter(|s| !s.is_empty()) + .map(str::to_string) + .unwrap_or_else(new_uuid); + + let mut cols: Vec<&'static str> = vec!["id"]; + let mut slots: Vec = Vec::new(); + let mut values: Vec> = vec![Some(id.clone())]; + for (json_key, col, is_int) in res.fields { + let Some(v) = obj.get(*json_key) else { continue }; + let Some(text) = param_of(v) else { continue }; + cols.push(col); + values.push(Some(text)); + slots.push(if *is_int { + format!("${}::text::bigint", values.len()) + } else { + format!("${}::text", values.len()) + }); + } + // 审计列:只有 `blade_visual` / `blade_visual_db` 两张表有 + // `create_user` / `create_time`(官方 Blade 系审计列,**不是** `f_creator_*`)。 + if has_audit_cols(res.table) { + if !cols.contains(&"create_user") { + cols.push("create_user"); + values.push(Some(user.to_string())); + slots.push(format!("${}::text", values.len())); + } + if !cols.contains(&"create_time") { + cols.push("create_time"); + slots.push("now()".to_string()); + } + } + // `blade_visual` 的 `status` / `is_deleted` 是 NOT NULL ⇒ 给默认值; + // `blade_visual_db` / `blade_visual_category` 的 `is_deleted` 同理。 + if res.table == "blade_visual" && !cols.contains(&"status") { + cols.push("status"); + slots.push("0".to_string()); + } + if has_is_deleted(res.table) && !cols.contains(&"is_deleted") { + cols.push("is_deleted"); + slots.push("0".to_string()); + } + // `f_tenant_id` 官方有 NOT NULL DEFAULT '0' ⇒ 显式给 '0'。 + cols.push("f_tenant_id"); + slots.push("'0'".to_string()); + + let col_sql = cols.join(", "); + let val_sql = slots.join(", "); + // ⚠️ `cols` 的第一项是 `id`,对应 `values[0]` ⇒ 它的占位符就是 `$1`; + // `slots` 从**第二个**值开始 ⇒ 必须 `$1` 打头,不能重复。 + let sql = format!( + "INSERT INTO {} ({}) VALUES ($1, {})", + res.table, col_sql, val_sql + ); + state.db.exec_params(&sql, ¶ms_of(&values)).await?; + Ok(id) +} + +/// 更新(只改 body 里出现的键)⇒ 是否命中。 +async fn update( + state: &AppState, + res: &BRes, + id: &str, + obj: &Map, + user: &str, +) -> Result { + let mut sets: Vec = Vec::new(); + let mut values: Vec> = Vec::new(); + for (json_key, col, is_int) in res.fields { + let Some(v) = obj.get(*json_key) else { continue }; + values.push(param_of(v)); + sets.push(format!( + "{col} = {}", + if *is_int { + format!("${}::text::bigint", values.len()) + } else { + format!("${}::text", values.len()) + } + )); + } + if sets.is_empty() { + return Ok(false); + } + // 审计列:有 `update_user` 的表才写。 + if res.fields.iter().any(|(_, c, _)| *c == "update_user") { + values.push(Some(user.to_string())); + sets.push(format!("update_user = ${}::text", values.len())); + sets.push("update_time = now()".to_string()); + } + values.push(Some(id.trim().to_string())); + let id_at = values.len(); + + let before = state + .db + .query_json_params( + &format!("SELECT id AS \"id\" FROM {} WHERE id = $1::text LIMIT 1", res.table), + &[&id.trim()], + ) + .await?; + if before.is_empty() { + return Ok(false); + } + let sql = format!( + "UPDATE {} SET {} WHERE id = ${id_at}::text", + res.table, + sets.join(", ") + ); + state.db.exec_params(&sql, ¶ms_of(&values)).await?; + Ok(true) +} + +/// 删除。 +/// +/// 🔴 **两种语义**: +/// - 有 `is_deleted` 的表(`blade_visual` / `blade_visual_category` / `blade_visual_db`) +/// ⇒ 官方是**软删**(`is_deleted = 1`)。 +/// - 没有 `is_deleted` 的表 ⇒ 官方是**物理删**(`deleteById`)。 +async fn remove( + state: &AppState, + res: &BRes, + id: &str, +) -> Result { + let before = state + .db + .query_json_params( + &format!("SELECT id AS \"id\" FROM {} WHERE id = $1::text LIMIT 1", res.table), + &[&id.trim()], + ) + .await?; + if before.is_empty() { + return Ok(false); + } + let deleted = deleted_where(res.table); + if deleted.is_empty() { + state + .db + .exec_params( + &format!("DELETE FROM {} WHERE id = $1::text", res.table), + &[&id.trim()], + ) + .await?; + } else { + state + .db + .exec_params( + &format!("UPDATE {} SET is_deleted = 1 WHERE id = $1::text", res.table), + &[&id.trim()], + ) + .await?; + } + Ok(true) +} + +// ================================================================ 资源声明 + +/// 🔴 `blade_visual`(大屏基本信息)。 +/// +/// 官方 `VisualListVO` 字段:`backgroundUrl` / `title` / `password` / `id` / `status` / `category`。 +const VISUAL: BRes = BRes { + table: "blade_visual", + projection: "title AS \"title\", background_url AS \"backgroundUrl\", \ + CAST(COALESCE(category, 0) AS bigint) AS \"category\", \ + password AS \"password\", \ + CAST(COALESCE(status, 0) AS bigint) AS \"status\"", + fields: &[ + ("title", "title", false), + ("backgroundUrl", "background_url", false), + ("category", "category", true), + ("password", "password", false), + ("status", "status", true), + ], + keyword: &["title"], + order: "create_time DESC NULLS LAST, title ASC", +}; + +/// 🔴 `blade_visual_assets`(静态资源)。 +/// +/// 官方 `VisualAssetsCrForm` 字段:`id` / `assetsName` / `assetsSize` / `assetsTime` / +/// `assetsType` / `assetsUrl`。 +const ASSETS: BRes = BRes { + table: "blade_visual_assets", + projection: "assetsname AS \"assetsName\", assetssize AS \"assetsSize\", \ + assetstime AS \"assetsTime\", assetstype AS \"assetsType\", \ + assetsurl AS \"assetsUrl\"", + fields: &[ + ("assetsName", "assetsname", false), + ("assetsSize", "assetssize", false), + ("assetsTime", "assetstime", false), + ("assetsType", "assetstype", false), + ("assetsUrl", "assetsurl", false), + ], + keyword: &["assetsname", "assetstype"], + order: "assetstime DESC NULLS LAST, assetsname ASC", +}; + +/// 🔴 `blade_visual_category`(大屏分类)。 +/// +/// 官方 `VisualCategoryCrForm` 字段:`categoryKey` / `categoryValue` / `isDeleted`。 +const CATEGORY: BRes = BRes { + table: "blade_visual_category", + projection: "category_key AS \"categoryKey\", category_value AS \"categoryValue\", \ + CAST(COALESCE(is_deleted, 0) AS bigint) AS \"isDeleted\"", + fields: &[ + ("categoryKey", "category_key", false), + ("categoryValue", "category_value", false), + ("isDeleted", "is_deleted", true), + ], + keyword: &["category_key", "category_value"], + order: "category_key ASC, category_value ASC", +}; + +/// 🔴 `blade_visual_component`(大屏组件库)。 +/// +/// 官方 `VisualComponentCrForm` 字段:`id` / `name` / `content` / `type` / `img`。 +const COMPONENT: BRes = BRes { + table: "blade_visual_component", + projection: "name AS \"name\", content AS \"content\", \ + CAST(COALESCE(type, 0) AS bigint) AS \"type\", img AS \"img\"", + fields: &[ + ("name", "name", false), + ("content", "content", false), + ("type", "type", true), + ("img", "img", false), + ], + keyword: &["name"], + order: "name ASC", +}; + +/// 🔴 `blade_visual_glob`(全局变量)。 +/// +/// 官方 `VisualGlobCrForm` 字段:`id` / `globalName` / `globalKey` / `globalValue`。 +const GLOB: BRes = BRes { + table: "blade_visual_glob", + projection: "globalname AS \"globalName\", globalkey AS \"globalKey\", \ + globalvalue AS \"globalValue\"", + fields: &[ + ("globalName", "globalname", false), + ("globalKey", "globalkey", false), + ("globalValue", "globalvalue", false), + ], + keyword: &["globalname", "globalkey"], + order: "globalname ASC", +}; + +/// 🔴 `blade_visual_db`(大屏数据源配置)。 +/// +/// 官方 `VisualDbListVO` 字段:`driverClass` / `name` / `username` / `url` / `id` / `remark`。 +/// 🔴 **详情 VO 额外带 `password`**(`VisualDbInfoVO`)—— 本仓在详情里**不返回密码** +/// (官方是加密串,返回也没用;但形状上保留 `password` 字段为空串)。 +const DB: BRes = BRes { + table: "blade_visual_db", + projection: "name AS \"name\", driver_class AS \"driverClass\", url AS \"url\", \ + username AS \"username\", remark AS \"remark\", \ + CAST(COALESCE(status, 0) AS bigint) AS \"status\"", + fields: &[ + ("name", "name", false), + ("driverClass", "driver_class", false), + ("url", "url", false), + ("username", "username", false), + ("password", "password", false), + ("remark", "remark", false), + ("status", "status", true), + ], + keyword: &["name", "driver_class"], + order: "create_time DESC NULLS LAST, name ASC", +}; + +/// 🔴 `blade_visual_map`(大屏地图)。 +/// +/// 官方 `VisualMapListVO` 字段:`name` / `id` / `code` / `level` / `parentName` / `hasChildren`。 +/// 🔴 官方列名是 `map_level`,但 VO 字段叫 **`level`** ⇒ 投影时改名。 +const MAP: BRes = BRes { + table: "blade_visual_map", + projection: "name AS \"name\", data AS \"data\", code AS \"code\", \ + CAST(COALESCE(map_level, 0) AS bigint) AS \"level\", \ + parent_id AS \"parentId\", parent_code AS \"parentCode\", \ + ancestors AS \"ancestors\"", + fields: &[ + ("name", "name", false), + ("data", "data", false), + ("code", "code", false), + ("level", "map_level", true), + ("parentId", "parent_id", false), + ("parentCode", "parent_code", false), + ("ancestors", "ancestors", false), + ], + keyword: &["name", "code"], + order: "code ASC, name ASC", +}; + +/// 🔴 `blade_visual_record`(大屏数据集配置)。 +/// +/// 官方 `VisualRecordCrForm` 字段:`id` / `name` / `url` / `dataType` / `dataMethod` / +/// `dataHeader` / `data` / `dataQuery` / `dataQueryType` / `dataFormatter` / `proxy` / +/// `wsUrl` / `dbsql` / `sql` / `mqtturl` / `mqttConfig` / `result`。 +/// +/// 🔴 **Java 字段 `sql` 对应物理列 `fsql`**(官方 DDL 里没有 `sql` 列)。 +/// 🔴 **Java 字段 `mqtturl` / `mqttConfig`** 对应列 `mqtturl` / `mqttconfig`。 +const RECORD: BRes = BRes { + table: "blade_visual_record", + projection: "name AS \"name\", url AS \"url\", \ + CAST(COALESCE(datatype, 0) AS bigint) AS \"dataType\", \ + datamethod AS \"dataMethod\", dataheader AS \"dataHeader\", \ + data AS \"data\", dataquery AS \"dataQuery\", \ + dataquerytype AS \"dataQueryType\", dataformatter AS \"dataFormatter\", \ + CAST(COALESCE(proxy, 0) AS bigint) AS \"proxy\", \ + wsurl AS \"wsUrl\", dbsql AS \"dbsql\", fsql AS \"sql\", \ + result AS \"result\", mqtturl AS \"mqtturl\", mqttconfig AS \"mqttConfig\"", + fields: &[ + ("name", "name", false), + ("url", "url", false), + ("dataType", "datatype", true), + ("dataMethod", "datamethod", false), + ("dataHeader", "dataheader", false), + ("data", "data", false), + ("dataQuery", "dataquery", false), + ("dataQueryType", "dataquerytype", false), + ("dataFormatter", "dataformatter", false), + ("proxy", "proxy", true), + ("wsUrl", "wsurl", false), + ("dbsql", "dbsql", false), + ("sql", "fsql", false), + ("result", "result", false), + ("mqtturl", "mqtturl", false), + ("mqttConfig", "mqttconfig", false), + ], + keyword: &["name"], + order: "name ASC", +}; + +// ================================================================ 通用 handler 包装 + +/// 分页列表(`VisualPageVO`)。 +async fn page_json( + state: &AppState, + res: &BRes, + raw: &RawQuery, + filters: Vec<(&str, &str, String)>, +) -> Json { + match page(state, res, raw, &filters).await { + Ok(v) => ok(v), + Err(e) => db_error(e, "大屏列表查询"), + } +} + +/// 详情。 +async fn info_json(state: &AppState, res: &BRes, id: &str) -> Json { + match info(state, res, id).await { + Ok(Some(row)) => ok(row), + Ok(None) => fail(code::FAIL, "数据不存在"), + Err(e) => db_error(e, "大屏详情查询"), + } +} + +/// 新增 ⇒ `{id}`。 +async fn create_json( + state: &AppState, + res: &BRes, + body: &Bytes, + user: &str, +) -> Json { + let obj = match parse_body(body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + match create(state, res, &obj, user).await { + Ok(id) => ok(json!({ "id": id })), + Err(e) => db_error(e, "新增"), + } +} + +/// 更新。 +async fn update_json( + state: &AppState, + res: &BRes, + id: &str, + body: &Bytes, + user: &str, +) -> Json { + let obj = match parse_body(body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + match update(state, res, id, &obj, user).await { + Ok(true) => ok(json!({ "id": id })), + Ok(false) => fail(code::FAIL, "数据不存在"), + Err(e) => db_error(e, "更新"), + } +} + +/// 从 query 取 `ids`(官方删除端点的入参**在 query**,见前端 `delObj`)。 +/// +/// 🔴 官方 `ids` 是**逗号分隔的多个 id**(`VisualController.remove` 的 `ids` 是 String)。 +fn ids_param(raw: &RawQuery) -> String { + qv(raw, "ids") +} + +// ================================================================ 大屏基本信息(visual) +// +// 官方 `VisualController`(`/api/blade-visual/visual`)。 + +/// `GET /api/blade-visual/visual/list` —— 大屏分页。 +/// +/// 官方 `VisualController.java:118-126` ⇒ `ActionResult`(实际装 `VisualPageVO`)。 +pub async fn visual_list( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let mut filters: Vec<(&str, &str, String)> = Vec::new(); + let category = qv(&raw, "category"); + if !category.is_empty() { + filters.push(("CAST(category AS text)", "eq", category)); + } + let title = qv(&raw, "title"); + if !title.is_empty() { + filters.push(("title", "like", format!("%{}%", title))); + } + page_json(&state, &VISUAL, &raw, filters).await +} + +/// `GET /api/blade-visual/visual/category` —— 大屏分类列表(**裸数组**)。 +/// +/// 官方 `VisualController.java:133-139` ⇒ `ActionResult>`。 +pub async fn visual_category( + State(state): State, + headers: HeaderMap, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + match all(&state, &CATEGORY).await { + Ok(rows) => ok(Value::Array(rows)), + Err(e) => db_error(e, "大屏分类查询"), + } +} + +/// `GET /api/blade-visual/visual/detail` —— 大屏详情(**双段**:`visual` + `config`)。 +/// +/// 官方 `VisualController.java:147-156` ⇒ `ActionResult`, +/// `VisualInfoVO` = `{visual: VisualInfoModel, config: VisualConfigInfoModel}`。 +pub async fn visual_detail( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let id = qv(&raw, "id"); + if id.trim().is_empty() { + return fail(code::FAIL, "主键不能为空"); + } + let visual = match info(&state, &VISUAL, &id).await { + Ok(Some(v)) => v, + Ok(None) => return fail(code::FAIL, "数据不存在"), + Err(e) => return db_error(e, "大屏详情查询"), + }; + // `blade_visual_config` 的 `visual_id` 指向 `blade_visual.id`。 + let config = match state + .db + .query_json_params( + "SELECT id AS \"id\", visual_id AS \"visualId\", detail AS \"detail\", \ + component AS \"component\" \ + FROM blade_visual_config WHERE visual_id = $1::text LIMIT 1", + &[&id.trim()], + ) + .await + { + Ok(rows) => rows.into_iter().next(), + Err(e) => return db_error(e, "大屏配置查询"), + }; + ok(json!({ + "visual": visual, + "config": config.unwrap_or(Value::Null), + })) +} + +/// `POST /api/blade-visual/visual/save` —— 新增大屏(**双段 body**)。 +/// +/// 官方 `VisualController.java:164-176`:body 是 `VisualCrform` +/// = `{visual: {...}, config: {...}}` ⇒ 落 **`blade_visual` + `blade_visual_config` 两张表**。 +/// 返回 `ActionResult.success({id})`(官方只放 id)。 +pub async fn visual_save( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_DATA_SCREEN).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + let visual_obj = match obj.get("visual") { + Some(Value::Object(v)) => v.clone(), + _ => { + // 🔴 官方前端 `addObj` 一定发 `{visual, config}`;但本仓也容忍「扁平 body」 + // (官方 `VisualUpform` 的 `visual` 段本来也是对象)。 + obj.clone() + } + }; + let id = match create(&state, &VISUAL, &visual_obj, &user.user_id).await { + Ok(id) => id, + Err(e) => return db_error(e, "新增大屏"), + }; + // `config` 段(官方前端发 `{detail: JSON字符串, component: '[]'}`)。 + if let Some(Value::Object(cfg)) = obj.get("config") { + let mut cols: Vec<&str> = vec!["id", "visual_id", "f_tenant_id"]; + let mut slots: Vec = vec!["$1::text".to_string(), "$2::text".to_string(), "'0'".to_string()]; + let mut values: Vec> = vec![Some(new_uuid()), Some(id.clone())]; + for (json_key, col) in [("detail", "detail"), ("component", "component")] { + let Some(v) = cfg.get(json_key) else { continue }; + let Some(text) = param_of(v) else { continue }; + values.push(Some(text)); + cols.push(col); + slots.push(format!("${}::text", values.len())); + } + let sql = format!( + "INSERT INTO blade_visual_config ({}) VALUES ({})", + cols.join(", "), + slots.join(", ") + ); + if let Err(e) = state.db.exec_params(&sql, ¶ms_of(&values)).await { + return db_error(e, "新增大屏配置"); + } + } + ok(json!({ "id": id })) +} + +/// `POST /api/blade-visual/visual/update` —— 修改大屏(**双段 body**)。 +/// +/// 官方 `VisualController.java:184-192`:body 是 `VisualUpform` = `{visual, config}`。 +pub async fn visual_update( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_DATA_SCREEN).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + let visual_obj = match obj.get("visual") { + Some(Value::Object(v)) => v.clone(), + _ => obj.clone(), + }; + let id = visual_obj + .get("id") + .and_then(Value::as_str) + .unwrap_or_default() + .trim() + .to_string(); + if id.is_empty() { + return fail(code::FAIL, "主键不能为空"); + } + match update(&state, &VISUAL, &id, &visual_obj, &user.user_id).await { + Ok(true) => {} + Ok(false) => return fail(code::FAIL, "数据不存在"), + Err(e) => return db_error(e, "更新大屏"), + } + // `config` 段:有则更新 `blade_visual_config`。 + if let Some(Value::Object(cfg)) = obj.get("config") { + let mut sets: Vec = Vec::new(); + let mut values: Vec> = Vec::new(); + for (json_key, col) in [("detail", "detail"), ("component", "component")] { + let Some(v) = cfg.get(json_key) else { continue }; + values.push(param_of(v)); + sets.push(format!("{col} = ${}::text", values.len())); + } + if !sets.is_empty() { + values.push(Some(id.clone())); + let id_at = values.len(); + let sql = format!( + "UPDATE blade_visual_config SET {} WHERE visual_id = ${id_at}::text", + sets.join(", ") + ); + if let Err(e) = state.db.exec_params(&sql, ¶ms_of(&values)).await { + return db_error(e, "更新大屏配置"); + } + } + } + ok(json!({ "id": id })) +} + +/// `POST /api/blade-visual/visual/remove` —— 删除大屏(`ids` **在 query**)。 +/// +/// 官方 `VisualController.java:200-210` ⇒ `@RequestParam("ids")`。 +pub async fn visual_remove( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let ids = ids_param(&raw); + if ids.trim().is_empty() { + return fail(code::FAIL, "主键不能为空"); + } + // 官方连带删 `blade_visual_config`。 + for id in ids.split(',').map(str::trim).filter(|s| !s.is_empty()) { + if let Err(e) = remove(&state, &VISUAL, id).await { + return db_error(e, "删除大屏"); + } + let sql = "DELETE FROM blade_visual_config WHERE visual_id = $1::text"; + if let Err(e) = state.db.exec_params(sql, &[&id]).await { + return db_error(e, "删除大屏配置"); + } + } + ok(Value::Null) +} + +/// `POST /api/blade-visual/visual/copy` —— 复制大屏。 +/// +/// 官方 `VisualController.java:218-230`:标题加 `_复制` 后新建, +/// 返回 **`ActionResult.success(msg, entity.getId())`** ⇒ `data` 是**裸 id 字符串**。 +pub async fn visual_copy( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + let user = match guard(&state, &headers, EN_DATA_SCREEN).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let id = qv(&raw, "id"); + if id.trim().is_empty() { + return fail(code::FAIL, "主键不能为空"); + } + let entity = match info(&state, &VISUAL, &id).await { + Ok(Some(v)) => v, + Ok(None) => return fail(code::FAIL, "数据不存在"), + Err(e) => return db_error(e, "查询大屏"), + }; + let mut obj = Map::new(); + for key in ["title", "backgroundUrl", "category", "password", "status"] { + if let Some(v) = entity.get(key) { + obj.insert(key.to_string(), v.clone()); + } + } + // 官方:`entity.setTitle(entity.getTitle() + "_复制")`。 + let title = entity + .get("title") + .and_then(Value::as_str) + .unwrap_or_default() + .to_string(); + obj.insert("title".to_string(), json!(format!("{title}_复制"))); + let new_id = match create(&state, &VISUAL, &obj, &user.user_id).await { + Ok(v) => v, + Err(e) => return db_error(e, "复制大屏"), + }; + // `blade_visual_config` 一并复制。 + if let Ok(rows) = state + .db + .query_json_params( + "SELECT detail AS \"detail\", component AS \"component\" \ + FROM blade_visual_config WHERE visual_id = $1::text LIMIT 1", + &[&id.trim()], + ) + .await + { + if let Some(cfg) = rows.into_iter().next() { + let mut cols: Vec<&str> = vec!["id", "visual_id", "f_tenant_id"]; + let mut slots: Vec = vec!["$1::text".to_string(), "$2::text".to_string(), "'0'".to_string()]; + let mut values: Vec> = vec![Some(new_uuid()), Some(new_id.clone())]; + for (json_key, col) in [("detail", "detail"), ("component", "component")] { + let Some(v) = cfg.get(json_key) else { continue }; + let Some(text) = param_of(v) else { continue }; + values.push(Some(text)); + cols.push(col); + slots.push(format!("${}::text", values.len())); + } + let sql = format!( + "INSERT INTO blade_visual_config ({}) VALUES ({})", + cols.join(", "), + slots.join(", ") + ); + let _ = state.db.exec_params(&sql, ¶ms_of(&values)).await; + } + } + // 官方:`ActionResult.success(MsgCode.SU005.get(), entity.getId())` ⇒ 裸 id 字符串。 + ok(Value::String(new_id)) +} + +/// `GET /api/blade-visual/visual/Selector` —— 大屏下拉框(**两级树**)。 +/// +/// 官方 `VisualController.java:288-319` ⇒ `ActionResult>` +/// = `{list:[{id, fullName, hasChildren, children:[…]}]}`。 +/// +/// 🔴 **官方逻辑**:遍历**分类**,把 `category` 字段等于分类 `categoryValue`(**转成 int**) +/// 的大屏挂到该分类下;**分类下没有大屏就不输出这个分类**。 +pub async fn visual_selector( + State(state): State, + headers: HeaderMap, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let categories = match all(&state, &CATEGORY).await { + Ok(v) => v, + Err(e) => return db_error(e, "大屏分类查询"), + }; + let visuals = match all(&state, &VISUAL).await { + Ok(v) => v, + Err(e) => return db_error(e, "大屏列表查询"), + }; + let mut tree: Vec = Vec::new(); + for cat in &categories { + let cat_value = cat.get("categoryValue").and_then(Value::as_str).unwrap_or(""); + let cat_key = cat.get("categoryKey").and_then(Value::as_str).unwrap_or(""); + let cat_id = cat.get("id").and_then(Value::as_str).unwrap_or(""); + // 官方:`t.getCategory().equals(Integer.parseInt(category.getCategoryValue()))` + let wanted = match cat_value.parse::() { + Ok(n) => n, + // 🔴 `categoryValue` 不是数字 ⇒ 官方这里会抛 `NumberFormatException`; + // 本仓**跳过**该分类(不让一条脏数据打断整棵树)。 + Err(_) => continue, + }; + let mut children: Vec = Vec::new(); + for v in &visuals { + let v_cat = v.get("category").and_then(Value::as_i64).unwrap_or(-1); + if v_cat != wanted { + continue; + } + children.push(json!({ + "id": v.get("id").cloned().unwrap_or(Value::Null), + "fullName": v.get("title").cloned().unwrap_or(Value::Null), + "hasChildren": false, + "children": Value::Null, + })); + } + if children.is_empty() { + // 官方:`if (!visualAll.isEmpty())` ⇒ 空分类**不输出**。 + continue; + } + tree.push(json!({ + "id": cat_id, + "fullName": cat_key, + "hasChildren": true, + "children": children, + })); + } + ok(list_vo(tree)) +} + +/// `GET /api/blade-visual/visual/{type}` —— 获取图片列表。 +/// +/// 官方 `VisualController.java:265-282` ⇒ `ActionResult>`。 +/// 🔴 本仓**没有文件服务**(没有对象存储 / 只有office 之类的预览服务)⇒ 明确失败。 +pub async fn visual_files( + State(state): State, + headers: HeaderMap, + Path(_type): Path, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + unsupported("大屏图片文件列表(没有文件服务)") +} + +/// `POST /api/blade-visual/visual/put-file/{type}` —— 上传文件。 +/// +/// 官方 `VisualController.java:241-256` ⇒ `ActionResult`。 +/// 🔴 本仓没有文件服务 ⇒ 明确失败。 +pub async fn visual_put_file( + State(state): State, + headers: HeaderMap, + Path(_type): Path, + body: Bytes, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let _ = parse_body(&body).map(|_| ()); + unsupported("大屏文件上传(没有文件服务)") +} + +/// `POST /api/blade-visual/visual/{id}/Actions/ExportData` —— 导出大屏。 +/// +/// 官方 `VisualController.java:327-339` ⇒ `ActionResult`。 +/// 🔴 本仓没有文件导出服务 ⇒ 明确失败。 +pub async fn visual_export( + State(state): State, + headers: HeaderMap, + Path(_id): Path, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + unsupported("大屏导出(没有文件导出服务)") +} + +/// `POST /api/blade-visual/visual/Model/Actions/ImportData` —— 导入大屏。 +/// +/// 官方 `VisualController.java:348-359`(multipart)⇒ `ActionResult`。 +/// 🔴 本仓没有文件服务 ⇒ 明确失败。 +pub async fn visual_import( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let _ = parse_body(&body).map(|_| ()); + unsupported("大屏导入(没有文件服务)") +} + +/// `POST /api/blade-visual/visual/GetApiData` —— 获取 API 动态数据。 +/// +/// 官方 `VisualController.java:367-396`:返回类型是 **`String`**(**裸字符串**,不是信封!) +/// ⇒ 官方是拿它当「HTTP 透传」用。 +/// 🔴 本仓**不做任意 URL 转发**(SSRF 面)⇒ 明确失败。 +pub async fn visual_get_api_data( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let _ = parse_body(&body).map(|_| ()); + unsupported("大屏 API 动态数据(不做任意 URL 转发)") +} + +/// `POST /api/blade-visual/visual/proxy` —— 代理转发。 +/// +/// 官方 `VisualController.java:404-442`:返回 **`String`**(裸字符串)。 +/// 🔴 本仓不做任意 URL 转发 ⇒ 明确失败。 +pub async fn visual_proxy( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let _ = parse_body(&body).map(|_| ()); + unsupported("大屏代理转发(不做任意 URL 转发)") +} + +// ================================================================ 大屏分类(category) + +/// `GET /api/blade-visual/category/page` —— 大屏分类分页。 +/// +/// 官方 `VisualCategoryController.java:57-65` ⇒ `ActionResult>`。 +pub async fn category_page( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + page_json(&state, &CATEGORY, &raw, Vec::new()).await +} + +/// `GET /api/blade-visual/category/list` —— 大屏分类列表(**裸数组**)。 +/// +/// 官方 `VisualCategoryController.java:72-78` ⇒ `ActionResult>`。 +pub async fn category_list( + State(state): State, + headers: HeaderMap, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + match all(&state, &CATEGORY).await { + Ok(rows) => ok(Value::Array(rows)), + Err(e) => db_error(e, "大屏分类查询"), + } +} + +/// `GET /api/blade-visual/category/detail` —— 大屏分类详情。 +/// +/// 官方 `VisualCategoryController.java:86-95` ⇒ `ActionResult`。 +/// 🔴 官方这条**没有** `@SaCheckPermission` ⇒ 本仓也**只要求登录**。 +pub async fn category_detail( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let id = qv(&raw, "id"); + if id.trim().is_empty() { + return fail(code::FAIL, "主键不能为空"); + } + info_json(&state, &CATEGORY, &id).await +} + +/// `POST /api/blade-visual/category/save` —— 新增大屏分类。 +/// +/// 官方 `VisualCategoryController.java:100-111`:先查「模块值已存在」再创建。 +pub async fn category_save( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_DATA_SCREEN).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + // 官方:`categoryService.isExistByValue(entity.getCategoryValue(), entity.getId(), sysInfo.getId())` + if let Some(value) = obj.get("categoryValue").and_then(Value::as_str) { + if !value.trim().is_empty() { + let rows = match state + .db + .query_json_params( + "SELECT id AS \"id\" FROM blade_visual_category \ + WHERE category_value = $1::text AND COALESCE(is_deleted, 0) = 0 LIMIT 1", + &[&value.trim()], + ) + .await + { + Ok(r) => r, + Err(e) => return db_error(e, "大屏分类查重"), + }; + if !rows.is_empty() { + return fail(code::FAIL, "模块值已存在"); + } + } + } + create_json(&state, &CATEGORY, &body, &user.user_id).await +} + +/// `POST /api/blade-visual/category/update` —— 修改大屏分类。 +pub async fn category_update( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_DATA_SCREEN).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + let id = obj.get("id").and_then(Value::as_str).unwrap_or_default().trim().to_string(); + if id.is_empty() { + return fail(code::FAIL, "主键不能为空"); + } + // 官方同样先查重(排除自己)。 + if let Some(value) = obj.get("categoryValue").and_then(Value::as_str) { + if !value.trim().is_empty() { + let rows = match state + .db + .query_json_params( + "SELECT id AS \"id\" FROM blade_visual_category \ + WHERE category_value = $1::text AND id <> $2::text \ + AND COALESCE(is_deleted, 0) = 0 LIMIT 1", + &[&value.trim(), &id], + ) + .await + { + Ok(r) => r, + Err(e) => return db_error(e, "大屏分类查重"), + }; + if !rows.is_empty() { + return fail(code::FAIL, "模块值已存在"); + } + } + } + update_json(&state, &CATEGORY, &id, &body, &user.user_id).await +} + +/// `POST /api/blade-visual/category/remove` —— 删除大屏分类(`ids` **在 query**)。 +/// +/// 官方 `VisualCategoryController.java:140-151`:`delete(String ids)`(**无 `@RequestParam`** +/// ⇒ Spring 默认当 query 参数)。 +pub async fn category_remove( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let ids = ids_param(&raw); + if ids.trim().is_empty() { + return fail(code::FAIL, "主键不能为空"); + } + for id in ids.split(',').map(str::trim).filter(|s| !s.is_empty()) { + if let Err(e) = remove(&state, &CATEGORY, id).await { + return db_error(e, "删除大屏分类"); + } + } + ok(Value::Null) +} + +// ================================================================ 静态资源(assets) + +/// `GET /api/blade-visual/assets/list` —— 静态资源分页。 +/// +/// 官方 `VisualAssetsController.java:47-54` ⇒ `ActionResult>`。 +/// 🔴 官方这条**没有** `@SaCheckPermission` ⇒ 本仓也**只要求登录**。 +pub async fn assets_list( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let mut filters: Vec<(&str, &str, String)> = Vec::new(); + let name = qv(&raw, "assetsName"); + if !name.is_empty() { + filters.push(("assetsname", "like", format!("%{}%", name))); + } + page_json(&state, &ASSETS, &raw, filters).await +} + +/// `GET /api/blade-visual/assets/detail` —— 静态资源详情。 +pub async fn assets_detail( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let id = qv(&raw, "id"); + if id.trim().is_empty() { + return fail(code::FAIL, "主键不能为空"); + } + info_json(&state, &ASSETS, &id).await +} + +/// `POST /api/blade-visual/assets/save` —— 新增静态资源。 +pub async fn assets_save( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_DATA_SCREEN).await { + Ok(u) => u, + Err(resp) => return resp, + }; + create_json(&state, &ASSETS, &body, &user.user_id).await +} + +/// `POST /api/blade-visual/assets/update` —— 修改静态资源。 +pub async fn assets_update( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_DATA_SCREEN).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + let id = obj.get("id").and_then(Value::as_str).unwrap_or_default().trim().to_string(); + if id.is_empty() { + return fail(code::FAIL, "主键不能为空"); + } + update_json(&state, &ASSETS, &id, &body, &user.user_id).await +} + +/// `POST /api/blade-visual/assets/remove` —— 删除静态资源(`ids` **在 query**)。 +pub async fn assets_remove( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let ids = ids_param(&raw); + if ids.trim().is_empty() { + return fail(code::FAIL, "主键不能为空"); + } + for id in ids.split(',').map(str::trim).filter(|s| !s.is_empty()) { + if let Err(e) = remove(&state, &ASSETS, id).await { + return db_error(e, "删除静态资源"); + } + } + ok(Value::Null) +} + +// ================================================================ 大屏组件库(component) + +/// `GET /api/blade-visual/component/list` —— 组件库分页。 +/// +/// 官方 `VisualComponentController.java:51-58` ⇒ `ActionResult>`。 +/// 🔴 官方这条**没有** `@SaCheckPermission` ⇒ 本仓也**只要求登录**。 +pub async fn component_list( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let mut filters: Vec<(&str, &str, String)> = Vec::new(); + let name = qv(&raw, "name"); + if !name.is_empty() { + filters.push(("name", "like", format!("%{}%", name))); + } + let ctype = qv(&raw, "type"); + if !ctype.is_empty() { + filters.push(("CAST(type AS text)", "eq", ctype)); + } + page_json(&state, &COMPONENT, &raw, filters).await +} + +/// `GET /api/blade-visual/component/detail` —— 组件库详情。 +pub async fn component_detail( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let id = qv(&raw, "id"); + if id.trim().is_empty() { + return fail(code::FAIL, "主键不能为空"); + } + info_json(&state, &COMPONENT, &id).await +} + +/// `POST /api/blade-visual/component/save` —— 新增组件。 +pub async fn component_save( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_DATA_SCREEN).await { + Ok(u) => u, + Err(resp) => return resp, + }; + create_json(&state, &COMPONENT, &body, &user.user_id).await +} + +/// `POST /api/blade-visual/component/update` —— 修改组件。 +pub async fn component_update( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_DATA_SCREEN).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + let id = obj.get("id").and_then(Value::as_str).unwrap_or_default().trim().to_string(); + if id.is_empty() { + return fail(code::FAIL, "主键不能为空"); + } + update_json(&state, &COMPONENT, &id, &body, &user.user_id).await +} + +/// `POST /api/blade-visual/component/remove` —— 删除组件(`ids` **在 query**)。 +pub async fn component_remove( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let ids = ids_param(&raw); + if ids.trim().is_empty() { + return fail(code::FAIL, "主键不能为空"); + } + for id in ids.split(',').map(str::trim).filter(|s| !s.is_empty()) { + if let Err(e) = remove(&state, &COMPONENT, id).await { + return db_error(e, "删除组件"); + } + } + ok(Value::Null) +} + +// ================================================================ 全局变量(visual-global) + +/// `GET /api/blade-visual/visual-global/list` —— 全局变量分页。 +/// +/// 官方 `VisualGlobController.java:51-58` ⇒ `ActionResult>`。 +pub async fn glob_list( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let mut filters: Vec<(&str, &str, String)> = Vec::new(); + let name = qv(&raw, "globalName"); + if !name.is_empty() { + filters.push(("globalname", "like", format!("%{}%", name))); + } + page_json(&state, &GLOB, &raw, filters).await +} + +/// `GET /api/blade-visual/visual-global/detail` —— 全局变量详情。 +pub async fn glob_detail( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let id = qv(&raw, "id"); + if id.trim().is_empty() { + return fail(code::FAIL, "主键不能为空"); + } + info_json(&state, &GLOB, &id).await +} + +/// `POST /api/blade-visual/visual-global/save` —— 新增全局变量。 +pub async fn glob_save( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_DATA_SCREEN).await { + Ok(u) => u, + Err(resp) => return resp, + }; + create_json(&state, &GLOB, &body, &user.user_id).await +} + +/// `POST /api/blade-visual/visual-global/update` —— 修改全局变量。 +pub async fn glob_update( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_DATA_SCREEN).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + let id = obj.get("id").and_then(Value::as_str).unwrap_or_default().trim().to_string(); + if id.is_empty() { + return fail(code::FAIL, "主键不能为空"); + } + update_json(&state, &GLOB, &id, &body, &user.user_id).await +} + +/// `POST /api/blade-visual/visual-global/remove` —— 删除全局变量(`ids` **在 query**)。 +pub async fn glob_remove( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let ids = ids_param(&raw); + if ids.trim().is_empty() { + return fail(code::FAIL, "主键不能为空"); + } + for id in ids.split(',').map(str::trim).filter(|s| !s.is_empty()) { + if let Err(e) = remove(&state, &GLOB, id).await { + return db_error(e, "删除全局变量"); + } + } + ok(Value::Null) +} + +// ================================================================ 数据源配置(db) + +/// `GET /api/blade-visual/db/list` —— 数据源分页。 +/// +/// 官方 `VisualDbController.java:58-65` ⇒ `ActionResult>`。 +pub async fn db_list( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + page_json(&state, &DB, &raw, Vec::new()).await +} + +/// `GET /api/blade-visual/db/db-list` —— 下拉数据源(**裸数组**)。 +/// +/// 官方 `VisualDbController.java:72-78` ⇒ `ActionResult>`。 +/// 🔴 `VisualDbSelectVO` 只要 `driverClass` / `name` / `id`(**不要 url / username**)。 +pub async fn db_select_list( + State(state): State, + headers: HeaderMap, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + match all(&state, &DB).await { + Ok(rows) => { + let list: Vec = rows + .iter() + .map(|r| { + json!({ + "id": r.get("id").cloned().unwrap_or(Value::Null), + "name": r.get("name").cloned().unwrap_or(Value::Null), + "driverClass": r.get("driverClass").cloned().unwrap_or(Value::Null), + }) + }) + .collect(); + ok(Value::Array(list)) + } + Err(e) => db_error(e, "数据源查询"), + } +} + +/// `GET /api/blade-visual/db/detail` —— 数据源详情。 +pub async fn db_detail( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let id = qv(&raw, "id"); + if id.trim().is_empty() { + return fail(code::FAIL, "主键不能为空"); + } + info_json(&state, &DB, &id).await +} + +/// `POST /api/blade-visual/db/submit` —— 新增或修改数据源。 +/// +/// 官方 `VisualDbController.java:101-113`:**有 id 就改,没 id 就增**(同一个端点)。 +pub async fn db_submit( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_DATA_SCREEN).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + let id = obj.get("id").and_then(Value::as_str).unwrap_or_default().trim().to_string(); + if id.is_empty() { + create_json(&state, &DB, &body, &user.user_id).await + } else { + update_json(&state, &DB, &id, &body, &user.user_id).await + } +} + +/// `POST /api/blade-visual/db/remove` —— 删除数据源(`ids` **在 query**)。 +pub async fn db_remove( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let ids = ids_param(&raw); + if ids.trim().is_empty() { + return fail(code::FAIL, "主键不能为空"); + } + for id in ids.split(',').map(str::trim).filter(|s| !s.is_empty()) { + if let Err(e) = remove(&state, &DB, id).await { + return db_error(e, "删除数据源"); + } + } + ok(Value::Null) +} + +/// `POST /api/blade-visual/db/db-test` —— 数据源测试连接。 +/// +/// 官方 `VisualDbController.java:139-150`:解密密码后**真的去连外部数据库**。 +/// 🔴 本仓**不连外部数据库** ⇒ 明确失败(绝不返「连接成功」的假答案)。 +pub async fn db_test( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let _ = parse_body(&body).map(|_| ()); + unsupported("数据源测试连接(本引擎不连外部数据库)") +} + +/// `POST /api/blade-visual/db/dynamic-query` —— 动态执行 SQL。 +/// +/// 官方 `VisualDbController.java:158-169`:在**外部数据源**上执行前端传来的 SQL。 +/// 🔴 本仓不执行外部 SQL ⇒ 明确失败。 +pub async fn db_dynamic_query( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let _ = parse_body(&body).map(|_| ()); + unsupported("数据源动态 SQL(本引擎不执行外部 SQL)") +} + +// ================================================================ 大屏地图(map) + +/// `GET /api/blade-visual/map/lazy-list` —— 地图懒加载列表(**裸数组**)。 +/// +/// 官方 `VisualMapController.java:51-65` ⇒ `ActionResult.success(MsgCode.SU005.get(), list)` +/// ⇒ `data` 是**裸数组**(不是 `VisualPageVO`!)。 +/// +/// 🔴 官方逐条填 `hasChildren`(该节点是否有子节点)和 `parentName`(父节点名)。 +pub async fn map_lazy_list( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let parent_id = qv(&raw, "parentId"); + let rows = match all(&state, &MAP).await { + Ok(v) => v, + Err(e) => return db_error(e, "地图查询"), + }; + // 父节点名(官方:`getBaseService().getInfo(pagination.getParentId())`)。 + let parent_name = if parent_id.trim().is_empty() { + None + } else { + match info(&state, &MAP, &parent_id).await { + Ok(Some(p)) => p.get("name").and_then(Value::as_str).map(str::to_string), + _ => None, + } + }; + // 懒加载:官方 `getListWithColnums(pagination, ...)` 按 `parentId` 过滤。 + let filtered: Vec = rows + .into_iter() + .filter(|r| { + if parent_id.trim().is_empty() { + // 🔴 官方懒加载的**根**是 `parentId` 为空的行。 + r.get("parentId") + .and_then(Value::as_str) + .map(str::trim) + .map(|s| s.is_empty() || s == "0") + .unwrap_or(true) + } else { + r.get("parentId").and_then(Value::as_str) == Some(parent_id.trim()) + } + }) + .collect(); + // `hasChildren`:该节点是否还有子节点。 + let mut list: Vec = Vec::new(); + for r in filtered { + let id = r.get("id").and_then(Value::as_str).unwrap_or_default().to_string(); + let has_children = rows_have_child(&state, &id).await; + let mut item = r.clone(); + if let Some(obj) = item.as_object_mut() { + obj.insert("hasChildren".to_string(), json!(has_children)); + obj.insert( + "parentName".to_string(), + match &parent_name { + Some(n) => json!(n), + None => Value::Null, + }, + ); + } + list.push(item); + } + ok(Value::Array(list)) +} + +/// 该节点是否有子节点。 +async fn rows_have_child(state: &AppState, id: &str) -> bool { + if id.trim().is_empty() { + return false; + } + match state + .db + .query_json_params( + "SELECT id AS \"id\" FROM blade_visual_map WHERE parent_id = $1::text LIMIT 1", + &[&id.trim()], + ) + .await + { + Ok(rows) => !rows.is_empty(), + Err(_) => false, + } +} + +/// `GET /api/blade-visual/map/detail` —— 地图详情。 +/// +/// 官方 `VisualMapController.java:73-78` ⇒ `ActionResult`。 +/// 🔴 官方这条**没有** `@SaCheckPermission` ⇒ 本仓也**只要求登录**。 +pub async fn map_detail( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let id = qv(&raw, "id"); + if id.trim().is_empty() { + return fail(code::FAIL, "主键不能为空"); + } + info_json(&state, &MAP, &id).await +} + +/// `GET /api/blade-visual/map/data` —— 地图数据详情。 +/// +/// 官方 `VisualMapController.java:137-143`:返回类型是 **`String`** ⇒ **裸字符串** +/// (`entity.getData()`,即地图 geojson 文本)。 +/// +/// 🔴 本仓的地图 geojson 需要**地图服务**(高德/百度)⇒ 没有数据时**明确失败**, +/// 绝不返假坐标。 +pub async fn map_data( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let id = qv(&raw, "id"); + if id.trim().is_empty() { + return fail(code::FAIL, "主键不能为空"); + } + let row = match info(&state, &MAP, &id).await { + Ok(Some(v)) => v, + Ok(None) => return fail(code::FAIL, "数据不存在"), + Err(e) => return db_error(e, "地图数据查询"), + }; + match row.get("data").and_then(Value::as_str) { + Some(d) if !d.trim().is_empty() => ok(Value::String(d.to_string())), + _ => fail(code::FAIL, "地图数据为空(没有地图服务数据源)"), + } +} + +/// `POST /api/blade-visual/map/save` —— 新增地图。 +pub async fn map_save( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_DATA_SCREEN).await { + Ok(u) => u, + Err(resp) => return resp, + }; + create_json(&state, &MAP, &body, &user.user_id).await +} + +/// `POST /api/blade-visual/map/update` —— 修改地图。 +pub async fn map_update( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_DATA_SCREEN).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + let id = obj.get("id").and_then(Value::as_str).unwrap_or_default().trim().to_string(); + if id.is_empty() { + return fail(code::FAIL, "主键不能为空"); + } + update_json(&state, &MAP, &id, &body, &user.user_id).await +} + +/// `POST /api/blade-visual/map/remove` —— 删除地图(`ids` **在 query**)。 +pub async fn map_remove( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let ids = ids_param(&raw); + if ids.trim().is_empty() { + return fail(code::FAIL, "主键不能为空"); + } + for id in ids.split(',').map(str::trim).filter(|s| !s.is_empty()) { + if let Err(e) = remove(&state, &MAP, id).await { + return db_error(e, "删除地图"); + } + } + ok(Value::Null) +} + +// ================================================================ 数据集配置(record) + +/// `GET /api/blade-visual/record/list` —— 数据集分页。 +/// +/// 官方 `VisualRecordController.java:51-58` ⇒ `ActionResult>`。 +pub async fn record_list( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let mut filters: Vec<(&str, &str, String)> = Vec::new(); + let name = qv(&raw, "name"); + if !name.is_empty() { + filters.push(("name", "like", format!("%{}%", name))); + } + page_json(&state, &RECORD, &raw, filters).await +} + +/// `GET /api/blade-visual/record/detail` —— 数据集详情。 +pub async fn record_detail( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let id = qv(&raw, "id"); + if id.trim().is_empty() { + return fail(code::FAIL, "主键不能为空"); + } + info_json(&state, &RECORD, &id).await +} + +/// `POST /api/blade-visual/record/save` —— 新增数据集。 +pub async fn record_save( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_DATA_SCREEN).await { + Ok(u) => u, + Err(resp) => return resp, + }; + create_json(&state, &RECORD, &body, &user.user_id).await +} + +/// `POST /api/blade-visual/record/update` —— 修改数据集。 +pub async fn record_update( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_DATA_SCREEN).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + let id = obj.get("id").and_then(Value::as_str).unwrap_or_default().trim().to_string(); + if id.is_empty() { + return fail(code::FAIL, "主键不能为空"); + } + update_json(&state, &RECORD, &id, &body, &user.user_id).await +} + +/// `POST /api/blade-visual/record/remove` —— 删除数据集(`ids` **在 query**)。 +pub async fn record_remove( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_DATA_SCREEN).await { + return resp; + } + let ids = ids_param(&raw); + if ids.trim().is_empty() { + return fail(code::FAIL, "主键不能为空"); + } + for id in ids.split(',').map(str::trim).filter(|s| !s.is_empty()) { + if let Err(e) = remove(&state, &RECORD, id).await { + return db_error(e, "删除数据集"); + } + } + ok(Value::Null) +} diff --git a/src/backend/src/routes.rs b/src/backend/src/routes.rs index b923cf8..3f02caf 100644 --- a/src/backend/src/routes.rs +++ b/src/backend/src/routes.rs @@ -1542,7 +1542,89 @@ pub fn build_router(state: AppState) -> axum::Router { .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/*` 在官方是「独立部署的第三方服务」** diff --git a/src/backend/tests/visualdata_it.rs b/src/backend/tests/visualdata_it.rs new file mode 100644 index 0000000..0e21f67 --- /dev/null +++ b/src/backend/tests/visualdata_it.rs @@ -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 = 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::().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}"); +}