feat(crud): 18 实体表注册表

- TableSpec 承载关键字列/过滤列/租户列/排序列/写入口禁令和冻结列
- DeliveryTask 的 41 个服务端权威列逐字抄自上游 changedAuthorityColumn
- Dataset 用派生谓词只读;ApiConsumeLog 关键字列修正上游 f_name 缺陷

Co-Authored-By: Claude Code <[email protected]>
This commit is contained in:
adminandClaude Code committed 2026-10-24 20:50:12 +08:00
1 parent a86611d4cf
commit 70fe0c5cc2
2 files changed
+576

No files matched your search

+1
View File
@@ -14,6 +14,7 @@ pub mod domain;
pub mod envelope;
pub mod ids;
pub mod protocol;
pub mod registry;
pub mod routes;
pub mod session;
pub mod state;
+575
View File
@@ -0,0 +1,575 @@
//! 18 个实体的表注册表 —— 通用 CRUD 引擎的**唯一**元数据来源。
//!
//! 数据来源:上游 `boot/ssw-tdc/ssw-tdc-controller` 下 18 个 `extends TdcCrudController`
//! 的子类,逐个抄下 `keywordColumns()` / `filterColumns()` / `tenantColumn()` /
//! `defaultOrderColumn()`;2026-10-24 用脚本对全仓 18 个控制器全量提取核对,零差异。
//!
//! 🔴 **有意偏离上游的两处**(上游缺陷,Rust 侧修正,见设计文档 §6):
//! 1. `ApiConsumeLog` 的关键字列不用基类默认的 `f_name`(该表**没有**这一列,
//! 上游一搜就 PG `42703`),改用 `f_order_code/f_app_id/f_product_id`。
//! 2. 过滤一律 `CAST(col AS TEXT) = $1`(上游把 varchar 绑给 smallint 列会 PG 报错),
//! 这条落在 `crud.rs`,注册表本身不变。
use crate::db::valid_table;
/// 不可经编辑入口改写的「服务端权威列」。
#[derive(Debug, Clone, Copy)]
pub struct FrozenColumn {
/// DB 列名。
pub column: &'static str,
/// 中文标签(拒改时回显给调用方)。
pub label: &'static str,
}
/// 一个可 CRUD 实体的元数据。
#[derive(Debug, Clone, Copy)]
pub struct TableSpec {
/// 实体名(路由末段,如 `Product`)。
pub api_name: &'static str,
/// 路由前缀(如 `/api/ssw/tdc/Product`)。
pub path: &'static str,
/// 物理表名(如 `tdc_product`)。
pub table: &'static str,
/// 关键字模糊匹配列(多列 OR)。
pub keyword_columns: &'static [&'static str],
/// 精确过滤:`(请求参数名, DB 列名)`。
pub filter_columns: &'static [(&'static str, &'static str)],
/// 租户列;`Some` 时客户端传 `tenantId` 一律拒(对齐上游 `tenantColumn()` 默认值)。
pub tenant_column: Option<&'static str>,
/// 默认排序列(**倒序**)。
pub default_order_column: &'static str,
/// 附加固定谓词(与 `ALIVE` AND 起来)。
pub extra_where: Option<&'static str>,
/// 禁止新建时的拒因(`None` = 允许)。
pub no_create: Option<&'static str>,
/// 禁止修改时的拒因。
pub no_update: Option<&'static str>,
/// 禁止删除时的拒因。
pub no_delete: Option<&'static str>,
/// 不可经编辑入口改写的列。
pub frozen_columns: &'static [FrozenColumn],
}
/// `DeliveryTask` 的 41 个服务端权威列。
///
/// 逐字抄自上游 `DeliveryTaskController#changedAuthorityColumn()`(2026-10-24 核对)。
/// 判定口径:**只拒「值真的变化」**——前端编辑弹窗会整行回传,按「字段出现即拒」会误伤正常编辑。
pub const DELIVERY_TASK_FROZEN: &[FrozenColumn] = &[
FrozenColumn { column: "f_self_role", label: "本端角色" },
FrozenColumn { column: "f_self_connector_id", label: "本端连接器" },
FrozenColumn { column: "f_provider_connector_id", label: "提供方连接器" },
FrozenColumn { column: "f_consumer_connector_id", label: "使用方连接器" },
FrozenColumn { column: "f_tds_task_id", label: "平台任务号" },
FrozenColumn { column: "f_status_version", label: "状态版本" },
FrozenColumn { column: "f_ready_status", label: "就绪状态" },
FrozenColumn { column: "f_status", label: "任务状态" },
FrozenColumn { column: "f_run_status", label: "运行状态" },
FrozenColumn { column: "f_event_seq", label: "事件序号" },
FrozenColumn { column: "f_app_id", label: "数据面 AppId" },
FrozenColumn { column: "f_app_key", label: "数据面 AppKey" },
FrozenColumn { column: "f_destroy_status", label: "销毁状态" },
FrozenColumn { column: "f_peer_endpoint", label: "对端地址" },
FrozenColumn { column: "f_peer_public_key", label: "对端公钥快照" },
FrozenColumn { column: "f_contract_id", label: "合约" },
FrozenColumn { column: "f_product_id", label: "产品" },
FrozenColumn { column: "f_business_space_id", label: "业务空间" },
FrozenColumn { column: "f_session_status", label: "会话状态" },
FrozenColumn { column: "f_session_end", label: "会话结束时刻" },
FrozenColumn { column: "f_session_pod", label: "会话 Pod" },
FrozenColumn { column: "f_session_start", label: "会话开始时刻" },
FrozenColumn { column: "f_session_expire", label: "会话到期时刻" },
FrozenColumn { column: "f_session_node_port", label: "会话 NodePort" },
FrozenColumn { column: "f_session_control_port", label: "会话控制端口" },
FrozenColumn { column: "f_session_url", label: "会话地址" },
FrozenColumn { column: "f_session_token", label: "会话令牌" },
FrozenColumn { column: "f_sandbox_image", label: "沙箱镜像" },
FrozenColumn { column: "f_sandbox_mode", label: "沙箱形态" },
FrozenColumn { column: "f_export_reject_reason", label: "导出被拒原因" },
FrozenColumn { column: "f_dev_pod_name", label: "工作台Pod" },
FrozenColumn { column: "f_dev_work_ref", label: "工作目录引用" },
FrozenColumn { column: "f_algorithm_hash", label: "算法哈希" },
FrozenColumn { column: "f_dev_url", label: "工作台地址" },
FrozenColumn { column: "f_dev_token", label: "工作台令牌" },
FrozenColumn { column: "f_dev_node_port", label: "工作台NodePort" },
FrozenColumn { column: "f_dev_control_port", label: "工作台控制端口" },
FrozenColumn { column: "f_audit_status", label: "审核状态" },
FrozenColumn { column: "f_audit_opinion", label: "审核意见" },
FrozenColumn { column: "f_audit_user_id", label: "审核人" },
FrozenColumn { column: "f_audit_time", label: "审核时间" },
];
/// 数据集(派生态只读视图)的固定谓词。
///
/// 逐字抄自上游 `DatasetController#buildWrapper`。🔴 `(f_source_kind='DATASOURCE' OR IS NULL)`
/// 必须写全 —— 只写 `='DATASOURCE'` 会让存量 NULL 行**静默消失**。
pub const DATASET_EXTRA_WHERE: &str = "f_status = 'ENABLED' \
AND f_mount_status = 'MOUNTED' \
AND f_dataset_name IS NOT NULL \
AND (f_source_kind = 'DATASOURCE' OR f_source_kind IS NULL) \
AND EXISTS (SELECT 1 FROM tdc_datasource d WHERE d.f_id = tdc_resource.f_datasource_id \
AND d.f_status = 'ENABLED' AND (d.f_delete_mark IS NULL OR d.f_delete_mark = 0))";
/// 全部可 CRUD 实体(上游 18 个 `TdcCrudController` 子类,顺序按路由注册顺序)。
pub static REGISTRY: &[TableSpec] = &[
TableSpec {
api_name: "ApiConsumeLog",
path: "/api/ssw/tdc/ApiConsumeLog",
table: "tdc_api_consume_log",
keyword_columns: &["f_order_code", "f_app_id", "f_product_id"],
filter_columns: &[
("appId", "f_app_id"),
("orderCode", "f_order_code"),
("productId", "f_product_id"),
("deliveryTaskId", "f_delivery_task_id"),
],
tenant_column: Some("f_tenant_id"),
default_order_column: "f_creator_time",
extra_where: None,
no_create: Some("计量明细只读:禁止经泛型 CRUD 新增/修改(「已用」的唯一来源,防旁路污染配额)"),
no_update: Some("计量明细只读:禁止经泛型 CRUD 新增/修改(「已用」的唯一来源,防旁路污染配额)"),
no_delete: Some("计量明细只读:禁止经泛型 CRUD 删除(审计证据不可篡改)"),
frozen_columns: &[],
},
TableSpec {
api_name: "AuditLog",
path: "/api/ssw/tdc/AuditLog",
table: "tdc_audit_log",
keyword_columns: &["f_action", "f_actor_name", "f_target"],
filter_columns: &[
("logType", "f_log_type"),
("bizType", "f_biz_type"),
("bizId", "f_biz_id"),
("actorType", "f_actor_type"),
("actorId", "f_actor_id"),
("result", "f_result"),
("reportMark", "f_report_mark"),
],
tenant_column: Some("f_tenant_id"),
default_order_column: "f_log_time",
extra_where: None,
no_create: None,
no_update: Some("审计日志不允许修改"),
no_delete: Some("审计日志不允许删除"),
frozen_columns: &[],
},
TableSpec {
api_name: "Contract",
path: "/api/ssw/tdc/Contract",
table: "tdc_contract",
keyword_columns: &["f_name", "f_contract_code", "f_product_name", "f_peer_org_name"],
filter_columns: &[
("status", "f_status"),
("role", "f_role"),
("productId", "f_product_id"),
("deliveryType", "f_delivery_type"),
("syncStatus", "f_sync_status"),
("tdsContractId", "f_tds_contract_id"),
],
tenant_column: Some("f_tenant_id"),
default_order_column: "f_creator_time",
extra_where: None,
no_create: None,
no_update: None,
no_delete: None,
frozen_columns: &[],
},
TableSpec {
api_name: "Credential",
path: "/api/ssw/tdc/Credential",
table: "tdc_credential",
keyword_columns: &["f_subject_name", "f_credential_code"],
filter_columns: &[
("subjectType", "f_subject_type"),
("subjectId", "f_subject_id"),
("status", "f_status"),
],
tenant_column: Some("f_tenant_id"),
default_order_column: "f_creator_time",
extra_where: None,
no_create: None,
no_update: None,
no_delete: None,
frozen_columns: &[],
},
TableSpec {
api_name: "DataInterface",
path: "/api/ssw/tdc/DataInterface",
table: "tdc_data_interface",
keyword_columns: &["f_name", "f_interface_code"],
filter_columns: &[("type", "f_type"), ("enabledMark", "f_enabled_mark")],
tenant_column: Some("f_tenant_id"),
default_order_column: "f_creator_time",
extra_where: None,
no_create: None,
no_update: None,
no_delete: None,
frozen_columns: &[],
},
TableSpec {
api_name: "Dataset",
path: "/api/ssw/tdc/Dataset",
table: "tdc_resource",
keyword_columns: &["f_dataset_name"],
filter_columns: &[],
tenant_column: Some("f_tenant_id"),
default_order_column: "f_creator_time",
extra_where: Some(DATASET_EXTRA_WHERE),
no_create: Some("数据集为只读视图,不支持新增/编辑/删除"),
no_update: Some("数据集为只读视图,不支持新增/编辑/删除"),
no_delete: Some("数据集为只读视图,不支持新增/编辑/删除"),
frozen_columns: &[],
},
TableSpec {
api_name: "Datasource",
path: "/api/ssw/tdc/Datasource",
table: "tdc_datasource",
keyword_columns: &["f_name", "f_datasource_code", "f_host", "f_db_name"],
filter_columns: &[
("type", "f_type"),
("status", "f_status"),
("testStatus", "f_test_status"),
("ownerDept", "f_owner_dept"),
],
tenant_column: Some("f_tenant_id"),
default_order_column: "f_creator_time",
extra_where: None,
no_create: None,
no_update: None,
no_delete: None,
frozen_columns: &[],
},
TableSpec {
api_name: "DeliveryLog",
path: "/api/ssw/tdc/DeliveryLog",
table: "tdc_delivery_log",
keyword_columns: &["f_step", "f_message"],
filter_columns: &[("taskId", "f_task_id"), ("step", "f_step"), ("level", "f_level")],
tenant_column: Some("f_tenant_id"),
default_order_column: "f_log_time",
extra_where: None,
no_create: None,
no_update: None,
no_delete: Some("交付日志是审计证据,不允许删除"),
frozen_columns: &[],
},
TableSpec {
api_name: "DeliveryTask",
path: "/api/ssw/tdc/DeliveryTask",
table: "tdc_delivery_task",
keyword_columns: &["f_task_no", "f_contract_code", "f_product_name", "f_consumer_org_name"],
filter_columns: &[
("status", "f_status"),
("contractId", "f_contract_id"),
("productId", "f_product_id"),
("deliveryType", "f_delivery_type"),
("triggerType", "f_trigger_type"),
("policyResult", "f_policy_result"),
("reportStatus", "f_report_status"),
("auditStatus", "f_audit_status"),
("runStatus", "f_run_status"),
("contractCode", "f_contract_code"),
("spaceId", "f_space_id"),
],
tenant_column: Some("f_tenant_id"),
default_order_column: "f_creator_time",
extra_where: None,
no_create: Some(
"该入口已废弃:交付任务只能由发起方经平台发起(DATASET=提供方 / API·沙箱=使用方);\
直建会产生「平台无权威行」的孤儿任务并导致合约永久闸死",
),
no_update: None,
no_delete: Some("交付任务记录是审计证据,不允许删除"),
frozen_columns: DELIVERY_TASK_FROZEN,
},
TableSpec {
api_name: "DestroyLog",
path: "/api/ssw/tdc/DestroyLog",
table: "tdc_destroy_log",
keyword_columns: &["f_task_no", "f_resource_uri", "f_reason"],
filter_columns: &[("taskId", "f_task_id"), ("method", "f_method"), ("operator", "f_operator")],
tenant_column: Some("f_tenant_id"),
default_order_column: "f_creator_time",
extra_where: None,
no_create: Some("销毁日志由系统自动记录,不可手工创建"),
no_update: None,
no_delete: Some("销毁日志是合规存证,不可删除"),
frozen_columns: &[],
},
TableSpec {
api_name: "Identity",
path: "/api/ssw/tdc/Identity",
table: "tdc_identity",
keyword_columns: &["f_name", "f_identity_code", "f_subject_name", "f_tds_space_name"],
filter_columns: &[
("status", "f_status"),
("registerStatus", "f_register_status"),
("deployMode", "f_deploy_mode"),
("tdsSpaceId", "f_tds_space_id"),
("defaultMark", "f_default_mark"),
],
tenant_column: None,
default_order_column: "f_creator_time",
extra_where: None,
no_create: None,
no_update: None,
no_delete: None,
frozen_columns: &[],
},
TableSpec {
api_name: "Notification",
path: "/api/ssw/tdc/Notification",
table: "tdc_notify",
keyword_columns: &["f_title", "f_content", "f_biz_type"],
filter_columns: &[
("type", "f_type"),
("level", "f_level"),
("receiver", "f_receiver"),
("readMark", "f_read_mark"),
("bizType", "f_biz_type"),
("bizId", "f_biz_id"),
],
tenant_column: Some("f_tenant_id"),
default_order_column: "f_creator_time",
extra_where: None,
no_create: None,
no_update: None,
no_delete: None,
frozen_columns: &[],
},
TableSpec {
api_name: "Order",
path: "/api/ssw/tdc/Order",
table: "tdc_order",
keyword_columns: &["f_order_code", "f_product_name", "f_buyer_name", "f_seller_name"],
filter_columns: &[
("status", "f_status"),
("buyerId", "f_buyer_id"),
("sellerId", "f_seller_id"),
("productId", "f_product_id"),
("deliveryType", "f_delivery_type"),
],
tenant_column: Some("f_tenant_id"),
default_order_column: "f_creator_time",
extra_where: None,
no_create: None,
no_update: None,
no_delete: None,
frozen_columns: &[],
},
TableSpec {
api_name: "Policy",
path: "/api/ssw/tdc/Policy",
table: "tdc_policy",
keyword_columns: &["f_name", "f_contract_id"],
filter_columns: &[
("contractId", "f_contract_id"),
("policyType", "f_policy_type"),
("enabledMark", "f_enabled_mark"),
],
tenant_column: Some("f_tenant_id"),
default_order_column: "f_creator_time",
extra_where: None,
no_create: None,
no_update: None,
no_delete: None,
frozen_columns: &[],
},
TableSpec {
api_name: "PolicyCheckLog",
path: "/api/ssw/tdc/PolicyCheckLog",
table: "tdc_policy_check_log",
keyword_columns: &["f_check_no", "f_requester_code"],
filter_columns: &[
("contractId", "f_contract_id"),
("productId", "f_product_id"),
("taskId", "f_task_id"),
("result", "f_result"),
],
tenant_column: Some("f_tenant_id"),
default_order_column: "f_creator_time",
extra_where: None,
no_create: None,
no_update: None,
no_delete: Some("策略评估流水是审计证据,不允许删除"),
frozen_columns: &[],
},
TableSpec {
api_name: "PolicyTemplate",
path: "/api/ssw/tdc/PolicyTemplate",
table: "tdc_policy_template",
keyword_columns: &["f_name"],
filter_columns: &[],
tenant_column: Some("f_tenant_id"),
default_order_column: "f_creator_time",
extra_where: None,
no_create: None,
no_update: None,
no_delete: None,
frozen_columns: &[],
},
TableSpec {
api_name: "Product",
path: "/api/ssw/tdc/Product",
table: "tdc_product",
keyword_columns: &["f_name", "f_product_code", "f_resource_name", "f_tags"],
filter_columns: &[
("resourceId", "f_resource_id"),
("identityId", "f_identity_id"),
("tdsSpaceId", "f_tds_space_id"),
("tdsProductId", "f_tds_product_id"),
("category", "f_category"),
("deliveryType", "f_delivery_type"),
("publishStatus", "f_publish_status"),
("status", "f_status"),
],
tenant_column: Some("f_tenant_id"),
default_order_column: "f_creator_time",
extra_where: None,
no_create: None,
no_update: None,
no_delete: None,
frozen_columns: &[],
},
TableSpec {
api_name: "Resource",
path: "/api/ssw/tdc/Resource",
table: "tdc_resource",
keyword_columns: &["f_name"],
filter_columns: &[
("datasourceId", "f_datasource_id"),
("resourceType", "f_resource_type"),
("category", "f_category"),
("classifyLevel", "f_classify_level"),
("sensitiveMark", "f_sensitive_mark"),
("status", "f_status"),
("sourceType", "f_source_type"),
],
tenant_column: Some("f_tenant_id"),
default_order_column: "f_creator_time",
extra_where: None,
no_create: None,
no_update: None,
no_delete: None,
frozen_columns: &[],
},
];
/// 按实体名查注册表。
pub fn find(api_name: &str) -> Option<&'static TableSpec> {
REGISTRY.iter().find(|s| s.api_name == api_name)
}
/// 注册表自检:所有表名必须过白名单(防拼接注入)。
pub fn validate() -> Result<(), String> {
for spec in REGISTRY {
if valid_table(spec.table).is_none() {
return Err(format!("注册表表名非法: {}", spec.table));
}
for (pname, col) in spec.filter_columns {
if valid_table(col).is_none() {
return Err(format!("注册表过滤列非法: {}.{}", spec.table, col));
}
let _ = pname;
}
}
Ok(())
}
/// 新增时由**服务端**补齐的默认值:`(camelCase JSON 键, 常量文本)`。
///
/// `{id}` 会被替换成本次新生成的雪花号 id。请求体已经给了的键**不覆盖**。
///
/// 目前只有 `AuditLog` 需要:上游 `TdcAuditLogServiceImpl#appendChain` 在 `beforeSave` 里
/// 补 `logNo / result / logType / actorType / actorName / reportMark`,
/// Rust 侧照抄这批**非哈希链**默认值(`seqNo / prevHash / hash` 属哈希链 ⇒ P2 再补)。
pub fn create_defaults(api_name: &str) -> &'static [(&'static str, &'static str)] {
match api_name {
"AuditLog" => &[
("logNo", "{id}"),
("result", "SUCCESS"),
("logType", "OPERATION"),
("actorType", "CONNECTOR"),
("actorName", "系统(自动)"),
("reportMark", "0"),
],
_ => &[],
}
}
/// 新增时由服务端补 `now()` 的列(camelCase JSON 键);请求体已给则不补。
pub fn create_now_columns(api_name: &str) -> &'static [&'static str] {
match api_name {
"AuditLog" => &["logTime"],
_ => &[],
}
}
#[cfg(test)]
mod tests {
use super::*;
use std::collections::HashSet;
#[test]
fn registry_has_exactly_18_entities_with_unique_paths() {
assert_eq!(REGISTRY.len(), 18);
let mut paths = HashSet::new();
for s in REGISTRY {
assert!(paths.insert(s.path), "路径重复: {}", s.path);
assert!(s.path.starts_with("/api/ssw/tdc/"), "路径前缀错: {}", s.path);
assert!(valid_table(s.table).is_some(), "表名非法: {}", s.table);
}
}
#[test]
fn identity_has_no_tenant_column_and_others_do() {
assert!(find("Identity").unwrap().tenant_column.is_none());
assert_eq!(find("Product").unwrap().tenant_column, Some("f_tenant_id"));
}
#[test]
fn api_consume_log_keyword_columns_exist_in_its_table() {
// 上游用基类默认的 f_name,但 tdc_api_consume_log 没有该列 —— Rust 侧必须改掉
let s = find("ApiConsumeLog").unwrap();
assert!(!s.keyword_columns.contains(&"f_name"));
assert_eq!(s.keyword_columns, &["f_order_code", "f_app_id", "f_product_id"]);
}
#[test]
fn dataset_is_readonly_with_derived_predicate() {
let s = find("Dataset").unwrap();
assert_eq!(s.table, "tdc_resource");
assert!(s.no_create.is_some() && s.no_update.is_some() && s.no_delete.is_some());
assert!(s.extra_where.unwrap().contains("f_mount_status = 'MOUNTED'"));
}
#[test]
fn delivery_task_freezes_forty_one_authority_columns() {
let s = find("DeliveryTask").unwrap();
assert_eq!(s.frozen_columns.len(), 41);
assert_eq!(s.frozen_columns[0].label, "本端角色");
assert_eq!(s.frozen_columns[0].column, "f_self_role");
assert!(s.no_create.is_some(), "上游已废弃直建入口");
assert!(s.no_delete.is_some(), "交付任务是审计证据");
}
#[test]
fn log_tables_are_write_guarded() {
assert!(find("AuditLog").unwrap().no_update.is_some());
assert!(find("AuditLog").unwrap().no_delete.is_some());
assert!(find("AuditLog").unwrap().no_create.is_none(), "审计日志允许 HTTP 写入");
assert!(find("DeliveryLog").unwrap().no_delete.is_some());
assert!(find("PolicyCheckLog").unwrap().no_delete.is_some());
assert!(find("DestroyLog").unwrap().no_create.is_some());
assert!(find("ApiConsumeLog").unwrap().no_create.is_some());
}
#[test]
fn audit_log_has_server_side_create_defaults() {
let defaults = create_defaults("AuditLog");
assert!(defaults.iter().any(|(k, v)| *k == "logType" && *v == "OPERATION"));
assert!(defaults.iter().any(|(k, v)| *k == "result" && *v == "SUCCESS"));
assert_eq!(create_now_columns("AuditLog"), &["logTime"]);
assert!(create_defaults("Product").is_empty());
assert!(create_now_columns("Product").is_empty());
}
}