feat(onlineDev): 补齐 onlineDev 78 条 + 在线报表 23 条端点并同步契约三处

契约面(面 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)
This commit is contained in:
admin committed 2026-11-02 16:01:24 +08:00
1 parent 1a41aed3b7
commit cf154d50ff
13 files changed
+6495 -52

No files matched your search

+98
View File
@@ -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::<模块>::<handler>`(旧版只认一段 ⇒ 取到 `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:"<JSON 串>"}` ⇒
**判据:看官方前端的消费点,不看 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<VisualFunctionModel>`(**单条 `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<ListVO<NoticeVO>>`(**不是** `PageListVO`);
官方消费点 `components/VisualPortal/Design/hooks/useTable.ts:136-137` 是 `res.data.list || []`。
入参官方 `NoticeModel { typeList: List<String> }`(**数组**,见 `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**
+170 -23
View File
@@ -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>`。
🔴 **这个改动让契约扫描器的守卫推导一度全失效**(`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:"<JSON 串>"}` | `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:"<JSON 串>"}`)
⇒ 返 `{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<VisualFunctionModel>`;官方消费点
`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<ListVO<NoticeVO>>`)+
消费点 `components/VisualPortal/Design/hooks/useTable.ts:136-137`(`res.data.list || []`);
入参官方 `NoticeModel { typeList: List<String> }`(`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. 收工前(每一轮都要做)
+25 -7
View File
@@ -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!(
+204 -1
View File
@@ -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
<!-- PACK:BEGIN -->
# 🔴 以下由 `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 期望断言数(尺子**自己**断言的条数;跑出来的条数对不上 ⇒ 失败)
+109 -21
View File
@@ -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::<模块>::<handler>` ⇒ 只认**第一段**会拿到
# `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::<模块>::<handler>` ⇒ 这些文件**必须**进 `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"]],
+403
View File
@@ -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))
+66
View File
@@ -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)
);
+7
View File
@@ -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?)"
+2
View File
@@ -22,3 +22,5 @@ pub mod permission;
pub mod message;
pub mod scheduletask;
pub mod core;
pub mod online_dev;
pub mod report;
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
+131
View File
@@ -1388,6 +1388,137 @@ pub fn build_router(state: AppState) -> axum::Router<AppState> {
// 🔴 **批次 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 中间件
+768
View File
@@ -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:"<JSON 串>"}`。
//! 返错形状 ⇒ 官方前端直接崩(`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<Db> = OnceCell::const_new();
static LOCK: Mutex<()> = Mutex::const_new(());
async fn db() -> &'static Db {
DB.get_or_init(|| async {
let db = Db::open_temp().await.expect("打开 pglite 临时库失败");
ssw_platform::bootstrap::ensure_schema_all(&db)
.await
.expect("ensure_schema_all 失败");
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 串>"}`** —— 官方自己 `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::<Value>(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<VisualFunctionModel>`
/// (**单条** `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<ListVO<NoticeVO>>`;
/// 官方消费点 `components/VisualPortal/Design/hooks/useTable.ts:136-137`:
/// `res.data.list || []` ⇒ **不是** `PageListVO`。
/// 入参 `NoticeModel { typeList: List<String> }` 是**数组**(`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()
}