Files
tdc-rs/tests/crud_engine.rs
T
adminandClaude Code 8b73397d66 fix(crud): 编码重试次数与失败文案逐实体对齐上游
- Product/Resource 重试 5 次,DataInterface/Datasource 重试 3 次(上游逐实体不同)
- 失败文案取上游原文,不再统一用「接口编码生成失败」
- 补注 Datasource 查重口径的有意分歧(本仓更严,唯一索引为部分索引,不会插入冲突)

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 23:09:03 +08:00

510 lines
20 KiB
Rust
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
//! CRUD 引擎端到端:新增 → 列表 → 关键字 → 过滤 → 修改 → 删除 → 各类拒因。
//!
//! ⚠️ 本测试二进制内共用一个 PGlite 实例(pglite-rs 每进程只允许一个)。
use std::collections::HashMap;
use std::sync::Arc;
use pglite::PGlite;
use serde_json::{json, Value};
use tdc_connector::auth::Principal;
use tdc_connector::config::Config;
use tdc_connector::crud;
use tdc_connector::registry;
use tdc_connector::session::SessionStore;
use tdc_connector::state::{AppState, BootstrapIdentity};
use tokio::sync::OnceCell;
static DB: OnceCell<Arc<PGlite>> = OnceCell::const_new();
async fn shared_db() -> Arc<PGlite> {
DB.get_or_init(|| async {
let db = Arc::new(PGlite::open_temp().await.expect("打开临时 PGlite 失败"));
tdc_connector::db::ensure_schema(db.as_ref())
.await
.expect("建表失败");
db
})
.await
.clone()
}
async fn test_state() -> AppState {
let db = shared_db().await;
let mut config = Config::from_env(std::env::current_dir().unwrap());
config.identity_code = "TEST-CONNECTOR".to_string();
AppState::new(
config,
db,
Arc::new(SessionStore::new()),
BootstrapIdentity {
identity_id: "TEST-OP".to_string(),
identity_code: "TEST-CONNECTOR".to_string(),
issued_secret: None,
},
)
}
fn principal() -> Principal {
Principal::Session {
identity_id: "TEST-OP".to_string(),
identity_code: "TEST-CONNECTOR".to_string(),
}
}
async fn body_of(resp: axum::response::Response) -> Value {
let bytes = axum::body::to_bytes(resp.into_body(), usize::MAX)
.await
.expect("读取响应体失败");
serde_json::from_slice(&bytes).expect("响应体不是 JSON")
}
#[tokio::test]
async fn product_crud_roundtrip() {
let state = test_state().await;
let spec = registry::find("Product").unwrap();
// 新增
let resp = crud::create(
&state,
spec,
&json!({"name": "测试产品", "productCode": "P-001", "status": "ENABLED"}),
Some(&principal()),
)
.await;
let body = body_of(resp).await;
assert_eq!(body["code"], 200);
assert_eq!(body["msg"], "新增成功");
let id = body["data"].as_str().expect("应返回 id").to_string();
assert!(!id.is_empty());
assert!(id.chars().all(|c| c.is_ascii_digit()), "id 应是雪花号十进制串");
// 列表(关键字)
let mut params = HashMap::new();
params.insert("keyword".to_string(), "测试产品".to_string());
let resp = crud::list(&state, spec, &params, Some(&principal())).await;
let body = body_of(resp).await;
assert_eq!(body["code"], 200);
assert_eq!(body["data"]["pagination"]["total"], 1);
let first = &body["data"]["list"][0];
assert_eq!(first["name"], "测试产品");
assert_eq!(first["productCode"], "P-001");
assert!(first.get("f_name").is_none(), "响应键必须是 camelCase");
// 过滤(category 命中不到 ⇒ total 0)
let mut params = HashMap::new();
params.insert("category".to_string(), "不存在的分类".to_string());
let resp = crud::list(&state, spec, &params, Some(&principal())).await;
let body = body_of(resp).await;
assert_eq!(body["data"]["pagination"]["total"], 0);
// tenantId 拒因
let mut params = HashMap::new();
params.insert("tenantId".to_string(), "x".to_string());
let resp = crud::list(&state, spec, &params, Some(&principal())).await;
let body = body_of(resp).await;
assert_eq!(body["code"], 400);
assert_eq!(
body["msg"],
"身份上下文不可由客户端指定(tenantId),请由固定实例/TDS 授权确定"
);
// 修改
let resp = crud::update(
&state,
spec,
&id,
&json!({"name": "改名后的产品"}),
Some(&principal()),
)
.await;
let body = body_of(resp).await;
assert_eq!(body["code"], 200);
assert_eq!(body["msg"], "修改成功");
let resp = crud::detail(&state, spec, &id, Some(&principal())).await;
let body = body_of(resp).await;
assert_eq!(body["data"]["name"], "改名后的产品");
assert_eq!(body["data"]["productCode"], "P-001", "未传的字段保持原值");
// 删除(逻辑删除)
let resp = crud::delete(&state, spec, &id, Some(&principal())).await;
let body = body_of(resp).await;
assert_eq!(body["code"], 200);
assert_eq!(body["msg"], "删除成功");
let resp = crud::detail(&state, spec, &id, Some(&principal())).await;
let body = body_of(resp).await;
assert_eq!(body["code"], 400);
assert_eq!(body["msg"], "记录不存在或已删除");
}
#[tokio::test]
async fn readonly_and_guarded_entities_reject_writes() {
let state = test_state().await;
// Dataset:派生态只读
let spec = registry::find("Dataset").unwrap();
let resp = crud::create(&state, spec, &json!({"name": "x"}), Some(&principal())).await;
let body = body_of(resp).await;
assert_eq!(body["code"], 400);
assert_eq!(body["msg"], "数据集为只读视图,不支持新增/编辑/删除");
// DeliveryTask:直建入口已废弃
let spec = registry::find("DeliveryTask").unwrap();
let resp = crud::create(&state, spec, &json!({"taskNo": "T-1"}), Some(&principal())).await;
let body = body_of(resp).await;
assert_eq!(body["code"], 400);
assert!(body["msg"]
.as_str()
.unwrap()
.starts_with("该入口已废弃:交付任务只能由发起方经平台发起"));
// AuditLog:允许写,但不许改/删
let spec = registry::find("AuditLog").unwrap();
let resp = crud::create(&state, spec, &json!({"action": "LOGIN"}), Some(&principal())).await;
let body = body_of(resp).await;
assert_eq!(body["code"], 200, "审计日志允许 HTTP 写入:{}", body);
let id = body["data"].as_str().unwrap().to_string();
let resp = crud::update(&state, spec, &id, &json!({"action": "X"}), Some(&principal())).await;
let body = body_of(resp).await;
assert_eq!(body["code"], 400);
assert_eq!(body["msg"], "审计日志不允许修改");
let resp = crud::delete(&state, spec, &id, Some(&principal())).await;
let body = body_of(resp).await;
assert_eq!(body["code"], 400);
assert_eq!(body["msg"], "审计日志不允许删除");
}
#[tokio::test]
async fn delivery_task_frozen_columns_cannot_be_changed() {
let state = test_state().await;
let spec = registry::find("DeliveryTask").unwrap();
// 写入口被上游废弃 ⇒ 测试里直接插一行
{
let _g = state.db_lock.lock().await;
state
.db
.query(
"INSERT INTO tdc_delivery_task (f_id, f_task_no, f_contract_id, f_status, f_creator_time) \
VALUES (CAST('T-1' AS character varying), CAST('TASK-1' AS character varying), \
CAST('C-1' AS character varying), CAST('READY' AS character varying), now())",
&[],
)
.await
.expect("插入测试行失败");
}
// 改冻结列(status)⇒ 拒
let resp = crud::update(
&state,
spec,
"T-1",
&json!({"status": "DONE"}),
Some(&principal()),
)
.await;
let body = body_of(resp).await;
assert_eq!(body["code"], 400);
assert_eq!(
body["msg"],
"不允许修改「任务状态」:该列由平台下发/本端服务写入,不得经编辑入口篡改"
);
// 原样回传(值没变)⇒ 放行
let resp = crud::update(
&state,
spec,
"T-1",
&json!({"status": "READY"}),
Some(&principal()),
)
.await;
let body = body_of(resp).await;
assert_eq!(body["code"], 200, "值没变不应误伤:{}", body);
// 删 ⇒ 拒(审计证据)
let resp = crud::delete(&state, spec, "T-1", Some(&principal())).await;
let body = body_of(resp).await;
assert_eq!(body["code"], 400);
assert_eq!(body["msg"], "交付任务记录是审计证据,不允许删除");
}
#[tokio::test]
async fn resource_detail_aggregate_carries_field_rules_and_mask_rules() {
let state = test_state().await;
let spec = registry::find("Resource").unwrap();
{
let _g = state.db_lock.lock().await;
state
.db
.query(
"INSERT INTO tdc_resource (f_id, f_name, f_resource_code, f_mount_status) \
VALUES (CAST('R-1' AS character varying), CAST('测试资源' AS character varying), \
CAST('RC-1' AS character varying), CAST('MOUNTED' AS character varying))",
&[],
)
.await
.expect("插入资源失败");
state
.db
.query(
"INSERT INTO tdc_resource_field \
(f_id, f_resource_id, f_field_name, f_field_type, f_field_constraint, f_remark, f_sort_code) \
VALUES (CAST('RF-1' AS character varying), CAST('R-1' AS character varying), \
CAST('id_card' AS character varying), CAST('varchar' AS character varying), \
CAST('NOT NULL' AS character varying), CAST('身份证号' AS character varying), 1)",
&[],
)
.await
.expect("插入字段失败");
state
.db
.query(
"INSERT INTO tdc_resource_mask_rule \
(f_id, f_resource_id, f_field_name, f_field_type, f_mask_type, f_origin_value, f_replace_value, f_sort_code) \
VALUES (CAST('RM-1' AS character varying), CAST('R-1' AS character varying), \
CAST('id_card' AS character varying), CAST('STRING' AS character varying), \
CAST('MD5' AS character varying), CAST('13800000000' AS character varying), \
CAST('***' AS character varying), 1)",
&[],
)
.await
.expect("插入脱敏规则失败");
}
let resp = crud::detail_aggregate(&state, spec, "R-1", Some(&principal())).await;
let body = body_of(resp).await;
assert_eq!(body["code"], 200, "聚合详情应成功:{}", body);
let data = &body["data"];
assert_eq!(data["id"], "R-1");
assert_eq!(data["name"], "测试资源");
let fields = data["fieldRules"].as_array().expect("应有 fieldRules 数组");
assert_eq!(fields.len(), 1, "字段子表条数:{}", body);
assert_eq!(fields[0]["fieldName"], "id_card");
assert_eq!(fields[0]["fieldType"], "varchar");
assert_eq!(fields[0]["fieldConstraint"], "NOT NULL");
assert_eq!(fields[0]["remark"], "身份证号");
let masks = data["maskRules"].as_array().expect("应有 maskRules 数组");
assert_eq!(masks.len(), 1, "脱敏子表条数:{}", body);
assert_eq!(masks[0]["fieldName"], "id_card");
assert_eq!(masks[0]["fieldType"], "STRING");
assert_eq!(masks[0]["maskType"], "MD5");
assert_eq!(masks[0]["originValue"], "13800000000");
assert_eq!(masks[0]["replaceValue"], "***");
// 查无 ⇒ 业务失败(HTTP 200 + code != 200)
let resp = crud::detail_aggregate(&state, spec, "R-NOT-EXIST", Some(&principal())).await;
let body = body_of(resp).await;
assert_eq!(body["code"], 400, "查无应是业务失败:{}", body);
}
/// 建一条实体并回读它的某个字段(简化测试样板)。
async fn create_and_read(
state: &tdc_connector::state::AppState,
spec: &'static tdc_connector::registry::TableSpec,
body: &Value,
field: &str,
principal: &Principal,
) -> String {
let resp = crud::create(state, spec, body, Some(principal)).await;
let resp_body = body_of(resp).await;
assert_eq!(resp_body["code"], 200, "新建应成功:{}", resp_body);
let id = resp_body["data"].as_str().expect("应返回 id").to_string();
let resp = crud::detail(state, spec, &id, Some(principal)).await;
let resp_body = body_of(resp).await;
assert_eq!(resp_body["code"], 200, "详情应成功:{}", resp_body);
resp_body["data"][field]
.as_str()
.unwrap_or_else(|| panic!("应有字段 {}:{}", field, resp_body))
.to_string()
}
/// 🔴 上游前端新建 Product **不送** `productCode`,而该列 NOT NULL 且无 DEFAULT
/// ⇒ 服务端必须生成(上游 `TdcCodeUtil`,`PRO-yyyyMMdd-HHmmss-8位序号-8位随机`)。
#[tokio::test]
async fn product_code_is_generated_server_side() {
let state = test_state().await;
let spec = registry::find("Product").unwrap();
let code = create_and_read(
&state,
spec,
&json!({"name": "编码生成产品甲"}),
"productCode",
&principal(),
)
.await;
let parts: Vec<&str> = code.split('-').collect();
assert_eq!(parts.len(), 5, "PRO 码应 5 段:{}", code);
assert_eq!(parts[0], "PRO");
assert_eq!(parts[1].len(), 8, "日期段 8 位:{}", code);
assert!(parts[1].chars().all(|c| c.is_ascii_digit()));
assert_eq!(parts[2].len(), 6, "时分秒段 6 位:{}", code);
assert!(parts[2].chars().all(|c| c.is_ascii_digit()));
assert_eq!(parts[3].len(), 8, "序号段补零到 8 位:{}", code);
assert!(parts[3].chars().all(|c| c.is_ascii_digit()));
assert_eq!(parts[4].chars().count(), 8, "随机尾 8 位:{}", code);
assert!(parts[4].chars().all(|c| c.is_ascii_alphanumeric()));
// 再建一条 ⇒ 两个码必须不同(唯一性)
let code2 = create_and_read(
&state,
spec,
&json!({"name": "编码生成产品乙"}),
"productCode",
&principal(),
)
.await;
assert_ne!(code, code2, "两次生成的码不得相同");
}
/// 上游规则「**空值即生成;显式传入不覆盖**」⇒ body 显式给了码就保留 body 的。
#[tokio::test]
async fn explicit_product_code_is_not_overwritten() {
let state = test_state().await;
let spec = registry::find("Product").unwrap();
let code = create_and_read(
&state,
spec,
&json!({"name": "固定码产品", "productCode": "FIXED-CODE"}),
"productCode",
&principal(),
)
.await;
assert_eq!(code, "FIXED-CODE", "显式传入的码不得被覆盖");
}
/// Datasource 用上游**另一套**生成器(`BizCodeUtil.of("DS")`):3 段、随机尾 6 位。
#[tokio::test]
async fn datasource_code_uses_the_six_char_tail_shape() {
let state = test_state().await;
let spec = registry::find("Datasource").unwrap();
let code = create_and_read(
&state,
spec,
&json!({"name": "码生成数据源", "type": "MYSQL"}),
"datasourceCode",
&principal(),
)
.await;
let parts: Vec<&str> = code.split('-').collect();
assert_eq!(parts.len(), 3, "DS 码应 3 段:{}", code);
assert_eq!(parts[0], "DS");
assert_eq!(parts[1].len(), 8, "日期段 8 位:{}", code);
assert!(parts[1].chars().all(|c| c.is_ascii_digit()));
assert_eq!(parts[2].chars().count(), 6, "随机尾 6 位:{}", code);
assert!(parts[2].chars().all(|c| c.is_ascii_alphanumeric()));
}
/// 🔴 NOT NULL 违约 ⇒ **业务失败**(HTTP 200 + `code=400`),不是 500。
#[tokio::test]
async fn missing_required_field_is_a_business_failure_not_a_500() {
let state = test_state().await;
let spec = registry::find("Product").unwrap();
// 不给 `name`(`f_name` NOT NULL 无 DEFAULT)⇒ 23502
let resp = crud::create(&state, spec, &json!({}), Some(&principal())).await;
let body = body_of(resp).await;
assert_eq!(body["code"], 400, "应是业务失败而非 500:{}", body);
assert!(
body["msg"].as_str().unwrap().contains("必填"),
"msg 应说明必填缺失:{}",
body
);
assert!(body["data"].is_null(), "业务失败的 data 键仍在但为 null");
}
/// 🔴 审计 actor 来自**登录主体**,不再恒为「系统(自动)」。
#[tokio::test]
async fn audit_actor_comes_from_the_login_principal() {
let state = test_state().await;
let spec = registry::find("AuditLog").unwrap();
// 本地账号 ⇒ USER / 账号 id / 账号名
let account = Principal::Account {
account_id: "U-1".to_string(),
account: "张三".to_string(),
};
let resp = crud::create(&state, spec, &json!({"action": "LOGIN"}), Some(&account)).await;
let body = body_of(resp).await;
assert_eq!(body["code"], 200, "{}", body);
let id = body["data"].as_str().unwrap().to_string();
let resp = crud::detail(&state, spec, &id, Some(&account)).await;
let body = body_of(resp).await;
assert_eq!(body["data"]["actorType"], "USER");
assert_eq!(body["data"]["actorId"], "U-1");
assert_eq!(body["data"]["actorName"], "张三");
// 连接器身份会话 ⇒ CONNECTOR / 身份 id / 身份码
let resp = crud::create(&state, spec, &json!({"action": "LOGIN"}), Some(&principal())).await;
let body = body_of(resp).await;
assert_eq!(body["code"], 200, "{}", body);
let id = body["data"].as_str().unwrap().to_string();
let resp = crud::detail(&state, spec, &id, Some(&principal())).await;
let body = body_of(resp).await;
assert_eq!(body["data"]["actorType"], "CONNECTOR");
assert_eq!(body["data"]["actorId"], "TEST-OP");
assert_eq!(body["data"]["actorName"], "TEST-CONNECTOR");
// 内部令牌但没有 operator ⇒ 回落 create_defaults 的兜底
let internal = Principal::Internal { operator: None };
let resp = crud::create(&state, spec, &json!({"action": "LOGIN"}), Some(&internal)).await;
let body = body_of(resp).await;
assert_eq!(body["code"], 200, "{}", body);
let id = body["data"].as_str().unwrap().to_string();
let resp = crud::detail(&state, spec, &id, Some(&internal)).await;
let body = body_of(resp).await;
assert_eq!(body["data"]["actorType"], "CONNECTOR");
assert_eq!(body["data"]["actorName"], "系统(自动)");
}
/// 上游 `ContractController#beforeDelete` **无条件**拒删。
#[tokio::test]
async fn contract_cannot_be_deleted() {
let state = test_state().await;
let spec = registry::find("Contract").unwrap();
let resp = crud::delete(&state, spec, "NO-SUCH-ID", Some(&principal())).await;
let body = body_of(resp).await;
assert_eq!(body["code"], 400, "合约恒拒删:{}", body);
assert!(
body["msg"].as_str().unwrap().contains("不可删除"),
"msg 应含「不可删除」:{}",
body
);
}
/// 🔴 编码生成的**逐实体**参数(重试次数 / 失败文案)等于**上游原文**,且**逐实体不同**
/// (上游 Product/Resource 重试 5 次、DataInterface/Datasource 重试 3 次;文案也各不相同)。
///
/// ⚠️ 「重试耗尽」这条分支**无法在集成层稳定构造**:真实候选带 8 位(`DaySeqTail8`)或
/// 6 位(`DayTail6`)随机尾,撞中一次要枚举十亿级组合 ⇒ 该分支由
/// `src/crud.rs` 里的单元测试(注入恒冲突候选)覆盖;本用例守的是**引擎读到的那份参数**。
#[tokio::test]
async fn code_retry_counts_and_failure_messages_are_per_entity() {
let expected = [
("Product", 5u32, "产品编码生成失败(连续 5 次撞库),请重试"),
("Resource", 5u32, "资源编码生成失败(连续 5 次撞库),请重试"),
("DataInterface", 3u32, "接口编码生成失败(重试 3 次仍冲突)"),
("Datasource", 3u32, "系统标识生成失败(连续 3 次撞库),请重试"),
];
for (api, retries, fail_msg) in expected {
let codes = registry::create_codes(api);
assert_eq!(codes.len(), 1, "{} 应恰好一个编码列", api);
assert_eq!(codes[0].retries, retries, "{} 的重试次数", api);
assert_eq!(codes[0].fail_msg, fail_msg, "{} 的失败文案", api);
}
// 逐实体不同 ⇒ 引擎不可能再用「统一的 5 次 + 统一文案」
let msgs: Vec<&str> = expected.iter().map(|(_, _, m)| *m).collect();
let mut uniq = msgs.clone();
uniq.sort_unstable();
uniq.dedup();
assert_eq!(uniq.len(), 4, "四个实体的失败文案应各不相同:{:?}", msgs);
}