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

+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()
}