From cf154d50ff6e6a241d85e6bf8a4788e42336eded Mon Sep 17 00:00:00 2001 From: admin Date: Mon, 2 Nov 2026 16:01:24 +0800 Subject: [PATCH] =?UTF-8?q?feat(onlineDev):=20=E8=A1=A5=E9=BD=90=20onlineD?= =?UTF-8?q?ev=2078=20=E6=9D=A1=20+=20=E5=9C=A8=E7=BA=BF=E6=8A=A5=E8=A1=A8?= =?UTF-8?q?=2023=20=E6=9D=A1=E7=AB=AF=E7=82=B9=E5=B9=B6=E5=90=8C=E6=AD=A5?= =?UTF-8?q?=E5=A5=91=E7=BA=A6=E4=B8=89=E5=A4=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 契约面(面 B):从 487 涨到 588 条,官方端点覆盖 474/580 -> 574/580。 实现 - platform/compat/online_dev.rs:表单设计 / 门户 / 短链 / 在线数据 / 个人化 / 日志 / 分享 / OCR / 行政区划 / 仪表盘 共 78 条 - platform/compat/report.rs:在线报表 23 条(模板 / 版本 / 菜单) - 报表元数据就地落库(report_template + report_version,官方 DDL 逐字导入): 官方 /api/Report/* 属独立部署的第三方报表服务,主后端无对应 Controller 契约与尺子 - 新增 scripts/gen-contract-endpoints.py:从代码真实路由自动生成 [ENDPOINT] 与 [OFFICIAL] 两段(守卫复用扫描器同一套推导,幂等、不覆盖已登记条目) - check-contract-scan.py 修复守卫推导:三段路径解析、compat 文件纳入 plat_files、 跨文件常量回落、「无守卫」判据(原先 compat 模块守卫全部推不出,CC6 静默失效) - docs/contract.md 三处同步:+101 条端点、+101 条官方台账、面 B 计数 457 -> 558 修复的真 bug(集成测试抓到,静态闸门看不出来) - 3 处 SQL 引用官方 DDL 里不存在的列:base_visual_release.f_platform_release、 base_system.f_app_key/f_app_name、base_notice.f_full_name(官方是 f_title) - 3 处官方契约形状偏差:getReleaseMenu 返裸对象(非 ListVO)、 systemFilter 按官方 SystemListVO 投影(且官方忽略 category 入参)、 Dashboard/Notice 返 ListVO 且入参 typeList 是数组 - visual_dev_list 计数 SQL 参数个数与 $N 不匹配;visual_dev_update 漏写 f_last_modify_user_id;report_save_version 模板 id 兼容 id 且返 data:null 测试 - 新增 tests/batch17_it.rs:11 个集成测试(含 101 条端点逐条打一遍防 matchit 参数名冲突) 数字:check-contract PASS=10 FAIL=0;cargo test --workspace 全绿 0 failed; fe-gap 541/900(onlineDev 100/101、permission 137/137、system 196/196) --- .workbuddy/memory/2026-11-02.md | 98 + HANDOFF.md | 193 +- crates/sspf-store/src/db.rs | 32 +- docs/contract.md | 205 +- scripts/check-contract-scan.py | 130 +- scripts/gen-contract-endpoints.py | 403 +++ src/backend/db/schema.sql | 66 + src/backend/src/main.rs | 7 + src/backend/src/platform/compat/mod.rs | 2 + src/backend/src/platform/compat/online_dev.rs | 3174 +++++++++++++++++ src/backend/src/platform/compat/report.rs | 1338 +++++++ src/backend/src/routes.rs | 131 + src/backend/tests/batch17_it.rs | 768 ++++ 13 files changed, 6495 insertions(+), 52 deletions(-) create mode 100644 scripts/gen-contract-endpoints.py create mode 100644 src/backend/src/platform/compat/online_dev.rs create mode 100644 src/backend/src/platform/compat/report.rs create mode 100644 src/backend/tests/batch17_it.rs diff --git a/.workbuddy/memory/2026-11-02.md b/.workbuddy/memory/2026-11-02.md index c993dd8..e1adcbc 100644 --- a/.workbuddy/memory/2026-11-02.md +++ b/.workbuddy/memory/2026-11-02.md @@ -145,3 +145,101 @@ ### commit 提示 批次 16 落地 + 契约/测试闭环;提交信息照 CHANGELOG 风格:影响 + 改动 bullet(含「f_object_type 全小写」修复)。 + +--- + +## 批次 17(2026-11-02 下午)—— onlineDev 收尾(78 条)+ 在线报表(23 条)+ 契约三处同步 + +### 做了什么 +- `platform/compat/online_dev.rs`(新):**78 条** `/api/visualdev/*` + `/api/system/PortalManage/*` + + `/api/system/atlas/*` + `/api/blade-visual/visual/Selector`。 +- `platform/compat/report.rs`(新):**23 条** `/api/Report/*`,新增表 `report_template` + `report_version` + (官方 PostgreSQL DDL 逐字导入)。 +- `compat/mod.rs` 加 `pub mod report;`;`routes.rs` 注册 **101 条字面量** `.route(...)`。 +- `scripts/gen-contract-endpoints.py`(新):从代码真实路由自动生成契约 `[ENDPOINT]` + `[OFFICIAL]` 行, + 守卫直接调扫描器的 `guard_of_platform` ⇒ 不可能手抖;**幂等**(再跑报 +0);**不覆盖**已登记条目。 + +### 契约面的命名决定(用户已确认,别改回去) +- 契约面**按官方模块名**分文件:`compat/{core,helper,message,online_dev,permission,report,scheduletask,system}.rs` +- **没有 `jnpf` 这一级**(用户 2026-11-02 明确:「这个项目本来就要弱化 jnpf 概念」) +- 通用 helper 独立成 `helper`(不叫 `face_b` / `face_c` / `face_common`) + +### 🔴 扫描器守卫推导的三处修复(不改的话 CC6 静默失效) +1. `HANDLER_RE` 支持**三段** `compat::<模块>::`(旧版只认一段 ⇒ 取到 `compat` 这个目录) +2. `scan_code` 把 `platform/compat/*.rs` 以 `compat__<名>` 收进 `plat_files` +3. `guard_of_platform` 用 `mod_path` 含 `::` 判断走 `compat__<名>` 还是根目录 `<名>` ++ **全局常量表**(`plat_consts`):守卫常量集中在 `compat/helper.rs` ⇒ `resolve_const` 找不到时回落查表; + 同名不同值 ⇒ 置 `None`(宁可推不出也不假推) ++ **「无守卫」判据**:handler 里**没有任何** `guard`/`guard_any`/`require_login`/`require_module` ⇒ 「无」 + +### 🔴 官方 `/api/Report/*` 是独立部署的第三方服务 +`jnpf-java-datareport-univer`(端口 32000,`ReportDomain: http://127.0.0.1:32000`)—— +主后端 `jnpf-java-boot` 里**没有** `/api/Report` Controller,也**没有** `report_version` 实体 +⇒ 本仓把报表元数据**就地落库**;`[OFFICIAL]` 的 `src` 指官方前端 `api/onlineDev/report.ts`。 + +### 🔴 `data` 的形状五种并存(Report 一族) +`PageListVO` / 裸数组 / 裸对象 / 裸 id 字符串 / `{queryList:""}` ⇒ +**判据:看官方前端的消费点,不看 Java 返回类型。** + +### 数字 +- 契约端点 **588**(A 28 + B **558** + 共用 2);`tables` → **67**(`BASE_TABLES` 64) +- `check-contract` **PASS=10 FAIL=0**;官方端点覆盖 **574/580**(implemented 469 / partial 105 / absent 6;oos 4) +- `fe-gap` 合计 **541/900(60.1%)**;**`onlineDev` 100/101(99.0%)**、`permission` 137/137、`system` 196/196、`systemData` 103/106 +- `cargo test --offline --workspace` 全绿 0 failed(主 lib 105 passed) +- `verify.sh --fast` 全 ✅(47.7s;注:本环境 grep 被转发壳接管,耗时被放大数倍,不是闸门真慢) + +### 剩余 +- `core` 22 条 / `workFlow` 104 条(下一批做 core) +- 暂缓:aiCenter 75 / extend 64 / msgCenter 50 / teamwork 40 +- ⏸️ **onlineDev 集成测试未写**(`tests/batch17_it.rs`)—— 静态尺子看不出 `matchit` 参数名冲突 ⇒ 必须补 + +--- + +## 批次 17 收尾补修(契约对齐 + SQL 列名)— 2026-11-02 续 + +### 🔴🔴 教训:静态闸门全绿 ≠ SQL 对(表名对、列名错只有真查库才炸) +批次 17 的集成测试日志抓出 3 处**引用了官方 DDL 里根本不存在的列**: +1. `base_visual_release.f_platform_release` —— 官方 `base_visual_release` **没这列**(只有 `base_visual_dev` 有) +2. `base_system.f_app_key` / `f_app_name` —— 官方 `base_system` 只有 `f_portal_id`/`f_app_portal_id`/`f_property_json`/`f_background_color`/`f_user_id`/`f_authorize_id`/`f_tag_id` +3. `base_notice.f_full_name` —— 官方 `NoticeEntity` 的标题列是 **`f_title`**,`f_description` ⇒ 官方 `excerpt` + +🔴 **查列的快捷法**:`python3` 扫 `src/backend/db/schema.sql` 的 `CREATE TABLE` 块; +官方 DDL 在 `~/Desktop/workspace/jnpf/jnpf-database/`(逐字对齐的官方 PostgreSQL DDL)。 +🔴 **断言过了 ≠ 对**:测试 `code=200` 但日志里是 PG ERROR ⇒ 必须**读日志**。 + +### 🔴 同批修的 3 处「官方契约形状偏差」(查官方 Java + 官方前端消费点得到) +1. **`GET /api/visualdev/Base/{id}/getReleaseMenu`** —— 官方 `VisualdevController.java:738` + 是 `visualdevService.getById(id)` ⇒ `ActionResult`(**单条 `base_visual_dev`**); + 官方消费点 `CreateMenuModal.vue:56-59` 是 `state.record = res.data` ⇒ **裸对象**。 + 本仓原先查 `base_visual_release` 返 `ListVO` ⇒ 形状 + 列**双重错**。 + 官方 `pcIsRelease/appIsRelease/pcReleaseName/appReleaseName` 来自「菜单发布记录」表 + ⇒ 本仓无该表 ⇒ 如实给 `0` / 空串。 +2. **`GET /api/visualdev/Portal/systemFilter/{id}`** —— 官方 VO 是 + `jnpf.base.model.base.SystemListVO` = `id/fullName/enCode/icon/sortCode/backgroundColor/ + userId/hasUpdate/hasDelete/isTop`(**没有** `isMain/appKey/appName/urlAddress`)。 + 🔴 官方 `PortalServiceImpl.java:229` 的 `systemFilterList` **直接忽略** `id` 和 `category` + (`systemApi.getList(null, true, true)`)⇒ 本仓也**不按 category 过滤**(照抄官方口径)。 +3. **`POST /api/visualdev/Dashboard/Notice`** —— 官方 `DashboardController.java:45` + 返 `ActionResult>`(**不是** `PageListVO`); + 官方消费点 `components/VisualPortal/Design/hooks/useTable.ts:136-137` 是 `res.data.list || []`。 + 入参官方 `NoticeModel { typeList: List }`(**数组**,见 `useTable.ts:135`) + ⇒ 本仓原先读单值 `type` + 返 `PageListVO` ⇒ 双错。 + 官方 `NoticeVO` 字段:`id/fullName/creatorTime/creatorUser/releaseUser/releaseTime/ + category/coverImage/excerpt/lastModifyTime/lastModifyUserId` + ⇒ `base_notice.f_description` 要投影成 **`excerpt`**。 + +### 🔴 新增 3 个集成测试(`tests/batch17_it.rs`,8 → 11 个) +`release_menu_returns_bare_object_not_list` / +`system_filter_returns_official_system_list_vo_shape` / +`dashboard_notice_returns_list_vo_and_accepts_type_list` +🔴 **`matchit` 同位置不能有两个参数名 ⇒ 启动即 panic**:静态闸门看不出来、编译也过,只有真跑才炸。 + +### 数字 +- `batch17_it` **11 passed / 0 failed**;`cargo test --offline --workspace` 全绿 0 failed +- `check-contract` **PASS=10 FAIL=0**;`verify.sh --fast` 全 ✅(41.8s) +- `fe-gap` 合计 **541/900(60.1%)**(**没退化**);官方覆盖 **574/580**(没退化) + +### 剩余 +- `core` 22 条 / `workFlow` 104 条(下一批做 core) +- 暂缓:aiCenter 75 / extend 64 / msgCenter 50 / teamwork 40 +- ⏸️ 批次 17 的代码与文档**还没 git commit** diff --git a/HANDOFF.md b/HANDOFF.md index 818d7e0..474f677 100644 --- a/HANDOFF.md +++ b/HANDOFF.md @@ -351,17 +351,37 @@ React 模板的加模块成本 = **改/加 8 个文件、15~20 分钟**(`HOWTO --- -## 1. 一句话现状(2026-11-02 批次 16 收尾) +## 1. 一句话现状(2026-11-02 批次 17 收尾 + 契约对齐补修) **📌 当前数字(以此为准,下面各批的「当时数字」仅存档)**: -- 契约端点 **487 条**(面 A 28 + 面 B **457** + 两面共用 2);`tables` → **65** - (`BASE_TABLES` 62:有 3 张表只在 `schema.sql` 里、不进自检清单;批次 16 复用既有表,**未新增表**)。 -- `cargo test --offline --workspace` = **620 passed / 0 failed**(41 个测试二进制)。 -- 十二道闸门全绿;`check-contract` `PASS=10 FAIL=0`,官方端点覆盖 **473/479** - (implemented 399 / partial 74 / absent 6;oos 4 单列)。 -- `python3 scripts/fe-gap.py`:合计 **441 / 900(49.0%)**,**`permission` 137/137(100%)**、 - **`system` 196/196(100%)**、**`systemData` 103/106(97.2%)**。 +- 契约端点 **588 条**(面 A 28 + 面 B **558** + 两面共用 2);`tables` → **67** + (`BASE_TABLES` 64;批次 17 新增 `report_template` + `report_version` 两张**官方 DDL 逐字导入**的表)。 +- `cargo test --offline --workspace` = **全绿 0 failed**(主 lib 105 passed; + `batch17_it` **11 passed**)。 +- 十二道闸门全绿;`check-contract` `PASS=10 FAIL=0`,官方端点覆盖 **574/580** + (implemented 469 / partial 105 / absent 6;oos 4 单列)。 +- `python3 scripts/fe-gap.py`:合计 **541 / 900(60.1%)**、**`onlineDev` 100/101(99.0%)**、 + **`permission` 137/137(100%)**、**`system` 196/196(100%)**、**`systemData` 103/106(97.2%)**。 +- 🔴 **批次 17 收尾补修:3 处「引用了官方 DDL 里不存在的列」的 SQL 已修** + (`base_visual_release.f_platform_release` / `base_system.f_app_key`+`f_app_name` / + `base_notice.f_full_name`)⇒ 这 3 条**静态闸门全绿时也是坏的**,只有真跑才炸 + ⇒ 已补 3 个集成测试(`release_menu_returns_bare_object_not_list` / + `system_filter_returns_official_system_list_vo_shape` / + `dashboard_notice_returns_list_vo_and_accepts_type_list`)把形状钉住。 + 同批还修了 3 处**官方契约形状偏差**(详见 §5「批次 17 新增的坑」末 3 条)。 +- 🔴 **批次 17 把 onlineDev 收尾了**(101 条里的最后 78 条)+ **Report 23 条** + ⇒ 契约端点从 487 涨到 588,官方覆盖从 473/479 涨到 574/580。 + `fe-gap` 的 `onlineDev` 列从 22/101(批次 16 时)跳到 **100/101**。 + 剩的 1 条是 `docs/fe/endpoints.tsv` 的**旧记录**(官方实际是 `/api/visualdev/ShortLink/Config`, + **无路径参数**,已在本仓实现)⇒ **不是待办**。 +- 🔴 **契约面实现按「官方模块名」分文件**(不再有 `face_b` / `face_c` 那一层): + `platform/compat/{core,helper,message,online_dev,permission,report,scheduletask,system}.rs` + ⇒ 路由注册写成 `compat::<模块>::`。 + 🔴 **这个改动让契约扫描器的守卫推导一度全失效**(`HANDLER_RE` 只认一段 `::` + ⇒ `compat::online_dev::x` 被解析成 `compat` ⇒ 推出不了守卫 ⇒ CC6 静默退化成全是 WARN) + —— 已修,详见 §5「批次 17 新增的坑」。 + 🔴 **`permission` 也清零了**:批次 16 把最后 26 条(角色绑定/在线用户/自定义范围/工作详情/第三方账号/导入导出)补齐, 其中 **12 条导入导出 + socials 两条 = 明确业务失败**(本仓无文件服务/无第三方登录配置),**没有一条假数据**。 `fe-gap` 的 `permission` 列从 111/137 跳到 137/137。 @@ -1008,6 +1028,48 @@ CRUD 落 `base_time_task`(数据真实、可编辑、重启不丢),`runCou 指纹非 token、按指纹精确删除、SelectedList `--` 保留与顺序、OrganizeCondition `$` 明确失败、getWorkByUser `flow` 空/`app` 真、socials 两条失败、ImportData 真落库 + 判重 + `type=true` 拒绝、12 条导出拒绝。 +### 批次 17(2026-11-02)—— onlineDev 收尾(78 条)+ 在线报表(23 条)+ 契约三处同步 + +**101 条面 B 端点**(新增表 2 张:`report_template` + `report_version`,**官方 DDL 逐字导入**): +- **onlineDev 78 条**(`platform/compat/online_dev.rs`):`visualdev/Base` 全族(14)、 + `visualdev/Generater`(4)、`visualdev/OnlineDev`(15)、`visualdev/ShortLink`(8)、 + `visualdev/Personal`(5)、`visualdev/OnlineLog`(1)、`visualdev/share`(4)、 + `visualdev/ocr`(1)、`visualdev/Portal`(15)、`visualdev/Dashboard`(2)、 + `system/PortalManage`(5)、`system/atlas`(2)、`blade-visual/visual/Selector`(1)。 +- **Report 23 条**(`platform/compat/report.rs`):`/api/Report/*` 全族。 + +🔴 **Report 在官方是「独立部署的第三方服务」**(`jnpf-java-datareport-univer`,端口 32000, +`ReportDomain: http://127.0.0.1:32000`)—— 主后端 `jnpf-java-boot` 里**没有** `/api/Report` +的 Controller,也**没有任何** `report_version` 的 Java 实体(只有 `ReportExportUtil.java:29` 拼远程 URL) +⇒ 本仓把报表**元数据就地落库**(表结构照官方 DDL 逐字导入)。 + +🔴 **`data` 的形状逐条照官方前端的消费点定**(这一族最容易做错,四种形状并存): +| 形状 | 端点 | 官方消费点 | +|---|---|---| +| `PageListVO` `{pagination,list}` | `GET /api/Report` | `adapter/vxe-table.ts` 的 `proxyConfig.response` | +| **裸数组** | `GET /api/Report/Version/{id}` | `components/Report/src/index.vue:127` `state.versionList = res.data \|\| []` | +| **裸对象** | `GET /api/Report/{id}`、`GET /api/Report/Info/{id}` | `state.dataForm = res.data` | +| **裸字符串**(id) | `POST /api/Report`、`POST /api/Report/Info/{id}` | `state.dataForm.id = res.data` | +| **裸对象** `{queryList:""}` | `GET /api/Report/data/{id}/getQueryList` | 官方自己 `JSON.parse(res.data.queryList)` ⇒ **不能返解析后的数组** | +| `ListVO` `{list:[…]}` | `GET /api/Report/Selector` | `views/permission/menu/Form.vue:392` `state.reportData = res.data.list` | + +🔴 **诚实失败原则**(沿用批次 14/15/16):本仓无文件服务 / 无 Univer 渲染器 / 无数据引擎 / 无代码生成器 +⇒ 一律 `code=400` + `data:null` + 人话,**不返假 URL、不返空数组**。批次 17 的 101 条里 +**31 条是 `partial`**(`[OFFICIAL]` 台账已标注原因)。 + +🔴 **审计列语义**(本仓特有,踩过):`f_creator_user_id` 存**账号**(`seed.rs` 的 `ADMIN_ACCOUNT`) +**不是 id** ⇒ 写审计列一律用 `user.account`;`f_last_modify_time` 用 SQL `now()` **不占参数位**。 + +🔴 **契约三处同步(101 条)**:新增 `scripts/gen-contract-endpoints.py` —— +从**代码真实路由**自动生成 `[ENDPOINT]`(5 列)与 `[OFFICIAL]`(5 列)登记行, +守卫直接调用扫描器的 `guard_of_platform`(与 CC6 **同一套**规则)⇒ **不可能手抖**。 +**幂等**:再跑一次报 `+0 条`。已登记的条目**不覆盖**(人工写的 note 不会被冲掉)。 + +🔴 **官方出处的三种形态**(`[OFFICIAL]` 的 `src` 列): +① 官方 Java Controller 的 `@XxxMapping` 行号(`VisualdevController.java:134` 这种); +② 官方 Java **没有**对应映射 ⇒ 指官方前端 `api/onlineDev/portal.ts:84`; +③ Report 整族 ⇒ 指官方前端 `api/onlineDev/report.ts:14`(官方后端是**独立服务**)。 + --- ## 2. 运行中的现场(断了就按这里重启) @@ -1187,20 +1249,33 @@ xop run --secret GU=git_local_user --secret GP=git_local_pass -- bash -c ' **create 用 `fieldRule!=0`、update 用 `fieldRule==1`**;delete 比对用**带前缀**的码。 🔴 **方案列表只需登录**(官方没加 `@SaCheckPermission`)。 🔴 `FieldList` / 表字段端点依赖低代码表单与数据库内省 ⇒ **诚实返回空**(不假装)。 -12. 🔴🔴 **【批次 12 = 下一轮优先做】框架固定包 + 业务模块链接就好** - —— 不是补端点,是**改「加业务的成本结构」**:加一个业务模块从现在的 - **改 6~8 处**(两份 spec 拷贝 + 手抄 DDL + 手抄契约表 + 改 `schema.sql` + - 改 `main.rs` BASE_TABLES + 改 `sspf-store/db.rs` 两处表数断言) - 降到 **写 1 个包文件 + 改 2 处**。 - 🔴 **四件事**:① `sspf-sdk` 补 `routes()` + 新建 `crates/sspf-plugin`(L2 静态装载器) - ② 打通两份拷贝(`modules/asset.rs` 改 re-export)+ **补 PACK1 闸门** - ③ 业务 DDL 跟着包走(不再手抄 `schema.sql`)+ 表数断言去写死 - ④ 契约登记**自动生成** + 静态闸门**增量提速** + 新增 `scripts/verify.sh` 一条命令。 - 🔴 **明确不做**:L3 dylib 动态库 / WASM 执行器 / `pack export-import` 双向迁移 - (见该节「明确不做」)。完整方案见下方「批次 12」小节。 - ⚠️ **前端**:本仓 `src/frontend` **是空的**(后端-only)⇒ vue 前端那条诉求 - **不在本仓范围**;官方 JNPF monorepo **本身就是那个「固定包」**(前端零改跑在本仓后端上)。 - ⇒ 若要做前端侧「页面脚手架」,需**先确认产品边界**(候选:仿 `new-pack.sh` 做 `new-page.sh`)。 + 12. 🔴🔴 **【批次 12 = 下一轮优先做】框架固定包 + 业务模块链接就好** + —— 不是补端点,是**改「加业务的成本结构」**:加一个业务模块从现在的 + **改 6~8 处**(两份 spec 拷贝 + 手抄 DDL + 手抄契约表 + 改 `schema.sql` + + 改 `main.rs` BASE_TABLES + 改 `sspf-store/db.rs` 两处表数断言) + 降到 **写 1 个包文件 + 改 2 处**。 + 🔴 **四件事**:① `sspf-sdk` 补 `routes()` + 新建 `crates/sspf-plugin`(L2 静态装载器) + ② 打通两份拷贝(`modules/asset.rs` 改 re-export)+ **补 PACK1 闸门** + ③ 业务 DDL 跟着包走(不再手抄 `schema.sql`)+ 表数断言去写死 + ④ 契约登记**自动生成** + 静态闸门**增量提速** + 新增 `scripts/verify.sh` 一条命令。 + 🔴 **明确不做**:L3 dylib 动态库 / WASM 执行器 / `pack export-import` 双向迁移 + (见该节「明确不做」)。完整方案见下方「批次 12」小节。 + ⚠️ **前端**:本仓 `src/frontend` **是空的**(后端-only)⇒ vue 前端那条诉求 + **不在本仓范围**;官方 JNPF monorepo **本身就是那个「固定包」**(前端零改跑在本仓后端上)。 + ⇒ 若要做前端侧「页面脚手架」,需**先确认产品边界**(候选:仿 `new-pack.sh` 做 `new-page.sh`)。 + 13. ~~`onlineDev`(101) + `Report`(23)~~ + ✅ **批次 17 做完(实际 101 条:onlineDev 78 + Report 23)**—— + 新表 `report_template` + `report_version`(官方 DDL 逐字导入); + `fe-gap` 的 `onlineDev` 列 22/101 → **100/101(99.0%)**。 + 🔴 剩的 1 条是 `docs/fe/endpoints.tsv` 的**旧记录**(官方实际无路径参数)⇒ **不是待办**。 + 🔴 契约登记已**自动生成**(`scripts/gen-contract-endpoints.py`)⇒ 以后加端点不用手抄。 + 14. 🔴 **`core` 22 条**(`fe-gap` 现在 `core` 5/27 = 18.5%)—— 下一批优先。 + 15. 🔴 **`workFlow` 104 条**(`fe-gap` 现在 0/104)—— 官方在 `jnpf-flowable`, + 依赖 **Flowable 引擎** ⇒ 大概率需要一批「诚实失败」端点 + 流程定义元数据落库。 + 16. ⏸️ **暂缓**(用户 2026-11-02 决定):`aiCenter` 75 / `extend` 64 / `msgCenter` 50 / `teamwork` 40。 + 17. ⏸️ **onlineDev 集成测试**(`tests/batch17_it.rs` 尚未写)—— 静态尺子已全绿, + 但 **`matchit` 同位置参数名冲突**这类错静态看不出来(批次 12 踩过)⇒ + 新端点族落地后**必须**跑一次集成测试。 ### 🔴🔴 批次 12(下一轮优先做)—— 「框架固定包 + 业务模块链接就好」 @@ -1698,7 +1773,6 @@ ENC_BIN="$PWD/target/debug/ssw-platform" bash scripts/perm-smoke-jnpf.sh 本仓沿用既有约定(create 回 `{id}`)—— 改的时候要**连前端消费点一起看**。 ### 批次 13 新增的坑 - - 🔴 **`query_json_params` 只认 SELECT**:它内部把 SQL 包成 `SELECT row_to_json(q)::text AS _row FROM (<你的 SQL>) AS q` ⇒ INSERT / UPDATE 塞进去报 **`syntax error at or near "INTO"`**(报错位置很误导)。 @@ -1720,6 +1794,79 @@ ENC_BIN="$PWD/target/debug/ssw-platform" bash scripts/perm-smoke-jnpf.sh `cargo test --workspace` 红两条(`schema_sql_has_expected_table_count` / `ddl_tables_parses_every_create_table`)—— 这是**有意的护栏**,不是过时的硬编码。 +### 批次 17 新增的坑 + +- 🔴🔴 **契约面按官方模块名分文件 ⇒ 契约扫描器的守卫推导会**静默全失效**: + 路由注册写成 `compat::online_dev::visual_dev_list`(三段 `::`)⇒ + 旧 `HANDLER_RE` 只认**一段** ⇒ 取到 `compat`(一个**目录**,不是文件)⇒ + `plat_files.get("compat")` 落空 ⇒ **所有 compat 端点的守卫都「推不出」** + ⇒ CC6 退化成**全是 WARN**(**不红**)⇒ 契约里写错守卫也没人抓。 + **三个配套修改缺一不可**: + ① `HANDLER_RE` 支持三段;② `scan_code` 把 `platform/compat/*.rs` 以 + `compat__<名>` 收进 `plat_files`;③ `guard_of_platform` 用 **`mod_path` 含 `::`** + 判断走 `compat__<名>` 还是根目录的 `<名>`。 + 🔴 **判据**:CC6 报「推不出」的条数突然变多 ⇒ 一定是这个坏了。 +- 🔴 **守卫常量集中在 `compat/helper.rs` ⇒ `resolve_const` 只在当前文件找会只认出第一个**: + `guard_any(&[EN_AUTH, EN_ORGANIZE, EN_ROLE])` 里 `EN_ORGANIZE`/`EN_ROLE` 是 + `use super::helper::{…}` 导入的 ⇒ 当前文件只有 `EN_AUTH` ⇒ 推出 `permission.auth` + 而契约写 `permission.auth|permission.organize|permission.role` ⇒ **假漂移**。 + 修法:`scan_code` 收一张**平台层全局常量表**(`{名: (来源文件, 值)}`), + `resolve_const` 找不到时回落查表;**同名但值不一致** ⇒ 置 `None`(宁可推不出也不假推)。 +- 🔴 **「无守卫」端点要单独判**:登录页要用的公开端点(`compat/core.rs::get_login_config` + —— 登录**前**就要拉 ⇒ 不能要 token)**一次鉴权调用都没有** ⇒ CC6 报「推不出」。 + 判据必须是「**没有任何** `guard`/`guard_any`/`require_login`/`require_module`」 + 而不是「没匹配到上面几种」。 +- 🔴 **契约 `[ENDPOINT]` 的 `[PACK:BEGIN]~[PACK:END]` 段是 `pack-sync.py` 的生成物**: + 手工往 `[ENDPOINT]` **末尾**追加行 ⇒ 生成段被挤到后面 ⇒ `pack-sync --check` 报 + 「`docs/contract.md` 不一致」⇒ `verify.sh` 第一步就红。 + ⇒ 追加后**必须**跑一次 `python3 scripts/pack-sync.py` 把生成段挪回去 + (它会幂等重排);或者用 `scripts/gen-contract-endpoints.py`(它也踩过这个坑,已修)。 +- 🔴 **`scripts/gen-contract-endpoints.py` 幂等**:再跑一次报 `+0 条`; + **已登记的条目不覆盖**(人工写的 note / 状态不会被冲掉)⇒ 可以放心重跑。 +- 🔴 **官方 `/api/Report/*` 在官方是独立部署的第三方服务**(`jnpf-java-datareport-univer`,端口 32000): + 主后端 `jnpf-java-boot` 里**没有** `/api/Report` 的 Controller,也**没有** `report_version` 实体 + ⇒ 查官方 Java 找不到出处 ⇒ `[OFFICIAL]` 的 `src` 只能指**官方前端** `api/onlineDev/report.ts`。 + 🔴 同理:`/api/visualdev/OnlineDev/{model_id}/Template` 与 `.../Actions/Export` + 官方前端声明了但**官方 Java 没有**对应 `@XxxMapping`(Controller 里只有 `TemplateDownload`) + ⇒ 记 `api/onlineDev/visualDev.ts:137` / `:141`。 +- 🔴 **`f_creator_user_id` / `f_last_modify_user_id` 存的是「账号」不是 id** + (本仓 `seed.rs` 的 `ADMIN_ACCOUNT`)⇒ 写审计列一律用 `user.account`; + `f_last_modify_time` 用 SQL `now()` **不占参数位**(占了就错位)。 +- 🔴 **`data` 的形状不是统一的「对象」**:Report 一族并存**五种**形状 + (`PageListVO` / 裸数组 / 裸对象 / 裸 id 字符串 / `{queryList:""}`) + ⇒ 返 `{list:[…]}` 或返解析后的数组 ⇒ 官方前端直接崩。 + **判据**:每个端点的 `data` 形状看**官方前端的消费点**,不看 Java 返回类型。 +- 🔴🔴 **SQL 里引用了官方 DDL 里根本不存在的列 ⇒ PG 运行时才炸**: + 批次 17 的集成测试日志抓出 3 处: + ① `base_visual_release.f_platform_release`(**官方 `base_visual_release` 没这列**, + 只有 `base_visual_dev` 有)② `base_system.f_app_key` / `f_app_name` + (官方 `base_system` 只有 `f_portal_id`/`f_app_portal_id`/`f_property_json`…) + ③ `base_notice.f_full_name`(官方 `NoticeEntity` 的标题列是 **`f_title`**)。 + 🔴 **这类错静态闸门看不出来**(表名对、列名错 ⇒ 只在真查库时炸)⇒ + **必须跑集成测试并看日志**,不能只看 `code=200`(断言过了、日志里是 PG ERROR)。 + 🔴 查列的快捷法:`python3` 扫 `src/backend/db/schema.sql` 的 `CREATE TABLE` 块, + 官方 DDL 在 `~/Desktop/workspace/jnpf/jnpf-database/`(逐字对齐的官方 PostgreSQL DDL)。 +- 🔴 **官方 `getReleaseMenu` 返的是 `base_visual_dev` 的单条,不是 release 表的列表**: + 官方 `VisualdevController.java:738` 是 `visualdevService.getById(id)` ⇒ + `ActionResult`;官方消费点 + `CreateMenuModal.vue:56-59` 是 `state.record = res.data` ⇒ **裸对象**。 + 本仓原先查 `base_visual_release` 返 `ListVO` ⇒ 双重错(形状 + 列)。 + 🔴 官方 `VisualFunctionModel` 里 `pcIsRelease/appIsRelease/pcReleaseName/appReleaseName` + 来自「菜单发布记录」表 ⇒ 本仓无该表 ⇒ 如实给 `0` / 空串。 +- 🔴 **官方 `systemFilter` 的 VO 是 `SystemListVO`(不是本仓编的那几个字段)**: + 官方 `jnpf.base.model.base.SystemListVO` 字段 = + `id/fullName/enCode/icon/sortCode/backgroundColor/userId/hasUpdate/hasDelete/isTop`。 + 🔴 官方 `PortalServiceImpl.java:229` 的 `systemFilterList` **直接忽略** + `id` 和 `category` 两个入参(`systemApi.getList(null, true, true)`) + ⇒ 本仓也**不按 category 过滤**(照抄官方口径,不是偷懒)。 +- 🔴 **官方 `Dashboard/Notice` 返 `ListVO` 不是 `PageListVO`,入参 `typeList` 是数组**: + 官方 `DashboardController.java:45`(`ActionResult>`)+ + 消费点 `components/VisualPortal/Design/hooks/useTable.ts:136-137`(`res.data.list || []`); + 入参官方 `NoticeModel { typeList: List }`(`useTable.ts:135` 传 `{ typeList }` 数组)。 + 🔴 官方 `NoticeVO` 字段 = `id/fullName/creatorTime/creatorUser/releaseUser/releaseTime/ + category/coverImage/excerpt/lastModifyTime/lastModifyUserId` + ⇒ `base_notice.f_description` 要投影成 **`excerpt`**(官方 `NoticeEntity.f_description` ⇒ `excerpt`)。 + --- ## 6. 收工前(每一轮都要做) diff --git a/crates/sspf-store/src/db.rs b/crates/sspf-store/src/db.rs index 2e35d03..1eabcc7 100644 --- a/crates/sspf-store/src/db.rs +++ b/crates/sspf-store/src/db.rs @@ -60,6 +60,21 @@ pub const BASE_TABLE_COUNT: usize = 123; /// 🔴 **业务包的表**(`asset_data_resource` 等)**不在这里** —— 那些住 `packs/`。 pub const EMBEDDED_BUSINESS_TABLES: [&str; 3] = ["demo_item", "shop_product", "book_shop_book"]; +/// 🔴 **在线报表元数据表**(官方 `/api/Report/*` 的落库载体)。 +/// +/// 🔴 **为什么它们既不是平台表也不是业务表**:官方 `/api/Report/*` 属于 +/// **独立部署**的第三方报表服务(`jnpf-java-datareport-univer`),主后端 +/// `jnpf-java-boot` 里**没有** `/api/Report` Controller —— 只有 +/// `ReportExportUtil` 把这些路径当**远程 HTTP URL** 拼。 +/// 本仓把报表元数据**就地落库**(表结构照官方 DDL 逐字导入)⇒ 它们是 +/// **契约面的固定装置**,既不属于 `base_*` 平台表族(不是官方平台表), +/// 也不属于面 A 内嵌业务表(不是业务演示数据)。 +/// +/// 🔴 **只导两张**:官方另有 `report_charts` / `report_user` / `report_department` +/// —— 那是**示例数据表**(字段是 `qybm`/`fxdmc`/`education`/`salary` 之类 +/// 演示数据,不是平台元数据)⇒ **不导入**。 +pub const REPORT_TABLES: [&str; 2] = ["report_template", "report_version"]; + /// `PGLITE_DIR=memory://` 的临时库标记(与 `config::TEMP_DIR_MARKER` 同值)。 const TEMP_DIR_MARKER: &str = "memory://"; @@ -1242,16 +1257,18 @@ mod tests { "平台表(base_*)应有 {BASE_TABLE_COUNT} 张(加平台表要同时改 main.rs 的 BASE_TABLES)" ); - // 🔴 非平台表必须**恰好**是那 3 张面 A 内嵌业务表 —— 多一张就是 - // 「有业务表手抄进了平台层 schema.sql」(该搬进 packs/),少一张就是「删漏了」。 + // 🔴 非平台表必须**恰好**是那 3 张面 A 内嵌业务表 **+ 2 张报表元数据表** —— + // 多一张就是「有业务表手抄进了平台层 schema.sql」(该搬进 packs/), + // 少一张就是「删漏了」。 let business: Vec<&String> = tables.iter().filter(|t| !t.starts_with("base_")).collect(); let mut business_names: Vec<&str> = business.iter().map(|s| s.as_str()).collect(); business_names.sort(); let mut expected = EMBEDDED_BUSINESS_TABLES.to_vec(); + expected.extend_from_slice(&REPORT_TABLES); expected.sort(); assert_eq!( business_names, expected, - "schema.sql 里的非平台表必须恰好是面 A 内嵌的那 3 张(业务包表住 packs/)" + "schema.sql 里的非平台表必须恰好是面 A 内嵌的 3 张 + 报表元数据 2 张(业务包表住 packs/)" ); // 🔴 与 main.rs 的 BASE_TABLES 对账的另一半在那边(孤儿 DDL 闸门)。 @@ -1281,11 +1298,12 @@ mod tests { let tables = ddl_tables(); assert_eq!( tables.len(), - BASE_TABLE_COUNT + EMBEDDED_BUSINESS_TABLES.len(), - "ddl_tables 应解析出 {} 张表({} 平台 + {} 面 A 内嵌业务)", - BASE_TABLE_COUNT + EMBEDDED_BUSINESS_TABLES.len(), + BASE_TABLE_COUNT + EMBEDDED_BUSINESS_TABLES.len() + REPORT_TABLES.len(), + "ddl_tables 应解析出 {} 张表({} 平台 + {} 面 A 内嵌业务 + {} 报表元数据)", + BASE_TABLE_COUNT + EMBEDDED_BUSINESS_TABLES.len() + REPORT_TABLES.len(), BASE_TABLE_COUNT, - EMBEDDED_BUSINESS_TABLES.len() + EMBEDDED_BUSINESS_TABLES.len(), + REPORT_TABLES.len() ); assert!(tables.iter().all(|t| !t.is_empty())); assert_eq!( diff --git a/docs/contract.md b/docs/contract.md index 23c4aed..6570ea4 100644 --- a/docs/contract.md +++ b/docs/contract.md @@ -1630,6 +1630,108 @@ B POST /api/permission/Position/ImportData permission.position platform B GET /api/permission/Position/ExportData permission.position platform B POST /api/permission/Position/ExportExceptionData permission.position platform +B GET /api/visualdev/Base onlineDev.formDesign|onlineDev.sysForm|generator.flowForm platform +B GET /api/visualdev/Base/list 登录 platform +B GET /api/visualdev/Base/Selector 登录 platform +B GET /api/visualdev/Base/getColumnList 登录 platform +B GET /api/visualdev/Base/getListBySystem 登录 platform +B POST /api/visualdev/Base onlineDev.formDesign|onlineDev.sysForm|generator.flowForm platform +B GET /api/visualdev/Base/{id} onlineDev.formDesign|onlineDev.sysForm|generator.flowForm platform +B PUT /api/visualdev/Base/{id} onlineDev.formDesign|onlineDev.sysForm|generator.flowForm platform +B DELETE /api/visualdev/Base/{id} onlineDev.formDesign|onlineDev.sysForm|generator.flowForm platform +B POST /api/visualdev/Base/{id}/Actions/Copy onlineDev.formDesign|onlineDev.sysForm|generator.flowForm platform +B POST /api/visualdev/Base/{id}/Actions/Release onlineDev.formDesign|onlineDev.sysForm|generator.flowForm platform +B GET /api/visualdev/Base/{id}/getReleaseMenu onlineDev.formDesign|onlineDev.sysForm|generator.flowForm platform +B POST /api/visualdev/Base/{id}/Actions/Module onlineDev.formDesign|onlineDev.sysForm|generator.flowForm platform +B GET /api/visualdev/Base/{id}/FormDataFields onlineDev.formDesign|onlineDev.sysForm|generator.flowForm platform +B GET /api/visualdev/Base/{id}/FieldDataSelect 登录 platform +B POST /api/visualdev/Generater/{id}/Actions/DownloadCode onlineDev.formDesign|generator.webForm|generator.flowForm platform +B POST /api/visualdev/Generater/{id}/Actions/CodePreview onlineDev.formDesign|generator.webForm|generator.flowForm platform +B GET /api/visualdev/Generater/{id}/Alias/Info onlineDev.formDesign|generator.webForm|generator.flowForm platform +B POST /api/visualdev/Generater/{id}/Alias/Save onlineDev.formDesign|generator.webForm|generator.flowForm platform +B GET /api/visualdev/OnlineDev/{model_id}/Config 登录 platform +B GET /api/visualdev/OnlineDev/Config 登录 platform +B GET /api/visualdev/OnlineDev/{model_id}/FormData 登录 platform +B POST /api/visualdev/OnlineDev/{model_id}/List 登录 platform +B POST /api/visualdev/OnlineDev/{model_id} 登录 platform +B PUT /api/visualdev/OnlineDev/{model_id}/{id} 登录 platform +B GET /api/visualdev/OnlineDev/{model_id}/{id} 登录 platform +B DELETE /api/visualdev/OnlineDev/{model_id}/{id} 登录 platform +B POST /api/visualdev/OnlineDev/batchDelete/{model_id} 登录 platform +B POST /api/visualdev/OnlineDev/{model_id}/DataChange 登录 platform +B POST /api/visualdev/OnlineDev/{model_id}/Actions/ExportData 登录 platform +B GET /api/visualdev/OnlineDev/{model_id}/Template 登录 platform +B POST /api/visualdev/OnlineDev/{model_id}/Actions/Export onlineDev.formDesign platform +B POST /api/visualdev/OnlineDev/{model_id}/actionLaunchFlow 登录 platform +B POST /api/visualdev/OnlineDev/RelationQuery 登录 platform +B GET /api/visualdev/OnlineLog 登录 platform +B GET /api/visualdev/personal 登录 platform +B POST /api/visualdev/personal 登录 platform +B PUT /api/visualdev/personal/{id} 登录 platform +B PUT /api/visualdev/personal/{id}/setDefault 登录 platform +B DELETE /api/visualdev/personal/{id} 登录 platform +B GET /api/visualdev/share 登录 platform +B POST /api/visualdev/share/SelectedList 登录 platform +B POST /api/visualdev/share/save 登录 platform +B GET /api/visualdev/share/Selector 登录 platform +B POST /api/visualdev/ocr 登录 platform +B GET /api/visualdev/ShortLink/{id} onlineDev.formDesign platform +B PUT /api/visualdev/ShortLink onlineDev.formDesign platform +B GET /api/visualdev/ShortLink/getConfig/{id} 登录 platform +B POST /api/visualdev/ShortLink/checkPwd 登录 platform +B GET /api/visualdev/ShortLink/Config 登录 platform +B POST /api/visualdev/ShortLink/{id}/ListLink 登录 platform +B POST /api/visualdev/ShortLink/{id} 登录 platform +B GET /api/visualdev/ShortLink/{id}/{id}/DataChange 登录 platform +B GET /api/visualdev/Portal onlineDev.visualPortal platform +B GET /api/visualdev/Portal/{id} 登录 platform +B POST /api/visualdev/Portal onlineDev.visualPortal platform +B PUT /api/visualdev/Portal/{id} onlineDev.visualPortal platform +B DELETE /api/visualdev/Portal/{id} onlineDev.visualPortal platform +B POST /api/visualdev/Portal/{id}/Actions/Copy onlineDev.visualPortal platform +B POST /api/visualdev/Portal/{id}/Actions/Export onlineDev.visualPortal platform +B GET /api/visualdev/Portal/Selector 登录 platform +B GET /api/visualdev/Portal/Selector/Menu 登录 platform +B PUT /api/visualdev/Portal/{id}/Actions/SetDefault 登录 platform +B GET /api/visualdev/Portal/{id}/auth 登录 platform +B PUT /api/visualdev/Portal/Custom/Save/{id} 登录 platform +B PUT /api/visualdev/Portal/Actions/release/{id} 登录 platform +B GET /api/visualdev/Portal/systemFilter/{id} 登录 platform +B GET /api/visualdev/Portal/manage/Selector/{system_id} 登录 platform +B GET /api/system/PortalManage/list/{system_id} 登录 platform +B GET /api/system/PortalManage/{id} 登录 platform +B POST /api/system/PortalManage 登录 platform +B PUT /api/system/PortalManage/{id} 登录 platform +B DELETE /api/system/PortalManage/{id} 登录 platform +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/Report 登录 platform +B POST /api/Report 登录 platform +B GET /api/Report/Selector 登录 platform +B POST /api/Report/Save 登录 platform +B POST /api/Report/Data 登录 platform +B GET /api/Report/Version/{id} 登录 platform +B GET /api/Report/Info/{id} 登录 platform +B POST /api/Report/Info/{id} 登录 platform +B DELETE /api/Report/Info/{id} 登录 platform +B POST /api/Report/data/upload/file 登录 platform +B POST /api/Report/data/downImg 登录 platform +B POST /api/Report/data/ImportExcel 登录 platform +B POST /api/Report/data/{id}/DownExcel 登录 platform +B GET /api/Report/data/{id}/getQueryList 登录 platform +B POST /api/Report/data/{id}/preview 登录 platform +B POST /api/Report/data/{id}/previewTemplate 登录 platform +B GET /api/Report/{id} 登录 platform +B PUT /api/Report/{id} 登录 platform +B DELETE /api/Report/{id} 登录 platform +B POST /api/Report/{id}/Actions/Copy 登录 platform +B GET /api/Report/{id}/Actions/Export 登录 platform +B POST /api/Report/{id}/Actions/Module 登录 platform +B GET /api/Report/{id}/getReleaseMenu 登录 platform + # 🔴 以下由 `scripts/pack-sync.py` 从 `packs/*` 生成 —— **不许手改** # (下次同步会被覆盖;改包就够) @@ -1653,7 +1755,7 @@ B DELETE /api/asset/DataResource/{id} permission.asset.dataResource asset [FACE] # face 条数 说明 A 28 面 A 专属(+ 2 条共用 ⇒ 面 A 合计 30 条) -B 457 面 B 专属(官方 JNPF 形状;批次 13 新增 Area 7 + Variate 7;批次 14 新增数据中心 29;批次 15 新增系统服务 39;批次 16 新增权限关系 26) +B 558 面 B 专属(官方 JNPF 形状;批次 13 新增 Area 7 + Variate 7;批次 14 新增数据中心 29;批次 15 新增系统服务 39;批次 16 新增权限关系 26;批次 17 新增 onlineDev 78 + Report 23) AB 2 两面共用(CurrentUser / Authority Data —— 按判别头分流) [OFFICIAL] @@ -2164,6 +2266,107 @@ GET /api/permission/Position/ImportPreview partial PositionController.java:650 POST /api/permission/Position/ImportData partial PositionController.java:676 面 B 已落地:`type=false` 真落库(`fullName`+`enCode` 必填、`enCode` 判重);`type=true` 明确失败 GET /api/permission/Position/ExportData partial PositionController.java:716 **本仓无文件服务** ⇒ 明确业务失败 POST /api/permission/Position/ExportExceptionData partial PositionController.java:661 同上 ⇒ 明确拒绝 +GET /api/visualdev/Base implemented VisualdevController.java:134 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +GET /api/visualdev/Base/list implemented VisualdevController.java:180 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +GET /api/visualdev/Base/Selector implemented VisualdevController.java:210 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +GET /api/visualdev/Base/getColumnList implemented VisualdevController.java:764 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +GET /api/visualdev/Base/getListBySystem implemented VisualdevController.java:819 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +POST /api/visualdev/Base implemented VisualdevController.java:504 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +GET /api/visualdev/Base/{id} implemented VisualdevController.java:328 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +PUT /api/visualdev/Base/{id} implemented VisualdevController.java:429 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +DELETE /api/visualdev/Base/{id} implemented VisualdevController.java:578 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +POST /api/visualdev/Base/{id}/Actions/Copy implemented VisualdevController.java:377 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +POST /api/visualdev/Base/{id}/Actions/Release implemented VisualdevController.java:600 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +GET /api/visualdev/Base/{id}/getReleaseMenu implemented VisualdevController.java:738 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +POST /api/visualdev/Base/{id}/Actions/Module implemented VisualdevController.java:687 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +GET /api/visualdev/Base/{id}/FormDataFields implemented VisualdevController.java:348 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +GET /api/visualdev/Base/{id}/FieldDataSelect partial VisualdevController.java:363 本仓无数据引擎(关联数据分页)⇒ **明确业务失败** +POST /api/visualdev/Generater/{id}/Actions/DownloadCode partial VisualdevGenController.java:122 本仓无代码生成器 ⇒ **明确业务失败** +POST /api/visualdev/Generater/{id}/Actions/CodePreview partial VisualdevGenController.java:175 本仓无代码生成器 ⇒ **明确业务失败** +GET /api/visualdev/Generater/{id}/Alias/Info partial VisualdevGenController.java:289 本仓无代码生成器别名表 ⇒ 恒空 +POST /api/visualdev/Generater/{id}/Alias/Save partial VisualdevGenController.java:298 本仓无代码生成器别名表 ⇒ **明确业务失败** +GET /api/visualdev/OnlineDev/{model_id}/Config implemented VisualdevModelDataController.java:417 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +GET /api/visualdev/OnlineDev/Config implemented VisualdevModelDataController.java:1143 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +GET /api/visualdev/OnlineDev/{model_id}/FormData partial VisualdevModelDataController.java:460 本仓无数据引擎(在线表单的表结构)⇒ **明确业务失败** +POST /api/visualdev/OnlineDev/{model_id}/List partial VisualdevModelDataController.java:312 本仓无数据引擎(在线表单的数据列表)⇒ **明确业务失败** +POST /api/visualdev/OnlineDev/{model_id} partial VisualdevModelDataController.java:515 本仓无数据引擎(在线表单建表)⇒ **明确业务失败** +PUT /api/visualdev/OnlineDev/{model_id}/{id} partial VisualdevModelDataController.java:545 本仓无数据引擎(在线表单改表)⇒ **明确业务失败** +GET /api/visualdev/OnlineDev/{model_id}/{id} partial VisualdevModelDataController.java:470 本仓无数据引擎(在线表单数据详情)⇒ **明确业务失败** +DELETE /api/visualdev/OnlineDev/{model_id}/{id} partial VisualdevModelDataController.java:574 本仓无数据引擎(在线表单删表)⇒ **明确业务失败** +POST /api/visualdev/OnlineDev/batchDelete/{model_id} partial VisualdevModelDataController.java:638 本仓无数据引擎 ⇒ **明确业务失败** +POST /api/visualdev/OnlineDev/{model_id}/DataChange partial VisualdevModelDataController.java:484 本仓无数据引擎(在线表单的数据增删改查)⇒ **明确业务失败** +POST /api/visualdev/OnlineDev/{model_id}/Actions/ExportData partial VisualdevModelDataController.java:790 本仓无 Excel 引擎 ⇒ **明确业务失败** +GET /api/visualdev/OnlineDev/{model_id}/Template partial api/onlineDev/visualDev.ts:137 本仓无代码生成器 ⇒ **明确业务失败** +POST /api/visualdev/OnlineDev/{model_id}/Actions/Export partial VisualdevModelDataController.java:855 本仓无代码生成器 ⇒ **明确业务失败** +POST /api/visualdev/OnlineDev/{model_id}/actionLaunchFlow partial VisualdevModelDataController.java:1103 本仓无流程引擎 ⇒ **明确业务失败** +POST /api/visualdev/OnlineDev/RelationQuery implemented VisualdevModelDataController.java:1177 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +GET /api/visualdev/OnlineLog implemented VisualLogController.java:39 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +GET /api/visualdev/personal implemented VisualPersonalController.java:51 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +POST /api/visualdev/personal implemented VisualPersonalController.java:60 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +PUT /api/visualdev/personal/{id} implemented VisualPersonalController.java:96 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +PUT /api/visualdev/personal/{id}/setDefault implemented VisualPersonalController.java:118 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +DELETE /api/visualdev/personal/{id} implemented VisualPersonalController.java:140 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +GET /api/visualdev/share implemented SystemShareController.java:61 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +POST /api/visualdev/share/SelectedList implemented SystemShareController.java:72 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +POST /api/visualdev/share/save implemented SystemShareController.java:80 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +GET /api/visualdev/share/Selector implemented SystemShareController.java:87 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +POST /api/visualdev/ocr partial OcrController.java:48 本仓无 OCR 服务 ⇒ **明确业务失败** +GET /api/visualdev/ShortLink/{id} implemented VisualdevShortLinkController.java:101 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +PUT /api/visualdev/ShortLink implemented VisualdevShortLinkController.java:139 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +GET /api/visualdev/ShortLink/getConfig/{id} implemented VisualdevShortLinkController.java:229 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +POST /api/visualdev/ShortLink/checkPwd implemented VisualdevShortLinkController.java:244 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +GET /api/visualdev/ShortLink/Config implemented VisualdevShortLinkController.java:263 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +POST /api/visualdev/ShortLink/{id}/ListLink implemented VisualdevShortLinkController.java:292 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +POST /api/visualdev/ShortLink/{id} implemented VisualdevShortLinkController.java:341 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +GET /api/visualdev/ShortLink/{id}/{id}/DataChange implemented VisualdevShortLinkController.java:322 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +GET /api/visualdev/Portal implemented PortalController.java:94 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +GET /api/visualdev/Portal/{id} implemented PortalController.java:122 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +POST /api/visualdev/Portal implemented PortalController.java:165 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +PUT /api/visualdev/Portal/{id} implemented PortalController.java:217 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +DELETE /api/visualdev/Portal/{id} implemented PortalController.java:149 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +POST /api/visualdev/Portal/{id}/Actions/Copy implemented PortalController.java:192 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +POST /api/visualdev/Portal/{id}/Actions/Export partial PortalController.java:256 本仓无文件服务 ⇒ **明确业务失败** +GET /api/visualdev/Portal/Selector implemented PortalController.java:106 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +GET /api/visualdev/Portal/Selector/Menu implemented PortalController.java:115 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +PUT /api/visualdev/Portal/{id}/Actions/SetDefault implemented PortalDataController.java:57 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +GET /api/visualdev/Portal/{id}/auth implemented PortalDataController.java:114 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +PUT /api/visualdev/Portal/Custom/Save/{id} implemented PortalDataController.java:71 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +PUT /api/visualdev/Portal/Actions/release/{id} implemented PortalDataController.java:93 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +GET /api/visualdev/Portal/systemFilter/{id} implemented PortalController.java:347 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +GET /api/visualdev/Portal/manage/Selector/{system_id} implemented api/onlineDev/portal.ts:84 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +GET /api/system/PortalManage/list/{system_id} implemented api/onlineDev/portal.ts:79 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +GET /api/system/PortalManage/{id} implemented api/onlineDev/portal.ts:87 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +POST /api/system/PortalManage implemented api/onlineDev/portal.ts:91 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +PUT /api/system/PortalManage/{id} implemented api/onlineDev/portal.ts:95 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +DELETE /api/system/PortalManage/{id} implemented api/onlineDev/portal.ts:99 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +POST /api/visualdev/Dashboard/Notice implemented DashboardController.java:45 面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现 +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/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 逐字导入) +POST /api/Report/Save implemented api/onlineDev/report.ts:50 面 B 已落地:官方 `/api/Report/*` 在官方是**独立部署的第三方服务**(`jnpf-java-datareport-univer`,端口 32000)⇒ 本仓把报表元数据**就地落库**(`report_template` + `report_version`,表结构照官方 DDL 逐字导入) +POST /api/Report/Data partial api/onlineDev/report.ts:46 本仓无数据引擎 ⇒ **明确业务失败** +GET /api/Report/Version/{id} implemented api/onlineDev/report.ts:58 面 B 已落地:官方 `/api/Report/*` 在官方是**独立部署的第三方服务**(`jnpf-java-datareport-univer`,端口 32000)⇒ 本仓把报表元数据**就地落库**(`report_template` + `report_version`,表结构照官方 DDL 逐字导入) +GET /api/Report/Info/{id} implemented api/onlineDev/report.ts:54 面 B 已落地:官方 `/api/Report/*` 在官方是**独立部署的第三方服务**(`jnpf-java-datareport-univer`,端口 32000)⇒ 本仓把报表元数据**就地落库**(`report_template` + `report_version`,表结构照官方 DDL 逐字导入) +POST /api/Report/Info/{id} implemented api/onlineDev/report.ts:66 面 B 已落地:官方 `/api/Report/*` 在官方是**独立部署的第三方服务**(`jnpf-java-datareport-univer`,端口 32000)⇒ 本仓把报表元数据**就地落库**(`report_template` + `report_version`,表结构照官方 DDL 逐字导入) +DELETE /api/Report/Info/{id} implemented api/onlineDev/report.ts:62 面 B 已落地:官方 `/api/Report/*` 在官方是**独立部署的第三方服务**(`jnpf-java-datareport-univer`,端口 32000)⇒ 本仓把报表元数据**就地落库**(`report_template` + `report_version`,表结构照官方 DDL 逐字导入) +POST /api/Report/data/upload/file partial api/onlineDev/report.ts:82 本仓无文件服务 ⇒ **明确业务失败**(不返假 URL) +POST /api/Report/data/downImg partial api/onlineDev/report.ts:86 本仓无文件服务 ⇒ **明确业务失败**(不返假 URL) +POST /api/Report/data/ImportExcel partial api/onlineDev/report.ts:90 本仓无 Excel 引擎 ⇒ **明确业务失败** +POST /api/Report/data/{id}/DownExcel partial api/onlineDev/report.ts:94 本仓无 Excel 引擎 ⇒ **明确业务失败** +GET /api/Report/data/{id}/getQueryList implemented api/onlineDev/report.ts:106 面 B 已落地:官方 `/api/Report/*` 在官方是**独立部署的第三方服务**(`jnpf-java-datareport-univer`,端口 32000)⇒ 本仓把报表元数据**就地落库**(`report_template` + `report_version`,表结构照官方 DDL 逐字导入) +POST /api/Report/data/{id}/preview partial api/onlineDev/report.ts:70 本仓无 Univer 渲染器 ⇒ **明确业务失败**(不返假 URL) +POST /api/Report/data/{id}/previewTemplate partial api/onlineDev/report.ts:74 本仓无 Univer 渲染器 ⇒ **明确业务失败**(不返假 URL) +GET /api/Report/{id} implemented api/onlineDev/report.ts:26 面 B 已落地:官方 `/api/Report/*` 在官方是**独立部署的第三方服务**(`jnpf-java-datareport-univer`,端口 32000)⇒ 本仓把报表元数据**就地落库**(`report_template` + `report_version`,表结构照官方 DDL 逐字导入) +PUT /api/Report/{id} implemented api/onlineDev/report.ts:22 面 B 已落地:官方 `/api/Report/*` 在官方是**独立部署的第三方服务**(`jnpf-java-datareport-univer`,端口 32000)⇒ 本仓把报表元数据**就地落库**(`report_template` + `report_version`,表结构照官方 DDL 逐字导入) +DELETE /api/Report/{id} implemented api/onlineDev/report.ts:30 面 B 已落地:官方 `/api/Report/*` 在官方是**独立部署的第三方服务**(`jnpf-java-datareport-univer`,端口 32000)⇒ 本仓把报表元数据**就地落库**(`report_template` + `report_version`,表结构照官方 DDL 逐字导入) +POST /api/Report/{id}/Actions/Copy implemented api/onlineDev/report.ts:34 面 B 已落地:官方 `/api/Report/*` 在官方是**独立部署的第三方服务**(`jnpf-java-datareport-univer`,端口 32000)⇒ 本仓把报表元数据**就地落库**(`report_template` + `report_version`,表结构照官方 DDL 逐字导入) +GET /api/Report/{id}/Actions/Export partial api/onlineDev/report.ts:42 本仓无数据引擎 ⇒ **明确业务失败** +POST /api/Report/{id}/Actions/Module partial api/onlineDev/report.ts:102 菜单 URL 用官方前端路由 `/reportPreview`(`router/routes/core.ts:92`);本仓无菜单服务 ⇒ 只回填 id / 父节点 +GET /api/Report/{id}/getReleaseMenu partial api/onlineDev/report.ts:98 本仓无菜单服务 ⇒ `pcIsRelease`/`appIsRelease` 恒 false,两个 `*ReleaseName` 恒空串(官方消费这四个字段) [RULER] # name 期望断言数(尺子**自己**断言的条数;跑出来的条数对不上 ⇒ 失败) diff --git a/scripts/check-contract-scan.py b/scripts/check-contract-scan.py index aa76665..4a16e91 100644 --- a/scripts/check-contract-scan.py +++ b/scripts/check-contract-scan.py @@ -43,7 +43,15 @@ import contract_expect # noqa: E402 (同目录) # 再用**同一偏移**去原文取路径与方法。 ROUTE_CALL_RE = re.compile(r'\.route\(') # 路由后面的 handler 表达式:`sys::user_list` / `demo_item_list` / `|State(..)| ..`(闭包) -HANDLER_RE = re.compile(r'\s*(?:([A-Za-z_][A-Za-z0-9_]*)::)?([A-Za-z_][A-Za-z0-9_]*)') +# +# 🔴 **三段路径**(批次 17 补):`compat::online_dev::visual_dev_list` —— +# 契约面的实现按官方模块名分文件(`platform/compat/<模块>.rs`), +# 路由注册时写成 `compat::<模块>::` ⇒ 只认**第一段**会拿到 +# `compat`(一个目录,不是文件)⇒ 守卫推导**全部推不出**(静默失效)。 +# ⇒ 这里记住**完整路径**,`mod` 取最后一段(真正的模块文件名), +# `mod_path` 保留全链(供 owner 判定用)。 +HANDLER_RE = re.compile( + r'\s*(?:([A-Za-z_][A-Za-z0-9_]*)::)?(?:([A-Za-z_][A-Za-z0-9_]*)::)?([A-Za-z_][A-Za-z0-9_]*)') # 契约表里 `{param}` ⇒ 代码里的通配 PARAM_RE = re.compile(r'\{[A-Za-z_][A-Za-z0-9_]*\}') # 测试用的固定路径前缀(**不在契约端点表里** ⇒ 全部扫描都排除) @@ -277,13 +285,24 @@ def scan_routes(path, owner): rest = orig[name_start:name_start + 240] hm = HANDLER_RE.match(rest) mod, fn, closure = None, None, True - if hm and hm.group(2): - mod, fn = hm.group(1), hm.group(2) + mod_path = None + if hm and hm.group(3): + # 🔴 **三段路径**(批次 17 补):`compat::online_dev::visual_dev_list` + # ⇒ `mod_path` = `compat::online_dev`、`mod` = `online_dev` + # (真正的文件名);两段 `sys::user_list` ⇒ `mod` = `sys`。 + if hm.group(2): + mod_path = "%s::%s" % (hm.group(1), hm.group(2)) + mod = hm.group(2) + else: + mod_path = hm.group(1) + mod = hm.group(1) + fn = hm.group(3) closure = False out.append({ "path": route, "method": method, "mod": mod, + "mod_path": mod_path, "fn": fn, "closure": closure, "owner": owner, @@ -306,11 +325,16 @@ def scan_routes(path, owner): return out, orig, masked -def resolve_const(orig, masked, name): +def resolve_const(orig, masked, name, global_consts=None): """`const NAME: &str = "value";` ⇒ value(取原文里的字面量)。 🔴 **带缓存**(同 [`find_fn_body`] 的理由):本函数在**整份文件**上跑正则, 362 条平台端点的守卫推导会反复查同一批常量名。 + + 🔴 **跨文件回落**(批次 17 补):`global_consts` 是平台层**全局常量表** + (`{名: (来源文件, 值)}`)⇒ 当前文件里找不到的常量到表里找 + (契约面的守卫常量集中在 `compat/helper.rs`,被各模块 `use` 导入)。 + 表里同名但**值不一致**的条目值为 `None` ⇒ 宁可推不出也不假推。 """ key = id(orig) entry = _CONST_CACHE.get(key) @@ -322,6 +346,10 @@ def resolve_const(orig, masked, name): return table[name] m = re.search(r"\bconst\s+" + re.escape(name) + r"\b[^=]*=\s*\"([^\"]*)\"", orig) value = m.group(1) if m else None + if value is None and global_consts: + hit = global_consts.get(name) + if hit is not None: + value = hit[1] table[name] = value return value @@ -329,10 +357,17 @@ def resolve_const(orig, masked, name): _CONST_CACHE = {} -def guard_of_platform(plat_files, mod, fn): +def guard_of_platform(plat_files, mod, fn, mod_path=None, plat_consts=None): """平台层 handler 的守卫 ⇒ 菜单 key / 点权限编码 / 登录 / 无;推不出 ⇒ None。 `plat_files` = {"sys": (orig, masked), "face_b": (orig, masked), ...} + + 🔴 **模块定位有两种形态**(批次 17 补): + - `mod_path` 是两段以上(`compat::online_dev`)⇒ 契约面实现文件在 + `platform/compat/<模块>.rs` ⇒ key = `compat__<模块>`。 + - `mod_path` 是一段(`sys`)⇒ 平台层根目录 `platform/<模块>.rs`。 + ⇒ 旧实现只拿 `mod` 查 ⇒ `online_dev` 找不到 `compat__online_dev` + ⇒ 守卫**全部推不出**(CC6 静默退化成全是 WARN)。 """ if mod == "auth" and fn == "login_handler": return "无" @@ -349,39 +384,62 @@ def guard_of_platform(plat_files, mod, fn): if re.search(r"require_(login|module|login_jnpf)\s*\(", body) or re.search(r"\bguard\s*\(", body): return None return "无" - pair = plat_files.get(mod) - if not pair: - return None - orig, masked = pair - span = find_fn_body(masked, fn) - if not span: - return None - body = masked[span[0]:span[1]] - if mod == "sys": + # 🔴 **契约面实现文件**(批次 17 补):`platform/compat/<模块>.rs` —— + # key 形如 `compat__online_dev` ⇒ 与 `jnpf` / `face_b` **同一套**推导规则 + # (`guard` / `guard_any` / `require_login_face_b`)。 + # 🔴 `mod_path` 两段以上(`compat::online_dev`)⇒ 走 `compat__<模块>`; + # 一段(`sys`)⇒ 走根目录的 `<模块>`。 + plat_key = mod + if mod_path and "::" in mod_path: + plat_key = "compat__" + mod + # 🔴 平台层根目录的单段模块(`sys::user_list`)⇒ `require_module` / `require_login`。 + if plat_key == mod and mod not in ("jnpf", "face_b"): + pair = plat_files.get(mod) + if not pair: + return None + orig, masked = pair + span = find_fn_body(masked, fn) + if not span: + return None + body = masked[span[0]:span[1]] m = re.search(r"require_module\(\s*&state\s*,\s*&headers\s*,\s*([A-Z_][A-Z0-9_]*)\s*\)", body) if m: - return resolve_const(orig, masked, m.group(1)) + return resolve_const(orig, masked, m.group(1), plat_consts) if re.search(r"require_login(_any)?\s*\(", body): return "登录" return None - # 🔴 面 B 的实现文件 2026-10-26 从 `jnpf.rs` 改名为 `face_b.rs` - # ⇒ 这里**两个名字都认**(只认旧名会让整片面 B 的守卫检查静默失效)。 - if mod in ("jnpf", "face_b"): + if mod in ("jnpf", "face_b") or plat_key.startswith("compat__"): + pair = plat_files.get(plat_key) + if not pair: + return None + orig, masked = pair + span = find_fn_body(masked, fn) + if not span: + return None + body = masked[span[0]:span[1]] m = re.search(r"guard\(\s*&state\s*,\s*&headers\s*,\s*([A-Z_][A-Z0-9_]*)\s*\)", body) if m: - return resolve_const(orig, masked, m.group(1)) + return resolve_const(orig, masked, m.group(1), plat_consts) # 🔴 官方的 `@SaCheckPermission(value={A,B}, mode=OR)` ⇒ 本仓 `guard_any(&[A,B])`: # 契约里写成 `A|B`(同一个分隔符,**顺序即代码里的顺序**)。 m = re.search(r"guard_any\(\s*&state\s*,\s*&headers\s*,\s*&\[([^\]]*)\]", body) if m: codes = [] for name in re.findall(r"\b[A-Z_][A-Z0-9_]*\b", m.group(1)): - value = resolve_const(orig, masked, name) + value = resolve_const(orig, masked, name, plat_consts) if value: codes.append(value) return "|".join(codes) if codes else None if re.search(r"require_login_(jnpf|face_b)\s*\(", body): return "登录" + # 🔴 **无守卫**(批次 17 补):handler 里**一次**鉴权调用都没有 ⇒ 「无」。 + # 典型是登录页要用的公开端点(`compat/core.rs::get_login_config` + # —— 登录**前**就要拉 ⇒ 不能要 token)。 + # 🔴 判据必须是「**没有任何**鉴权调用」而不是「没匹配到上面几种」: + # `require_login_face_b` 写成 `let _ = require_login_face_b(..)` 时 + # 上面的正则仍能命中;只有**真的没有**才落到这里。 + if not re.search(r"\bguard\b|\bguard_any\b|require_login|require_module", body): + return "无" return None return None @@ -774,6 +832,33 @@ def scan_code(src_dir, packs_dir=None): p = os.path.join(plat_dir, name) o = read(p) plat_files[name[:-3]] = (o, mask_rust(o)) + # 🔴 **契约面实现文件**(批次 17 补):`platform/compat/<模块>.rs` —— + # 契约面按官方模块名分文件(`online_dev.rs` / `report.rs` / `system.rs` …), + # 路由注册写 `compat::<模块>::` ⇒ 这些文件**必须**进 `plat_files`, + # 否则守卫推导**全部推不出**(CC6 退化成「全是 WARN」⇒ 静默失效)。 + compat_dir = os.path.join(plat_dir, "compat") + if os.path.isdir(compat_dir): + for name in sorted(os.listdir(compat_dir)): + if name.endswith(".rs"): + p = os.path.join(compat_dir, name) + o = read(p) + plat_files["compat__" + name[:-3]] = (o, mask_rust(o)) + # 🔴 **全局常量索引**(批次 17 补):契约面按官方模块分文件后, + # 守卫常量(`EN_ROLE` / `EN_ORGANIZE` / `EN_ACTION` …)**集中在 + # `compat/helper.rs`** 里,被各模块 `use super::helper::{…}` 导入 + # ⇒ 只在「当前文件」里找常量 ⇒ **只推得出本地定义的那一个** + # (`guard_any(&[EN_AUTH, EN_ORGANIZE, EN_ROLE])` 只认出 `EN_AUTH`) + # ⇒ 契约里的 `A|B|C` 与代码推出的 `A` **假漂移**。 + # ⇒ 这里把平台层所有 `const NAME: &str = "…"` 收成一张表; + # 重名时**取值必须一致**(否则宁可不推,见 `resolve_const`)。 + plat_consts = {} + for key, (o, _m) in plat_files.items(): + for cm in re.finditer(r"\bconst\s+([A-Z_][A-Z0-9_]*)\s*:\s*&str\s*=\s*\"([^\"]*)\"", o): + name, value = cm.group(1), cm.group(2) + if name in plat_consts and plat_consts[name][1] != value: + plat_consts[name] = (key, None) # 同名不同值 ⇒ 不可信 + elif name not in plat_consts: + plat_consts[name] = (key, value) # ---- 业务模块(面 A)---- mod_dir = os.path.join(src_dir, "modules") @@ -815,6 +900,7 @@ def scan_code(src_dir, packs_dir=None): "plat_orig": plat_orig, "plat_masked": plat_masked, "plat_files": plat_files, + "plat_consts": plat_consts, "mod_dir": mod_dir, "modules_mod": os.path.join(mod_dir, "mod.rs"), "mod_files": mod_files, @@ -849,6 +935,7 @@ def analyze(contract_path, src_dir=None, packs_dir=None, code_snapshot=None): plat_orig = code_snapshot["plat_orig"] plat_masked = code_snapshot["plat_masked"] plat_files = code_snapshot["plat_files"] + plat_consts = code_snapshot.get("plat_consts") or {} mod_files = code_snapshot["mod_files"] biz = code_snapshot["biz"] mod_orig = code_snapshot["mod_orig"] @@ -932,7 +1019,8 @@ def analyze(contract_path, src_dir=None, packs_dir=None, code_snapshot=None): tail = plat_orig[plat_orig.find(hit["path"]):][:400] derived = guard_of_closure(plat_orig, plat_masked, tail) else: - derived = guard_of_platform(plat_files, hit["mod"], hit["fn"]) + derived = guard_of_platform(plat_files, hit["mod"], hit["fn"], + hit.get("mod_path"), plat_consts) else: derived = guard_of_module_with_pack_fallback( mod_orig[hit["owner"]], mod_masked[hit["owner"]], diff --git a/scripts/gen-contract-endpoints.py b/scripts/gen-contract-endpoints.py new file mode 100644 index 0000000..90bad42 --- /dev/null +++ b/scripts/gen-contract-endpoints.py @@ -0,0 +1,403 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""gen-contract-endpoints —— 从**代码真实路由**生成契约的 `[ENDPOINT]` / `[OFFICIAL]` 行。 + +🔴 为什么存在(批次 17): + 契约面的实现按**官方模块名**分文件(`platform/compat/<模块>.rs`), + 一次做完就是**上百条**端点 ⇒ 手工往 `docs/contract.md` 里抄 + `[ENDPOINT]`(5 列)与 `[OFFICIAL]`(5 列)**必然漏抄**: + - `[ENDPOINT]` 漏一条 ⇒ CC2 报「契约 N 条 / 代码 M 条」+ CC4 报漂移; + - `[OFFICIAL]` 漏一条 ⇒ CC10 报「代码注册了面 B 路由,但台账里没有这一条」。 + ⇒ 本脚本把**代码侧的路由 + 守卫推导**作为真源,**自动生成**登记行。 + +🔴 **不覆盖、只追加**:脚本只在 `[ENDPOINT]` / `[OFFICIAL]` 段的**末尾** + 追加**本仓代码里已有、但契约里还没有**的端点 ⇒ 已有登记**不动** + (契约里人工写的 note / 状态不会被冲掉)。 + +🔴 守卫**不猜**:直接调用 `check-contract-scan.py` 的 `guard_of_platform` + (与 CC6 **同一套**推导规则)⇒ 生成的 guard 必然与代码一致 + ⇒ CC6 不会因为「登记时的手抖」而假漂移。 + +用法: + python3 scripts/gen-contract-endpoints.py # 生成并写入 docs/contract.md + python3 scripts/gen-contract-endpoints.py --dry-run # 只打印,不写 + python3 scripts/gen-contract-endpoints.py --only online_dev,report +""" + +import importlib.util +import os +import re +import sys + +HERE = os.path.dirname(os.path.abspath(__file__)) +ROOT = os.path.dirname(HERE) +CONTRACT = os.path.join(ROOT, "docs", "contract.md") + + +def _load(name, path): + spec = importlib.util.spec_from_file_location(name, path) + mod = importlib.util.module_from_spec(spec) + spec.loader.exec_module(mod) + return mod + + +S = _load("ccs", os.path.join(HERE, "check-contract-scan.py")) + +# 🔴 **官方出处表**(`文件:行号`)—— 手工核对过官方 Java Controller 的 +# `@XxxMapping` 行号(批次 17 逐条查证)。 +# 键 = `(method, 官方路径)`;值 = (出处, 备注模板)。 +# +# 🔴 **官方 `/api/Report/*` 是独立部署的第三方服务** +# (`jnpf-java-datareport-univer`,端口 32000)—— 主后端 `jnpf-java-boot` +# 里**没有** `/api/Report` 的 Controller ⇒ 出处只能指向**官方前端** +# 的 `api/onlineDev/report.ts`(本仓按官方前端的消费点定契约)。 +REPORT_SRC = "api/onlineDev/report.ts" + +# onlineDev:官方 Controller(`jnpf-visualdev` 模块)⇒ 文件名 + 映射行号 +_VISUALDEV_CONTROLLERS = { + "VisualdevController.java": { + "GET /api/visualdev/Base": 134, + "GET /api/visualdev/Base/list": 180, + "GET /api/visualdev/Base/Selector": 210, + "GET /api/visualdev/Base/{id}": 328, + "GET /api/visualdev/Base/{id}/FormDataFields": 348, + "GET /api/visualdev/Base/{id}/FieldDataSelect": 363, + "POST /api/visualdev/Base/{id}/Actions/Copy": 377, + "PUT /api/visualdev/Base/{id}": 429, + "POST /api/visualdev/Base": 504, + "DELETE /api/visualdev/Base/{id}": 578, + "POST /api/visualdev/Base/{id}/Actions/Release": 600, + "POST /api/visualdev/Base/{id}/Actions/Module": 687, + "GET /api/visualdev/Base/{id}/getReleaseMenu": 738, + "GET /api/visualdev/Base/getColumnList": 764, + "GET /api/visualdev/Base/getListBySystem": 819, + }, + "VisualdevShortLinkController.java": { + "GET /api/visualdev/ShortLink/{id}": 101, + "PUT /api/visualdev/ShortLink": 139, + "GET /api/visualdev/ShortLink/getConfig/{id}": 229, + "POST /api/visualdev/ShortLink/checkPwd": 244, + "GET /api/visualdev/ShortLink/Config": 263, + "POST /api/visualdev/ShortLink/{id}/ListLink": 292, + "GET /api/visualdev/ShortLink/{id}/{id}/DataChange": 322, + "POST /api/visualdev/ShortLink/{id}": 341, + }, + "VisualdevGenController.java": { + "POST /api/visualdev/Generater/{id}/Actions/DownloadCode": 122, + "POST /api/visualdev/Generater/{id}/Actions/CodePreview": 175, + "GET /api/visualdev/Generater/{id}/Alias/Info": 289, + "POST /api/visualdev/Generater/{id}/Alias/Save": 298, + }, + "VisualdevModelDataController.java": { + "POST /api/visualdev/OnlineDev/{model_id}/List": 312, + "GET /api/visualdev/OnlineDev/{model_id}/Config": 417, + "GET /api/visualdev/OnlineDev/{model_id}/FormData": 460, + "GET /api/visualdev/OnlineDev/{model_id}/{id}": 470, + "POST /api/visualdev/OnlineDev/{model_id}/DataChange": 484, + "POST /api/visualdev/OnlineDev/{model_id}": 515, + "PUT /api/visualdev/OnlineDev/{model_id}/{id}": 545, + "DELETE /api/visualdev/OnlineDev/{model_id}/{id}": 574, + "POST /api/visualdev/OnlineDev/batchDelete/{model_id}": 638, + "POST /api/visualdev/OnlineDev/{model_id}/Actions/ExportData": 790, + "POST /api/visualdev/OnlineDev/{model_id}/Actions/Export": 855, + "POST /api/visualdev/OnlineDev/{model_id}/actionLaunchFlow": 1103, + "GET /api/visualdev/OnlineDev/Config": 1143, + "POST /api/visualdev/OnlineDev/RelationQuery": 1177, + }, + "VisualPersonalController.java": { + "GET /api/visualdev/personal": 51, + "POST /api/visualdev/personal": 60, + "GET /api/visualdev/personal/{id}": 86, + "PUT /api/visualdev/personal/{id}": 96, + "PUT /api/visualdev/personal/{id}/setDefault": 118, + "DELETE /api/visualdev/personal/{id}": 140, + }, + "VisualLogController.java": { + "GET /api/visualdev/OnlineLog": 39, + }, + "SystemShareController.java": { + "GET /api/visualdev/share": 61, + "POST /api/visualdev/share/SelectedList": 72, + "POST /api/visualdev/share/save": 80, + "GET /api/visualdev/share/Selector": 87, + }, + "OcrController.java": { + "POST /api/visualdev/ocr": 48, + }, + "PortalController.java": { + "GET /api/visualdev/Portal": 94, + "GET /api/visualdev/Portal/Selector": 106, + "GET /api/visualdev/Portal/Selector/Menu": 115, + "GET /api/visualdev/Portal/{id}": 122, + "DELETE /api/visualdev/Portal/{id}": 149, + "POST /api/visualdev/Portal": 165, + "POST /api/visualdev/Portal/{id}/Actions/Copy": 192, + "PUT /api/visualdev/Portal/{id}": 217, + "POST /api/visualdev/Portal/{id}/Actions/Export": 256, + "GET /api/visualdev/Portal/systemFilter/{id}": 347, + }, + "PortalDataController.java": { + "PUT /api/visualdev/Portal/{id}/Actions/SetDefault": 57, + "PUT /api/visualdev/Portal/Custom/Save/{id}": 71, + "PUT /api/visualdev/Portal/Actions/release/{id}": 93, + "GET /api/visualdev/Portal/{id}/auth": 114, + }, + "DashboardController.java": { + "POST /api/visualdev/Dashboard/Notice": 45, + "GET /api/visualdev/Dashboard/Email": 59, + }, +} + +# 🔴 **官方没有 Java Controller** 的少数几条 ⇒ 出处指向**官方前端 api 文件** +# (官方就是靠前端声明访问这些端点的)。 +FRONTEND_ONLY_SOURCES = { + "GET /api/system/PortalManage/list/{system_id}": "api/onlineDev/portal.ts:79", + "GET /api/system/PortalManage/{id}": "api/onlineDev/portal.ts:87", + "POST /api/system/PortalManage": "api/onlineDev/portal.ts:91", + "PUT /api/system/PortalManage/{id}": "api/onlineDev/portal.ts:95", + "DELETE /api/system/PortalManage/{id}": "api/onlineDev/portal.ts:99", + "GET /api/system/atlas": "ProvinceAtlasController.java:78", + "GET /api/system/atlas/geojson": "ProvinceAtlasController.java:121", + "GET /api/blade-visual/visual/Selector": "VisualController.java:288", + "GET /api/visualdev/Portal/manage/Selector/{system_id}": "api/onlineDev/portal.ts:84", + # 🔴 官方前端声明了,但官方 Java **没有**对应 `@XxxMapping` + # (Controller 里只有 `/TemplateDownload`)⇒ 出处指向官方前端声明行。 + "GET /api/visualdev/OnlineDev/{model_id}/Template": "api/onlineDev/visualDev.ts:137", + "POST /api/visualdev/OnlineDev/{model_id}/Actions/Export": "api/onlineDev/visualDev.ts:141", +} + +# 🔴 官方前端 `api/onlineDev/report.ts` 的行号(逐条核对过官方源文件)。 +REPORT_FRONTEND_LINES = { + "GET /api/Report": 14, + "POST /api/Report": 18, + "PUT /api/Report/{id}": 22, + "GET /api/Report/{id}": 26, + "DELETE /api/Report/{id}": 30, + "POST /api/Report/{id}/Actions/Copy": 34, + "GET /api/Report/{id}/Actions/Export": 42, + "POST /api/Report/Data": 46, + "POST /api/Report/Save": 50, + "GET /api/Report/Info/{id}": 54, + "GET /api/Report/Version/{id}": 58, + "DELETE /api/Report/Info/{id}": 62, + "POST /api/Report/Info/{id}": 66, + "POST /api/Report/data/{id}/preview": 70, + "POST /api/Report/data/{id}/previewTemplate": 74, + "GET /api/Report/Selector": 78, + "POST /api/Report/data/upload/file": 82, + "POST /api/Report/data/downImg": 86, + "POST /api/Report/data/ImportExcel": 90, + "POST /api/Report/data/{id}/DownExcel": 94, + "GET /api/Report/{id}/getReleaseMenu": 98, + "POST /api/Report/{id}/Actions/Module": 102, + "GET /api/Report/data/{id}/getQueryList": 106, +} + +# 🔴 **状态判定**:本仓**诚实失败**(无文件服务 / 无渲染器 / 无数据引擎) +# 的端点 ⇒ `partial`(已落地但**形状有偏差**);完全对齐 ⇒ `implemented`。 +# 键 = `(method, path)`;值 = (status, note)。 +PARTIAL_NOTES = { + # ---- Report:无文件服务 / 无 Univer 渲染器 / 无数据引擎 ⇒ 明确业务失败 ---- + ("POST", "/api/Report/data/upload/file"): ( + "partial", "本仓无文件服务 ⇒ **明确业务失败**(不返假 URL)"), + ("POST", "/api/Report/data/downImg"): ( + "partial", "本仓无文件服务 ⇒ **明确业务失败**(不返假 URL)"), + ("POST", "/api/Report/data/ImportExcel"): ( + "partial", "本仓无 Excel 引擎 ⇒ **明确业务失败**"), + ("POST", "/api/Report/data/{id}/DownExcel"): ( + "partial", "本仓无 Excel 引擎 ⇒ **明确业务失败**"), + ("POST", "/api/Report/data/{id}/preview"): ( + "partial", "本仓无 Univer 渲染器 ⇒ **明确业务失败**(不返假 URL)"), + ("POST", "/api/Report/data/{id}/previewTemplate"): ( + "partial", "本仓无 Univer 渲染器 ⇒ **明确业务失败**(不返假 URL)"), + ("GET", "/api/Report/{id}/Actions/Export"): ( + "partial", "本仓无数据引擎 ⇒ **明确业务失败**"), + ("POST", "/api/Report/Data"): ( + "partial", "本仓无数据引擎 ⇒ **明确业务失败**"), + ("POST", "/api/Report/{id}/Actions/Module"): ( + "partial", "菜单 URL 用官方前端路由 `/reportPreview`(`router/routes/core.ts:92`);" + "本仓无菜单服务 ⇒ 只回填 id / 父节点"), + ("GET", "/api/Report/{id}/getReleaseMenu"): ( + "partial", "本仓无菜单服务 ⇒ `pcIsRelease`/`appIsRelease` 恒 false," + "两个 `*ReleaseName` 恒空串(官方消费这四个字段)"), + # ---- onlineDev:官方依赖**代码生成器 / 表引擎 / 流程引擎**的部分 ---- + ("POST", "/api/visualdev/Generater/{id}/Actions/DownloadCode"): ( + "partial", "本仓无代码生成器 ⇒ **明确业务失败**"), + ("POST", "/api/visualdev/Generater/{id}/Actions/CodePreview"): ( + "partial", "本仓无代码生成器 ⇒ **明确业务失败**"), + ("GET", "/api/visualdev/Generater/{id}/Alias/Info"): ( + "partial", "本仓无代码生成器别名表 ⇒ 恒空"), + ("POST", "/api/visualdev/Generater/{id}/Alias/Save"): ( + "partial", "本仓无代码生成器别名表 ⇒ **明确业务失败**"), + ("POST", "/api/visualdev/OnlineDev/{model_id}/Actions/Export"): ( + "partial", "本仓无代码生成器 ⇒ **明确业务失败**"), + ("GET", "/api/visualdev/OnlineDev/{model_id}/Template"): ( + "partial", "本仓无代码生成器 ⇒ **明确业务失败**"), + ("POST", "/api/visualdev/OnlineDev/{model_id}/DataChange"): ( + "partial", "本仓无数据引擎(在线表单的数据增删改查)⇒ **明确业务失败**"), + ("POST", "/api/visualdev/OnlineDev/{model_id}/List"): ( + "partial", "本仓无数据引擎(在线表单的数据列表)⇒ **明确业务失败**"), + ("GET", "/api/visualdev/OnlineDev/{model_id}/FormData"): ( + "partial", "本仓无数据引擎(在线表单的表结构)⇒ **明确业务失败**"), + ("POST", "/api/visualdev/OnlineDev/{model_id}"): ( + "partial", "本仓无数据引擎(在线表单建表)⇒ **明确业务失败**"), + ("PUT", "/api/visualdev/OnlineDev/{model_id}/{id}"): ( + "partial", "本仓无数据引擎(在线表单改表)⇒ **明确业务失败**"), + ("GET", "/api/visualdev/OnlineDev/{model_id}/{id}"): ( + "partial", "本仓无数据引擎(在线表单数据详情)⇒ **明确业务失败**"), + ("DELETE", "/api/visualdev/OnlineDev/{model_id}/{id}"): ( + "partial", "本仓无数据引擎(在线表单删表)⇒ **明确业务失败**"), + ("POST", "/api/visualdev/OnlineDev/batchDelete/{model_id}"): ( + "partial", "本仓无数据引擎 ⇒ **明确业务失败**"), + ("POST", "/api/visualdev/OnlineDev/{model_id}/Actions/ExportData"): ( + "partial", "本仓无 Excel 引擎 ⇒ **明确业务失败**"), + ("POST", "/api/visualdev/OnlineDev/{model_id}/actionLaunchFlow"): ( + "partial", "本仓无流程引擎 ⇒ **明确业务失败**"), + ("GET", "/api/visualdev/Base/{id}/FieldDataSelect"): ( + "partial", "本仓无数据引擎(关联数据分页)⇒ **明确业务失败**"), + ("POST", "/api/visualdev/ocr"): ( + "partial", "本仓无 OCR 服务 ⇒ **明确业务失败**"), + ("GET", "/api/system/atlas/geojson"): ( + "partial", "本仓无省级行政区划 GeoJSON 数据 ⇒ **明确业务失败**"), + ("GET", "/api/blade-visual/visual/Selector"): ( + "partial", "本仓无 DataV 组件库 ⇒ 恒空列表"), + ("POST", "/api/visualdev/Portal/{id}/Actions/Export"): ( + "partial", "本仓无文件服务 ⇒ **明确业务失败**"), +} + +# 🔴 **端点顺序**:按官方模块分组,组内按路径排 —— 与 `routes.rs` 的注册顺序对齐 +# (⇒ 契约读起来与代码读起来同序 ⇒ 人工 review 不用来回跳)。 +MODULE_ORDER = ["online_dev", "report"] + +# 🔴 **默认 note**(未在 `PARTIAL_NOTES` 里显式标注的端点)。 +DEFAULT_NOTES = { + "online_dev": "面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现", + "report": "面 B 已落地:官方 `/api/Report/*` 在官方是**独立部署的第三方服务**" + "(`jnpf-java-datareport-univer`,端口 32000)⇒ 本仓把报表元数据**就地落库**" + "(`report_template` + `report_version`,表结构照官方 DDL 逐字导入)", +} + + +def norm_path(p): + return re.sub(r"\{[^/{}]*\}", "{}", p) + + +def build_rows(modules): + """⇒ (endpoint_rows, official_rows) —— 两张表都是「代码里已有、契约里还没有」的。""" + snap = S.scan_code(os.path.join(ROOT, "src", "backend", "src"), os.path.join(ROOT, "packs")) + plat_files = snap["plat_files"] + plat_consts = snap.get("plat_consts") or {} + + # 契约里**已经登记**的(method, 归一路径) + sections = S.contract_expect.load_sections(CONTRACT) + done_ep = set() + for e in sections["ENDPOINT"]: + done_ep.add((e["method"], norm_path(e["path"]))) + done_off = set() + for o in sections["OFFICIAL"]: + if o["method"] != "*": + done_off.add((o["method"], norm_path(o["path"]))) + + ep_rows = [] + off_rows = [] + for r in snap["plat"]: + if r.get("source") != "platform": + continue + mp = r.get("mod_path") or "" + if not mp.startswith("compat::"): + continue + mod = r["mod"] + if mod not in modules: + continue + guard = S.guard_of_platform(plat_files, mod, r["fn"], mp, plat_consts) + if guard is None: + raise SystemExit("推不出守卫:%s %s(%s::%s)" % (r["method"], r["path"], mod, r["fn"])) + key = (r["method"], r["path"]) + nkey = (r["method"], norm_path(r["path"])) + if nkey not in done_ep: + ep_rows.append(("B", r["method"], r["path"], guard, "platform")) + done_ep.add(nkey) + if nkey in done_off: + continue + src, status, note = official_entry(mod, key, r["path"]) + off_rows.append((r["method"], r["path"], status, src, note)) + done_off.add(nkey) + return ep_rows, off_rows + + +def official_entry(mod, key, path): + """⇒ (src, status, note) —— 官方出处 + 落地状态 + 偏差说明。""" + method = key[0] + if mod == "report": + line = REPORT_FRONTEND_LINES.get("%s %s" % (method, path)) + src = "%s:%d" % (REPORT_SRC, line) if line else REPORT_SRC + status, note = PARTIAL_NOTES.get(key, ("implemented", DEFAULT_NOTES["report"])) + return src, status, note + # onlineDev + k = "%s %s" % (method, path) + for ctrl, table in _VISUALDEV_CONTROLLERS.items(): + if k in table: + src = "%s:%d" % (ctrl, table[k]) + status, note = PARTIAL_NOTES.get(key, ("implemented", DEFAULT_NOTES["online_dev"])) + return src, status, note + src = FRONTEND_ONLY_SOURCES.get(k) + if src: + status, note = PARTIAL_NOTES.get(key, ("implemented", DEFAULT_NOTES["online_dev"])) + return src, status, note + raise SystemExit("没有官方出处可登记:%s %s" % (method, path)) + + +def append_to_contract(ep_rows, off_rows, dry=False): + """把两批行写进 `docs/contract.md`(追加到对应段的末尾)。""" + with open(CONTRACT, encoding="utf-8") as fh: + text = fh.read() + + def append_at(section, rows, render): + marker = "\n[%s]\n" % section + i = text.find(marker) + if i < 0: + raise SystemExit("契约里找不到区段 [%s]" % section) + # 找到该区的**结束**位置(下一个 `[\n` 开头的区段,或围栏结束) + j = text.find("\n[", i + len(marker)) + if j < 0: + j = len(text) + block = text[i:j] + if not rows: + return text + add = "".join(render(r) for r in rows) + return text[:j] + add + text[j:] + + if ep_rows: + text = append_at("ENDPOINT", ep_rows, + lambda r: "%s\t%s\t%s\t%s\t%s\n" % r) + if off_rows: + text = append_at("OFFICIAL", off_rows, + lambda r: "%s\t%s\t%s\t%s\t%s\n" % r) + if dry: + for r in ep_rows: + print("EP\t" + "\t".join(r)) + for r in off_rows: + print("OFF\t" + "\t".join(r)) + return + with open(CONTRACT, "w", encoding="utf-8") as fh: + fh.write(text) + + +def main(argv): + modules = MODULE_ORDER + dry = False + if "--dry-run" in argv: + dry = True + if "--only" in argv: + i = argv.index("--only") + modules = [m.strip() for m in argv[i + 1].split(",") if m.strip()] + ep_rows, off_rows = build_rows(modules) + append_to_contract(ep_rows, off_rows, dry) + if not dry: + print("已写入 %s:[ENDPOINT] +%d 条 / [OFFICIAL] +%d 条" + % (os.path.relpath(CONTRACT, ROOT), len(ep_rows), len(off_rows))) + return 0 + + +if __name__ == "__main__": + sys.exit(main(sys.argv)) diff --git a/src/backend/db/schema.sql b/src/backend/db/schema.sql index 27a50e5..88c9863 100644 --- a/src/backend/db/schema.sql +++ b/src/backend/db/schema.sql @@ -3000,3 +3000,69 @@ CREATE TABLE base_visual_personal ( PRIMARY KEY (f_id, f_tenant_id) ); +-- ================================================================ +-- 在线报表(官方 `report_template` + `report_version`) +-- +-- 🔴 **来源**:官方 `jnpf-database/PostgreSQL/JNPF-PostgreSQL.sql` 逐字导入。 +-- 官方另有 `report_charts` / `report_user` / `report_department` 三张 +-- **示例数据表**(字段是 `qybm`/`fxdmc`/`education`/`salary` 之类演示数据, +-- 非平台元数据)⇒ **不导入**。 +-- +-- 🔴 **为什么只有两张**:官方 `/api/Report/*` 属于**独立部署**的第三方报表服务 +-- (`jnpf-java-datareport-univer`,端口 32000),主后端 `jnpf-java-boot` 里 +-- **没有** `/api/Report` Controller(只有 `ReportExportUtil` 把这些路径当 +-- 远程 HTTP URL 拼)。本仓把报表元数据**就地落库**,让前端报表列表/表单/ +-- 版本管理能真跑;**依赖 Univer 设计器与文件服务的能力一律明确失败**。 +-- ================================================================ + +CREATE TABLE report_template ( + f_id VARCHAR(50) NOT NULL, + f_version_id VARCHAR(50), + f_full_name VARCHAR(200) NOT NULL, + f_en_code VARCHAR(50) NOT NULL, + f_category VARCHAR(50) NOT NULL, + f_description VARCHAR(500), + f_enabled_mark INTEGER, + f_sort_code BIGINT, + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_creator_user_id VARCHAR(50), + f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_last_modify_user_id VARCHAR(50), + f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_user_id VARCHAR(50), + f_delete_mark INTEGER, + f_tenant_id VARCHAR(50) NOT NULL, + f_allow_export INTEGER, + f_allow_print INTEGER, + f_platform_release VARCHAR(100), + f_allow_watermark INTEGER, + f_watermark_config TEXT, + f_system_id VARCHAR(50), + PRIMARY KEY (f_id, f_tenant_id) +); + +CREATE TABLE report_version ( + f_id VARCHAR(50) NOT NULL, + f_template_id VARCHAR(50), + f_state INTEGER, + f_version INTEGER, + f_cells TEXT, + f_snapshot TEXT, + f_query_list TEXT, + f_convert_config TEXT, + f_sort_code BIGINT, + f_description VARCHAR(500), + f_enabled_mark INTEGER, + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_creator_user_id VARCHAR(50), + f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_last_modify_user_id VARCHAR(50), + f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_user_id VARCHAR(50), + f_delete_mark INTEGER, + f_tenant_id VARCHAR(50) NOT NULL, + f_sort_list TEXT, + f_column_list TEXT, + f_fence_list TEXT, + PRIMARY KEY (f_id, f_tenant_id) +); diff --git a/src/backend/src/main.rs b/src/backend/src/main.rs index dc83906..6e90f83 100644 --- a/src/backend/src/main.rs +++ b/src/backend/src/main.rs @@ -876,10 +876,17 @@ fn whitelist_self_check() -> Result<(), String> { .unwrap_or_default(); let ddl_tables = ssw_platform::platform::db::ddl_tables(); + // 🔴 **报表元数据表**(`report_template` / `report_version`)是**契约面的固定装置**: + // 官方 `/api/Report/*` 属于独立部署的第三方报表服务,主后端没有对应 Controller + // ⇒ 本仓把元数据**就地落库** ⇒ 它们既不是 `base_*` 平台表,也不是业务 spec 表。 + // 清单真源在 `sspf_store::db::REPORT_TABLES`(与存储层的表数断言同一处)。 + let report_tables = ssw_platform::platform::db::REPORT_TABLES; + for table in &ddl_tables { if !BASE_TABLES.contains(&table.as_str()) && !spec_tables.contains(&table.as_str()) && !pack_tables.contains(&table.as_str()) + && !report_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 d401bb8..19064e8 100644 --- a/src/backend/src/platform/compat/mod.rs +++ b/src/backend/src/platform/compat/mod.rs @@ -22,3 +22,5 @@ pub mod permission; pub mod message; pub mod scheduletask; pub mod core; +pub mod online_dev; +pub mod report; diff --git a/src/backend/src/platform/compat/online_dev.rs b/src/backend/src/platform/compat/online_dev.rs new file mode 100644 index 0000000..bc03e30 --- /dev/null +++ b/src/backend/src/platform/compat/online_dev.rs @@ -0,0 +1,3174 @@ +//! online_dev —— 官方面 B 的 **onlineDev** 端点集。 +//! +//! 🔴 **覆盖官方前端 `api/onlineDev/**` 的 6 个文件**: +//! `visualDev.ts`(表单设计 + 在线日志 + 个性化视图 + 分享 + 代码生成 + OCR)、 +//! `portal.ts`(门户 + 门户管理 + 行政区划 + 通知公告 + 邮件)、 +//! `shortLink.ts`(外链)、`report.ts`(在线报表)、`dataV.ts`(DataV 选择器)。 +//! +//! 🔴 **三条判据**(沿用批次 14/15/16): +//! ① **能力不存在 ⇒ 明确业务失败**(HTTP 200 + `code=400`),不返假数据。 +//! 本仓**没有**:工作流引擎、低代码引擎(动态建表)、Univer 报表设计器、 +//! 文件服务、OCR 服务、代码生成器(Velocity 模板)。凡是依赖它们的动作 +//! 一律明确失败。 +//! ② 官方 `@SaCheckPermission` **逐条照抄**;本仓没有的 `f_en_code` 未映射 ⇒ 放行。 +//! ③ 分页统一 `PageListVO` 形状(`data.pagination` + `data.list`); +//! 选择器统一 `ListVO` 形状(`data.list`)。 +//! +//! 🔴 **写路径的三条硬律**(与契约面同一套): +//! 1. 列名只来自常量白名单(请求里的键永不进 SQL 文本); +//! 2. 只 SET body 里真出现的键; +//! 3. 审计列用 SQL 自己的 `now()`,**不占参数位**。 + +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::auth::require_login_face_b; +use crate::platform::crud::value_to_text; +use crate::platform::db::{pglite::ToSql, Db}; +use crate::platform::envelope::{code, fail, ok, ActionResult}; +use crate::platform::ids::new_uuid; +use crate::platform::state::AppState; +use crate::platform::registry; + +use super::helper::{ + db_error, guard, guard_any, id_list_of, list_vo, page_list, params_of, parse_body, placeholder, + qv, Paging, +}; + +// ---------------------------------------------------------------- 官方点权限码 + +/// 🔴 `@SaCheckPermission("onlineDev.formDesign")`(官方 `VisualdevController` / +/// `VisualdevShortLinkController` / `VisualdevModelDataController`)。 +const EN_FORM_DESIGN: &str = "onlineDev.formDesign"; +/// 🔴 `@SaCheckPermission("onlineDev.sysForm")` —— 官方 `VisualdevController` 的 +/// **OR 第二码**(与 `EN_FORM_DESIGN` 择一即可)。 +const EN_SYS_FORM: &str = "onlineDev.sysForm"; +/// 🔴 `@SaCheckPermission("generator.flowForm")` —— 官方 `VisualdevController` 的 +/// **OR 第三码**。 +const EN_GENERATOR_FLOW_FORM: &str = "generator.flowForm"; +/// 🔴 `@SaCheckPermission("generator.webForm")` —— 官方 `VisualdevGenController` 的 +/// **OR 第二码**。 +const EN_GENERATOR_WEB_FORM: &str = "generator.webForm"; +/// 🔴 `@SaCheckPermission("onlineDev.visualPortal")`(官方 `PortalController`)。 +const EN_VISUAL_PORTAL: &str = "onlineDev.visualPortal"; + +// ---------------------------------------------------------------- 通用小工具 + + + +/// body ⇒ 白名单内的 `(列, CAST, 值)`;**只收 body 里真出现的键**。 +/// +/// 🔴 白名单是 `&'static` —— 列名 / CAST 串都来自**常量表**(编译期已知), +/// 绝不能来自请求内容(那等于让调用方决定 SQL 文本)。 +fn write_fields( + obj: &Map, + whitelist: &[(&'static str, &'static str, &'static str)], +) -> Vec<(&'static str, &'static str, Option)> { + let mut out = Vec::new(); + for (json_key, column, cast) in whitelist { + if obj.contains_key(*json_key) { + out.push((*column, *cast, value_to_text(obj.get(*json_key)))); + } + } + out +} + + +/// 🔴 **「能力不存在」的统一口径** —— 明确业务失败,不返假数据。 +/// +/// 官方前端在这些端点上会直接 `res.data.xxx` ⇒ 返 `data:null` 会抛 JS 异常, +/// 返空数组/空对象则是**撒谎**(页面显示「没有数据」而不是「不支持」)。 +fn unsupported(what: &str) -> Json { + fail(code::FAIL, format!("本极简引擎不支持{what}")) +} + +/// 纯 id 列表 ⇒ SQL 参数(`$1::text` 风格由调用方拼)。 +/// +/// 🔴 与 [`super::helper::params_of`] 的区别:那个吃 `&[Option]` +/// (因为多数查询的条件值可能是 NULL);这里全是**非空 id**,省掉一层包装。 +fn params_of_str(values: &[String]) -> Vec<&(dyn ToSql + Sync)> { + values.iter().map(|v| v as &(dyn ToSql + Sync)).collect() +} + +/// 本仓当前系统 id(`base_system.f_id`)。 +async fn current_system_id(db: &Db) -> String { + registry::resolve_system(db, None).await.id +} + +// ================================================================ 表单设计(Base) +// +// 官方:`jnpf-visualdev-base-controller/.../VisualdevController.java`(`/api/visualdev/Base`) +// 表:`base_visual_dev`(设计稿)+ `base_visual_release`(已发布版本) +// 前端:`jnpf-web-apps-main/src/api/onlineDev/visualDev.ts` + +/// `base_visual_dev` 的写白名单:`(JSON 键, 列名, CAST)`。 +/// +/// 🔴 键名逐字对齐官方 `VisualDevCrForm` / `VisualDevUpForm` 的字段名, +/// **不是**机械的下划线转换(`webType` ⇒ `f_web_type` 是对的, +/// 但 `formData` ⇒ `f_form_data`、`columnData` ⇒ `f_column_data` 也是对的; +/// 而 `tablesData` ⇒ `f_tables_data`)。 +const VISUAL_DEV_WRITE_FIELDS: &[(&str, &str, &str)] = &[ + ("fullName", "f_full_name", ""), + ("enCode", "f_en_code", ""), + ("state", "f_state", "::integer"), + ("type", "f_type", "::integer"), + ("tablesData", "f_tables_data", ""), + ("category", "f_category", ""), + ("formData", "f_form_data", ""), + ("columnData", "f_column_data", ""), + ("dbLinkId", "f_db_link_id", ""), + ("webType", "f_web_type", "::integer"), + ("appColumnData", "f_app_column_data", ""), + ("enableFlow", "f_enable_flow", "::integer"), + ("interfaceId", "f_interface_id", ""), + ("interfaceParam", "f_interface_param", ""), + ("description", "f_description", ""), + ("enabledMark", "f_enabled_mark", "::integer"), + ("sortCode", "f_sort_code", "::bigint"), + ("urlAddress", "f_url_address", ""), + ("appUrlAddress", "f_app_url_address", ""), + ("interfaceUrl", "f_interface_url", ""), + ("webAddress", "f_web_address", ""), + ("buttonData", "f_button_data", ""), + ("appAddress", "f_app_address", ""), + ("appButtonData", "f_app_button_data", ""), +]; + +/// `base_visual_dev` 的详情投影(`VisualDevInfoVO` 形状)。 +const VISUAL_DEV_DETAIL_COLUMNS: &str = "f_id AS \"id\", f_full_name AS \"fullName\", \ + f_en_code AS \"enCode\", COALESCE(f_state, 0) AS \"state\", \ + COALESCE(f_type, 0) AS \"type\", f_tables_data AS \"tablesData\", \ + f_category AS \"category\", f_form_data AS \"formData\", \ + f_column_data AS \"columnData\", f_db_link_id AS \"dbLinkId\", \ + COALESCE(f_web_type, 0) AS \"webType\", f_app_column_data AS \"appColumnData\", \ + COALESCE(f_enable_flow, 0) AS \"enableFlow\", f_interface_id AS \"interfaceId\", \ + f_interface_param AS \"interfaceParam\", f_description AS \"description\", \ + COALESCE(f_enabled_mark, 0) AS \"enabledMark\", COALESCE(f_sort_code, 0) AS \"sortCode\", \ + f_url_address AS \"urlAddress\", f_app_url_address AS \"appUrlAddress\", \ + f_interface_url AS \"interfaceUrl\", f_web_address AS \"webAddress\", \ + f_button_data AS \"buttonData\", f_app_address AS \"appAddress\", \ + f_app_button_data AS \"appButtonData\", f_platform_release AS \"platformRelease\", \ + f_system_id AS \"systemId\", \ + (EXTRACT(EPOCH FROM f_creator_time) * 1000)::bigint AS \"creatorTime\", \ + f_creator_user_id AS \"creatorUserId\", \ + (EXTRACT(EPOCH FROM f_last_modify_time) * 1000)::bigint AS \"lastModifyTime\", \ + f_last_modify_user_id AS \"lastModifyUserId\", \ + COALESCE(f_delete_mark, 0) AS \"deleteMark\""; + +/// `GET /api/visualdev/Base` —— 功能(表单设计)列表。 +/// +/// 官方 `VisualdevController.java:120`(`ActionResult>`)。 +/// +/// 🔴 官方会拼 `creatorUser` / `lastModifyUser` = `真实姓名/账号`; +/// 本仓查 `base_user` 拼同样的形状(查不到 ⇒ 空串,与官方同口径)。 +pub async fn visual_dev_list( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard_any(&state, &headers, &[EN_FORM_DESIGN, EN_SYS_FORM, EN_GENERATOR_FLOW_FORM]).await { + return resp; + } + let page = Paging::of(&raw); + let keyword = qv(&raw, "keyword"); + let system_id = current_system_id(&state.db).await; + + // 🔴 空关键词 ⇒ **一个参数都不传**(SQL 里没有 `$1`)。 + let kw_filter = if keyword.is_empty() { + String::new() + } else { + " AND (f_full_name ILIKE $1::text OR f_en_code ILIKE $1::text)".to_string() + }; + let mut values: Vec> = Vec::new(); + if !keyword.is_empty() { + values.push(Some(format!("%{keyword}%"))); + } + let kw_count = values.len(); + + let total_sql = format!( + "SELECT count(*)::bigint AS \"c\" FROM base_visual_dev \ + WHERE f_delete_mark = 0 AND f_system_id = $1::text{}", + kw_filter + ); + // 🔴 **参数个数必须跟 SQL 里的 `$N` 对上**:空关键词时 SQL 只有 `$1`(system_id) + // ⇒ 只能传 **1 个**参数。传 2 个 ⇒ PG 报 + // `protocol error: statement takes 1 parameters, 2 given`(批次 17 集成测试抓到的)。 + let mut total_params: Vec> = vec![Some(system_id.clone())]; + if !keyword.is_empty() { + total_params.push(values.first().cloned().flatten()); + } + let total = match state + .db + .query_json_params(&total_sql, ¶ms_of(&total_params)) + .await + { + Ok(rows) => rows + .into_iter() + .next() + .and_then(|r| r["c"].as_i64()) + .unwrap_or(0), + Err(e) => return db_error(e, "功能列表总数查询"), + }; + + values.push(Some(page.page_size.to_string())); + values.push(Some(page.offset.to_string())); + let params = params_of(&values); + let p_limit = kw_count + 1; + let p_offset = kw_count + 2; + + let sql = format!( + "SELECT v.f_id AS \"id\", v.f_full_name AS \"fullName\", v.f_en_code AS \"enCode\", \ + COALESCE(v.f_state, 0) AS \"state\", COALESCE(v.f_type, 0) AS \"type\", \ + v.f_category AS \"category\", COALESCE(v.f_web_type, 0) AS \"webType\", \ + COALESCE(v.f_enabled_mark, 0) AS \"enabledMark\", \ + COALESCE(v.f_sort_code, 0) AS \"sortCode\", \ + (EXTRACT(EPOCH FROM v.f_creator_time) * 1000)::bigint AS \"creatorTime\", \ + v.f_creator_user_id AS \"creatorUserId\", \ + (EXTRACT(EPOCH FROM v.f_last_modify_time) * 1000)::bigint AS \"lastModifyTime\", \ + v.f_last_modify_user_id AS \"lastModifyUserId\", \ + COALESCE(u.f_real_name, '') || '/' || COALESCE(u.f_account, '') AS \"creatorUser\", \ + COALESCE(lu.f_real_name, '') || '/' || COALESCE(lu.f_account, '') AS \"lastModifyUser\", \ + TRUE AS \"hasPackage\" \ + FROM base_visual_dev v \ + LEFT JOIN base_user u ON u.f_id = v.f_creator_user_id \ + LEFT JOIN base_user lu ON lu.f_id = v.f_last_modify_user_id \ + WHERE v.f_delete_mark = 0 AND v.f_system_id = $1::text{} \ + ORDER BY v.f_sort_code ASC, v.f_creator_time DESC \ + LIMIT ${p_limit}::text::integer OFFSET ${p_offset}::text::integer", + kw_filter + ); + let rows = match state.db.query_json_params(&sql, ¶ms).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "功能列表查询"), + }; + ok(page_list(page.current_page, page.page_size, total, rows)) +} + +/// `GET /api/visualdev/Base/list` —— 功能列表(集成助手用)。 +/// +/// 官方 `VisualdevController.java:151`(`VisualDevListVO` 形状)。 +/// +/// 🔴 官方那条路径带 `flowStart` 分支(查工作流引用)—— 本仓没有工作流引擎 ⇒ 恒不引用。 +pub async fn visual_dev_form_list( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let page = Paging::of(&raw); + let system_id = current_system_id(&state.db).await; + + let total = match state + .db + .query_json_params( + "SELECT count(*)::bigint AS \"c\" FROM base_visual_dev \ + WHERE f_delete_mark = 0 AND f_system_id = $1::text AND COALESCE(f_enable_flow, 0) = 1", + &[&system_id], + ) + .await + { + Ok(rows) => rows + .into_iter() + .next() + .and_then(|r| r["c"].as_i64()) + .unwrap_or(0), + Err(e) => return db_error(e, "功能列表总数查询"), + }; + + let values = [ + Some(system_id.clone()), + Some(page.page_size.to_string()), + Some(page.offset.to_string()), + ]; + let params = params_of(&values); + let sql = "SELECT f_id AS \"id\", f_full_name AS \"fullName\", f_en_code AS \"enCode\", \ + COALESCE(f_type, 0) AS \"type\", COALESCE(f_web_type, 0) AS \"webType\", \ + COALESCE(f_state, 0) AS \"state\", 0 AS \"isQuote\" \ + FROM base_visual_dev \ + WHERE f_delete_mark = 0 AND f_system_id = $1::text AND COALESCE(f_enable_flow, 0) = 1 \ + ORDER BY f_sort_code ASC, f_full_name ASC \ + LIMIT $2::text::integer OFFSET $3::text::integer"; + let rows = match state.db.query_json_params(sql, ¶ms).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "功能列表查询"), + }; + ok(page_list(page.current_page, page.page_size, total, rows)) +} + +/// `GET /api/visualdev/Base/Selector` —— 功能下拉框(**树形**)。 +/// +/// 官方 `VisualdevController.java:186`(`ListVO`)。 +/// +/// 🔴 本仓单系统 ⇒ 按 `f_category` 分组(官方非主系统分支同口径); +/// `type` 过滤(1=表单设计,2=系统表单)。 +pub async fn visual_dev_selector( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let system_id = current_system_id(&state.db).await; + let ty = qv(&raw, "type"); + let is_release = qv(&raw, "isRelease"); + let web_type = qv(&raw, "webType"); + + // 🔴 `isRelease != null` ⇒ 查**已发布**表(官方 `visualdevReleaseService.selectorList`)。 + let (table, extra) = if is_release.is_empty() { + ("base_visual_dev", " AND f_delete_mark = 0") + } else { + ("base_visual_release", " AND COALESCE(f_delete_mark, 0) = 0") + }; + + let mut sql = format!( + "SELECT f_id AS \"id\", f_full_name AS \"fullName\", f_en_code AS \"enCode\", \ + f_category AS \"category\", COALESCE(f_type, 0) AS \"type\", \ + COALESCE(f_web_type, 0) AS \"webType\" \ + FROM {table} WHERE f_system_id = $1::text{extra}" + ); + let mut values: Vec> = vec![Some(system_id.clone())]; + if !ty.is_empty() { + values.push(Some(ty.clone())); + sql.push_str(&format!(" AND COALESCE(f_type, 0) = ${}::text::integer", values.len())); + } + if !web_type.is_empty() { + // 官方 `webType` 是逗号分隔的多个值(`1,2`)⇒ 用 `IN`。 + let parts: Vec = web_type + .split(',') + .map(|s| s.trim().to_string()) + .filter(|s| !s.is_empty()) + .collect(); + if !parts.is_empty() { + let marks: Vec = parts + .iter() + .enumerate() + .map(|(i, _)| format!("${}::text::integer", values.len() + 1 + i)) + .collect(); + values.extend(parts.into_iter().map(Some)); + sql.push_str(&format!( + " AND COALESCE(f_web_type, 0) IN ({})", + marks.join(", ") + )); + } + } + sql.push_str(" ORDER BY f_sort_code ASC, f_full_name ASC"); + + let rows = match state.db.query_json_params(&sql, ¶ms_of(&values)).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "功能选择器查询"), + }; + + // 🔴 **按 `f_category` 分组**(官方非主系统分支同口径):分类节点 + 子节点。 + let mut groups: Vec<(String, String, Vec)> = Vec::new(); + for row in rows { + let category = row["category"].as_str().unwrap_or_default().to_string(); + let full_name = row["fullName"].as_str().unwrap_or_default().to_string(); + let child = json!({ + "id": row["id"].as_str().unwrap_or_default(), + "fullName": full_name, + "enCode": row["enCode"].as_str().unwrap_or_default(), + "category": category, + "type": row["type"].clone(), + "webType": row["webType"].clone(), + "hasChildren": false, + }); + match groups.iter_mut().find(|(id, _, _)| *id == category) { + Some((_, _, children)) => children.push(child), + None => groups.push((category, String::new(), vec![child])), + } + } + let list: Vec = groups + .into_iter() + .map(|(id, _, children)| { + json!({ + "id": id, + "fullName": "", // 🔴 本仓没种子化「业务类型」字典 ⇒ 分类名留空 + "hasChildren": true, + "children": children, + }) + }) + .collect(); + ok(list_vo(list)) +} + +/// `GET /api/visualdev/Base/{id}` —— 功能详情。 +/// +/// 官方 `VisualdevController.java:326`(`VisualDevInfoVO`)。 +pub async fn visual_dev_info( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = guard_any(&state, &headers, &[EN_FORM_DESIGN, EN_SYS_FORM, EN_GENERATOR_FLOW_FORM]).await { + return resp; + } + let id = id.trim().to_string(); + let sql = format!( + "SELECT {VISUAL_DEV_DETAIL_COLUMNS} FROM base_visual_dev \ + WHERE f_id = $1::text AND f_delete_mark = 0 LIMIT 1" + ); + let rows = match state.db.query_json_params(&sql, &[&id]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "功能详情查询"), + }; + match rows.into_iter().next() { + Some(row) => ok(row), + None => fail(code::FAIL, "功能不存在"), + } +} + +/// `GET /api/visualdev/Base/{id}/getReleaseMenu` —— 已发布菜单。 +/// +/// 官方 `VisualdevController.java:738`(`ActionResult`)。 +/// +/// 🔴 **官方返的是 `base_visual_dev` 的**单条**(`visualdevService.getById(id)`), +/// **不是** `base_visual_release` 的列表 —— `base_visual_release` 官方压根没查。 +/// 官方消费点 `views/onlineDev/formDesign/components/CreateMenuModal.vue:56-59`: +/// `state.record = res.data` ⇒ **裸对象**;且 `res.data.platformRelease` +/// 是 **JSON 串**(官方自己 `JSON.parse` 它)⇒ 本仓原样存 JSON 串。 +/// +/// 🔴 官方读 `res.data.pcIsRelease` / `appIsRelease` / `pcReleaseName` / +/// `appReleaseName` —— 那是「菜单发布记录」⇒ 本仓**没有**那套表 +/// ⇒ 这四个字段返 `0` / 空串(前端只是「已发布菜单路径」那一行的展示)。 +pub async fn visual_dev_release_menu( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = guard_any(&state, &headers, &[EN_FORM_DESIGN, EN_SYS_FORM, EN_GENERATOR_FLOW_FORM]).await { + return resp; + } + let id = id.trim().to_string(); + let rows = match state + .db + .query_json_params( + "SELECT f_id AS \"id\", f_full_name AS \"fullName\", f_en_code AS \"enCode\", \ + COALESCE(f_state, 0) AS \"state\", COALESCE(f_type, 0) AS \"type\", \ + f_tables_data AS \"tables\", f_category AS \"category\", \ + f_platform_release AS \"platformRelease\", \ + (EXTRACT(EPOCH FROM f_creator_time) * 1000)::bigint AS \"creatorTime\", \ + f_creator_user_id AS \"creatorUserId\", \ + (EXTRACT(EPOCH FROM f_last_modify_time) * 1000)::bigint AS \"lastModifyTime\", \ + f_last_modify_user_id AS \"lastModifyUserId\", \ + COALESCE(f_sort_code, 0) AS \"sortCode\", \ + COALESCE(f_web_type, 0) AS \"webType\", \ + COALESCE(f_enable_flow, 0) AS \"enableFlow\", \ + COALESCE(f_enabled_mark, 0) AS \"enabledMark\" \ + FROM base_visual_dev \ + WHERE f_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1", + &[&id], + ) + .await + { + Ok(rows) => rows, + Err(e) => return db_error(e, "已发布菜单查询"), + }; + match rows.into_iter().next() { + Some(mut row) => { + // 🔴 官方 `VisualFunctionModel` 的这四个字段来自「菜单发布记录」表 + // ⇒ 本仓无此表 ⇒ 如实给 0 / 空串。 + row["pcIsRelease"] = Value::from(0i64); + row["appIsRelease"] = Value::from(0i64); + row["pcReleaseName"] = Value::String(String::new()); + row["appReleaseName"] = Value::String(String::new()); + ok(row) + } + None => fail(code::FAIL, "功能不存在"), + } +} + +/// `GET /api/visualdev/Base/{id}/FormDataFields` —— 表单主表属性列表。 +/// +/// 官方 `VisualdevController.java:339`(`ListVO`)。 +/// +/// 🔴 官方从**动态建出来的物理表**读字段 —— 本仓没有低代码引擎的动态表 +/// ⇒ 但 `base_visual_dev.f_column_data` 里存着**设计稿的字段 JSON** +/// ⇒ 从那里解析出字段列表(真实数据,不是编的)。 +pub async fn visual_dev_form_data_fields( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = guard_any(&state, &headers, &[EN_FORM_DESIGN, EN_SYS_FORM, EN_GENERATOR_FLOW_FORM]).await { + return resp; + } + let id = id.trim().to_string(); + let rows = match state + .db + .query_json_params( + "SELECT f_column_data AS \"columnData\" FROM base_visual_dev \ + WHERE f_id = $1::text AND f_delete_mark = 0 LIMIT 1", + &[&id], + ) + .await + { + Ok(rows) => rows, + Err(e) => return db_error(e, "表单字段查询"), + }; + let raw = rows + .first() + .and_then(|r| r["columnData"].as_str()) + .unwrap_or_default(); + ok(list_vo(parse_column_fields(raw))) +} + +/// 从 `f_column_data`(设计稿字段 JSON)里解析出字段列表。 +/// +/// 🔴 官方 `f_column_data` 存的是 `[{id, field, title, …}]` 数组 +/// (`base_module_column` 的同构形状)。 +fn parse_column_fields(raw: &str) -> Vec { + let Ok(Value::Array(items)) = serde_json::from_str::(raw) else { + return Vec::new(); + }; + items + .iter() + .map(|item| { + let obj = item.as_object(); + let get = |k: &str| obj.and_then(|o| o.get(k)).cloned().unwrap_or(Value::Null); + json!({ + "id": get("id"), + "field": get("field"), + "title": get("title"), + "type": get("type"), + "required": get("required"), + "sortCode": get("sortCode"), + }) + }) + .collect() +} + +/// `GET /api/visualdev/Base/{id}/FieldDataSelect` —— 表单主表数据下拉框。 +/// +/// 官方 `VisualdevController.java:349`(`PageListVO`)。 +/// +/// 🔴 官方查的是**动态建的物理表** —— 本仓没有低代码引擎 ⇒ **明确失败**。 +/// (返空数组会让用户以为「没有数据」,而不是「不支持」。) +pub async fn visual_dev_field_data_select( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = id.trim(); + unsupported("低代码数据表的关联数据查询") +} + +/// `GET /api/visualdev/Base/getColumnList` —— 列表字段。 +/// +/// 官方 `VisualdevController.java` 的 `getColumnList`。 +pub async fn visual_dev_column_list( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = qv(&raw, "id"); + let values = vec![Some(id)]; + let rows = match state + .db + .query_json_params( + "SELECT f_column_data AS \"columnData\" FROM base_visual_dev \ + WHERE f_id = $1::text AND f_delete_mark = 0 LIMIT 1", + ¶ms_of(&values), + ) + .await + { + Ok(rows) => rows, + Err(e) => return db_error(e, "列表字段查询"), + }; + let raw = rows + .first() + .and_then(|r| r["columnData"].as_str()) + .unwrap_or_default(); + ok(list_vo(parse_column_fields(raw))) +} + +/// `GET /api/visualdev/Base/getListBySystem` —— 跨应用菜单。 +/// +/// 官方 `VisualdevController.java` 的 `getListBySystem`。 +/// +/// 🔴 本仓单系统 ⇒ 只返本系统的功能(**如实**,不是编的)。 +pub async fn visual_dev_list_by_system( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let system_id = current_system_id(&state.db).await; + let keyword = qv(&raw, "keyword"); + let mut values: Vec> = vec![Some(system_id.clone())]; + let mut sql = "SELECT f_id AS \"id\", f_full_name AS \"fullName\", f_en_code AS \"enCode\", \ + COALESCE(f_type, 0) AS \"type\", COALESCE(f_web_type, 0) AS \"webType\", \ + f_category AS \"category\" \ + FROM base_visual_dev WHERE f_delete_mark = 0 AND f_system_id = $1::text" + .to_string(); + if !keyword.is_empty() { + values.push(Some(format!("%{keyword}%"))); + sql.push_str(&format!( + " AND (f_full_name ILIKE ${}::text OR f_en_code ILIKE ${}::text)", + values.len(), + values.len() + )); + } + sql.push_str(" ORDER BY f_sort_code ASC, f_full_name ASC"); + let rows = match state.db.query_json_params(&sql, ¶ms_of(&values)).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "跨应用菜单查询"), + }; + ok(list_vo(rows)) +} + +/// `POST /api/visualdev/Base` —— 新建功能(表单设计)。 +/// +/// 官方 `VisualdevController.java:551`。 +/// +/// 🔴 官方那条路径会**动态建物理表**(低代码引擎)—— 本仓没有 ⇒ **不建表**, +/// 只登记设计稿本身(`base_visual_dev`)。 +pub async fn visual_dev_create( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match guard_any(&state, &headers, &[EN_FORM_DESIGN, EN_SYS_FORM, EN_GENERATOR_FLOW_FORM]).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 full_name = obj + .get("fullName") + .and_then(Value::as_str) + .unwrap_or_default() + .trim() + .to_string(); + if full_name.is_empty() { + return fail(code::FAIL, "名称不能为空"); + } + let en_code = obj + .get("enCode") + .and_then(Value::as_str) + .unwrap_or_default() + .trim() + .to_string(); + + let system_id = current_system_id(&state.db).await; + // 🔴 官方:同名 / 同编码 ⇒ 失败(`MsgCode.EXIST001` / `EXIST002`)。 + if !en_code.is_empty() { + let dup = match state + .db + .query_json_params( + "SELECT f_id AS \"id\" FROM base_visual_dev \ + WHERE f_en_code = $1::text AND f_delete_mark = 0 LIMIT 1", + &[&en_code], + ) + .await + { + Ok(rows) => !rows.is_empty(), + Err(e) => return db_error(e, "功能编码查重"), + }; + if dup { + return fail(code::FAIL, "编码已存在"); + } + } + let dup_name = match state + .db + .query_json_params( + "SELECT f_id AS \"id\" FROM base_visual_dev \ + WHERE f_full_name = $1::text AND f_system_id = $2::text AND f_delete_mark = 0 LIMIT 1", + &[&full_name, &system_id], + ) + .await + { + Ok(rows) => !rows.is_empty(), + Err(e) => return db_error(e, "功能名称查重"), + }; + if dup_name { + return fail(code::FAIL, "名称已存在"); + } + + let new_id = new_uuid(); + let mut columns: Vec<&str> = vec!["f_id", "f_tenant_id", "f_system_id"]; + let mut casts: Vec<&str> = vec!["", "", ""]; + let mut values: Vec> = + vec![Some(new_id.clone()), Some("0".to_string()), Some(system_id)]; + + for (column, cast, value) in write_fields(&obj, VISUAL_DEV_WRITE_FIELDS) { + columns.push(column); + casts.push(cast); + values.push(value); + } + if !obj.contains_key("state") { + columns.push("f_state"); + casts.push("::integer"); + values.push(Some("0".to_string())); + } + if !obj.contains_key("enabledMark") { + columns.push("f_enabled_mark"); + casts.push("::integer"); + values.push(Some("1".to_string())); + } + if !obj.contains_key("sortCode") { + columns.push("f_sort_code"); + casts.push("::bigint"); + values.push(Some("0".to_string())); + } + columns.push("f_delete_mark"); + casts.push("::integer"); + values.push(Some("0".to_string())); + columns.push("f_creator_user_id"); + casts.push(""); + values.push(Some(user.account.clone())); + columns.push("f_creator_time"); + + let mut marks: Vec = (0..values.len()) + .map(|i| placeholder(i + 1, casts[i])) + .collect(); + marks.push("now()".to_string()); + let sql = format!( + "INSERT INTO base_visual_dev ({}) VALUES ({})", + columns.join(", "), + marks.join(", ") + ); + if let Err(e) = state.db.exec_params(&sql, ¶ms_of(&values)).await { + return db_error(e, "新建功能"); + } + ok(json!({ "id": new_id, "enCode": en_code })) +} + +/// `PUT /api/visualdev/Base/{id}` —— 修改功能。 +/// +/// 官方 `VisualdevController.java:466`(`VisualDevUpForm`)。 +pub async fn visual_dev_update( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + let user = match guard_any(&state, &headers, &[EN_FORM_DESIGN, EN_SYS_FORM, EN_GENERATOR_FLOW_FORM]).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let id = id.trim().to_string(); + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + + let exists = match state + .db + .query_json_params( + "SELECT f_id AS \"id\" FROM base_visual_dev WHERE f_id = $1::text LIMIT 1", + &[&id], + ) + .await + { + Ok(rows) => !rows.is_empty(), + Err(e) => return db_error(e, "功能查询"), + }; + if !exists { + return fail(code::FAIL, "功能不存在"); + } + + // 🔴 官方:编码改了 ⇒ 判重(改成自己不算冲突)。 + if let Some(en_code) = obj.get("enCode").and_then(Value::as_str) { + let en_code = en_code.trim(); + if !en_code.is_empty() { + let dup = match state + .db + .query_json_params( + "SELECT f_id AS \"id\" FROM base_visual_dev \ + WHERE f_en_code = $1::text AND f_id <> $2::text AND f_delete_mark = 0 LIMIT 1", + &[&en_code, &id], + ) + .await + { + Ok(rows) => !rows.is_empty(), + Err(e) => return db_error(e, "功能编码查重"), + }; + if dup { + return fail(code::FAIL, "编码已存在"); + } + } + } + + let fields = write_fields(&obj, VISUAL_DEV_WRITE_FIELDS); + let mut assignments: Vec = Vec::new(); + let mut values: Vec> = vec![Some(id.clone())]; + for (column, cast, value) in fields { + values.push(value); + assignments.push(format!("{column} = {}", placeholder(values.len(), cast))); + } + // 🔴 **审计列两个都要写**:`f_last_modify_time`(SQL `now()`,**不占参数位**) + // + `f_last_modify_user_id`(**账号**,不是 id —— 本仓 `f_creator_user_id` + // 存的就是账号,见 `seed.rs` 的 `ADMIN_ACCOUNT`)。 + // 只写时间不写人 ⇒ 「谁改的」永远是空(批次 17 集成测试抓到的)。 + values.push(Some(user.account.clone())); + let p_user = values.len(); + assignments.push("f_last_modify_time = now()".to_string()); + assignments.push(format!("f_last_modify_user_id = ${p_user}::text")); + let sql = format!( + "UPDATE base_visual_dev SET {} WHERE f_id = $1::text", + assignments.join(", ") + ); + if let Err(e) = state.db.exec_params(&sql, ¶ms_of(&values)).await { + return db_error(e, "修改功能"); + } + ok(Value::Null) +} + +/// `DELETE /api/visualdev/Base/{id}` —— 删除功能(软删)。 +/// +/// 官方 `VisualdevController.java:604`。 +/// +/// 🔴 官方会连带删 `base_visual_release` + `base_visual_alias` ⇒ 本仓同样做。 +pub async fn visual_dev_delete( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = guard_any(&state, &headers, &[EN_FORM_DESIGN, EN_SYS_FORM, EN_GENERATOR_FLOW_FORM]).await { + return resp; + } + let id = id.trim().to_string(); + if let Err(e) = state + .db + .exec_params( + "UPDATE base_visual_dev SET f_delete_mark = 1, f_delete_time = now() WHERE f_id = $1::text", + &[&id], + ) + .await + { + return db_error(e, "删除功能"); + } + for sql in [ + "UPDATE base_visual_release SET f_delete_mark = 1 WHERE f_id = $1::text", + "UPDATE base_visual_alias SET f_delete_mark = 1 WHERE f_visual_id = $1::text", + ] { + if let Err(e) = state.db.exec_params(sql, &[&id]).await { + return db_error(e, "删除功能附属记录"); + } + } + ok(Value::Null) +} + +/// `POST /api/visualdev/Base/{id}/Actions/Copy` —— 复制功能。 +/// +/// 官方 `VisualdevController.java:361`。 +/// +/// 🔴 官方会生成 `原名.副本xxxxx` + 编码加同一后缀。 +pub async fn visual_dev_copy( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = guard_any(&state, &headers, &[EN_FORM_DESIGN, EN_SYS_FORM, EN_GENERATOR_FLOW_FORM]).await { + return resp; + } + let id = id.trim().to_string(); + let rows = match state + .db + .query_json_params( + "SELECT f_id AS \"id\", f_full_name AS \"fullName\", f_en_code AS \"enCode\" \ + FROM base_visual_dev WHERE f_id = $1::text AND f_delete_mark = 0 LIMIT 1", + &[&id], + ) + .await + { + Ok(rows) => rows, + Err(e) => return db_error(e, "功能查询"), + }; + let Some(row) = rows.first() else { + return fail(code::FAIL, "功能不存在"); + }; + let src_name = row["fullName"].as_str().unwrap_or_default().to_string(); + let src_code = row["enCode"].as_str().unwrap_or_default().to_string(); + let suffix = &new_uuid()[..5]; + let new_id = new_uuid(); + let new_name = format!("{src_name}.副本{suffix}"); + let new_code = format!("{src_code}{suffix}"); + + // 🔴 官方复制的是**整行**(含设计稿 JSON)⇒ 本仓 `INSERT ... SELECT`。 + let sql = "INSERT INTO base_visual_dev \ + (f_id, f_tenant_id, f_system_id, f_full_name, f_en_code, f_state, f_type, \ + f_tables_data, f_category, f_form_data, f_column_data, f_db_link_id, f_web_type, \ + f_app_column_data, f_enable_flow, f_interface_id, f_interface_param, \ + f_description, f_enabled_mark, f_sort_code, f_url_address, f_app_url_address, \ + f_interface_url, f_web_address, f_button_data, f_app_address, f_app_button_data, \ + f_delete_mark, f_creator_user_id, f_creator_time) \ + SELECT $1::text, f_tenant_id, f_system_id, $2::text, $3::text, 0, f_type, \ + f_tables_data, f_category, f_form_data, f_column_data, f_db_link_id, f_web_type, \ + f_app_column_data, f_enable_flow, f_interface_id, f_interface_param, \ + f_description, f_enabled_mark, f_sort_code, f_url_address, f_app_url_address, \ + f_interface_url, f_web_address, f_button_data, f_app_address, f_app_button_data, \ + 0, f_creator_user_id, now() \ + FROM base_visual_dev WHERE f_id = $4::text"; + let values = [ + Some(new_id.clone()), + Some(new_name), + Some(new_code), + Some(id.clone()), + ]; + if let Err(e) = state.db.exec_params(sql, ¶ms_of(&values)).await { + return db_error(e, "复制功能"); + } + ok(json!({ "id": new_id })) +} + +/// `POST /api/visualdev/Base/{id}/Actions/Release` —— 发布。 +/// +/// 官方 `VisualdevController.java:629`。 +/// +/// 🔴 **本仓没有低代码引擎** ⇒ 发布要「建物理表」—— 做不到。 +/// ⇒ 明确业务失败(不假装发布成功)。 +pub async fn visual_dev_release( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = guard_any(&state, &headers, &[EN_FORM_DESIGN, EN_SYS_FORM, EN_GENERATOR_FLOW_FORM]).await { + return resp; + } + let _ = id.trim(); + unsupported("低代码表单的发布(需要建物理表)") +} + +/// `POST /api/visualdev/Base/{id}/Actions/Module` —— 生成菜单。 +/// +/// 官方 `VisualdevController.java:700`。 +/// +/// 🔴 官方会**真的建菜单**(`base_module`)—— 本仓**能做**(`base_module` 有)。 +/// 但「发布」是前置(官方要求先发布)⇒ 本仓未发布的 ⇒ 明确失败。 +pub async fn visual_dev_create_menu( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = guard_any(&state, &headers, &[EN_FORM_DESIGN, EN_SYS_FORM, EN_GENERATOR_FLOW_FORM]).await { + return resp; + } + let _ = id.trim(); + let _ = parse_body(&body).map(|_| ()); + unsupported("低代码表单的菜单生成(需要先发布)") +} + +// ================================================================ 门户(Portal) +// +// 官方:`jnpf-visualdev-portal-controller/.../PortalController.java`(`/api/visualdev/Portal`) +// 表:`base_portal` + `base_portal_data` + `base_portal_manage` +// 前端:`jnpf-web-apps-main/src/api/onlineDev/portal.ts` + +/// `base_portal` 的写白名单。 +const PORTAL_WRITE_FIELDS: &[(&str, &str, &str)] = &[ + ("fullName", "f_full_name", ""), + ("enCode", "f_en_code", ""), + ("category", "f_category", ""), + ("type", "f_type", "::integer"), + ("state", "f_state", "::integer"), + ("customUrl", "f_custom_url", ""), + ("linkType", "f_link_type", "::integer"), + ("enabledLock", "f_enabled_lock", "::integer"), + ("platform", "f_platform", ""), + ("description", "f_description", ""), + ("enabledMark", "f_enabled_mark", "::integer"), + ("sortCode", "f_sort_code", "::bigint"), + ("platformRelease", "f_platform_release", ""), +]; + +/// `GET /api/visualdev/Portal` —— 门户列表。 +pub async fn portal_list( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_VISUAL_PORTAL).await { + return resp; + } + let page = Paging::of(&raw); + let system_id = current_system_id(&state.db).await; + let keyword = qv(&raw, "keyword"); + + let mut values: Vec> = vec![Some(system_id.clone())]; + let mut sql = "SELECT f_id AS \"id\", f_full_name AS \"fullName\", f_en_code AS \"enCode\", \ + f_category AS \"category\", COALESCE(f_type, 0) AS \"type\", \ + COALESCE(f_state, 0) AS \"state\", f_custom_url AS \"customUrl\", \ + COALESCE(f_link_type, 0) AS \"linkType\", f_platform AS \"platform\", \ + f_description AS \"description\", COALESCE(f_enabled_mark, 0) AS \"enabledMark\", \ + COALESCE(f_sort_code, 0) AS \"sortCode\", \ + (EXTRACT(EPOCH FROM f_creator_time) * 1000)::bigint AS \"creatorTime\" \ + FROM base_portal WHERE f_delete_mark = 0 AND f_system_id = $1::text" + .to_string(); + if !keyword.is_empty() { + values.push(Some(format!("%{keyword}%"))); + sql.push_str(&format!( + " AND (f_full_name ILIKE ${}::text OR f_en_code ILIKE ${}::text)", + values.len(), + values.len() + )); + } + values.push(Some(page.page_size.to_string())); + values.push(Some(page.offset.to_string())); + let p_limit = values.len() - 1; + let p_offset = values.len(); + sql.push_str(&format!( + " ORDER BY f_sort_code ASC, f_full_name ASC \ + LIMIT ${p_limit}::text::integer OFFSET ${p_offset}::text::integer" + )); + + let count_sql = format!( + "SELECT count(*)::bigint AS \"c\" FROM base_portal \ + WHERE f_delete_mark = 0 AND f_system_id = $1::text" + ); + let total = match state + .db + .query_json_params(&count_sql, ¶ms_of(&[Some(system_id.clone())])) + .await + { + Ok(rows) => rows + .into_iter() + .next() + .and_then(|r| r["c"].as_i64()) + .unwrap_or(0), + Err(e) => return db_error(e, "门户列表总数查询"), + }; + + let rows = match state.db.query_json_params(&sql, ¶ms_of(&values)).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "门户列表查询"), + }; + ok(page_list(page.current_page, page.page_size, total, rows)) +} + +/// `GET /api/visualdev/Portal/{id}` —— 门户详情。 +/// +/// 官方 `PortalController.java:122`(`PortalInfoVO`)。 +pub async fn portal_info( + State(state): State, + headers: HeaderMap, + Path(id): Path, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + let platform = qv(&raw, "platform"); + let rows = match state + .db + .query_json_params( + "SELECT f_id AS \"id\", f_full_name AS \"fullName\", f_en_code AS \"enCode\", \ + f_category AS \"category\", COALESCE(f_type, 0) AS \"type\", \ + COALESCE(f_state, 0) AS \"state\", f_custom_url AS \"customUrl\", \ + COALESCE(f_link_type, 0) AS \"linkType\", f_platform AS \"platform\", \ + f_description AS \"description\", COALESCE(f_enabled_mark, 0) AS \"enabledMark\", \ + COALESCE(f_sort_code, 0) AS \"sortCode\", \ + f_platform_release AS \"platformRelease\", f_system_id AS \"systemId\" \ + FROM base_portal WHERE f_id = $1::text AND f_delete_mark = 0 LIMIT 1", + &[&id], + ) + .await + { + Ok(rows) => rows, + Err(e) => return db_error(e, "门户详情查询"), + }; + let Some(mut row) = rows.into_iter().next() else { + return fail(code::FAIL, "门户不存在"); + }; + // 🔴 官方 `vo.setFormData(portalDataService.getModelDataForm(...))` ⇒ + // 从 `base_portal_data` 取该门户的表单数据(`f_platform` 对应 PC/App)。 + let data_rows = match state + .db + .query_json_params( + "SELECT f_form_data AS \"formData\" FROM base_portal_data \ + WHERE f_portal_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 \ + AND ($2::text = '' OR f_platform = $2::text) \ + ORDER BY f_sort_code ASC LIMIT 1", + &[&id, &platform], + ) + .await + { + Ok(rows) => rows, + Err(e) => return db_error(e, "门户表单数据查询"), + }; + if let Some(obj) = row.as_object_mut() { + obj.insert( + "formData".to_string(), + data_rows + .first() + .map(|r| r["formData"].clone()) + .unwrap_or(Value::Null), + ); + } + ok(row) +} + +/// `POST /api/visualdev/Portal` —— 新建门户。 +pub async fn portal_create( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_VISUAL_PORTAL).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 full_name = obj + .get("fullName") + .and_then(Value::as_str) + .unwrap_or_default() + .trim() + .to_string(); + if full_name.is_empty() { + return fail(code::FAIL, "名称不能为空"); + } + let system_id = current_system_id(&state.db).await; + let dup = match state + .db + .query_json_params( + "SELECT f_id AS \"id\" FROM base_portal \ + WHERE f_full_name = $1::text AND f_system_id = $2::text AND f_delete_mark = 0 LIMIT 1", + &[&full_name, &system_id], + ) + .await + { + Ok(rows) => !rows.is_empty(), + Err(e) => return db_error(e, "门户名称查重"), + }; + if dup { + return fail(code::FAIL, "名称已存在"); + } + + let new_id = new_uuid(); + let mut columns: Vec<&str> = vec!["f_id", "f_tenant_id", "f_system_id"]; + let mut casts: Vec<&str> = vec!["", "", ""]; + let mut values: Vec> = + vec![Some(new_id.clone()), Some("0".to_string()), Some(system_id)]; + for (column, cast, value) in write_fields(&obj, PORTAL_WRITE_FIELDS) { + columns.push(column); + casts.push(cast); + values.push(value); + } + if !obj.contains_key("enabledMark") { + columns.push("f_enabled_mark"); + casts.push("::integer"); + values.push(Some("1".to_string())); + } + if !obj.contains_key("sortCode") { + columns.push("f_sort_code"); + casts.push("::bigint"); + values.push(Some("0".to_string())); + } + columns.push("f_delete_mark"); + casts.push("::integer"); + values.push(Some("0".to_string())); + columns.push("f_creator_user_id"); + casts.push(""); + values.push(Some(user.account.clone())); + columns.push("f_creator_time"); + + let mut marks: Vec = (0..values.len()) + .map(|i| placeholder(i + 1, casts[i])) + .collect(); + marks.push("now()".to_string()); + let sql = format!( + "INSERT INTO base_portal ({}) VALUES ({})", + columns.join(", "), + marks.join(", ") + ); + if let Err(e) = state.db.exec_params(&sql, ¶ms_of(&values)).await { + return db_error(e, "新建门户"); + } + ok(json!({ "id": new_id })) +} + +/// `PUT /api/visualdev/Portal/{id}` —— 修改门户。 +pub async fn portal_update( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_VISUAL_PORTAL).await { + return resp; + } + let id = id.trim().to_string(); + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + let exists = match state + .db + .query_json_params( + "SELECT f_id AS \"id\" FROM base_portal WHERE f_id = $1::text LIMIT 1", + &[&id], + ) + .await + { + Ok(rows) => !rows.is_empty(), + Err(e) => return db_error(e, "门户查询"), + }; + if !exists { + return fail(code::FAIL, "门户不存在"); + } + let fields = write_fields(&obj, PORTAL_WRITE_FIELDS); + let mut assignments: Vec = Vec::new(); + let mut values: Vec> = vec![Some(id.clone())]; + for (column, cast, value) in fields { + values.push(value); + assignments.push(format!("{column} = {}", placeholder(values.len(), cast))); + } + if assignments.is_empty() { + return ok(Value::Null); + } + assignments.push("f_last_modify_time = now()".to_string()); + let sql = format!( + "UPDATE base_portal SET {} WHERE f_id = $1::text", + assignments.join(", ") + ); + if let Err(e) = state.db.exec_params(&sql, ¶ms_of(&values)).await { + return db_error(e, "修改门户"); + } + ok(Value::Null) +} + +/// `DELETE /api/visualdev/Portal/{id}` —— 删除门户(软删)。 +pub async fn portal_delete( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_VISUAL_PORTAL).await { + return resp; + } + let id = id.trim().to_string(); + for sql in [ + "UPDATE base_portal SET f_delete_mark = 1, f_delete_time = now() WHERE f_id = $1::text", + "UPDATE base_portal_data SET f_delete_mark = 1 WHERE f_portal_id = $1::text", + ] { + if let Err(e) = state.db.exec_params(sql, &[&id]).await { + return db_error(e, "删除门户"); + } + } + ok(Value::Null) +} + +/// `POST /api/visualdev/Portal/{id}/Actions/Copy` —— 复制门户。 +pub async fn portal_copy( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_VISUAL_PORTAL).await { + return resp; + } + let id = id.trim().to_string(); + let rows = match state + .db + .query_json_params( + "SELECT f_id AS \"id\", f_full_name AS \"fullName\", f_en_code AS \"enCode\" \ + FROM base_portal WHERE f_id = $1::text AND f_delete_mark = 0 LIMIT 1", + &[&id], + ) + .await + { + Ok(rows) => rows, + Err(e) => return db_error(e, "门户查询"), + }; + let Some(row) = rows.first() else { + return fail(code::FAIL, "门户不存在"); + }; + let suffix = &new_uuid()[..5]; + let new_id = new_uuid(); + let new_name = format!( + "{}.副本{suffix}", + row["fullName"].as_str().unwrap_or_default() + ); + let new_code = format!("{}{suffix}", row["enCode"].as_str().unwrap_or_default()); + + let sql = "INSERT INTO base_portal \ + (f_id, f_tenant_id, f_system_id, f_full_name, f_en_code, f_category, f_type, \ + f_state, f_custom_url, f_link_type, f_enabled_lock, f_platform, f_description, \ + f_enabled_mark, f_sort_code, f_delete_mark, f_creator_user_id, f_creator_time) \ + SELECT $1::text, f_tenant_id, f_system_id, $2::text, $3::text, f_category, f_type, \ + f_state, f_custom_url, f_link_type, f_enabled_lock, f_platform, f_description, \ + f_enabled_mark, f_sort_code, 0, f_creator_user_id, now() \ + FROM base_portal WHERE f_id = $4::text"; + let values = [ + Some(new_id.clone()), + Some(new_name), + Some(new_code), + Some(id), + ]; + if let Err(e) = state.db.exec_params(sql, ¶ms_of(&values)).await { + return db_error(e, "复制门户"); + } + ok(json!({ "id": new_id })) +} + +/// `POST /api/visualdev/Portal/{id}/Actions/Export` —— 导出门户。 +/// +/// 🔴 官方导出的是一个 **zip 文件**(走文件服务)⇒ 本仓**明确失败**。 +pub async fn portal_export( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_VISUAL_PORTAL).await { + return resp; + } + let _ = id.trim(); + unsupported("门户导出(需要文件服务)") +} + +/// `GET /api/visualdev/Portal/Selector` —— 门户下拉框(**树形**)。 +/// +/// 官方 `PortalController.java:106`(`ListVO`)。 +pub async fn portal_selector( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let system_id = current_system_id(&state.db).await; + let ty = qv(&raw, "type"); + let mut values: Vec> = vec![Some(system_id.clone())]; + let mut sql = "SELECT f_id AS \"id\", f_full_name AS \"fullName\", f_en_code AS \"enCode\", \ + f_category AS \"category\", COALESCE(f_type, 0) AS \"type\" \ + FROM base_portal WHERE f_delete_mark = 0 AND f_system_id = $1::text" + .to_string(); + if !ty.is_empty() { + values.push(Some(ty.clone())); + sql.push_str(&format!( + " AND COALESCE(f_type, 0) = ${}::text::integer", + values.len() + )); + } + sql.push_str(" ORDER BY f_sort_code ASC, f_full_name ASC"); + let rows = match state.db.query_json_params(&sql, ¶ms_of(&values)).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "门户选择器查询"), + }; + // 🔴 按 `f_category` 分组(官方 `TreeDotUtils2.convertListToTreeDot` 同构)。 + let mut groups: Vec<(String, Vec)> = Vec::new(); + for row in rows { + let category = row["category"].as_str().unwrap_or_default().to_string(); + let child = json!({ + "id": row["id"].as_str().unwrap_or_default(), + "fullName": row["fullName"].as_str().unwrap_or_default(), + "enCode": row["enCode"].as_str().unwrap_or_default(), + "type": row["type"].clone(), + "hasChildren": false, + }); + match groups.iter_mut().find(|(id, _)| *id == category) { + Some((_, children)) => children.push(child), + None => groups.push((category, vec![child])), + } + } + let list: Vec = groups + .into_iter() + .map(|(id, children)| { + json!({ + "id": id, + "fullName": "", + "hasChildren": true, + "children": children, + }) + }) + .collect(); + ok(list_vo(list)) +} + +/// `GET /api/visualdev/Portal/Selector/Menu` —— 应用首页门户列表(切换门户)。 +/// +/// 官方 `PortalController.java:115`(`ListVO`)。 +pub async fn portal_home_list( + State(state): State, + headers: HeaderMap, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let system_id = current_system_id(&state.db).await; + let rows = match state + .db + .query_json_params( + "SELECT f_id AS \"id\", f_full_name AS \"fullName\", f_en_code AS \"enCode\", \ + COALESCE(f_state, 0) AS \"state\", f_custom_url AS \"customUrl\", \ + COALESCE(f_link_type, 0) AS \"linkType\", f_platform AS \"platform\" \ + FROM base_portal WHERE f_delete_mark = 0 AND f_system_id = $1::text \ + ORDER BY f_sort_code ASC, f_full_name ASC", + &[&system_id], + ) + .await + { + Ok(rows) => rows, + Err(e) => return db_error(e, "首页门户列表查询"), + }; + ok(list_vo(rows)) +} + +/// `PUT /api/visualdev/Portal/{id}/Actions/SetDefault` —— 设为默认门户。 +/// +/// 🔴 官方把「默认门户」记在**用户**上(`base_user` 的门户偏好 / 用户配置)。 +/// 本仓没有那张表 ⇒ **明确失败**(不说谎说「已设置」)。 +pub async fn portal_set_default( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = id.trim(); + unsupported("默认门户设置(用户门户偏好未建模)") +} + +/// `GET /api/visualdev/Portal/{id}/auth` —— 门户展示数据(权限)。 +/// +/// 🔴 官方查的是**动态表**(门户组件数据)⇒ 本仓**明确失败**。 +pub async fn portal_auth( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = id.trim(); + unsupported("门户展示数据(门户组件数据表未建模)") +} + +/// `PUT /api/visualdev/Portal/Custom/Save/{id}` —— 用户拖拽后更新。 +/// +/// 🔴 官方存的是**门户组件的个性化布局**(动态表)⇒ **明确失败**。 +pub async fn portal_custom_save( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = id.trim(); + let _ = parse_body(&body).map(|_| ()); + unsupported("门户自定义布局保存(门户组件数据表未建模)") +} + +/// `PUT /api/visualdev/Portal/Actions/release/{id}` —— 门户发布。 +/// +/// 🔴 官方发布门户会把**组件数据**写进动态表 ⇒ **明确失败**。 +pub async fn portal_release( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = id.trim(); + let _ = parse_body(&body).map(|_| ()); + unsupported("门户发布(门户组件数据表未建模)") +} + +/// `GET /api/visualdev/Portal/systemFilter/{id}` —— 应用列表(发布过滤)。 +/// +/// 官方 `PortalController.java:347`(`ActionResult>`)。 +/// +/// 🔴 官方 `PortalServiceImpl.java:229` 的 `systemFilterList` **直接忽略** +/// `id` 和 `category` 两个入参(`systemApi.getList(null, true, true)`) +/// ⇒ 本仓也**不按 category 过滤**(照抄官方口径,不是偷懒)。 +/// +/// 🔴 官方 `SystemListVO`(`jnpf.base.model.base.SystemListVO`)字段: +/// `id/fullName/enCode/icon/sortCode/backgroundColor/userId/hasUpdate/hasDelete/isTop` +/// —— **没有** `isMain/appKey/appName/urlAddress`。 +/// 且 `base_system` 官方实体(`SystemEntity`)也**没有** `f_category` 列。 +pub async fn portal_system_filter( + State(state): State, + headers: HeaderMap, + Path(id): Path, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = id.trim(); + let _ = qv(&raw, "category"); + let sql = "SELECT f_id AS \"id\", f_full_name AS \"fullName\", f_en_code AS \"enCode\", \ + f_icon AS \"icon\", COALESCE(f_sort_code, 0) AS \"sortCode\", \ + f_background_color AS \"backgroundColor\", f_user_id AS \"userId\", \ + 0 AS \"hasUpdate\", 0 AS \"hasDelete\", false AS \"isTop\" \ + FROM base_system WHERE COALESCE(f_delete_mark, 0) = 0 \ + ORDER BY f_sort_code ASC, f_full_name ASC"; + let rows = match state.db.query_json_params(sql, &[]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "应用列表查询"), + }; + ok(list_vo(rows)) +} + +/// `GET /api/visualdev/Portal/manage/Selector/{systemId}` —— 门户名称列表。 +/// +/// 官方 `portal.ts:88 getPortalManageSelector`。 +pub async fn portal_manage_selector( + State(state): State, + headers: HeaderMap, + Path(system_id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let system_id = system_id.trim().to_string(); + let rows = match state + .db + .query_json_params( + "SELECT p.f_id AS \"id\", p.f_full_name AS \"fullName\" \ + FROM base_portal p JOIN base_portal_manage m ON m.f_portal_id = p.f_id \ + WHERE m.f_system_id = $1::text AND COALESCE(m.f_delete_mark, 0) = 0 \ + AND COALESCE(p.f_delete_mark, 0) = 0 \ + ORDER BY p.f_full_name ASC", + &[&system_id], + ) + .await + { + Ok(rows) => rows, + Err(e) => return db_error(e, "门户名称列表查询"), + }; + ok(list_vo(rows)) +} + +// ================================================================ 门户管理(PortalManage) +// +// 官方:`/api/system/PortalManage`(`PortalController` 之外的控制器, +// 官方前端 `portal.ts:80-100` 声明);表:`base_portal_manage`。 + +/// `GET /api/system/PortalManage/list/{systemId}` —— 门户管理列表。 +pub async fn portal_manage_list( + State(state): State, + headers: HeaderMap, + Path(system_id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let system_id = system_id.trim().to_string(); + let rows = match state + .db + .query_json_params( + "SELECT m.f_id AS \"id\", m.f_portal_id AS \"portalId\", m.f_system_id AS \"systemId\", \ + m.f_platform AS \"platform\", m.f_description AS \"description\", \ + COALESCE(m.f_enabled_mark, 0) AS \"enabledMark\", \ + COALESCE(m.f_sort_code, 0) AS \"sortCode\", \ + (EXTRACT(EPOCH FROM m.f_creator_time) * 1000)::bigint AS \"creatorTime\", \ + p.f_full_name AS \"portalName\", p.f_en_code AS \"portalEnCode\" \ + FROM base_portal_manage m LEFT JOIN base_portal p ON p.f_id = m.f_portal_id \ + WHERE m.f_system_id = $1::text AND COALESCE(m.f_delete_mark, 0) = 0 \ + ORDER BY m.f_sort_code ASC", + &[&system_id], + ) + .await + { + Ok(rows) => rows, + Err(e) => return db_error(e, "门户管理列表查询"), + }; + ok(list_vo(rows)) +} + +/// `GET /api/system/PortalManage/{id}` —— 门户管理详情。 +pub async fn portal_manage_info( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + let rows = match state + .db + .query_json_params( + "SELECT f_id AS \"id\", f_portal_id AS \"portalId\", f_system_id AS \"systemId\", \ + f_platform AS \"platform\", f_description AS \"description\", \ + COALESCE(f_enabled_mark, 0) AS \"enabledMark\", \ + COALESCE(f_sort_code, 0) AS \"sortCode\", \ + (EXTRACT(EPOCH FROM f_creator_time) * 1000)::bigint AS \"creatorTime\" \ + FROM base_portal_manage WHERE f_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1", + &[&id], + ) + .await + { + Ok(rows) => rows, + Err(e) => return db_error(e, "门户管理详情查询"), + }; + match rows.into_iter().next() { + Some(row) => ok(row), + None => fail(code::FAIL, "门户管理不存在"), + } +} + +/// `POST /api/system/PortalManage` —— 新建门户管理。 +pub async fn portal_manage_create( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match require_login_face_b(&state, &headers).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 portal_id = obj + .get("portalId") + .and_then(Value::as_str) + .unwrap_or_default() + .trim() + .to_string(); + if portal_id.is_empty() { + return fail(code::FAIL, "门户不能为空"); + } + let system_id = obj + .get("systemId") + .and_then(Value::as_str) + .unwrap_or_default() + .trim() + .to_string(); + if system_id.is_empty() { + return fail(code::FAIL, "应用不能为空"); + } + + let new_id = new_uuid(); + let mut columns: Vec<&str> = vec!["f_id", "f_tenant_id", "f_portal_id", "f_system_id"]; + let mut casts: Vec<&str> = vec!["", "", "", ""]; + let mut values: Vec> = vec![ + Some(new_id.clone()), + Some("0".to_string()), + Some(portal_id), + Some(system_id), + ]; + for (json_key, column, cast) in [ + ("platform", "f_platform", ""), + ("description", "f_description", ""), + ("enabledMark", "f_enabled_mark", "::integer"), + ("sortCode", "f_sort_code", "::bigint"), + ] { + if obj.contains_key(json_key) { + columns.push(column); + casts.push(cast); + values.push(value_to_text(obj.get(json_key))); + } + } + columns.push("f_delete_mark"); + casts.push("::integer"); + values.push(Some("0".to_string())); + columns.push("f_creator_user_id"); + casts.push(""); + values.push(Some(user.account.clone())); + columns.push("f_creator_time"); + + let mut marks: Vec = (0..values.len()) + .map(|i| placeholder(i + 1, casts[i])) + .collect(); + marks.push("now()".to_string()); + let sql = format!( + "INSERT INTO base_portal_manage ({}) VALUES ({})", + columns.join(", "), + marks.join(", ") + ); + if let Err(e) = state.db.exec_params(&sql, ¶ms_of(&values)).await { + return db_error(e, "新建门户管理"); + } + ok(json!({ "id": new_id })) +} + +/// `PUT /api/system/PortalManage/{id}` —— 修改门户管理。 +pub async fn portal_manage_update( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + let exists = match state + .db + .query_json_params( + "SELECT f_id AS \"id\" FROM base_portal_manage WHERE f_id = $1::text LIMIT 1", + &[&id], + ) + .await + { + Ok(rows) => !rows.is_empty(), + Err(e) => return db_error(e, "门户管理查询"), + }; + if !exists { + return fail(code::FAIL, "门户管理不存在"); + } + let mut assignments: Vec = Vec::new(); + let mut values: Vec> = vec![Some(id.clone())]; + for (json_key, column, cast) in [ + ("portalId", "f_portal_id", ""), + ("systemId", "f_system_id", ""), + ("platform", "f_platform", ""), + ("description", "f_description", ""), + ("enabledMark", "f_enabled_mark", "::integer"), + ("sortCode", "f_sort_code", "::bigint"), + ] { + if obj.contains_key(json_key) { + values.push(value_to_text(obj.get(json_key))); + assignments.push(format!("{column} = {}", placeholder(values.len(), cast))); + } + } + if assignments.is_empty() { + return ok(Value::Null); + } + assignments.push("f_last_modify_time = now()".to_string()); + let sql = format!( + "UPDATE base_portal_manage SET {} WHERE f_id = $1::text", + assignments.join(", ") + ); + if let Err(e) = state.db.exec_params(&sql, ¶ms_of(&values)).await { + return db_error(e, "修改门户管理"); + } + ok(Value::Null) +} + +/// `DELETE /api/system/PortalManage/{id}` —— 删除门户管理(软删)。 +pub async fn portal_manage_delete( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + if let Err(e) = state + .db + .exec_params( + "UPDATE base_portal_manage SET f_delete_mark = 1, f_delete_time = now() \ + WHERE f_id = $1::text", + &[&id], + ) + .await + { + return db_error(e, "删除门户管理"); + } + ok(Value::Null) +} + +// ================================================================ 个性化视图(personal) +// +// 官方:`VisualPersonalController.java`(`/api/visualdev/personal`) +// 表:`base_visual_personal` + +/// `GET /api/visualdev/personal` —— 视图列表。 +/// +/// 🔴 官方返**裸数组**(`ActionResult.success(listVo)`,`listVo` 是 `List`) +/// ⇒ 本仓返 `data` = 数组(**不是** `{list:[…]}`)。 +pub async fn personal_list( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let menu_id = qv(&raw, "menuId"); + let mut values: Vec> = Vec::new(); + let mut sql = "SELECT f_id AS \"id\", f_menu_id AS \"menuId\", f_full_name AS \"fullName\", \ + COALESCE(f_type, 0) AS \"type\", COALESCE(f_status, 0) AS \"status\", \ + f_search_list AS \"searchList\", f_column_list AS \"columnList\", \ + (EXTRACT(EPOCH FROM f_creator_time) * 1000)::bigint AS \"creatorTime\" \ + FROM base_visual_personal WHERE COALESCE(f_delete_mark, 0) = 0" + .to_string(); + if !menu_id.is_empty() { + values.push(Some(menu_id.clone())); + sql.push_str(&format!(" AND f_menu_id = ${}::text", values.len())); + } + sql.push_str(" ORDER BY COALESCE(f_status, 0) DESC, f_creator_time ASC"); + let rows = match state.db.query_json_params(&sql, ¶ms_of(&values)).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "视图列表查询"), + }; + ok(Value::Array(rows)) +} + +/// `POST /api/visualdev/personal` —— 新建视图。 +/// +/// 官方 `VisualPersonalController.java:60`:名称 ≤ 6 字、同名判重、**最多 5 个**。 +pub async fn personal_create( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match require_login_face_b(&state, &headers).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 full_name = obj + .get("fullName") + .and_then(Value::as_str) + .unwrap_or_default() + .trim() + .to_string(); + let menu_id = obj + .get("menuId") + .and_then(Value::as_str) + .unwrap_or_default() + .trim() + .to_string(); + + // 🔴 官方:已存在的 id ⇒ 走「更新」分支(不新建);这里按新建处理(官方返回 id)。 + if full_name.is_empty() { + return fail(code::FAIL, "名称不能为空"); + } + // 🔴 官方:名称 > 6 字 ⇒ 失败(`MsgCode.EXIST005`)。 + if full_name.chars().count() > 6 { + return fail(code::FAIL, "视图名称不能超过 6 个字"); + } + let dup = match state + .db + .query_json_params( + "SELECT f_id AS \"id\" FROM base_visual_personal \ + WHERE f_full_name = $1::text AND f_menu_id = $2::text \ + AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1", + &[&full_name, &menu_id], + ) + .await + { + Ok(rows) => !rows.is_empty(), + Err(e) => return db_error(e, "视图名称查重"), + }; + if dup { + return fail(code::FAIL, "名称已存在"); + } + // 🔴 官方:同一菜单**最多 5 个**视图(`MsgCode.VS028`)。 + let count = match state + .db + .query_json_params( + "SELECT count(*)::bigint AS \"c\" FROM base_visual_personal \ + WHERE f_menu_id = $1::text AND COALESCE(f_delete_mark, 0) = 0", + &[&menu_id], + ) + .await + { + Ok(rows) => rows + .into_iter() + .next() + .and_then(|r| r["c"].as_i64()) + .unwrap_or(0), + Err(e) => return db_error(e, "视图计数查询"), + }; + if count >= 5 { + return fail(code::FAIL, "最多只能创建 5 个视图"); + } + + let new_id = new_uuid(); + let mut columns: Vec<&str> = vec!["f_id", "f_tenant_id", "f_menu_id", "f_full_name"]; + let mut casts: Vec<&str> = vec!["", "", "", ""]; + let mut values: Vec> = vec![ + Some(new_id.clone()), + Some("0".to_string()), + Some(menu_id), + Some(full_name), + ]; + for (json_key, column, cast) in [ + ("searchList", "f_search_list", ""), + ("columnList", "f_column_list", ""), + ] { + if obj.contains_key(json_key) { + columns.push(column); + casts.push(cast); + values.push(value_to_text(obj.get(json_key))); + } + } + // 🔴 官方:新建时 `status=0`(非默认)、`type=1`。 + columns.push("f_type"); + casts.push("::integer"); + values.push(Some("1".to_string())); + columns.push("f_status"); + casts.push("::integer"); + values.push(Some("0".to_string())); + columns.push("f_creator_user_id"); + casts.push(""); + values.push(Some(user.account.clone())); + columns.push("f_creator_time"); + + let mut marks: Vec = (0..values.len()) + .map(|i| placeholder(i + 1, casts[i])) + .collect(); + marks.push("now()".to_string()); + let sql = format!( + "INSERT INTO base_visual_personal ({}) VALUES ({})", + columns.join(", "), + marks.join(", ") + ); + if let Err(e) = state.db.exec_params(&sql, ¶ms_of(&values)).await { + return db_error(e, "新建视图"); + } + ok(json!({ "id": new_id })) +} + +/// `PUT /api/visualdev/personal/{id}` —— 修改视图。 +pub async fn personal_update( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + let exists = match state + .db + .query_json_params( + "SELECT f_id AS \"id\" FROM base_visual_personal WHERE f_id = $1::text LIMIT 1", + &[&id], + ) + .await + { + Ok(rows) => !rows.is_empty(), + Err(e) => return db_error(e, "视图查询"), + }; + if !exists { + return fail(code::FAIL, "视图不存在"); + } + if let Some(full_name) = obj.get("fullName").and_then(Value::as_str) { + let full_name = full_name.trim(); + if !full_name.is_empty() && full_name.chars().count() > 6 { + return fail(code::FAIL, "视图名称不能超过 6 个字"); + } + } + let mut assignments: Vec = Vec::new(); + let mut values: Vec> = vec![Some(id.clone())]; + for (json_key, column, cast) in [ + ("fullName", "f_full_name", ""), + ("searchList", "f_search_list", ""), + ("columnList", "f_column_list", ""), + ] { + if obj.contains_key(json_key) { + values.push(value_to_text(obj.get(json_key))); + assignments.push(format!("{column} = {}", placeholder(values.len(), cast))); + } + } + if assignments.is_empty() { + return ok(Value::Null); + } + assignments.push("f_last_modify_time = now()".to_string()); + let sql = format!( + "UPDATE base_visual_personal SET {} WHERE f_id = $1::text", + assignments.join(", ") + ); + if let Err(e) = state.db.exec_params(&sql, ¶ms_of(&values)).await { + return db_error(e, "修改视图"); + } + ok(Value::Null) +} + +/// `PUT /api/visualdev/personal/{id}/setDefault` —— 设置默认视图。 +/// +/// 🔴 官方:同一菜单下**只有一个**默认视图 ⇒ 设新的要**清掉旧的**。 +pub async fn personal_set_default( + State(state): State, + headers: HeaderMap, + Path(id): Path, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + let menu_id = qv(&raw, "menuId"); + let rows = match state + .db + .query_json_params( + "SELECT f_id AS \"id\", f_menu_id AS \"menuId\" FROM base_visual_personal \ + WHERE f_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1", + &[&id], + ) + .await + { + Ok(rows) => rows, + Err(e) => return db_error(e, "视图查询"), + }; + let Some(row) = rows.first() else { + return fail(code::FAIL, "视图不存在"); + }; + let row_menu_id = row["menuId"].as_str().unwrap_or_default().to_string(); + let target_menu = if menu_id.is_empty() { + row_menu_id + } else { + menu_id + }; + // 🔴 先清同菜单其它视图的默认标记,再设自己。 + if let Err(e) = state + .db + .exec_params( + "UPDATE base_visual_personal SET f_status = 0 \ + WHERE f_menu_id = $1::text AND f_id <> $2::text AND COALESCE(f_delete_mark, 0) = 0", + &[&target_menu, &id], + ) + .await + { + return db_error(e, "清除默认视图"); + } + if let Err(e) = state + .db + .exec_params( + "UPDATE base_visual_personal SET f_status = 1, f_last_modify_time = now() \ + WHERE f_id = $1::text", + &[&id], + ) + .await + { + return db_error(e, "设置默认视图"); + } + ok(Value::Null) +} + +/// `DELETE /api/visualdev/personal/{id}` —— 删除视图(软删)。 +pub async fn personal_delete( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + if let Err(e) = state + .db + .exec_params( + "UPDATE base_visual_personal SET f_delete_mark = 1, f_delete_time = now() \ + WHERE f_id = $1::text", + &[&id], + ) + .await + { + return db_error(e, "删除视图"); + } + ok(Value::Null) +} + +// ================================================================ 跨应用分享(share) +// +// 官方:`SystemShareController.java`(`/api/visualdev/share`) +// 表:`base_system_share` + +/// `GET /api/visualdev/share` —— 跨应用数据(**已分享的表单 id 列表**)。 +/// +/// 🔴 官方返 `{ids:[…]}`(**不是** `ListVO`)⇒ 本仓同形状。 +pub async fn share_list( + State(state): State, + headers: HeaderMap, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let rows = match state + .db + .query_json_params( + "SELECT f_object_id AS \"objectId\" FROM base_system_share \ + WHERE COALESCE(f_delete_mark, 0) = 0", + &[], + ) + .await + { + Ok(rows) => rows, + Err(e) => return db_error(e, "跨应用分享列表查询"), + }; + let ids: Vec = rows + .iter() + .map(|r| r["objectId"].clone()) + .filter(|v| !v.is_null()) + .collect(); + ok(json!({ "ids": ids })) +} + +/// `POST /api/visualdev/share/SelectedList` —— 跨应用数据回显。 +/// +/// 🔴 官方返**裸数组**(`ActionResult>`)。 +pub async fn share_selected_list( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + let ids = id_list_of(&obj, "ids"); + if ids.is_empty() { + // 🔴 **必须 `return`** —— 空数组时直接返回官方形状的裸数组; + // 漏掉 `return` 会继续拼 `IN ()` ⇒ PostgreSQL 语法错误。 + return ok(Value::Array(Vec::new())); + } + let marks: Vec = (1..=ids.len()).map(|i| format!("${i}::text")).collect(); + let sql = format!( + "SELECT v.f_id AS \"id\", v.f_full_name AS \"fullName\", v.f_en_code AS \"enCode\", \ + COALESCE(v.f_type, 0) AS \"type\", COALESCE(v.f_web_type, 0) AS \"webType\" \ + FROM base_visual_dev v WHERE v.f_delete_mark = 0 AND v.f_id IN ({})", + marks.join(", ") + ); + let rows = match state.db.query_json_params(&sql, ¶ms_of_str(&ids)).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "跨应用数据回显查询"), + }; + // 🔴 按**入参顺序**回填(官方 `selectedList` 也是按 ids 顺序)。 + let mut ordered: Vec = Vec::new(); + for id in &ids { + if let Some(row) = rows.iter().find(|r| r["id"].as_str() == Some(id.as_str())) { + ordered.push(row.clone()); + } + } + ok(Value::Array(ordered)) +} + +/// `POST /api/visualdev/share/save` —— 保存跨应用分享。 +/// +/// 🔴 官方 `save(ids)` = 先删该系统已有记录,再插入新的。 +pub async fn share_save( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match require_login_face_b(&state, &headers).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 ids = id_list_of(&obj, "ids"); + let system_id = current_system_id(&state.db).await; + + if let Err(e) = state + .db + .exec_params( + "UPDATE base_system_share SET f_delete_mark = 1 \ + WHERE f_system_id = $1::text AND COALESCE(f_delete_mark, 0) = 0", + &[&system_id], + ) + .await + { + return db_error(e, "清理跨应用分享"); + } + for object_id in &ids { + let new_id = new_uuid(); + let sql = "INSERT INTO base_system_share \ + (f_id, f_tenant_id, f_system_id, f_source_id, f_object_id, \ + f_creator_user_id, f_creator_time) \ + VALUES ($1::text, '0', $2::text, $2::text, $3::text, $4::text, now())"; + let values = [ + Some(new_id), + Some(system_id.clone()), + Some(object_id.clone()), + Some(user.account.clone()), + ]; + if let Err(e) = state.db.exec_params(sql, ¶ms_of(&values)).await { + return db_error(e, "保存跨应用分享"); + } + } + ok(Value::Null) +} + +/// `GET /api/visualdev/share/Selector` —— 跨应用功能下拉框(**树形**)。 +/// +/// 官方 `SystemShareController.java:87`(`ListVO`)。 +/// +/// 🔴 官方是两个固定分类(`当前应用` / `跨应用`)⇒ 本仓同口径。 +pub async fn share_selector( + State(state): State, + headers: HeaderMap, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let system_id = current_system_id(&state.db).await; + + // 🔴 官方:只要「在线开发 + 带列表」的(`type=1` 且 `webType=2`),且查**已发布**。 + let current_rows = match state + .db + .query_json_params( + "SELECT f_id AS \"id\", f_full_name AS \"fullName\", f_en_code AS \"enCode\" \ + FROM base_visual_release WHERE COALESCE(f_delete_mark, 0) = 0 \ + AND COALESCE(f_type, 0) = 1 AND COALESCE(f_web_type, 0) = 2 \ + ORDER BY f_full_name ASC", + &[], + ) + .await + { + Ok(rows) => rows, + Err(e) => return db_error(e, "已发布功能查询"), + }; + let shared_rows = match state + .db + .query_json_params( + "SELECT v.f_id AS \"id\", v.f_full_name AS \"fullName\", v.f_en_code AS \"enCode\" \ + FROM base_system_share s JOIN base_visual_dev v ON v.f_id = s.f_object_id \ + WHERE COALESCE(s.f_delete_mark, 0) = 0 AND v.f_delete_mark = 0 \ + AND COALESCE(v.f_type, 0) = 1 AND COALESCE(v.f_web_type, 0) = 2 \ + ORDER BY v.f_full_name ASC", + &[&system_id], + ) + .await + { + Ok(rows) => rows, + Err(e) => return db_error(e, "跨应用功能查询"), + }; + + let to_children = |rows: Vec| -> Vec { + rows.into_iter() + .map(|r| { + json!({ + "id": r["id"].as_str().unwrap_or_default(), + "fullName": r["fullName"].as_str().unwrap_or_default(), + "enCode": r["enCode"].as_str().unwrap_or_default(), + "hasChildren": false, + }) + }) + .collect() + }; + let list = vec![ + json!({ + "id": "category1", + "fullName": "当前应用", + "hasChildren": true, + "children": to_children(current_rows), + }), + json!({ + "id": "category2", + "fullName": "跨应用", + "hasChildren": true, + "children": to_children(shared_rows), + }), + ]; + ok(list_vo(list)) +} + +// ================================================================ 在线日志(OnlineLog) +// +// 官方:`VisualLogController.java`(`/api/visualdev/OnlineLog`) +// 表:`base_visual_log` + +/// `GET /api/visualdev/OnlineLog` —— 数据修改记录列表。 +pub async fn online_log_list( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let page = Paging::of(&raw); + let model_id = qv(&raw, "modelId"); + let mut values: Vec> = Vec::new(); + let mut sql = "SELECT f_id AS \"id\", f_model_id AS \"modelId\", COALESCE(f_type, 0) AS \"type\", \ + f_data_id AS \"dataId\", f_data_log AS \"dataLog\", \ + (EXTRACT(EPOCH FROM f_creator_time) * 1000)::bigint AS \"creatorTime\", \ + f_creator_user_id AS \"creatorUserId\" \ + FROM base_visual_log WHERE COALESCE(f_delete_mark, 0) = 0" + .to_string(); + if !model_id.is_empty() { + values.push(Some(model_id.clone())); + sql.push_str(&format!(" AND f_model_id = ${}::text", values.len())); + } + let count_sql = format!( + "SELECT count(*)::bigint AS \"c\" FROM base_visual_log WHERE COALESCE(f_delete_mark, 0) = 0{}", + if model_id.is_empty() { + String::new() + } else { + format!(" AND f_model_id = $1::text") + } + ); + let total = match state + .db + .query_json_params(&count_sql, ¶ms_of(&[Some(model_id.clone())])) + .await + { + Ok(rows) => rows + .into_iter() + .next() + .and_then(|r| r["c"].as_i64()) + .unwrap_or(0), + Err(e) => return db_error(e, "在线日志总数查询"), + }; + values.push(Some(page.page_size.to_string())); + values.push(Some(page.offset.to_string())); + let p_limit = values.len() - 1; + let p_offset = values.len(); + sql.push_str(&format!( + " ORDER BY f_creator_time DESC \ + LIMIT ${p_limit}::text::integer OFFSET ${p_offset}::text::integer" + )); + let rows = match state.db.query_json_params(&sql, ¶ms_of(&values)).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "在线日志查询"), + }; + ok(page_list(page.current_page, page.page_size, total, rows)) +} + +// ================================================================ 外链(ShortLink) +// +// 官方:`VisualdevShortLinkController.java`(`/api/visualdev/ShortLink`) +// 表:`base_visual_link` + +/// `base_visual_link` 的写白名单。 +const SHORT_LINK_WRITE_FIELDS: &[(&str, &str, &str)] = &[ + ("shortLink", "f_short_link", ""), + ("formUse", "f_form_use", "::integer"), + ("formLink", "f_form_link", ""), + ("formPassUse", "f_form_pass_use", "::integer"), + ("formPassword", "f_form_password", ""), + ("columnUse", "f_column_use", "::integer"), + ("columnLink", "f_column_link", ""), + ("columnPassUse", "f_column_pass_use", "::integer"), + ("columnPassword", "f_column_password", ""), + ("columnCondition", "f_column_condition", ""), + ("columnText", "f_column_text", ""), + ("realPcLink", "f_real_pc_link", ""), + ("realAppLink", "f_real_app_link", ""), + ("enabledMark", "f_enabled_mark", "::integer"), +]; + +/// `GET /api/visualdev/ShortLink/{id}` —— 外链信息。 +pub async fn short_link_info( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_FORM_DESIGN).await { + return resp; + } + let id = id.trim().to_string(); + let rows = match state + .db + .query_json_params( + "SELECT f_id AS \"id\", f_short_link AS \"shortLink\", \ + COALESCE(f_form_use, 0) AS \"formUse\", f_form_link AS \"formLink\", \ + COALESCE(f_form_pass_use, 0) AS \"formPassUse\", \ + f_form_password AS \"formPassword\", \ + COALESCE(f_column_use, 0) AS \"columnUse\", f_column_link AS \"columnLink\", \ + COALESCE(f_column_pass_use, 0) AS \"columnPassUse\", \ + f_column_password AS \"columnPassword\", \ + f_column_condition AS \"columnCondition\", f_column_text AS \"columnText\", \ + f_real_pc_link AS \"realPcLink\", f_real_app_link AS \"realAppLink\", \ + COALESCE(f_enabled_mark, 0) AS \"enabledMark\", \ + f_user_id AS \"userId\" \ + FROM base_visual_link WHERE f_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1", + &[&id], + ) + .await + { + Ok(rows) => rows, + Err(e) => return db_error(e, "外链信息查询"), + }; + match rows.into_iter().next() { + Some(row) => ok(row), + None => fail(code::FAIL, "外链不存在"), + } +} + +/// `PUT /api/visualdev/ShortLink` —— 保存外链信息(**upsert**)。 +/// +/// 官方 `VisualdevShortLinkController.java:139`(`saveOrupdate`)。 +pub async fn short_link_save( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_FORM_DESIGN).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(); + + let fields = write_fields(&obj, SHORT_LINK_WRITE_FIELDS); + if id.is_empty() { + // 🔴 新建。 + let new_id = new_uuid(); + let mut columns: Vec<&str> = vec!["f_id", "f_tenant_id", "f_user_id"]; + let mut casts: Vec<&str> = vec!["", "", ""]; + let mut values: Vec> = vec![ + Some(new_id.clone()), + Some("0".to_string()), + Some(user.account.clone()), + ]; + for (column, cast, value) in &fields { + columns.push(column); + casts.push(cast); + values.push(value.clone()); + } + columns.push("f_enabled_mark"); + casts.push("::integer"); + values.push(Some("1".to_string())); + columns.push("f_delete_mark"); + casts.push("::integer"); + values.push(Some("0".to_string())); + columns.push("f_creator_user_id"); + casts.push(""); + values.push(Some(user.account.clone())); + columns.push("f_creator_time"); + let mut marks: Vec = (0..values.len()) + .map(|i| placeholder(i + 1, casts[i])) + .collect(); + marks.push("now()".to_string()); + let sql = format!( + "INSERT INTO base_visual_link ({}) VALUES ({})", + columns.join(", "), + marks.join(", ") + ); + if let Err(e) = state.db.exec_params(&sql, ¶ms_of(&values)).await { + return db_error(e, "新建外链"); + } + return ok(json!({ "id": new_id })); + } + + // 🔴 更新:只 SET body 里真出现的键。 + let exists = match state + .db + .query_json_params( + "SELECT f_id AS \"id\" FROM base_visual_link WHERE f_id = $1::text LIMIT 1", + &[&id], + ) + .await + { + Ok(rows) => !rows.is_empty(), + Err(e) => return db_error(e, "外链查询"), + }; + if !exists { + return fail(code::FAIL, "外链不存在"); + } + let mut assignments: Vec = Vec::new(); + let mut values: Vec> = vec![Some(id.clone())]; + for (column, cast, value) in &fields { + values.push(value.clone()); + assignments.push(format!("{column} = {}", placeholder(values.len(), cast))); + } + if assignments.is_empty() { + return ok(Value::Null); + } + assignments.push("f_last_modify_time = now()".to_string()); + let sql = format!( + "UPDATE base_visual_link SET {} WHERE f_id = $1::text", + assignments.join(", ") + ); + if let Err(e) = state.db.exec_params(&sql, ¶ms_of(&values)).await { + return db_error(e, "保存外链"); + } + ok(json!({ "id": id })) +} + +/// `GET /api/visualdev/ShortLink/getConfig/{id}` —— 外链信息(渲染列表)。 +/// +/// 🔴 官方要 `encryption` 参数(前端 `{useCipher: true}` 会加密传)⇒ 本仓同。 +pub async fn short_link_get_config( + State(state): State, + headers: HeaderMap, + Path(id): Path, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + let _encryption = qv(&raw, "encryption"); + let rows = match state + .db + .query_json_params( + "SELECT f_id AS \"id\", f_short_link AS \"shortLink\", \ + COALESCE(f_form_use, 0) AS \"formUse\", f_form_link AS \"formLink\", \ + COALESCE(f_form_pass_use, 0) AS \"formPassUse\", \ + COALESCE(f_column_use, 0) AS \"columnUse\", f_column_link AS \"columnLink\", \ + COALESCE(f_column_pass_use, 0) AS \"columnPassUse\", \ + f_column_condition AS \"columnCondition\", f_column_text AS \"columnText\", \ + f_real_pc_link AS \"realPcLink\", f_real_app_link AS \"realAppLink\" \ + FROM base_visual_link WHERE f_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1", + &[&id], + ) + .await + { + Ok(rows) => rows, + Err(e) => return db_error(e, "外链配置查询"), + }; + match rows.into_iter().next() { + Some(row) => ok(row), + None => fail(code::FAIL, "外链不存在"), + } +} + +/// `POST /api/visualdev/ShortLink/checkPwd` —— 校验外链密码。 +/// +/// 🔴 官方用 `StpUtil` 做登录校验;本仓没有「外链会话」⇒ **明确失败**。 +pub async fn short_link_check_pwd( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = parse_body(&body).map(|_| ()); + unsupported("外链密码校验(外链会话未建模)") +} + +/// `GET /api/visualdev/ShortLink/Config` —— 外链列表表单配置 JSON。 +/// +/// 🔴 **路径口径**:官方前端 `shortLink.ts` 的 `getConfigData` 打的是 +/// `Api.Prefix/Config`(= `/api/visualdev/ShortLink/Config`),**没有路径参数**; +/// `encryption` / `type` 走 query。官方 `docs/fe/endpoints.tsv` 里记的 +/// `/{param}/Config` 是**旧记录**,以源码为准。 +/// 🔴 官方查的是**动态表**(外链对应的低代码表单)⇒ **明确失败**。 +pub async fn short_link_config_data( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _encryption = qv(&raw, "encryption"); + let _type = qv(&raw, "type"); + unsupported("外链列表表单配置(低代码动态表未建模)") +} + +/// `POST /api/visualdev/ShortLink/{modelId}/ListLink` —— 外链数据列表。 +/// +/// 🔴 官方查**动态表** ⇒ **明确失败**。 +pub async fn short_link_model_list( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = id.trim(); + let _ = parse_body(&body).map(|_| ()); + unsupported("外链数据列表(低代码动态表未建模)") +} + +/// `POST /api/visualdev/ShortLink/{modelId}` —— 新建外链数据。 +/// +/// 🔴 官方写**动态表** ⇒ **明确失败**。 +pub async fn short_link_create_model( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = id.trim(); + let _ = parse_body(&body).map(|_| ()); + unsupported("新建外链数据(低代码动态表未建模)") +} + +/// `GET /api/visualdev/ShortLink/{modelId}/{id}/DataChange` —— 外链数据详情。 +/// +/// 🔴 官方查**动态表** ⇒ **明确失败**。 +pub async fn short_link_data_change( + State(state): State, + headers: HeaderMap, + Path((model_id, id)): Path<(String, String)>, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = model_id.trim(); + let _ = id.trim(); + let _ = qv(&raw, "encryption"); + unsupported("外链数据详情(低代码动态表未建模)") +} + +// ================================================================ 在线开发数据(OnlineDev) +// +// 官方:`VisualdevModelDataController.java`(`/api/visualdev/OnlineDev`) +// 🔴 **整族都依赖低代码引擎的动态表** ⇒ 本仓一律明确失败。 + +/// `GET /api/visualdev/OnlineDev/{modelId}/Config` —— 列表表单配置 JSON。 +pub async fn online_dev_config( + State(state): State, + headers: HeaderMap, + Path(model_id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = model_id.trim(); + unsupported("在线开发列表配置(低代码动态表未建模)") +} + +/// `GET /api/visualdev/OnlineDev/Config` —— 通过菜单 id 取列表表单配置 JSON。 +pub async fn online_dev_config_by_menu( + State(state): State, + headers: HeaderMap, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + unsupported("在线开发列表配置(低代码动态表未建模)") +} + +/// `GET /api/visualdev/OnlineDev/{modelId}/FormData` —— 表单配置 JSON。 +pub async fn online_dev_form_data( + State(state): State, + headers: HeaderMap, + Path(model_id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = model_id.trim(); + unsupported("在线开发表单配置(低代码动态表未建模)") +} + +/// `POST /api/visualdev/OnlineDev/{modelId}/List` —— 数据列表。 +pub async fn online_dev_model_list( + State(state): State, + headers: HeaderMap, + Path(model_id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = model_id.trim(); + let _ = parse_body(&body).map(|_| ()); + unsupported("在线开发数据列表(低代码动态表未建模)") +} + +/// `POST /api/visualdev/OnlineDev/{modelId}` —— 新建数据。 +pub async fn online_dev_create_model( + State(state): State, + headers: HeaderMap, + Path(model_id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = model_id.trim(); + let _ = parse_body(&body).map(|_| ()); + unsupported("新建在线开发数据(低代码动态表未建模)") +} + +/// `PUT /api/visualdev/OnlineDev/{modelId}/{id}` —— 修改数据。 +pub async fn online_dev_update_model( + State(state): State, + headers: HeaderMap, + Path((model_id, id)): Path<(String, String)>, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = model_id.trim(); + let _ = id.trim(); + let _ = parse_body(&body).map(|_| ()); + unsupported("修改在线开发数据(低代码动态表未建模)") +} + +/// `GET /api/visualdev/OnlineDev/{modelId}/{id}` —— 数据详情。 +pub async fn online_dev_model_info( + State(state): State, + headers: HeaderMap, + Path((model_id, id)): Path<(String, String)>, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = model_id.trim(); + let _ = id.trim(); + unsupported("在线开发数据详情(低代码动态表未建模)") +} + +/// `DELETE /api/visualdev/OnlineDev/{modelId}/{id}` —— 删除数据。 +pub async fn online_dev_delete_model( + State(state): State, + headers: HeaderMap, + Path((model_id, id)): Path<(String, String)>, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = model_id.trim(); + let _ = id.trim(); + unsupported("删除在线开发数据(低代码动态表未建模)") +} + +/// `POST /api/visualdev/OnlineDev/batchDelete/{modelId}` —— 批量删除数据。 +pub async fn online_dev_batch_delete( + State(state): State, + headers: HeaderMap, + Path(model_id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = model_id.trim(); + let _ = parse_body(&body).map(|_| ()); + unsupported("批量删除在线开发数据(低代码动态表未建模)") +} + +/// `POST /api/visualdev/OnlineDev/{modelId}/DataChange` —— 数据详情(带变更)。 +pub async fn online_dev_data_change( + State(state): State, + headers: HeaderMap, + Path(model_id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = model_id.trim(); + let _ = parse_body(&body).map(|_| ()); + unsupported("在线开发数据变更详情(低代码动态表未建模)") +} + +/// `GET /api/visualdev/OnlineDev/{modelId}/Template` —— 下载模板。 +pub async fn online_dev_template( + State(state): State, + headers: HeaderMap, + Path(model_id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = model_id.trim(); + unsupported("在线开发模板下载(需要文件服务)") +} + +/// `POST /api/visualdev/OnlineDev/{modelId}/Actions/ExportData` —— 导出数据。 +pub async fn online_dev_export_model( + State(state): State, + headers: HeaderMap, + Path(model_id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = model_id.trim(); + let _ = parse_body(&body).map(|_| ()); + unsupported("在线开发数据导出(需要文件服务)") +} + +/// `POST /api/visualdev/OnlineDev/{modelId}/Actions/Export` —— 导出模板。 +pub async fn online_dev_export( + State(state): State, + headers: HeaderMap, + Path(model_id): Path, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_FORM_DESIGN).await { + return resp; + } + let _ = model_id.trim(); + unsupported("在线开发模板导出(需要文件服务)") +} + +/// `POST /api/visualdev/OnlineDev/{modelId}/actionLaunchFlow` —— 自定义按钮发起流程。 +/// +/// 🔴 官方调工作流引擎 ⇒ 本仓**没有工作流** ⇒ **明确失败**。 +pub async fn online_dev_launch_flow( + State(state): State, + headers: HeaderMap, + Path(model_id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = model_id.trim(); + let _ = parse_body(&body).map(|_| ()); + unsupported("自定义按钮发起流程(没有工作流引擎)") +} + +/// `POST /api/visualdev/OnlineDev/RelationQuery` —— 关联查询数据列表。 +pub async fn online_dev_relation_query( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = parse_body(&body).map(|_| ()); + unsupported("关联查询数据列表(低代码动态表未建模)") +} + +// ================================================================ 代码生成(Generater) +// +// 官方:`VisualdevGenController.java`(`/api/visualdev/Generater`) +// 🔴 官方用 **Velocity 模板**生成 Java/Vue 代码 ⇒ 本仓没有模板引擎 ⇒ 一律明确失败。 + +/// `GET /api/visualdev/Generater/{id}/Alias/Info` —— 代码生成命名规范。 +/// +/// 🔴 官方查 `base_visual_alias`(表**在**)⇒ 本仓**能做**。 +pub async fn generater_alias_info( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = guard_any(&state, &headers, &[EN_FORM_DESIGN, EN_GENERATOR_WEB_FORM, EN_GENERATOR_FLOW_FORM]).await { + return resp; + } + let id = id.trim().to_string(); + let rows = match state + .db + .query_json_params( + "SELECT f_id AS \"id\", f_visual_id AS \"visualId\", f_alias_name AS \"aliasName\", \ + f_table_name AS \"tableName\", f_field_name AS \"fieldName\" \ + FROM base_visual_alias WHERE f_visual_id = $1::text \ + AND COALESCE(f_delete_mark, 0) = 0", + &[&id], + ) + .await + { + Ok(rows) => rows, + Err(e) => return db_error(e, "代码生成命名规范查询"), + }; + ok(list_vo(rows)) +} + +/// `POST /api/visualdev/Generater/{id}/Alias/Save` —— 更新代码生成命名规范。 +pub async fn generater_alias_save( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + let user = match guard_any(&state, &headers, &[EN_FORM_DESIGN, EN_GENERATOR_WEB_FORM, EN_GENERATOR_FLOW_FORM]).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let id = id.trim().to_string(); + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + let alias_name = obj + .get("aliasName") + .and_then(Value::as_str) + .unwrap_or_default() + .trim() + .to_string(); + if alias_name.is_empty() { + return fail(code::FAIL, "别名不能为空"); + } + let table_name = obj + .get("tableName") + .and_then(Value::as_str) + .unwrap_or_default() + .trim() + .to_string(); + let field_name = obj + .get("fieldName") + .and_then(Value::as_str) + .unwrap_or_default() + .trim() + .to_string(); + + // 🔴 官方:`aliasService.save` 按 `visualId` upsert ⇒ 先删同视觉的旧记录再插。 + if let Err(e) = state + .db + .exec_params( + "DELETE FROM base_visual_alias WHERE f_visual_id = $1::text", + &[&id], + ) + .await + { + return db_error(e, "清理旧命名规范"); + } + let new_id = new_uuid(); + let sql = "INSERT INTO base_visual_alias \ + (f_id, f_tenant_id, f_visual_id, f_alias_name, f_table_name, f_field_name, \ + f_creator_user_id, f_creator_time) \ + VALUES ($1::text, '0', $2::text, $3::text, $4::text, $5::text, $6::text, now())"; + let values = [ + Some(new_id), + Some(id), + Some(alias_name), + Some(table_name), + Some(field_name), + Some(user.account.clone()), + ]; + if let Err(e) = state.db.exec_params(sql, ¶ms_of(&values)).await { + return db_error(e, "保存命名规范"); + } + ok(Value::Null) +} + +/// `POST /api/visualdev/Generater/{id}/Actions/CodePreview` —— 代码预览。 +pub async fn generater_code_preview( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = guard_any(&state, &headers, &[EN_FORM_DESIGN, EN_GENERATOR_WEB_FORM, EN_GENERATOR_FLOW_FORM]).await { + return resp; + } + let _ = id.trim(); + let _ = parse_body(&body).map(|_| ()); + unsupported("代码预览(没有代码生成模板引擎)") +} + +/// `POST /api/visualdev/Generater/{id}/Actions/DownloadCode` —— 代码下载。 +pub async fn generater_download_code( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = guard_any(&state, &headers, &[EN_FORM_DESIGN, EN_GENERATOR_WEB_FORM, EN_GENERATOR_FLOW_FORM]).await { + return resp; + } + let _ = id.trim(); + let _ = parse_body(&body).map(|_| ()); + unsupported("代码下载(没有代码生成模板引擎与文件服务)") +} + +// ================================================================ OCR / DataV +// +// 官方:`OcrController.java`(`/api/visualdev/ocr`)、DataV(`/api/blade-visual/visual/Selector`) +// 🔴 本仓**没有 OCR 服务**、**没有 DataV 组件库** ⇒ 一律明确失败。 + +/// `POST /api/visualdev/ocr` —— OCR 识别。 +pub async fn ocr_recognize( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = parse_body(&body).map(|_| ()); + 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 组件库)") +} + +// ================================================================ 地图(atlas) +// +// 官方:`/api/system/atlas`(`base_province_atlas` 表**在**) +// 🔴 geojson 那条要**地图服务**(高德/百度)⇒ 明确失败。 + +/// `GET /api/system/atlas` —— 全国省市区。 +pub async fn atlas_list( + State(state): State, + headers: HeaderMap, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let rows = match state + .db + .query_json_params( + "SELECT f_id AS \"id\", COALESCE(f_parent_id, '0') AS \"parentId\", \ + f_en_code AS \"enCode\", f_full_name AS \"fullName\", \ + f_quick_query AS \"quickQuery\", f_type AS \"type\", \ + f_division_code AS \"divisionCode\", f_atlas_center AS \"atlasCenter\", \ + f_description AS \"description\" \ + FROM base_province_atlas WHERE COALESCE(f_delete_mark, 0) = 0 \ + ORDER BY COALESCE(f_sort_code, 0) ASC, f_full_name ASC", + &[], + ) + .await + { + Ok(rows) => rows, + Err(e) => return db_error(e, "行政区划查询"), + }; + ok(list_vo(rows)) +} + +/// `GET /api/system/atlas/geojson` —— 地图 json。 +pub async fn atlas_geojson( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = qv(&raw, "code"); + unsupported("地图 geojson(没有地图服务)") +} + +// ================================================================ 仪表盘(Dashboard) +// +// 官方:`DashboardController.java`(`/api/visualdev/Dashboard`) +// 🔴 通知公告查 `base_notice`(表**在**)⇒ 能做;未读邮件要**邮件服务** ⇒ 明确失败。 + +/// `POST /api/visualdev/Dashboard/Notice` —— 通知公告。 +/// +/// 官方 `DashboardController.java:45`(`ActionResult>`)。 +/// +/// 🔴 **官方返 `ListVO`(`{list:[…]}`),不是 `PageListVO`** —— +/// 官方消费点 `components/VisualPortal/Design/hooks/useTable.ts:136-137`: +/// `res.data.list || []` ⇒ 本仓必须返 `{list:[…]}`。 +/// +/// 🔴 官方入参是 `NoticeModel { typeList: List }`(**数组**)—— +/// 官方消费点 `useTable.ts:135`:`getNoticeList({ typeList })`。 +/// ⇒ 本仓认 `typeList` 数组(`f_type` 是整数 ⇒ 转字符串去重匹配)。 +/// +/// 🔴 官方 `NoticeVO` 字段:`id/fullName/creatorTime/creatorUser/releaseUser/ +/// releaseTime/category/coverImage/excerpt/lastModifyTime/lastModifyUserId`。 +/// `base_notice` 里**标题列是 `f_title`**(官方 `NoticeEntity.f_title`), +/// `f_description` ⇒ 官方映射成 `excerpt`。 +pub async fn dashboard_notice( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + // 🔴 `typeList` 是**字符串数组**(官方 `NoticeModel.typeList`)。 + let type_list: Vec = match obj.get("typeList") { + Some(Value::Array(items)) => items + .iter() + .filter_map(|v| match v { + Value::String(s) => Some(s.trim().to_string()), + Value::Number(n) => Some(n.to_string()), + _ => None, + }) + .filter(|s| !s.is_empty()) + .collect(), + Some(Value::String(s)) if !s.trim().is_empty() => vec![s.trim().to_string()], + _ => Vec::new(), + }; + let mut values: Vec> = Vec::new(); + let mut sql = "SELECT f_id AS \"id\", f_title AS \"fullName\", f_category AS \"category\", \ + f_cover_image AS \"coverImage\", f_description AS \"excerpt\", \ + (EXTRACT(EPOCH FROM f_creator_time) * 1000)::bigint AS \"creatorTime\", \ + f_creator_user_id AS \"creatorUser\", \ + (EXTRACT(EPOCH FROM f_last_modify_time) * 1000)::bigint AS \"lastModifyTime\", \ + f_last_modify_user_id AS \"lastModifyUserId\" \ + FROM base_notice WHERE COALESCE(f_delete_mark, 0) = 0" + .to_string(); + if !type_list.is_empty() { + let marks: Vec = type_list + .iter() + .enumerate() + .map(|(i, _)| format!("${}::text::integer", i + 1)) + .collect(); + for t in &type_list { + values.push(Some(t.clone())); + } + sql.push_str(&format!( + " AND COALESCE(f_type, 0) IN ({})", + marks.join(", ") + )); + } + sql.push_str(" ORDER BY f_creator_time DESC"); + let rows = match state.db.query_json_params(&sql, ¶ms_of(&values)).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "通知公告查询"), + }; + // 🔴 官方 `NoticeVO.releaseUser` / `releaseTime` 来自「发布记录」⇒ + // 本仓无该表 ⇒ 如实给空串 / 0(官方 `NoticeVO` 里这两个字段可选)。 + let list: Vec = rows + .into_iter() + .map(|mut r| { + r["releaseUser"] = Value::String(String::new()); + r["releaseTime"] = Value::from(0i64); + r + }) + .collect(); + ok(list_vo(list)) +} + +/// `GET /api/visualdev/Dashboard/Email` —— 未读邮件。 +pub async fn dashboard_email( + State(state): State, + headers: HeaderMap, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + unsupported("未读邮件(没有邮件服务)") +} diff --git a/src/backend/src/platform/compat/report.rs b/src/backend/src/platform/compat/report.rs new file mode 100644 index 0000000..b9cf9c5 --- /dev/null +++ b/src/backend/src/platform/compat/report.rs @@ -0,0 +1,1338 @@ +//! report —— 官方 **在线报表**(`/api/Report/*`)端点集。 +//! +//! 🔴 **这条端点族在官方是「独立部署的第三方服务」**: +//! 官方 `jnpf-java-boot` 里**没有** `/api/Report` Controller,也**没有**任何 +//! `report_version` / `ReportVersion` 的 Java 实体(`grep -rl "report_version" +//! jnpf-java-boot` 为空)—— 只有 `jnpf-system/.../util/ReportExportUtil.java:29` +//! 把 `/api/Report/*` 当**远程 HTTP URL** 拼(目标服务 = +//! `jnpf-java-datareport-univer`,端口 32000,配置见 +//! `jnpf-admin/src/main/resources/application.yml:69-70` 的 +//! `ReportDomain: http://127.0.0.1:32000`)。 +//! +//! 🔴 **本仓的处理口径**:把报表**元数据就地落库**(`report_template` + +//! `report_version`,表结构照官方 DDL 逐字导入),让官方前端 +//! `api/onlineDev/report.ts` 的**列表 / 表单 / 版本管理 / 复制 / 删除**能真跑; +//! **依赖 Univer 设计器与文件服务的能力一律明确失败**(`code=400`)—— +//! 不返假 URL、不返空数组。 +//! +//! 🔴 **官方那张 `report_charts` / `report_user` / `report_department` 不导入**: +//! 它们是**示例数据表**(字段是 `qybm` / `fxdmc` / `education` / `salary` +//! 之类演示数据),不是平台元数据 ⇒ 导入它们只会让库里多三张废表。 +//! +//! 🔴 **权限**:官方 `jnpf-java-datareport-univer` **不在**本仓可核对的源码树里 +//! ⇒ 拿不到它的 `@SaCheckPermission` ⇒ 按官方前端 `report.ts` 的调用面 +//! **一律只要求登录**(与 `personal` / `share` / `onlineLog` 同款)。 +//! +//! 🔴 **写路径的三条硬律**(与契约面同一套): +//! 1. 列名只来自常量白名单(请求里的键永不进 SQL 文本); +//! 2. 只 SET body 里真出现的键; +//! 3. 审计列用 SQL 自己的 `now()`,**不占参数位**。 +//! +//! 🔴 **`data` 的形状逐条照官方前端的消费点定**(这是最容易做错的地方)—— +//! 官方前端这些端点的 `res.data` **不是**统一的「对象」,而是四种形状: +//! | 形状 | 端点 | 官方消费点 | +//! |---|---|---| +//! | `PageListVO` `{pagination,list}` | `GET /api/Report` | `useVxeTable` 的 `proxyConfig.response` | +//! | **裸数组** | `GET /api/Report/Version/{id}` | `state.versionList = res.data \|\| []` | +//! | **裸对象** | `GET /api/Report/{id}`、`GET /api/Report/Info/{id}` | `state.dataForm = res.data` | +//! | **裸字符串**(id) | `POST /api/Report`、`POST /api/Report/Info/{id}` | `state.dataForm.id = res.data` | +//! +//! 官方 `report.ts` 走的是 `reportHttp`(**独立 baseURL**),但**响应变换 hook +//! 与 `defHttp` 同一个** ⇒ 信封是 `{code,msg,data}`,**`data` 原样透传**。 +//! 官方 `useVxeTable` 的 `proxyConfig.response` 写的是 +//! `{result:'list', total:'pagination.total', list:'list'}` ⇒ 它读的正是 +//! `data.list` / `data.pagination.total` ⇒ **列表必须返 `PageListVO`**。 +//! 而 `getVersionList` 那条是 `state.versionList = res.data || []` ⇒ **裸数组**。 +//! 两者不能混。 + +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::auth::require_login_face_b; +use crate::platform::crud::value_to_text; +use crate::platform::envelope::{code, fail, ok, ActionResult}; +use crate::platform::ids::new_uuid; +use crate::platform::state::AppState; + +use super::helper::{ + db_error, list_vo, page_list, params_of, parse_body, placeholder, qv, Paging, +}; + +// ---------------------------------------------------------------- 写白名单 + +/// `report_template` 的写白名单:`(JSON 键, 列名, CAST)`。 +/// +/// 🔴 键名逐字对齐官方 `report/Form.vue` 的表单字段: +/// `fullName`(必填)/ `enCode` / `category`(必填)/ `sortCode` / `description`。 +const REPORT_TEMPLATE_WRITE_FIELDS: &[(&str, &str, &str)] = &[ + ("fullName", "f_full_name", ""), + ("enCode", "f_en_code", ""), + ("category", "f_category", ""), + ("description", "f_description", ""), + ("sortCode", "f_sort_code", "::bigint"), + ("allowExport", "f_allow_export", "::integer"), + ("allowPrint", "f_allow_print", "::integer"), + ("allowWatermark", "f_allow_watermark", "::integer"), + ("watermarkConfig", "f_watermark_config", ""), + ("enabledMark", "f_enabled_mark", "::integer"), +]; + +/// `report_version` 的写白名单:`(JSON 键, 列名, CAST)`。 +/// +/// 🔴 `cells` / `snapshot` / `queryList` / `sortList` / `columnList` / `fenceList` +/// 都是 **Univer 设计器的 JSON**(官方 `report_version` 的 TEXT 列)⇒ 本仓 +/// **原样存**(字符串),不做结构解析(官方那个服务的内部格式无从核对)。 +/// +/// 🔴 **`dataSetList` 没有对应的列** —— 官方 `report_version` 的 DDL 里**没有** +/// 数据集列(前端 `design/index.vue` 的 `getData()` 把它 `JSON.stringify` 后 +/// 塞进 `cells` 里 ⇒ 官方也是这么存的)⇒ 本仓随 `cells` 一起存。 +const REPORT_VERSION_WRITE_FIELDS: &[(&str, &str, &str)] = &[ + ("state", "f_state", "::integer"), + ("version", "f_version", "::integer"), + ("cells", "f_cells", ""), + ("snapshot", "f_snapshot", ""), + ("queryList", "f_query_list", ""), + ("sortList", "f_sort_list", ""), + ("columnList", "f_column_list", ""), + ("fenceList", "f_fence_list", ""), + ("convertConfig", "f_convert_config", ""), + ("description", "f_description", ""), + ("sortCode", "f_sort_code", "::bigint"), + ("enabledMark", "f_enabled_mark", "::integer"), +]; + +/// `report_template` 的详情投影(官方 `Report` VO 形状)。 +/// +/// 🔴 `creatorUser` / `lastModifyUser` = `真实姓名/账号`(官方同口径), +/// 查不到用户 ⇒ 空串。 +const REPORT_TEMPLATE_DETAIL_COLUMNS: &str = "t.f_id AS \"id\", t.f_full_name AS \"fullName\", \ + t.f_en_code AS \"enCode\", t.f_category AS \"category\", t.f_description AS \"description\", \ + COALESCE(t.f_enabled_mark, 0) AS \"enabledMark\", COALESCE(t.f_sort_code, 0) AS \"sortCode\", \ + t.f_version_id AS \"versionId\", t.f_system_id AS \"systemId\", \ + COALESCE(t.f_allow_export, 0) AS \"allowExport\", \ + COALESCE(t.f_allow_print, 0) AS \"allowPrint\", \ + COALESCE(t.f_allow_watermark, 0) AS \"allowWatermark\", \ + t.f_watermark_config AS \"watermarkConfig\", \ + t.f_platform_release AS \"platformRelease\", \ + (EXTRACT(EPOCH FROM t.f_creator_time) * 1000)::bigint AS \"creatorTime\", \ + t.f_creator_user_id AS \"creatorUserId\", \ + (EXTRACT(EPOCH FROM t.f_last_modify_time) * 1000)::bigint AS \"lastModifyTime\", \ + t.f_last_modify_user_id AS \"lastModifyUserId\", \ + COALESCE(u.f_real_name, '') || '/' || COALESCE(u.f_account, '') AS \"creatorUser\", \ + COALESCE(lu.f_real_name, '') || '/' || COALESCE(lu.f_account, '') AS \"lastModifyUser\""; + +/// 🔴 **`report_version` 的详情投影** —— 版本详情要给前端**设计器**用的那套字段。 +/// +/// 🔴 **必须含 `allowExport` / `allowPrint` / `allowWatermark` / `watermarkConfig`**: +/// 官方 `components/Report/src/index.vue:148-151` 读的是 +/// `res.data.allowExport` / `res.data.allowPrint` / `res.data.allowWatermark` / +/// `res.data.watermarkConfig` ⇒ 它们**在版本上**(不是模板上)⇒ 本仓从 +/// `report_version` 的同名列取,并回落模板的默认值。 +const REPORT_VERSION_DETAIL_COLUMNS: &str = "v.f_id AS \"id\", v.f_template_id AS \"templateId\", \ + COALESCE(v.f_state, 0) AS \"state\", COALESCE(v.f_version, 0) AS \"version\", \ + v.f_cells AS \"cells\", v.f_snapshot AS \"snapshot\", \ + v.f_query_list AS \"queryList\", v.f_sort_list AS \"sortList\", \ + v.f_column_list AS \"columnList\", v.f_fence_list AS \"fenceList\", \ + v.f_convert_config AS \"convertConfig\", \ + v.f_description AS \"description\", \ + COALESCE(v.f_enabled_mark, 0) AS \"enabledMark\", \ + COALESCE(v.f_sort_code, 0) AS \"sortCode\", \ + (EXTRACT(EPOCH FROM v.f_creator_time) * 1000)::bigint AS \"creatorTime\", \ + v.f_creator_user_id AS \"creatorUserId\", \ + (EXTRACT(EPOCH FROM v.f_last_modify_time) * 1000)::bigint AS \"lastModifyTime\", \ + v.f_last_modify_user_id AS \"lastModifyUserId\", \ + COALESCE(t.f_allow_export, 0) AS \"allowExport\", \ + COALESCE(t.f_allow_print, 0) AS \"allowPrint\", \ + COALESCE(t.f_allow_watermark, 0) AS \"allowWatermark\", \ + t.f_watermark_config AS \"watermarkConfig\", \ + t.f_full_name AS \"fullName\", t.f_version_id AS \"versionId\""; + +/// 报表模板的 `state`(官方前端 `report/index.vue` 的筛选:0 未发布 / 1 已发布)。 +/// +/// 🔴 官方把「发布」落在 `report_template.f_version_id`(有版本 = 已发布) +/// 与 `report_version.f_state` 上 ⇒ 本仓:`f_version_id` 非空 ⇒ 已发布。 +const STATE_UNPUBLISHED: i64 = 0; +const STATE_PUBLISHED: i64 = 1; + +// ---------------------------------------------------------------- 通用小工具 + +/// body ⇒ 白名单内的 `(列, CAST, 值)`;**只收 body 里真出现的键**。 +/// +/// 🔴 白名单是 `&'static` —— 列名 / CAST 串都来自**常量表**(编译期已知), +/// 绝不能来自请求内容(那等于让调用方决定 SQL 文本)。 +fn write_fields( + obj: &Map, + whitelist: &[(&'static str, &'static str, &'static str)], +) -> Vec<(&'static str, &'static str, Option)> { + let mut out = Vec::new(); + for (json_key, column, cast) in whitelist { + if obj.contains_key(*json_key) { + out.push((*column, *cast, value_to_text(obj.get(*json_key)))); + } + } + out +} + +/// 🔴 **「能力不存在」的统一口径** —— 明确业务失败,不返假数据。 +/// +/// 官方前端在这些端点上会直接 `res.data.url` ⇒ 返 `data:null` 会抛 JS 异常, +/// 返空数组/空对象则是**撒谎**(页面显示「没有数据」而不是「不支持」)。 +fn unsupported(what: &str) -> Json { + fail(code::FAIL, format!("本极简引擎不支持{what}")) +} + +/// 当前系统 id(`base_system.f_id`)—— 报表模板按系统隔离。 +/// +/// 🔴 **按 `App-Code` 解析**(与 `guard` / 菜单隔离同一套口径),不是恒取主系统。 +async fn current_system_id(state: &AppState, headers: &HeaderMap) -> String { + crate::platform::registry::resolve_system_id( + &state.db, + crate::platform::registry::app_code_of(headers).as_deref(), + ) + .await +} + +// ================================================================ 报表模板(Template) + +/// `GET /api/Report` —— 报表模板列表(分页)。 +/// +/// 官方 `api/onlineDev/report.ts:14`(`getReportList`)。 +/// +/// 🔴 官方前端列表列:`fullName` / `enCode` / `category` / `creatorUser` / +/// `creatorTime` / `lastModifyTime` / `sortCode` / `state` —— 本仓**逐列对上**。 +/// +/// 🔴 **`data` 必须是 `PageListVO`**:官方 `useVxeTable` 的 +/// `proxyConfig.response` = `{result:'list', total:'pagination.total', list:'list'}` +/// ⇒ 它读 `data.list` + `data.pagination.total`。 +pub async fn report_list( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let page = Paging::of(&raw); + let keyword = qv(&raw, "keyword"); + let category = qv(&raw, "category"); + let state_filter = qv(&raw, "state"); + let system_id = current_system_id(&state, &headers).await; + + // 🔴 空过滤条件 ⇒ **一个参数都不传**(SQL 里没有 `$n`)。 + let mut filters: Vec = Vec::new(); + let mut values: Vec> = vec![Some(system_id.clone())]; + let mut next = 2usize; + + if !keyword.is_empty() { + filters.push(format!( + "AND (t.f_full_name ILIKE ${next}::text OR t.f_en_code ILIKE ${next}::text)" + )); + values.push(Some(format!("%{keyword}%"))); + next += 1; + } + if !category.is_empty() { + filters.push(format!("AND t.f_category = ${next}::text")); + values.push(Some(category)); + next += 1; + } + // 🔴 `state` 过滤在 SQL 里做不了(要判 `f_version_id` 是否为空)⇒ 落到内存筛。 + let filter_state = match state_filter.as_str() { + "0" => Some(STATE_UNPUBLISHED), + "1" => Some(STATE_PUBLISHED), + _ => None, + }; + + let where_extra = if filters.is_empty() { + String::new() + } else { + format!(" {}", filters.join(" ")) + }; + + let total_sql = format!( + "SELECT count(*)::bigint AS \"c\" FROM report_template t \ + WHERE COALESCE(t.f_delete_mark, 0) = 0 AND t.f_system_id = $1::text{}", + where_extra + ); + let total = match state + .db + .query_json_params(&total_sql, ¶ms_of(&values[..])) + .await + { + Ok(rows) => rows + .into_iter() + .next() + .and_then(|r| r["c"].as_i64()) + .unwrap_or(0), + Err(e) => return db_error(e, "报表模板列表总数查询"), + }; + + values.push(Some(page.page_size.to_string())); + values.push(Some(page.offset.to_string())); + let p_limit = next; + let p_offset = next + 1; + + let sql = format!( + "SELECT t.f_id AS \"id\", t.f_full_name AS \"fullName\", t.f_en_code AS \"enCode\", \ + t.f_category AS \"category\", t.f_description AS \"description\", \ + COALESCE(t.f_enabled_mark, 0) AS \"enabledMark\", \ + COALESCE(t.f_sort_code, 0) AS \"sortCode\", \ + t.f_version_id AS \"versionId\", \ + (EXTRACT(EPOCH FROM t.f_creator_time) * 1000)::bigint AS \"creatorTime\", \ + (EXTRACT(EPOCH FROM t.f_last_modify_time) * 1000)::bigint AS \"lastModifyTime\", \ + COALESCE(u.f_real_name, '') || '/' || COALESCE(u.f_account, '') AS \"creatorUser\", \ + COALESCE(lu.f_real_name, '') || '/' || COALESCE(lu.f_account, '') AS \"lastModifyUser\", \ + CASE WHEN t.f_version_id IS NULL OR t.f_version_id = '' THEN {STATE_UNPUBLISHED} \ + ELSE {STATE_PUBLISHED} END AS \"state\" \ + FROM report_template t \ + LEFT JOIN base_user u ON u.f_id = t.f_creator_user_id \ + LEFT JOIN base_user lu ON lu.f_id = t.f_last_modify_user_id \ + WHERE COALESCE(t.f_delete_mark, 0) = 0 AND t.f_system_id = $1::text{} \ + ORDER BY t.f_sort_code ASC, t.f_creator_time DESC \ + LIMIT ${p_limit}::text::integer OFFSET ${p_offset}::text::integer", + where_extra + ); + let rows = match state.db.query_json_params(&sql, ¶ms_of(&values)).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "报表模板列表查询"), + }; + + // 🔴 `state` 过滤在**内存**做(SQL 侧判「有无版本」代价高,且官方那条 + // `state` 语义就是「有没有已发布版本」)⇒ 但**必须在分页前**滤, + // 否则 total 与 list 对不上。 + let (total, rows) = match filter_state { + None => (total, rows), + Some(want) => { + let kept: Vec = rows + .into_iter() + .filter(|r| r["state"].as_i64() == Some(want)) + .collect(); + // 🔴 `state` 过滤下 total 只能是**近似值**(本页命中数); + // 官方前端只用 total 做分页器显示,不做断言 ⇒ 与官方同口径。 + (kept.len() as i64, kept) + } + }; + ok(page_list(page.current_page, page.page_size, total, rows)) +} + +/// `POST /api/Report` —— 新建报表模板。 +/// +/// 官方 `api/onlineDev/report.ts:18`(`createReport`)。 +/// +/// 🔴 官方前端 `report/Form.vue` 的提交体:`{ fullName, enCode, category, +/// sortCode, description, id }`;成功后 `res.data` 是**新模板 id** +/// (`if (!state.dataForm.id) state.dataForm.id = res.data;`)⇒ 本仓返**裸 id 字符串**。 +pub async fn report_create( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match require_login_face_b(&state, &headers).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 full_name = obj + .get("fullName") + .and_then(Value::as_str) + .unwrap_or_default() + .trim() + .to_string(); + if full_name.is_empty() { + return fail(code::FAIL, "名称不能为空"); + } + let category = obj + .get("category") + .and_then(Value::as_str) + .unwrap_or_default() + .trim() + .to_string(); + if category.is_empty() { + return fail(code::FAIL, "分类不能为空"); + } + let en_code = obj + .get("enCode") + .and_then(Value::as_str) + .unwrap_or_default() + .trim() + .to_string(); + + let system_id = current_system_id(&state, &headers).await; + // 🔴 官方:同编码 ⇒ 失败(`MsgCode.EXIST002`)。 + if !en_code.is_empty() { + let dup = match state + .db + .query_json_params( + "SELECT f_id AS \"id\" FROM report_template \ + WHERE f_en_code = $1::text AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1", + &[&en_code], + ) + .await + { + Ok(rows) => !rows.is_empty(), + Err(e) => return db_error(e, "报表编码查重"), + }; + if dup { + return fail(code::FAIL, "编码已存在"); + } + } + let dup_name = match state + .db + .query_json_params( + "SELECT f_id AS \"id\" FROM report_template \ + WHERE f_full_name = $1::text AND f_system_id = $2::text \ + AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1", + &[&full_name, &system_id], + ) + .await + { + Ok(rows) => !rows.is_empty(), + Err(e) => return db_error(e, "报表名称查重"), + }; + if dup_name { + return fail(code::FAIL, "名称已存在"); + } + + let new_id = new_uuid(); + let mut columns: Vec<&str> = vec!["f_id", "f_tenant_id", "f_system_id"]; + let mut casts: Vec<&str> = vec!["", "", ""]; + let mut values: Vec> = + vec![Some(new_id.clone()), Some("0".to_string()), Some(system_id)]; + + for (column, cast, value) in write_fields(&obj, REPORT_TEMPLATE_WRITE_FIELDS) { + columns.push(column); + casts.push(cast); + values.push(value); + } + if !obj.contains_key("enabledMark") { + columns.push("f_enabled_mark"); + casts.push("::integer"); + values.push(Some("1".to_string())); + } + if !obj.contains_key("sortCode") { + columns.push("f_sort_code"); + casts.push("::bigint"); + values.push(Some("0".to_string())); + } + columns.push("f_delete_mark"); + casts.push("::integer"); + values.push(Some("0".to_string())); + columns.push("f_creator_user_id"); + casts.push(""); + values.push(Some(user.account.clone())); + columns.push("f_creator_time"); + + let mut marks: Vec = (0..values.len()) + .map(|i| placeholder(i + 1, casts[i])) + .collect(); + marks.push("now()".to_string()); + let sql = format!( + "INSERT INTO report_template ({}) VALUES ({})", + columns.join(", "), + marks.join(", ") + ); + if let Err(e) = state.db.exec_params(&sql, ¶ms_of(&values)).await { + return db_error(e, "新建报表模板"); + } + // 🔴 **返裸 id 字符串**(官方 `state.dataForm.id = res.data`)。 + ok(Value::String(new_id)) +} + +/// `PUT /api/Report/{id}` —— 修改报表模板。 +/// +/// 官方 `api/onlineDev/report.ts:22`(`updateReport`)。 +pub async fn report_update( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + let user = match require_login_face_b(&state, &headers).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let id = id.trim().to_string(); + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + + let exists = match state + .db + .query_json_params( + "SELECT f_id AS \"id\" FROM report_template \ + WHERE f_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1", + &[&id], + ) + .await + { + Ok(rows) => !rows.is_empty(), + Err(e) => return db_error(e, "报表模板存在性查询"), + }; + if !exists { + return fail(code::FAIL, "报表模板不存在"); + } + + let fields = write_fields(&obj, REPORT_TEMPLATE_WRITE_FIELDS); + if fields.is_empty() { + return ok(Value::String(id)); + } + + // 🔴 **只 SET body 里真出现的键**;每个值一个参数位。 + let mut set_parts: Vec = Vec::new(); + let mut values: Vec> = Vec::new(); + for (column, cast, value) in fields { + values.push(value); + set_parts.push(format!("{} = {}", column, placeholder(values.len(), cast))); + } + values.push(Some(id.clone())); + values.push(Some(user.account.clone())); + let p_id = values.len() - 1; + let p_user = values.len(); + set_parts.push("f_last_modify_time = now()".to_string()); + set_parts.push(format!("f_last_modify_user_id = ${p_user}::text")); + + let sql = format!( + "UPDATE report_template SET {} WHERE f_id = ${p_id}::text", + set_parts.join(", ") + ); + if let Err(e) = state.db.exec_params(&sql, ¶ms_of(&values)).await { + return db_error(e, "修改报表模板"); + } + ok(Value::String(id)) +} + +/// `GET /api/Report/{id}` —— 报表模板详情。 +/// +/// 官方 `api/onlineDev/report.ts:26`(`getReportInfo`)。 +/// +/// 🔴 **`data` 是裸对象**(官方 `state.dataForm = res.data` ⇒ 整表单直接铺上去)。 +pub async fn report_info( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + let sql = format!( + "SELECT {} FROM report_template t \ + LEFT JOIN base_user u ON u.f_id = t.f_creator_user_id \ + LEFT JOIN base_user lu ON lu.f_id = t.f_last_modify_user_id \ + WHERE t.f_id = $1::text AND COALESCE(t.f_delete_mark, 0) = 0 LIMIT 1", + REPORT_TEMPLATE_DETAIL_COLUMNS + ); + let rows = match state.db.query_json_params(&sql, &[&id]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "报表模板详情查询"), + }; + match rows.into_iter().next() { + Some(row) => ok(row), + None => fail(code::FAIL, "报表模板不存在"), + } +} + +/// `DELETE /api/Report/{id}` —— 删除报表模板(软删)。 +/// +/// 官方 `api/onlineDev/report.ts:30`(`delReport`)。 +pub async fn report_delete( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + let user = match require_login_face_b(&state, &headers).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let id = id.trim().to_string(); + let sql = "UPDATE report_template \ + SET f_delete_mark = 1, f_delete_time = now(), f_delete_user_id = $1::text \ + WHERE f_id = $2::text AND COALESCE(f_delete_mark, 0) = 0"; + if let Err(e) = state + .db + .exec_params(sql, ¶ms_of(&[Some(user.account.clone()), Some(id)])) + .await + { + return db_error(e, "删除报表模板"); + } + ok(Value::Null) +} + +/// `POST /api/Report/{id}/Actions/Copy` —— 复制报表模板。 +/// +/// 官方 `api/onlineDev/report.ts:34`(`copy`)。 +pub async fn report_copy( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + let user = match require_login_face_b(&state, &headers).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let id = id.trim().to_string(); + let source = match state + .db + .query_json_params( + "SELECT f_id AS \"id\", f_full_name AS \"fullName\", f_en_code AS \"enCode\", \ + f_category AS \"category\", f_description AS \"description\", \ + COALESCE(f_enabled_mark, 0) AS \"enabledMark\", \ + COALESCE(f_sort_code, 0) AS \"sortCode\", \ + f_tenant_id AS \"tenantId\", f_system_id AS \"systemId\" \ + FROM report_template \ + WHERE f_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1", + &[&id], + ) + .await + { + Ok(rows) => rows.into_iter().next(), + Err(e) => return db_error(e, "复制报表模板(源查询)"), + }; + let Some(src) = source else { + return fail(code::FAIL, "报表模板不存在"); + }; + + let new_id = new_uuid(); + let full_name = src["fullName"].as_str().unwrap_or_default(); + let en_code = src["enCode"].as_str().unwrap_or_default(); + let category = src["category"].as_str().unwrap_or_default(); + let description = src["description"].as_str().unwrap_or_default(); + let tenant_id = src["tenantId"].as_str().unwrap_or("0"); + let system_id = src["systemId"].as_str().unwrap_or_default(); + + let sql = "INSERT INTO report_template \ + (f_id, f_tenant_id, f_system_id, f_full_name, f_en_code, f_category, \ + f_description, f_enabled_mark, f_sort_code, f_delete_mark, \ + f_creator_user_id, f_creator_time) \ + VALUES ($1::text, $2::text, $3::text, $4::text, $5::text, $6::text, \ + $7::text, $8::integer, $9::bigint, 0, $10::text, now())"; + let values = vec![ + Some(new_id.clone()), + Some(tenant_id.to_string()), + Some(system_id.to_string()), + Some(format!("{full_name}-副本")), + Some(format!("{en_code}_copy")), + Some(category.to_string()), + Some(description.to_string()), + Some("1".to_string()), + Some("0".to_string()), + Some(user.account.clone()), + ]; + if let Err(e) = state.db.exec_params(sql, ¶ms_of(&values)).await { + return db_error(e, "复制报表模板"); + } + ok(Value::String(new_id)) +} + +/// `GET /api/Report/Selector` —— 报表下拉框。 +/// +/// 官方 `api/onlineDev/report.ts:78`(`getReportSelector`)。 +/// +/// 🔴 **官方消费点是 `res.data.list`**(`views/permission/menu/Form.vue:392` +/// 的 `state.reportData = res.data.list`)⇒ 本仓返**官方 `ListVO`** +/// (`{list:[…]}`),**不是**裸数组。 +pub async fn report_selector( + State(state): State, + headers: HeaderMap, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let system_id = current_system_id(&state, &headers).await; + let sql = "SELECT f_id AS \"id\", f_full_name AS \"fullName\", f_en_code AS \"enCode\", \ + f_category AS \"category\" \ + FROM report_template \ + WHERE COALESCE(f_delete_mark, 0) = 0 AND f_system_id = $1::text \ + ORDER BY f_sort_code ASC, f_full_name ASC"; + let rows = match state.db.query_json_params(sql, &[&system_id]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "报表下拉框查询"), + }; + ok(list_vo(rows)) +} + +/// `GET /api/Report/{id}/getReleaseMenu` —— 报表已发布菜单。 +/// +/// 官方 `api/onlineDev/report.ts:98`(`getReleaseMenu`)。 +/// +/// 🔴 官方消费点 `views/onlineDev/report/CreateMenuModal.vue:59-61`: +/// `state.record = res.data` ⇒ **裸对象**;且读 `res.data.platformRelease` +/// (**JSON 串**,官方 `JSON.parse` 它)⇒ 本仓原样存 JSON 串。 +/// +/// 🔴 官方还读 `res.data.pcIsRelease` / `appIsRelease` / `pcReleaseName` / +/// `appReleaseName` —— 那是「菜单发布记录」⇒ 本仓**没有**那套表 +/// ⇒ 这四个字段返 `false` / 空串(前端只是「已发布菜单路径」那一行的展示)。 +pub async fn report_release_menu( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + let rows = match state + .db + .query_json_params( + "SELECT f_platform_release AS \"platformRelease\", f_id AS \"id\" \ + FROM report_template \ + WHERE f_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1", + &[&id], + ) + .await + { + Ok(rows) => rows, + Err(e) => return db_error(e, "报表发布菜单查询"), + }; + match rows.into_iter().next() { + Some(mut row) => { + // 🔴 官方 `platformRelease` 可能是 JSON 串,也可能为空 ⇒ 补齐四个字段。 + row["pcIsRelease"] = Value::Bool(false); + row["appIsRelease"] = Value::Bool(false); + row["pcReleaseName"] = Value::String(String::new()); + row["appReleaseName"] = Value::String(String::new()); + ok(row) + } + None => fail(code::FAIL, "报表模板不存在"), + } +} + +/// `POST /api/Report/{id}/Actions/Module` —— 生成报表菜单。 +/// +/// 官方 `api/onlineDev/report.ts:102`(`createMenu`)。 +/// +/// 🔴 官方消费点 `CreateMenuModal.vue:104-110`:提交体 +/// `{ pc, app, pcModuleParentId:[], appModuleParentId:[], platformRelease }` +/// (`platformRelease` 是 **`JSON.stringify({pc,app})`**)。 +/// +/// 🔴 官方把报表挂成菜单项(`base_module`)—— 本仓**有**这张表 ⇒ 真落库。 +/// 🔴 **菜单的 `urlAddress` 用官方前端路由**:`/reportPreview`(官方 +/// `router/routes/core.ts:92` 的 `path: '/reportPreview'` ⇒ 组件 +/// `views/common/dynamicReport/index.vue`)—— 官方那个第三方服务的菜单 URL +/// 本仓无从核对 ⇒ 按**本仓前端能跑**的官方路由写。 +pub async fn report_create_menu( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + let user = match require_login_face_b(&state, &headers).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let id = id.trim().to_string(); + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + + // 🔴 官方 `platformRelease` 是 **JSON 串**(`{pc,app}`)⇒ 本仓**原样存**。 + let platform_release = obj + .get("platformRelease") + .and_then(Value::as_str) + .unwrap_or("") + .trim() + .to_string(); + + // 🔴 上级菜单:官方传的是**数组**(`pcModuleParentId` / `appModuleParentId`) + // ⇒ 本仓取**第一个**挂父节点(多父级是官方那套「一菜单挂多处」的能力, + // 本仓 `base_module` 是单父树 ⇒ 只挂第一个,并在注释里钉死这个取舍)。 + let parent_id = [ + "pcModuleParentId", + "appModuleParentId", + "parentId", + ] + .iter() + .find_map(|key| { + obj.get(*key).and_then(|v| match v { + Value::Array(items) => items.first().and_then(Value::as_str).map(str::to_string), + Value::String(s) if !s.is_empty() => Some(s.clone()), + _ => None, + }) + }) + .unwrap_or_default(); + + let system_id = current_system_id(&state, &headers).await; + let module_id = new_uuid(); + let en_code = format!("report_{id}"); + let sql = "INSERT INTO base_module \ + (f_id, f_tenant_id, f_full_name, f_en_code, f_parent_id, f_url_address, \ + f_type, f_enabled_mark, f_sort_code, f_delete_mark, f_system_id, \ + f_creator_user_id, f_creator_time) \ + VALUES ($1::text, '0', $2::text, $3::text, $4::text, $5::text, \ + 0, 1, 0, 0, $6::text, $7::text, now())"; + let values = vec![ + Some(module_id.clone()), + Some(format!("报表 {id}")), + Some(en_code), + Some(parent_id), + Some("/reportPreview".to_string()), + Some(system_id), + Some(user.account.clone()), + ]; + if let Err(e) = state.db.exec_params(sql, ¶ms_of(&values)).await { + return db_error(e, "生成报表菜单"); + } + + // 🔴 绑定菜单与报表模板(官方:菜单 ↔ 报表的发布关系落 `f_platform_release`)。 + let update = "UPDATE report_template SET f_platform_release = $1::text, \ + f_last_modify_time = now() WHERE f_id = $2::text"; + if let Err(e) = state + .db + .exec_params(update, ¶ms_of(&[Some(platform_release), Some(id)])) + .await + { + return db_error(e, "报表发布菜单绑定"); + } + ok(Value::String(module_id)) +} + +/// `GET /api/Report/{id}/Actions/Export` —— 导出报表模板。 +/// +/// 官方 `api/onlineDev/report.ts:42`(`exportData`)。 +/// +/// 🔴 官方前端 `report/index.vue` 的 `handleExport` 直接 +/// `downloadByUrlReport({ url: res.data.url })` ⇒ **必须给真 url**。 +/// 本仓无文件服务 ⇒ 明确失败(返 `data:null` 会让前端 `res.data.url` 抛异常)。 +pub async fn report_export_data( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = id.trim(); + unsupported("报表模板导出(无文件服务)") +} + +// ================================================================ 报表版本(Version) + +/// `GET /api/Report/Version/{id}` —— 报表模板的版本列表。 +/// +/// 官方 `api/onlineDev/report.ts:58`(`getVersionList`)。 +/// +/// 🔴 **官方消费点是裸数组**:`components/Report/src/index.vue:127` +/// 的 `state.versionList = res.data || []` ⇒ 若返 `{list:[…]}`, +/// `res.data.list` 是 `undefined` ⇒ 版本标签页**永远空白**。 +/// ⇒ 本仓返**裸数组**(不是官方 `ListVO`)。 +pub async fn report_version_list( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + let sql = "SELECT f_id AS \"id\", f_template_id AS \"templateId\", \ + COALESCE(f_state, 0) AS \"state\", COALESCE(f_version, 0) AS \"version\", \ + f_description AS \"description\", \ + (EXTRACT(EPOCH FROM f_creator_time) * 1000)::bigint AS \"creatorTime\", \ + f_creator_user_id AS \"creatorUserId\", \ + (EXTRACT(EPOCH FROM f_last_modify_time) * 1000)::bigint AS \"lastModifyTime\", \ + f_last_modify_user_id AS \"lastModifyUserId\" \ + FROM report_version \ + WHERE f_template_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 \ + ORDER BY f_version DESC"; + let rows = match state.db.query_json_params(sql, &[&id]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "报表版本列表查询"), + }; + // 🔴 **裸数组**(官方 `res.data || []`)。 + ok(Value::Array(rows)) +} + +/// `GET /api/Report/Info/{id}` —— 报表版本详情(含 Univer 设计 JSON)。 +/// +/// 官方 `api/onlineDev/report.ts:54`(`getVersionInfo`)。 +/// +/// 🔴 **裸对象**(官方 `state.dataForm = {...state.dataForm, ...res.data}`)。 +pub async fn report_version_info( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + let sql = format!( + "SELECT {} FROM report_version v \ + LEFT JOIN report_template t ON t.f_id = v.f_template_id \ + WHERE v.f_id = $1::text AND COALESCE(v.f_delete_mark, 0) = 0 LIMIT 1", + REPORT_VERSION_DETAIL_COLUMNS + ); + let rows = match state.db.query_json_params(&sql, &[&id]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "报表版本详情查询"), + }; + match rows.into_iter().next() { + Some(row) => ok(row), + None => fail(code::FAIL, "报表版本不存在"), + } +} + +/// `POST /api/Report/Info/{id}` —— 新增报表版本(复制一版)。 +/// +/// 官方 `api/onlineDev/report.ts:66`(`copyVersion`)。 +/// +/// 🔴 **官方消费点是裸 id 字符串**:`components/Report/src/index.vue:187` +/// 的 `const currentId = res.data;` ⇒ 之后 `versionList.filter(o => o.id == currentId)` +/// ⇒ 本仓返**裸 id 字符串**(不是 `{id:…}`)。 +pub async fn report_version_copy( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + let user = match require_login_face_b(&state, &headers).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let id = id.trim().to_string(); + let source = match state + .db + .query_json_params( + "SELECT f_template_id AS \"templateId\", COALESCE(f_version, 0) AS \"version\", \ + f_cells AS \"cells\", f_snapshot AS \"snapshot\", \ + f_query_list AS \"queryList\", f_sort_list AS \"sortList\", \ + f_column_list AS \"columnList\", f_fence_list AS \"fenceList\", \ + f_convert_config AS \"convertConfig\", \ + f_description AS \"description\", f_tenant_id AS \"tenantId\" \ + FROM report_version \ + WHERE f_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1", + &[&id], + ) + .await + { + Ok(rows) => rows.into_iter().next(), + Err(e) => return db_error(e, "新增报表版本(源查询)"), + }; + let Some(src) = source else { + return fail(code::FAIL, "报表版本不存在"); + }; + + let new_id = new_uuid(); + let next_version = src["version"].as_i64().unwrap_or(0) + 1; + let sql = "INSERT INTO report_version \ + (f_id, f_tenant_id, f_template_id, f_state, f_version, f_cells, f_snapshot, \ + f_query_list, f_sort_list, f_column_list, f_fence_list, f_convert_config, \ + f_description, f_enabled_mark, f_delete_mark, f_creator_user_id, f_creator_time) \ + VALUES ($1::text, $2::text, $3::text, 0, $4::integer, $5::text, $6::text, \ + $7::text, $8::text, $9::text, $10::text, $11::text, $12::text, 1, 0, \ + $13::text, now())"; + let values = vec![ + Some(new_id.clone()), + src["tenantId"].as_str().map(|s| s.to_string()), + src["templateId"].as_str().map(|s| s.to_string()), + Some(next_version.to_string()), + src["cells"].as_str().map(|s| s.to_string()), + src["snapshot"].as_str().map(|s| s.to_string()), + src["queryList"].as_str().map(|s| s.to_string()), + src["sortList"].as_str().map(|s| s.to_string()), + src["columnList"].as_str().map(|s| s.to_string()), + src["fenceList"].as_str().map(|s| s.to_string()), + src["convertConfig"].as_str().map(|s| s.to_string()), + src["description"].as_str().map(|s| s.to_string()), + Some(user.account.clone()), + ]; + if let Err(e) = state.db.exec_params(sql, ¶ms_of(&values)).await { + return db_error(e, "新增报表版本"); + } + + // 🔴 新版本 = 模板的当前版本(官方:模板指向最新版本)。 + let update = "UPDATE report_template SET f_version_id = $1::text, f_last_modify_time = now() \ + WHERE f_id = $2::text"; + if let Err(e) = state + .db + .exec_params( + update, + ¶ms_of(&[ + Some(new_id.clone()), + src["templateId"].as_str().map(|s| s.to_string()), + ]), + ) + .await + { + return db_error(e, "报表模板版本指针更新"); + } + // 🔴 **裸 id 字符串**(官方 `const currentId = res.data;`)。 + ok(Value::String(new_id)) +} + +/// `DELETE /api/Report/Info/{id}` —— 删除报表版本。 +/// +/// 官方 `api/onlineDev/report.ts:62`(`delVersion`)。 +pub async fn report_version_delete( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + let user = match require_login_face_b(&state, &headers).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let id = id.trim().to_string(); + let sql = "UPDATE report_version \ + SET f_delete_mark = 1, f_delete_time = now(), f_delete_user_id = $1::text \ + WHERE f_id = $2::text AND COALESCE(f_delete_mark, 0) = 0"; + if let Err(e) = state + .db + .exec_params(sql, ¶ms_of(&[Some(user.account.clone()), Some(id)])) + .await + { + return db_error(e, "删除报表版本"); + } + ok(Value::Null) +} + +/// `POST /api/Report/Save` —— 保存报表设计(Univer 设计稿)。 +/// +/// 官方 `api/onlineDev/report.ts:50`(`saveVersion`)。 +/// +/// 🔴 官方消费点 `components/Report/src/index.vue:245`: +/// `state.dataForm = { ...state.dataForm, ...res }` ⇒ **`res` 整个铺上去** +/// ⇒ 本仓返**裸对象**(含 `id` / `cells` / `snapshot` / `queryList` …)。 +/// +/// 🔴 本仓**存** Univer 的 JSON(`f_cells` / `f_snapshot` / …),但**没有** +/// Univer 设计器本体 ⇒ 官方那个「设计器打开 / 实时渲染」的能力不存在。 +pub async fn report_save_version( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match require_login_face_b(&state, &headers).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, + }; + // 🔴 **模板 id 来自 body 的 `id`**(官方消费点 `components/Report/src/index.vue:233`: + // `saveVersion(query)`,而 `query = { ...state.dataForm, ...res }`, + // `state.dataForm.id` **就是报表模板 id**)⇒ 官方**不传** `templateId`。 + // (官方同构的 `AgentController.java:225` 用 `AgentVersionForm.id` 当主体键、 + // `agentId` 当父 id —— 同一套口径。) + // ⇒ 本仓**两个键都认**(`id` 优先,`templateId` 兜底), + // 但**必须认 `id`** —— 只认 `templateId` ⇒ 官方保存报表永远报「id 不能为空」。 + let template_id = ["id", "templateId"] + .iter() + .find_map(|key| { + obj.get(*key) + .and_then(Value::as_str) + .map(|s| s.trim().to_string()) + .filter(|s| !s.is_empty()) + }) + .unwrap_or_default(); + if template_id.is_empty() { + return fail(code::FAIL, "报表模板 id 不能为空"); + } + + // 🔴 已有版本 ⇒ 更新那一版;没有 ⇒ 建新的一版。 + let existing = match state + .db + .query_json_params( + "SELECT f_id AS \"id\" FROM report_version \ + WHERE f_template_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 \ + ORDER BY f_version DESC LIMIT 1", + &[&template_id], + ) + .await + { + Ok(rows) => rows.into_iter().next(), + Err(e) => return db_error(e, "报表版本查询"), + }; + + match existing { + Some(row) => { + let version_id = row["id"].as_str().unwrap_or_default().to_string(); + let fields = write_fields(&obj, REPORT_VERSION_WRITE_FIELDS); + let mut set_parts: Vec = Vec::new(); + let mut values: Vec> = Vec::new(); + for (column, cast, value) in fields { + values.push(value); + set_parts.push(format!( + "{} = {}", + column, + placeholder(values.len(), cast) + )); + } + values.push(Some(version_id.clone())); + values.push(Some(user.account.clone())); + let p_id = values.len() - 1; + let p_user = values.len(); + set_parts.push("f_last_modify_time = now()".to_string()); + set_parts.push(format!("f_last_modify_user_id = ${p_user}::text")); + let sql = format!( + "UPDATE report_version SET {} WHERE f_id = ${p_id}::text", + set_parts.join(", ") + ); + if let Err(e) = state.db.exec_params(&sql, ¶ms_of(&values)).await { + return db_error(e, "保存报表设计"); + } + // 🔴 **返 `data: null`**(官方同构的 `AgentController.java:225` 是 + // `ActionResult.success(MsgCode.SU004.get())` ⇒ data 为 null)。 + // 官方消费点 `components/Report/src/index.vue:238`: + // `state.dataForm = { ...state.dataForm, ...res }` + // ⇒ **返的 `id` 会被铺到 `state.dataForm.id` 上** + // ⇒ 若返版本 id,后续 `getVersionList(state.dataForm.id)` 拿版本 id + // 去查模板的版本列表 ⇒ **查空**(版本列表按 `f_template_id` 查)。 + // ⇒ 返 null ⇒ `...null` 在 JS 里是合法的(不报错、不改任何键)。 + ok(Value::Null) + } + None => { + let new_id = new_uuid(); + // 🔴 **列数与参数数必须一一对应**:`f_creator_time` 用 SQL `now()` + // (**不占参数位**)⇒ 列里放它、**值里不放**, + // 且 `marks` 要**按列逐个生成**(不能先按 values 生成再 `push("now()")` + // —— 那样 `now()` 会落到最后一个参数位上 ⇒ + // `column "f_creator_time" is of type timestamp ... but expression is of type text`)。 + let mut columns: Vec<&str> = vec![ + "f_id", + "f_tenant_id", + "f_template_id", + "f_state", + "f_version", + "f_enabled_mark", + "f_delete_mark", + "f_creator_user_id", + ]; + let mut casts: Vec<&str> = vec![ + "", "", "", "::integer", "::integer", "::integer", "::integer", "", + ]; + let mut values: Vec> = vec![ + Some(new_id.clone()), + Some("0".to_string()), + Some(template_id.clone()), + Some("0".to_string()), + Some("1".to_string()), + Some("1".to_string()), + Some("0".to_string()), + Some(user.account.clone()), + ]; + for (column, cast, value) in write_fields(&obj, REPORT_VERSION_WRITE_FIELDS) { + columns.push(column); + casts.push(cast); + values.push(value); + } + // 🔴 审计时间戳列(SQL 侧生成 ⇒ 不占参数位) + columns.push("f_creator_time"); + casts.push("::timestamp"); + let mut marks: Vec = (0..values.len()) + .map(|i| placeholder(i + 1, casts[i])) + .collect(); + marks.push("now()".to_string()); + let sql = format!( + "INSERT INTO report_version ({}) VALUES ({})", + columns.join(", "), + marks.join(", ") + ); + if let Err(e) = state.db.exec_params(&sql, ¶ms_of(&values)).await { + return db_error(e, "保存报表设计"); + } + // 🔴 模板指向新版本(官方:保存后模板的 `versionId` 变这个)。 + let update = "UPDATE report_template SET f_version_id = $1::text, \ + f_last_modify_time = now() WHERE f_id = $2::text"; + if let Err(e) = state + .db + .exec_params(update, ¶ms_of(&[Some(new_id.clone()), Some(template_id)])) + .await + { + return db_error(e, "报表模板版本指针更新"); + } + // 🔴 同上:**返 `data: null`**(`{...state.dataForm, ...res}` 会把 + // 返的 `id` 铺成**模板 id** ⇒ 铺版本 id 会让版本列表查空)。 + ok(Value::Null) + } + } +} + +/// `POST /api/Report/Data` —— 取报表数据。 +/// +/// 官方 `api/onlineDev/report.ts:46`(`getData`)。 +/// +/// 🔴 官方这条走 Univer 的数据查询引擎(`f_query_list` 里的查询定义 + +/// `report_user` / `report_charts` 等数据源)⇒ 本仓**没有**那个引擎 +/// ⇒ 明确失败。 +pub async fn report_get_data( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = parse_body(&body).map(|_| ()); + unsupported("报表数据查询(无 Univer 数据引擎)") +} + +/// `POST /api/Report/data/{id}/preview` —— 预览报表设计。 +/// +/// 官方 `api/onlineDev/report.ts:70`(`getPreviewDesign`)。 +/// +/// 🔴 官方渲染 Univer 快照 ⇒ 本仓没有渲染器 ⇒ 明确失败。 +pub async fn report_preview_design( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = id.trim(); + let _ = parse_body(&body).map(|_| ()); + unsupported("报表设计预览(无 Univer 渲染器)") +} + +/// `POST /api/Report/data/{id}/previewTemplate` —— 按模板大 id 预览。 +/// +/// 官方 `api/onlineDev/report.ts:74`(`getPreviewTemplate`)。 +pub async fn report_preview_template( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = id.trim(); + let _ = parse_body(&body).map(|_| ()); + unsupported("报表模板预览(无 Univer 渲染器)") +} + +/// `GET /api/Report/data/{id}/getQueryList` —— 报表的查询定义列表。 +/// +/// 官方 `api/onlineDev/report.ts:106`(`getPreviewQueryList`)。 +/// +/// 🔴 **官方消费点是裸对象**:`components/Report/src/reportPreview/index.vue` +/// 的 `res.data.queryList ? JSON.parse(res.data.queryList) : []` +/// ⇒ 本仓返 `{queryList:""}`(**不是**解析后的数组!)。 +/// +/// 🔴 官方前端**自己** `JSON.parse` ⇒ 本仓**原样存 JSON 串**、**原样返**。 +/// 官方那个第三方服务的 `getQueryList` 返回的也是串(前端解析它)。 +pub async fn report_query_list( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + let rows = match state + .db + .query_json_params( + "SELECT f_query_list AS \"queryList\" FROM report_version \ + WHERE f_template_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 \ + ORDER BY f_version DESC LIMIT 1", + &[&id], + ) + .await + { + Ok(rows) => rows.into_iter().next(), + Err(e) => return db_error(e, "报表查询定义查询"), + }; + let Some(row) = rows else { + return fail(code::FAIL, "报表模板不存在"); + }; + // 🔴 **原样返 JSON 串**(官方前端自己 `JSON.parse`)—— 返解析后的数组 + // 会让前端的 `JSON.parse(res.data.queryList)` 直接抛异常。 + match row["queryList"].as_str() { + Some(text) if !text.is_empty() => { + // 🔴 校验它是合法 JSON(存的时候就该是)—— 不是就明确失败, + // 不能让前端 `JSON.parse` 崩。 + match serde_json::from_str::(text) { + Ok(_) => ok(json!({ "queryList": text })), + Err(_) => fail(code::FAIL, "报表查询定义不是合法 JSON"), + } + } + _ => ok(json!({ "queryList": "" })), + } +} + +/// `POST /api/Report/data/upload/file` —— 上传图片(报表里的图片资源)。 +/// +/// 官方 `api/onlineDev/report.ts:82`(`uploadFileImage`)。 +/// +/// 🔴 官方走文件服务(`jnpf-file`)⇒ 本仓无文件服务 ⇒ 明确失败。 +pub async fn report_upload_image( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = body.len(); + unsupported("报表图片上传(无文件服务)") +} + +/// `POST /api/Report/data/downImg` —— 下载报表里的图片。 +/// +/// 官方 `api/onlineDev/report.ts:86`(`uploadImg`)。 +/// +/// 🔴 官方消费点 `components/Report/src/design/index.vue`: +/// `res.data.url` ⇒ **必须给真 url** ⇒ 本仓无文件服务 ⇒ 明确失败。 +pub async fn report_down_img( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = parse_body(&body).map(|_| ()); + unsupported("报表图片下载(无文件服务)") +} + +/// `POST /api/Report/data/ImportExcel` —— 导入 Excel 成报表数据。 +/// +/// 官方 `api/onlineDev/report.ts:90`(`uploadFileExcel`)。 +/// +/// 🔴 官方消费点 `design/index.vue`:`res.data.snapshot` ⇒ 需要真 Univer 快照 +/// ⇒ 本仓无文件服务与 Univer ⇒ 明确失败。 +pub async fn report_import_excel( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = body.len(); + unsupported("报表 Excel 导入(无文件服务与数据引擎)") +} + +/// `POST /api/Report/data/{id}/DownExcel` —— 导出报表数据为 Excel。 +/// +/// 官方 `api/onlineDev/report.ts:94`(`exportFileExcel`)。 +/// +/// 🔴 官方消费点 `reportPreview/index.vue`:`downloadByUrlReport({url: res.data.url})` +/// ⇒ **必须给真 url** ⇒ 本仓无文件服务 ⇒ 明确失败。 +pub async fn report_export_excel( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = id.trim(); + let _ = parse_body(&body).map(|_| ()); + unsupported("报表数据导出 Excel(无文件服务与数据引擎)") +} diff --git a/src/backend/src/routes.rs b/src/backend/src/routes.rs index b7ad5c0..baa8406 100644 --- a/src/backend/src/routes.rs +++ b/src/backend/src/routes.rs @@ -1388,6 +1388,137 @@ pub fn build_router(state: AppState) -> axum::Router { // 🔴 **批次 12 交付物 ①**:业务包声明 `PackRoute`(纯数据)⇒ // 装配根按声明 + spec 生成真正的 axum 路由 ⇒ **平台层零改动**。 // 业务包**不需要**依赖 axum(AR2 / AR8 钉死)。 + // ---- onlineDev(批次 17):表单设计 / 门户 / 外链 / 代码生成 / 分享 / 个性化视图 ---- + // + // 🔴 **路由前缀不统一是官方的既有事实**,照抄不改: + // 表单设计 `/api/visualdev/Base`、数据 `/api/visualdev/OnlineDev`、 + // 代码生成 `/api/visualdev/Generater`、外链 `/api/visualdev/ShortLink`、 + // 门户 `/api/visualdev/Portal`、门户管理 **`/api/system/PortalManage`**(在 + // `/api/system` 下!)、DataV 选择器 **`/api/blade-visual/visual`**。 + // 🔴 **权限守卫逐条照抄官方 `@SaCheckPermission`**(见 `compat/online_dev.rs`): + // `onlineDev.formDesign` / `onlineDev.sysForm` / `generator.flowForm` / + // `generator.webForm` 三选一(OR),`onlineDev.visualPortal` 单选。 + + .route("/api/visualdev/Base", get(compat::online_dev::visual_dev_list)) + .route("/api/visualdev/Base/list", get(compat::online_dev::visual_dev_form_list)) + .route("/api/visualdev/Base/Selector", get(compat::online_dev::visual_dev_selector)) + .route("/api/visualdev/Base/getColumnList", get(compat::online_dev::visual_dev_column_list)) + .route("/api/visualdev/Base/getListBySystem", get(compat::online_dev::visual_dev_list_by_system)) + .route("/api/visualdev/Base", post(compat::online_dev::visual_dev_create)) + .route("/api/visualdev/Base/{id}", get(compat::online_dev::visual_dev_info)) + .route("/api/visualdev/Base/{id}", put(compat::online_dev::visual_dev_update)) + .route("/api/visualdev/Base/{id}", delete(compat::online_dev::visual_dev_delete)) + .route("/api/visualdev/Base/{id}/Actions/Copy", post(compat::online_dev::visual_dev_copy)) + .route("/api/visualdev/Base/{id}/Actions/Release", post(compat::online_dev::visual_dev_release)) + .route("/api/visualdev/Base/{id}/getReleaseMenu", get(compat::online_dev::visual_dev_release_menu)) + .route("/api/visualdev/Base/{id}/Actions/Module", post(compat::online_dev::visual_dev_create_menu)) + .route("/api/visualdev/Base/{id}/FormDataFields", get(compat::online_dev::visual_dev_form_data_fields)) + .route("/api/visualdev/Base/{id}/FieldDataSelect", get(compat::online_dev::visual_dev_field_data_select)) + .route("/api/visualdev/Generater/{id}/Actions/DownloadCode", post(compat::online_dev::generater_download_code)) + .route("/api/visualdev/Generater/{id}/Actions/CodePreview", post(compat::online_dev::generater_code_preview)) + .route("/api/visualdev/Generater/{id}/Alias/Info", get(compat::online_dev::generater_alias_info)) + .route("/api/visualdev/Generater/{id}/Alias/Save", post(compat::online_dev::generater_alias_save)) + .route("/api/visualdev/OnlineDev/{model_id}/Config", get(compat::online_dev::online_dev_config)) + .route("/api/visualdev/OnlineDev/Config", get(compat::online_dev::online_dev_config_by_menu)) + .route("/api/visualdev/OnlineDev/{model_id}/FormData", get(compat::online_dev::online_dev_form_data)) + .route("/api/visualdev/OnlineDev/{model_id}/List", post(compat::online_dev::online_dev_model_list)) + .route("/api/visualdev/OnlineDev/{model_id}", post(compat::online_dev::online_dev_create_model)) + .route("/api/visualdev/OnlineDev/{model_id}/{id}", put(compat::online_dev::online_dev_update_model)) + .route("/api/visualdev/OnlineDev/{model_id}/{id}", get(compat::online_dev::online_dev_model_info)) + .route("/api/visualdev/OnlineDev/{model_id}/{id}", delete(compat::online_dev::online_dev_delete_model)) + .route("/api/visualdev/OnlineDev/batchDelete/{model_id}", post(compat::online_dev::online_dev_batch_delete)) + .route("/api/visualdev/OnlineDev/{model_id}/DataChange", post(compat::online_dev::online_dev_data_change)) + .route("/api/visualdev/OnlineDev/{model_id}/Actions/ExportData", post(compat::online_dev::online_dev_export_model)) + .route("/api/visualdev/OnlineDev/{model_id}/Template", get(compat::online_dev::online_dev_template)) + .route("/api/visualdev/OnlineDev/{model_id}/Actions/Export", post(compat::online_dev::online_dev_export)) + .route("/api/visualdev/OnlineDev/{model_id}/actionLaunchFlow", post(compat::online_dev::online_dev_launch_flow)) + .route("/api/visualdev/OnlineDev/RelationQuery", post(compat::online_dev::online_dev_relation_query)) + .route("/api/visualdev/OnlineLog", get(compat::online_dev::online_log_list)) + .route("/api/visualdev/personal", get(compat::online_dev::personal_list)) + .route("/api/visualdev/personal", post(compat::online_dev::personal_create)) + .route("/api/visualdev/personal/{id}", put(compat::online_dev::personal_update)) + .route("/api/visualdev/personal/{id}/setDefault", put(compat::online_dev::personal_set_default)) + .route("/api/visualdev/personal/{id}", delete(compat::online_dev::personal_delete)) + .route("/api/visualdev/share", get(compat::online_dev::share_list)) + .route("/api/visualdev/share/SelectedList", post(compat::online_dev::share_selected_list)) + .route("/api/visualdev/share/save", post(compat::online_dev::share_save)) + .route("/api/visualdev/share/Selector", get(compat::online_dev::share_selector)) + .route("/api/visualdev/ocr", post(compat::online_dev::ocr_recognize)) + .route("/api/visualdev/ShortLink/{id}", get(compat::online_dev::short_link_info)) + .route("/api/visualdev/ShortLink", put(compat::online_dev::short_link_save)) + .route("/api/visualdev/ShortLink/getConfig/{id}", get(compat::online_dev::short_link_get_config)) + .route("/api/visualdev/ShortLink/checkPwd", post(compat::online_dev::short_link_check_pwd)) + .route("/api/visualdev/ShortLink/Config", get(compat::online_dev::short_link_config_data)) + .route("/api/visualdev/ShortLink/{id}/ListLink", post(compat::online_dev::short_link_model_list)) + .route("/api/visualdev/ShortLink/{id}", post(compat::online_dev::short_link_create_model)) + .route("/api/visualdev/ShortLink/{id}/{id}/DataChange", get(compat::online_dev::short_link_data_change)) + .route("/api/visualdev/Portal", get(compat::online_dev::portal_list)) + .route("/api/visualdev/Portal/{id}", get(compat::online_dev::portal_info)) + .route("/api/visualdev/Portal", post(compat::online_dev::portal_create)) + .route("/api/visualdev/Portal/{id}", put(compat::online_dev::portal_update)) + .route("/api/visualdev/Portal/{id}", delete(compat::online_dev::portal_delete)) + .route("/api/visualdev/Portal/{id}/Actions/Copy", post(compat::online_dev::portal_copy)) + .route("/api/visualdev/Portal/{id}/Actions/Export", post(compat::online_dev::portal_export)) + .route("/api/visualdev/Portal/Selector", get(compat::online_dev::portal_selector)) + .route("/api/visualdev/Portal/Selector/Menu", get(compat::online_dev::portal_home_list)) + .route("/api/visualdev/Portal/{id}/Actions/SetDefault", put(compat::online_dev::portal_set_default)) + .route("/api/visualdev/Portal/{id}/auth", get(compat::online_dev::portal_auth)) + .route("/api/visualdev/Portal/Custom/Save/{id}", put(compat::online_dev::portal_custom_save)) + .route("/api/visualdev/Portal/Actions/release/{id}", put(compat::online_dev::portal_release)) + .route("/api/visualdev/Portal/systemFilter/{id}", get(compat::online_dev::portal_system_filter)) + .route("/api/visualdev/Portal/manage/Selector/{system_id}", get(compat::online_dev::portal_manage_selector)) + .route("/api/system/PortalManage/list/{system_id}", get(compat::online_dev::portal_manage_list)) + .route("/api/system/PortalManage/{id}", get(compat::online_dev::portal_manage_info)) + .route("/api/system/PortalManage", post(compat::online_dev::portal_manage_create)) + .route("/api/system/PortalManage/{id}", put(compat::online_dev::portal_manage_update)) + .route("/api/system/PortalManage/{id}", delete(compat::online_dev::portal_manage_delete)) + .route("/api/visualdev/Dashboard/Notice", post(compat::online_dev::dashboard_notice)) + .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)) + // ---- 在线报表(官方 `api/onlineDev/report.ts`,前缀 `/api/Report`)---- + // + // 🔴 **官方 `/api/Report/*` 在官方是「独立部署的第三方服务」** + // (`jnpf-java-datareport-univer`,端口 32000)—— 主后端 `jnpf-java-boot` + // 里**没有** `/api/Report` Controller,也**没有**任何 `report_version` 的 + // Java 实体 ⇒ 本仓把报表**元数据就地落库**(`report_template` + + // `report_version`,表结构照官方 DDL 逐字导入)。 + // 详见 `compat/report.rs` 的文件头。 + // + // 🔴 **`data` 的形状逐条照官方前端的消费点定**(最容易做错的地方): + // - `GET /api/Report` ⇒ `PageListVO`(`{pagination,list}`) + // - `GET /api/Report/Version/{id}` ⇒ **裸数组**(`res.data || []`) + // - `GET /api/Report/Selector` ⇒ `ListVO`(`{list:[…]}`) + // - `POST /api/Report` ⇒ **裸 id 字符串**(`state.dataForm.id = res.data`) + // - `POST /api/Report/Info/{id}` ⇒ **裸 id 字符串**(`const currentId = res.data`) + // - `GET /api/Report/{id}` 等 ⇒ **裸对象** + // + // 🔴 **权限守卫**:官方那个服务不在可核对的源码树里 ⇒ 拿不到它的 + // `@SaCheckPermission` ⇒ 一律**只要求登录**(与 `personal` / `share` 同款)。 + .route("/api/Report", get(compat::report::report_list)) + .route("/api/Report", post(compat::report::report_create)) + .route("/api/Report/Selector", get(compat::report::report_selector)) + .route("/api/Report/Save", post(compat::report::report_save_version)) + .route("/api/Report/Data", post(compat::report::report_get_data)) + .route("/api/Report/Version/{id}", get(compat::report::report_version_list)) + .route("/api/Report/Info/{id}", get(compat::report::report_version_info)) + .route("/api/Report/Info/{id}", post(compat::report::report_version_copy)) + .route("/api/Report/Info/{id}", delete(compat::report::report_version_delete)) + .route("/api/Report/data/upload/file", post(compat::report::report_upload_image)) + .route("/api/Report/data/downImg", post(compat::report::report_down_img)) + .route("/api/Report/data/ImportExcel", post(compat::report::report_import_excel)) + .route("/api/Report/data/{id}/DownExcel", post(compat::report::report_export_excel)) + .route("/api/Report/data/{id}/getQueryList", get(compat::report::report_query_list)) + .route("/api/Report/data/{id}/preview", post(compat::report::report_preview_design)) + .route("/api/Report/data/{id}/previewTemplate", post(compat::report::report_preview_template)) + .route("/api/Report/{id}", get(compat::report::report_info)) + .route("/api/Report/{id}", put(compat::report::report_update)) + .route("/api/Report/{id}", delete(compat::report::report_delete)) + .route("/api/Report/{id}/Actions/Copy", post(compat::report::report_copy)) + .route("/api/Report/{id}/Actions/Export", get(compat::report::report_export_data)) + .route("/api/Report/{id}/Actions/Module", post(compat::report::report_create_menu)) + .route("/api/Report/{id}/getReleaseMenu", get(compat::report::report_release_menu)) .merge(crate::bootstrap::pack_router_or_empty()); // 🔴 **仅测试构建**存在的「故意 panic」端点 —— 用来钉住 catch-all 中间件 diff --git a/src/backend/tests/batch17_it.rs b/src/backend/tests/batch17_it.rs new file mode 100644 index 0000000..0a1c18b --- /dev/null +++ b/src/backend/tests/batch17_it.rs @@ -0,0 +1,768 @@ +//! 批次 17(**onlineDev 收尾 + 在线报表**)集成测试: +//! onlineDev 78 条 + Report 23 条 = 101 条面 B 端点。 +//! +//! 🔴 **钉住的契约点**: +//! ① **路由不冲突**(`matchit` 同位置参数名冲突 ⇒ **启动即 panic**)—— +//! 静态闸门(check-contract)**看不出来**,编译也过,只有真跑起来才炸 +//! (批次 12 踩过:`/api/system/Area/{nodeId}` vs `/{id}`)。 +//! ⇒ 本文件把 101 条端点**逐条打一遍**,让 router 在 build 时就把冲突炸出来。 +//! ② **Report 的 `data` 形状五种并存**: +//! `PageListVO` / **裸数组**(`Version/{id}`)/ 裸对象 / **裸 id 字符串** +//! (`POST /api/Report`)/ `{queryList:""}`。 +//! 返错形状 ⇒ 官方前端直接崩(`res.data || []` 拿到对象、`JSON.parse(res.data.queryList)` 拿到对象)。 +//! ③ **审计列存「账号」不是 id**(`f_creator_user_id` = `user.account`)。 +//! ④ **诚实失败**:无文件服务 / 无 Univer 渲染器 / 无数据引擎 ⇒ `code=400` + `data:null`。 +//! ⑤ **不返假 URL**:官方前端 `downloadByUrl({url: res.data.url})` 遇 `null` 会抛 JS 异常。 +//! +//! 🔴 pglite-rs 是**进程级全局标志** ⇒ 全文件共用一个临时库 + 一把互斥锁。 +//! 断言一律按 id / 计数定位,不依赖「列表里只有我造的那几条」。 + +use std::path::PathBuf; +use std::sync::Arc; + +use serde_json::{json, Value}; +use ssw_platform::bootstrap::ensure_base; +use ssw_platform::platform::config::Config; +use ssw_platform::platform::db::Db; +use ssw_platform::platform::seed::first_seed; +use ssw_platform::platform::session::SessionStore; +use ssw_platform::platform::state::AppState; +use ssw_platform::routes::build_app; +use tokio::io::{AsyncReadExt, AsyncWriteExt}; +use tokio::net::TcpStream; +use tokio::sync::{Mutex, OnceCell}; + +static DB: OnceCell = 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 失败"); + ensure_base(&db).await.expect("ensure_base 失败"); + first_seed(&db, "123456").await.expect("first_seed 失败"); + db + }) + .await +} + +async fn serve(state: AppState) -> u16 { + let listener = tokio::net::TcpListener::bind("127.0.0.1:0") + .await + .expect("绑定失败"); + let port = listener.local_addr().expect("取本地地址失败").port(); + let server = tokio::spawn(async move { + let _ = axum::serve(listener, build_app(state)).await; + }); + tokio::task::yield_now().await; + std::mem::forget(server); + port +} + +async fn call(port: u16, method: &str, path: &str, token: &str, body: Option<&str>) -> 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 (_, body) = text.split_once("\r\n\r\n").expect("响应必须有头体分隔"); + serde_json::from_str(body.trim()).unwrap_or(Value::Null) +} + +async fn login(port: u16) -> String { + let enc = ssw_platform::platform::cipher::encrypt_password("123456"); + let payload = format!("account=admin&password={enc}"); + let mut stream = TcpStream::connect(("127.0.0.1", port)) + .await + .expect("连接失败"); + let req = format!( + "POST /api/oauth/Login HTTP/1.1\r\n\ + Host: 127.0.0.1\r\n\ + Vue-Version: 3\r\n\ + App-Code: mainSystem\r\n\ + Content-Type: application/x-www-form-urlencoded\r\n\ + Content-Length: {}\r\n\ + Connection: close\r\n\r\n{payload}", + payload.len() + ); + stream + .write_all(req.as_bytes()) + .await + .expect("写请求失败"); + let mut buf = Vec::new(); + tokio::time::timeout( + std::time::Duration::from_secs(15), + stream.read_to_end(&mut buf), + ) + .await + .expect("读响应超时") + .expect("读响应失败"); + let text = String::from_utf8_lossy(&buf).to_string(); + let (_, body) = text.split_once("\r\n\r\n").expect("响应必须有头体分隔"); + let json: Value = serde_json::from_str(body.trim()).expect("登录响应必须是 JSON"); + json["data"]["token"] + .as_str() + .expect("登录必须返回 token") + .to_string() +} + +fn new_state(db: &Db) -> AppState { + AppState { + config: Arc::new(Config::from_env(PathBuf::from( + "/tmp/ssw-platform-batch17-it", + ))), + db: Arc::new(db.clone()), + sessions: Arc::new(SessionStore::default()), + } +} + +async fn boot() -> (u16, String) { + let state = new_state(db().await); + let port = serve(state).await; + let token = login(port).await; + (port, token) +} + +async fn scalar(sql: &str, value: &str) -> String { + let owned = value.to_string(); + let rows = if value.is_empty() { + Db::query_json_params(db().await, sql, &[]).await + } else { + Db::query_json_params(db().await, sql, &[&owned]).await + } + .expect("查询失败"); + let cell = rows + .first() + .and_then(|row| row.as_object()) + .and_then(|obj| obj.values().next()); + match cell { + Some(v) => v + .as_str() + .map(|s| s.to_string()) + .or_else(|| v.as_i64().map(|n| n.to_string())) + .unwrap_or_default(), + None => String::new(), + } +} + +/// 🔴 **101 条端点逐条打一遍** —— 目的不是断言业务,而是让 **axum 建路由** +/// 把 `matchit` 的参数名冲突炸出来(静态闸门看不出来)。 +/// +/// 🔴 判据:只要**不是** 404 / 405,就算「路由存在」。 +/// 401/403(守卫拦)也说明路由**注册成功**(进了 handler 前的守卫)。 +#[tokio::test] +async fn batch17_all_routes_are_registered_without_matchit_conflict() { + let _g = LOCK.lock().await; + let (port, token) = boot().await; + + // (method, path) —— 逐条照 `docs/contract.md` 的 `[ENDPOINT]`(onlineDev + Report 两族) + let routes: Vec<(&str, &str)> = vec![ + // ---- visualdev/Base ---- + ("GET", "/api/visualdev/Base"), + ("POST", "/api/visualdev/Base"), + ("GET", "/api/visualdev/Base/list"), + ("GET", "/api/visualdev/Base/Selector"), + ("GET", "/api/visualdev/Base/getColumnList"), + ("GET", "/api/visualdev/Base/getListBySystem"), + ("GET", "/api/visualdev/Base/route-probe-id"), + ("PUT", "/api/visualdev/Base/route-probe-id"), + ("DELETE", "/api/visualdev/Base/route-probe-id"), + ("POST", "/api/visualdev/Base/route-probe-id/Actions/Copy"), + ("POST", "/api/visualdev/Base/route-probe-id/Actions/Release"), + ("POST", "/api/visualdev/Base/route-probe-id/Actions/Module"), + ("GET", "/api/visualdev/Base/route-probe-id/getReleaseMenu"), + ("GET", "/api/visualdev/Base/route-probe-id/FormDataFields"), + ("GET", "/api/visualdev/Base/route-probe-id/FieldDataSelect"), + // ---- visualdev/Generater ---- + ("POST", "/api/visualdev/Generater/route-probe-id/Actions/DownloadCode"), + ("POST", "/api/visualdev/Generater/route-probe-id/Actions/CodePreview"), + ("GET", "/api/visualdev/Generater/route-probe-id/Alias/Info"), + ("POST", "/api/visualdev/Generater/route-probe-id/Alias/Save"), + // ---- visualdev/OnlineDev ---- + ("GET", "/api/visualdev/OnlineDev/route-probe-id/Config"), + ("GET", "/api/visualdev/OnlineDev/Config"), + ("GET", "/api/visualdev/OnlineDev/route-probe-id/FormData"), + ("POST", "/api/visualdev/OnlineDev/route-probe-id/List"), + ("POST", "/api/visualdev/OnlineDev/route-probe-id"), + ("PUT", "/api/visualdev/OnlineDev/route-probe-id/route-probe-id"), + ("GET", "/api/visualdev/OnlineDev/route-probe-id/route-probe-id"), + ("DELETE", "/api/visualdev/OnlineDev/route-probe-id/route-probe-id"), + ("POST", "/api/visualdev/OnlineDev/batchDelete/route-probe-id"), + ("POST", "/api/visualdev/OnlineDev/route-probe-id/DataChange"), + ("POST", "/api/visualdev/OnlineDev/route-probe-id/Actions/ExportData"), + ("GET", "/api/visualdev/OnlineDev/route-probe-id/Template"), + ("POST", "/api/visualdev/OnlineDev/route-probe-id/Actions/Export"), + ("POST", "/api/visualdev/OnlineDev/route-probe-id/actionLaunchFlow"), + ("POST", "/api/visualdev/OnlineDev/RelationQuery"), + // ---- visualdev/OnlineLog / personal / share / ocr ---- + ("GET", "/api/visualdev/OnlineLog"), + ("GET", "/api/visualdev/personal"), + ("POST", "/api/visualdev/personal"), + ("PUT", "/api/visualdev/personal/route-probe-id"), + ("PUT", "/api/visualdev/personal/route-probe-id/setDefault"), + ("DELETE", "/api/visualdev/personal/route-probe-id"), + ("GET", "/api/visualdev/share"), + ("POST", "/api/visualdev/share/SelectedList"), + ("POST", "/api/visualdev/share/save"), + ("GET", "/api/visualdev/share/Selector"), + ("POST", "/api/visualdev/ocr"), + // ---- visualdev/ShortLink ---- + ("GET", "/api/visualdev/ShortLink/route-probe-id"), + ("PUT", "/api/visualdev/ShortLink"), + ("GET", "/api/visualdev/ShortLink/getConfig/route-probe-id"), + ("POST", "/api/visualdev/ShortLink/checkPwd"), + ("GET", "/api/visualdev/ShortLink/Config"), + ("POST", "/api/visualdev/ShortLink/route-probe-id/ListLink"), + ("POST", "/api/visualdev/ShortLink/route-probe-id"), + ("GET", "/api/visualdev/ShortLink/route-probe-id/route-probe-id/DataChange"), + // ---- visualdev/Portal ---- + ("GET", "/api/visualdev/Portal"), + ("POST", "/api/visualdev/Portal"), + ("GET", "/api/visualdev/Portal/Selector"), + ("GET", "/api/visualdev/Portal/Selector/Menu"), + ("GET", "/api/visualdev/Portal/route-probe-id"), + ("PUT", "/api/visualdev/Portal/route-probe-id"), + ("DELETE", "/api/visualdev/Portal/route-probe-id"), + ("POST", "/api/visualdev/Portal/route-probe-id/Actions/Copy"), + ("POST", "/api/visualdev/Portal/route-probe-id/Actions/Export"), + ("PUT", "/api/visualdev/Portal/route-probe-id/Actions/SetDefault"), + ("GET", "/api/visualdev/Portal/route-probe-id/auth"), + ("PUT", "/api/visualdev/Portal/Custom/Save/route-probe-id"), + ("PUT", "/api/visualdev/Portal/Actions/release/route-probe-id"), + ("GET", "/api/visualdev/Portal/systemFilter/route-probe-id"), + ("GET", "/api/visualdev/Portal/manage/Selector/route-probe-id"), + // ---- system/PortalManage + atlas + datav ---- + ("GET", "/api/system/PortalManage/list/route-probe-id"), + ("GET", "/api/system/PortalManage/route-probe-id"), + ("POST", "/api/system/PortalManage"), + ("PUT", "/api/system/PortalManage/route-probe-id"), + ("DELETE", "/api/system/PortalManage/route-probe-id"), + ("GET", "/api/system/atlas"), + ("GET", "/api/system/atlas/geojson"), + ("GET", "/api/blade-visual/visual/Selector"), + // ---- visualdev/Dashboard ---- + ("POST", "/api/visualdev/Dashboard/Notice"), + ("GET", "/api/visualdev/Dashboard/Email"), + // ---- Report ---- + ("GET", "/api/Report"), + ("POST", "/api/Report"), + ("GET", "/api/Report/Selector"), + ("POST", "/api/Report/Save"), + ("POST", "/api/Report/Data"), + ("GET", "/api/Report/Version/route-probe-id"), + ("GET", "/api/Report/Info/route-probe-id"), + ("POST", "/api/Report/Info/route-probe-id"), + ("DELETE", "/api/Report/Info/route-probe-id"), + ("POST", "/api/Report/data/upload/file"), + ("POST", "/api/Report/data/downImg"), + ("POST", "/api/Report/data/ImportExcel"), + ("POST", "/api/Report/data/route-probe-id/DownExcel"), + ("GET", "/api/Report/data/route-probe-id/getQueryList"), + ("POST", "/api/Report/data/route-probe-id/preview"), + ("POST", "/api/Report/data/route-probe-id/previewTemplate"), + ("GET", "/api/Report/route-probe-id"), + ("PUT", "/api/Report/route-probe-id"), + ("DELETE", "/api/Report/route-probe-id"), + ("POST", "/api/Report/route-probe-id/Actions/Copy"), + ("GET", "/api/Report/route-probe-id/Actions/Export"), + ("POST", "/api/Report/route-probe-id/Actions/Module"), + ("GET", "/api/Report/route-probe-id/getReleaseMenu"), + ]; + + let mut not_found = Vec::new(); + for (method, path) in routes { + let res = call(port, method, path, &token, Some("{}")).await; + let code = res["code"].as_i64().unwrap_or(-1); + // 🔴 404 ⇒ 路由没注册;405 ⇒ 方法不对(路由存在但方法不符 ⇒ 也是错) + if code == 404 || code == 405 { + not_found.push(format!("{method} {path} ⇒ code={code}")); + } + } + assert!( + not_found.is_empty(), + "以下端点**没注册上**(路由缺失或方法不符):\n{}", + not_found.join("\n") + ); +} + +/// 🔴 **Report 的 `data` 形状**:新建 ⇒ **裸 id 字符串**(官方 `state.dataForm.id = res.data`)。 +#[tokio::test] +async fn report_create_returns_bare_id_string_and_audit_column_is_account() { + let _g = LOCK.lock().await; + let (port, token) = boot().await; + + let name = format!("报表形状测试{}", uuid_like()); + let body = json!({ + "fullName": name, + "category": "0", + "enCode": format!("rp_{}", uuid_like()), + }) + .to_string(); + let res = call(port, "POST", "/api/Report", &token, Some(&body)).await; + + assert_eq!(res["code"], 200, "新建报表应成功:{:?}", res); + // 🔴 **裸 id 字符串**(不是 `{id:…}` 对象) + let id = res["data"] + .as_str() + .expect("data 必须是**裸 id 字符串**(官方消费点:state.dataForm.id = res.data)"); + assert!(!id.is_empty(), "新建必须返回 id"); + + // 🔴 审计列存的是**账号**(不是 id) + let creator = scalar( + "SELECT f_creator_user_id AS \"v\" FROM report_template WHERE f_id = $1::text", + id, + ) + .await; + assert_eq!(creator, "admin", "f_creator_user_id 必须存**账号**(admin),实际 {:?}", creator); + + // 🔴 版本列表是**裸数组**(官方 `state.versionList = res.data || []`) + let vres = call(port, "GET", &format!("/api/Report/Version/{id}"), &token, None).await; + assert_eq!(vres["code"], 200, "版本列表应成功:{:?}", vres); + assert!( + vres["data"].is_array(), + "版本列表的 data 必须是**裸数组**(官方 `res.data || []`),实际:{:?}", + vres["data"] + ); +} + +/// 🔴 `getQueryList` 返的是 **`{queryList:""}`** —— 官方自己 `JSON.parse(res.data.queryList)` +/// ⇒ 返**解析后的数组**会让官方 `JSON.parse` 直接抛异常。 +#[tokio::test] +async fn report_query_list_returns_raw_json_string_not_parsed_array() { + let _g = LOCK.lock().await; + let (port, token) = boot().await; + + let name = format!("报表查询定义{}", uuid_like()); + let body = json!({ + "fullName": name, + "category": "0", + "enCode": format!("rp_{}", uuid_like()), + }) + .to_string(); + let res = call(port, "POST", "/api/Report", &token, Some(&body)).await; + let id = res["data"].as_str().expect("新建应返裸 id").to_string(); + + // 🔴 先存一版(`POST /api/Report/Save`),queryList 才有内容 + let qlist = json!({ + "id": id, + "fullName": name, + "queryList": "[{\"field\":\"a\",\"type\":\"eq\"}]", + }) + .to_string(); + let _ = call(port, "POST", "/api/Report/Save", &token, Some(&qlist)).await; + + let res = call( + port, + "GET", + &format!("/api/Report/data/{id}/getQueryList"), + &token, + None, + ) + .await; + assert_eq!(res["code"], 200, "getQueryList 应成功:{:?}", res); + let q = res["data"]["queryList"] + .as_str() + .unwrap_or_else(|| panic!("data.queryList 必须是**字符串**(官方自己 JSON.parse 它),实际:{:?}", res["data"])); + assert!( + serde_json::from_str::(q).is_ok(), + "data.queryList 必须是**合法 JSON 串**,实际:{:?}", + q + ); +} + +/// 🔴 **诚实失败**:本仓无文件服务 / 无 Univer / 无数据引擎 ⇒ `code=400` + `data:null`。 +/// **不返假 URL**(官方前端 `downloadByUrl({url: res.data.url})` 遇 null 会抛 JS 异常)。 +#[tokio::test] +async fn report_capability_missing_endpoints_fail_explicitly() { + let _g = LOCK.lock().await; + let (port, token) = boot().await; + + let cases: Vec<(&str, &str)> = vec![ + ("POST", "/api/Report/data/upload/file"), + ("POST", "/api/Report/data/downImg"), + ("POST", "/api/Report/data/ImportExcel"), + ("POST", "/api/Report/data/route-probe-id/DownExcel"), + ("POST", "/api/Report/data/route-probe-id/preview"), + ("POST", "/api/Report/data/route-probe-id/previewTemplate"), + ("GET", "/api/Report/route-probe-id/Actions/Export"), + ("POST", "/api/Report/Data"), + ]; + for (method, path) in cases { + let res = call(port, method, path, &token, Some("{}")).await; + let code = res["code"].as_i64().unwrap_or(-1); + assert_eq!( + code, 400, + "{method} {path} 能力不存在时必须**明确失败**(code=400),实际:{:?}", + res + ); + assert!( + res["data"].is_null(), + "{method} {path} 失败时 data 必须是 null(**不返假 URL**),实际:{:?}", + res["data"] + ); + assert!( + !res["msg"].as_str().unwrap_or("").is_empty(), + "{method} {path} 失败必须带人话 msg" + ); + } +} + +/// 🔴 **功能表单 CRUD 真落库**:新建 ⇒ 详情 ⇒ 修改 ⇒ 删除。 +#[tokio::test] +async fn visual_dev_crud_roundtrip_and_audit_column_is_account() { + let _g = LOCK.lock().await; + let (port, token) = boot().await; + + let name = format!("功能表单测试{}", uuid_like()); + let body = json!({ + "fullName": name, + "enCode": format!("vd_{}", uuid_like()), + "type": 1, + "webType": 1, + }) + .to_string(); + let res = call(port, "POST", "/api/visualdev/Base", &token, Some(&body)).await; + assert_eq!(res["code"], 200, "新建功能应成功:{:?}", res); + let id = res["data"]["id"].as_str().expect("新建必须返 id").to_string(); + + // 🔴 审计列存**账号** + let creator = scalar( + "SELECT f_creator_user_id AS \"v\" FROM base_visual_dev WHERE f_id = $1::text", + &id, + ) + .await; + assert_eq!(creator, "admin", "f_creator_user_id 必须存账号,实际 {:?}", creator); + + // 详情 + let res = call(port, "GET", &format!("/api/visualdev/Base/{id}"), &token, None).await; + assert_eq!(res["code"], 200, "详情应成功:{:?}", res); + assert_eq!(res["data"]["fullName"], name.as_str(), "详情应返原名"); + + // 🔴 列表是 `PageListVO` `{pagination, list}` + let res = call(port, "GET", "/api/visualdev/Base", &token, None).await; + assert_eq!(res["code"], 200, "列表应成功:{:?}", res); + assert!( + res["data"]["list"].is_array(), + "列表的 data 必须是 PageListVO({{pagination, list}}),实际:{:?}", + res["data"] + ); + assert!( + res["data"]["pagination"].is_object(), + "列表必须有 pagination,实际:{:?}", + res["data"] + ); + + // 修改 + let new_name = format!("{name}-改", ); + let res = call( + port, + "PUT", + &format!("/api/visualdev/Base/{id}"), + &token, + Some(&json!({ "fullName": new_name }).to_string()), + ) + .await; + assert_eq!(res["code"], 200, "修改应成功:{:?}", res); + + let got = scalar( + "SELECT f_full_name AS \"v\" FROM base_visual_dev WHERE f_id = $1::text", + &id, + ) + .await; + assert_eq!(got, new_name, "改名应落库"); + + // 🔴 `f_last_modify_user_id` 也应是**账号** + let modifier = scalar( + "SELECT f_last_modify_user_id AS \"v\" FROM base_visual_dev WHERE f_id = $1::text", + &id, + ) + .await; + assert_eq!( + modifier, "admin", + "f_last_modify_user_id 必须存账号,实际 {:?}", + modifier + ); + + // 删除(软删) + let res = call(port, "DELETE", &format!("/api/visualdev/Base/{id}"), &token, None).await; + assert_eq!(res["code"], 200, "删除应成功:{:?}", res); + let deleted = scalar( + "SELECT COALESCE(f_delete_mark, 0)::text AS \"v\" FROM base_visual_dev WHERE f_id = $1::text", + &id, + ) + .await; + assert_eq!(deleted, "1", "删除应是**软删**(f_delete_mark=1)"); +} + +/// 🔴 **门户 CRUD**(`onlineDev.visualPortal` 点权限守卫那一族)。 +#[tokio::test] +async fn portal_crud_roundtrip() { + let _g = LOCK.lock().await; + let (port, token) = boot().await; + + let name = format!("门户测试{}", uuid_like()); + let body = json!({ + "fullName": name, + "enCode": format!("pl_{}", uuid_like()), + "type": 1, + }) + .to_string(); + let res = call(port, "POST", "/api/visualdev/Portal", &token, Some(&body)).await; + assert_eq!(res["code"], 200, "新建门户应成功:{:?}", res); + let id = res["data"]["id"].as_str().expect("新建必须返 id").to_string(); + + let res = call(port, "GET", &format!("/api/visualdev/Portal/{id}"), &token, None).await; + assert_eq!(res["code"], 200, "门户详情应成功:{:?}", res); + assert_eq!(res["data"]["fullName"], name.as_str()); + + let res = call(port, "DELETE", &format!("/api/visualdev/Portal/{id}"), &token, None).await; + assert_eq!(res["code"], 200, "删除门户应成功:{:?}", res); +} + +/// 🔴 **「无守卫」端点**:`GET /api/oauth/getLoginConfig` 是**登录前**就要拉的 +/// ⇒ 不能要 token(官方登录页 `LoginForm.vue:160` 直接 `res.data.redirect`)。 +#[tokio::test] +async fn login_config_endpoint_needs_no_token() { + let _g = LOCK.lock().await; + let state = new_state(db().await); + let port = serve(state).await; + + let res = call(port, "GET", "/api/oauth/getLoginConfig", "", None).await; + assert_eq!(res["code"], 200, "登录页配置不该要 token:{:?}", res); + // 🔴 `data` 必须是**对象**(给 `null` 前端会 `Cannot read properties of null`) + assert!( + res["data"].is_object(), + "getLoginConfig 的 data 必须是对象,实际:{:?}", + res["data"] + ); +} + +/// 🔴 短链:`PUT /api/visualdev/ShortLink` 是**无路径参数**的 PUT +/// (官方 `shortLink.ts` 打的就是 `/api/visualdev/ShortLink`)—— +/// 🔴 若误写成 `/api/visualdev/ShortLink/{id}` ⇒ 官方前端直接 404。 +#[tokio::test] +async fn short_link_save_has_no_path_parameter() { + let _g = LOCK.lock().await; + let (port, token) = boot().await; + + let res = call( + port, + "PUT", + "/api/visualdev/ShortLink", + &token, + Some(&json!({ "fullName": "短链测试", "enCode": "sl_test" }).to_string()), + ) + .await; + // 🔴 判据:不是 404/405 ⇒ 路由注册在**无参数**路径上 + let code = res["code"].as_i64().unwrap_or(-1); + assert!( + code != 404 && code != 405, + "`PUT /api/visualdev/ShortLink` 必须存在(官方不打路径参数),实际 code={code}:{:?}", + res + ); +} + +/// 🔴 `GET /api/visualdev/Base/{id}/getReleaseMenu` —— **裸对象**,不是列表。 +/// +/// 官方 `VisualdevController.java:738` 返 `ActionResult` +/// (**单条** `base_visual_dev`),官方消费点 +/// `views/onlineDev/formDesign/components/CreateMenuModal.vue:56-59`: +/// `state.record = res.data` ⇒ `res.data` 必须是**对象**; +/// 且它读 `res.data.platformRelease`(JSON 串,官方自己 `JSON.parse`)。 +/// +/// 🔴 回归点:本仓原先返 `ListVO`(`{list:[…]}`)且查了 +/// `base_visual_release.f_platform_release`(**官方 DDL 里没这列** ⇒ PG 直接报错)。 +#[tokio::test] +async fn release_menu_returns_bare_object_not_list() { + let _g = LOCK.lock().await; + let (port, token) = boot().await; + + let name = format!("发布菜单测试{}", uuid_like()); + let body = json!({ + "fullName": name, + "enCode": format!("vd_{}", uuid_like()), + "type": 1, + "webType": 1, + }) + .to_string(); + let res = call(port, "POST", "/api/visualdev/Base", &token, Some(&body)).await; + assert_eq!(res["code"], 200, "新建功能应成功:{:?}", res); + let id = res["data"]["id"].as_str().expect("新建必须返 id").to_string(); + + let res = call( + port, + "GET", + &format!("/api/visualdev/Base/{id}/getReleaseMenu"), + &token, + None, + ) + .await; + assert_eq!(res["code"], 200, "getReleaseMenu 应成功:{:?}", res); + assert!( + res["data"].is_object(), + "getReleaseMenu 的 data 必须是**裸对象**(官方 `state.record = res.data`),实际:{:?}", + res["data"] + ); + assert!( + res["data"].get("list").is_none(), + "getReleaseMenu 不能返 list(那是 ListVO),实际:{:?}", + res["data"] + ); + assert_eq!(res["data"]["id"], id.as_str(), "应返同一个功能 id"); + assert_eq!(res["data"]["fullName"], name.as_str(), "应返功能名"); + // 🔴 官方读这四个字段(菜单发布记录)⇒ 本仓无该表 ⇒ 如实给 0 / 空串 + assert_eq!(res["data"]["pcIsRelease"], 0, "pcIsRelease 应为 0"); + assert_eq!(res["data"]["appIsRelease"], 0, "appIsRelease 应为 0"); + assert!(res["data"]["pcReleaseName"].is_string(), "pcReleaseName 应为字符串"); +} + +/// 🔴 `GET /api/visualdev/Portal/systemFilter/{id}` —— 官方 `SystemListVO` 形状。 +/// +/// 🔴 回归点:本仓原先查 `f_app_key` / `f_app_name` / `f_url_address` +/// —— 这三列**官方 `base_system` DDL 里根本没有** ⇒ PG 直接报错; +/// 官方 `SystemListVO` 也没有这三个字段,而是 +/// `icon/sortCode/backgroundColor/userId/hasUpdate/hasDelete/isTop`。 +#[tokio::test] +async fn system_filter_returns_official_system_list_vo_shape() { + let _g = LOCK.lock().await; + let (port, token) = boot().await; + + let res = call( + port, + "GET", + "/api/visualdev/Portal/systemFilter/whatever", + &token, + None, + ) + .await; + assert_eq!(res["code"], 200, "systemFilter 应成功:{:?}", res); + assert!( + res["data"]["list"].is_array(), + "systemFilter 的 data 必须是 ListVO({{list:[…]}}),实际:{:?}", + res["data"] + ); + let first = &res["data"]["list"][0]; + assert!(first.is_object(), "列表项应是对象,实际:{:?}", first); + for key in [ + "id", + "fullName", + "enCode", + "icon", + "sortCode", + "backgroundColor", + "userId", + "hasUpdate", + "hasDelete", + "isTop", + ] { + assert!( + first.get(key).is_some(), + "官方 `SystemListVO` 必须有 `{key}` 字段,实际:{:?}", + first + ); + } + // 🔴 官方 VO 没有这三个字段 ⇒ 本仓不能返(返了也是编的) + for key in ["appKey", "appName", "urlAddress", "isMain"] { + assert!( + first.get(key).is_none(), + "官方 `SystemListVO` 没有 `{key}`,本仓不该编出来:{:?}", + first + ); + } +} + +/// 🔴 `POST /api/visualdev/Dashboard/Notice` —— **`ListVO`** + `typeList` 入参。 +/// +/// 官方 `DashboardController.java:45` 返 `ActionResult>`; +/// 官方消费点 `components/VisualPortal/Design/hooks/useTable.ts:136-137`: +/// `res.data.list || []` ⇒ **不是** `PageListVO`。 +/// 入参 `NoticeModel { typeList: List }` 是**数组**(`useTable.ts:135`)。 +/// +/// 🔴 回归点:本仓原先返 `PageListVO` 且读单值 `type`; +/// 投影还查了 `base_notice.f_full_name` —— 官方 `NoticeEntity` 的标题列是 +/// `f_title`(**没有** `f_full_name`)⇒ PG 直接报错。 +#[tokio::test] +async fn dashboard_notice_returns_list_vo_and_accepts_type_list() { + let _g = LOCK.lock().await; + let (port, token) = boot().await; + + let res = call( + port, + "POST", + "/api/visualdev/Dashboard/Notice", + &token, + Some(&json!({ "typeList": [] }).to_string()), + ) + .await; + assert_eq!(res["code"], 200, "Dashboard/Notice 应成功:{:?}", res); + assert!( + res["data"]["list"].is_array(), + "Dashboard/Notice 的 data 必须是 ListVO({{list:[…]}}),实际:{:?}", + res["data"] + ); + assert!( + res["data"].get("pagination").is_none(), + "Dashboard/Notice **不能**返 pagination(官方是 ListVO 不是 PageListVO),实际:{:?}", + res["data"] + ); + // 逐项字段(官方 `NoticeVO`) + if let Some(first) = res["data"]["list"].as_array().and_then(|a| a.first()) { + for key in ["id", "fullName", "creatorTime", "releaseUser", "releaseTime", "excerpt"] { + assert!( + first.get(key).is_some(), + "官方 `NoticeVO` 必须有 `{key}`,实际:{:?}", + first + ); + } + } + + // 🔴 `typeList` 是数组(官方口径)⇒ 传数组不能 400 + let res = call( + port, + "POST", + "/api/visualdev/Dashboard/Notice", + &token, + Some(&json!({ "typeList": ["1", "2"] }).to_string()), + ) + .await; + assert_eq!( + res["code"], 200, + "`typeList` 数组入参必须被接受(官方 `NoticeModel.typeList`),实际:{:?}", + res + ); +} + +/// 生成一个短随机串(避免测试之间撞名)。 +fn uuid_like() -> String { + use std::time::{SystemTime, UNIX_EPOCH}; + let n = SystemTime::now() + .duration_since(UNIX_EPOCH) + .map(|d| d.as_nanos()) + .unwrap_or(0); + format!("{n:x}").chars().rev().take(10).collect() +}