- boot/ (Java/Maven, JNPF 7.0) — 移除旧的 boot/.git,源码直接纳入仓库
- web/ (Vue 3 + Vite + Ant Design Vue, pnpm)
- docs/, scard/, nax/
- refs/INDEX.md + refs/国标/(其余 refs/* 开源子仓库不纳入)
- 已忽略: connector_data/, jweb/, log/, web/{dist,node_modules,.pnpm}, boot/*/target/, .DS_Store, .idea, .vscode
6.8 KiB
TDS 领域模型 — 可信数据空间管理服务平台
数据库:独立库
tds(PostgreSQL,schemapublic),通过@DS("tds")路由。 与sswflow、tdc三库物理隔离,任何跨子系统访问必须走 HTTP 接口,不允许跨库 join。
1. 领域全景
TDS 是数据空间的"管理侧",管的是谁能进来、能挂什么、按什么规则用、用了留什么证据四件事。 对应四条主线:
┌──────────────┐
│ 数据空间 │ tds_space
│ (运营方) │
└──────┬───────┘
┌───────────────┼───────────────┐
▼ ▼ ▼
┌──────────────┐ ┌─────────────┐ ┌──────────────┐
│ 连接器接入 │ │ 数据产品 │ │ 使用控制策略 │
│ tds_connector│ │ tds_data_ │ │ tds_policy_ │
│ │ │ product │ │ template │
└──────┬───────┘ └──────┬──────┘ └──────┬───────┘
└────────────────┼───────────────┘
▼
┌──────────────┐
│ 数字合约 │ tds_contract
│ (双签生效) │
└──────┬───────┘
▼
┌──────────────┐
│ 审计留痕 │ tds_audit_log
│ (哈希链) │
└──────────────┘
2. 核心实体
| 表 | 列数 | 聚合根 | 说明 |
|---|---|---|---|
tds_space |
31 | ✔ | 数据空间。所有业务数据以 f_space_id 归属,是租户隔离的第一维度 |
tds_space_member |
28 | 空间成员(参与机构)名单与角色 | |
tds_connector |
42 | ✔ | 连接器接入登记,审批通过后方可上线;心跳 5 秒 |
tds_data_product |
45 | ✔ | 数据产品目录,产品标识 C..65 |
tds_policy_template |
27 | ✔ | 使用控制策略模板(国标 34 种 + 组合模板) |
tds_policy_instance |
25 | 策略在具体合约上的实例化取值 | |
tds_contract |
48 | ✔ | 数字合约,合约标识 C..47,状态机见 §4 |
tds_contract_sign |
27 | 签署流水(供需双方各一条),签署延迟 ≤1 秒 | |
tds_contract_change |
27 | 变更记录,合约内容变更须重新签署 | |
tds_order |
34 | 数据交易订单 | |
tds_delivery_record |
29 | 交付记录(由 TDC 上报汇聚) | |
tds_audit_log |
35 | ✔ | 审计日志,SHA-256 哈希链,留存 ≥180 天 |
tds_audit_record |
26 | 审计事件明细 | |
tds_chain_evidence |
26 | 存证上链记录 |
所有表继承 9 个系统列(f_id / f_creator_time / f_creator_user_id / f_last_modify_time / f_last_modify_user_id / f_delete_mark / f_delete_time / f_delete_user_id / f_sort_code)。
软删除统一走 f_delete_mark=1,查询一律附加 f_delete_mark IS NULL。
3. 隔离规则
TdsCrudController<T> 是所有 TDS 控制器的基类,它固化了两件事:
- 空间隔离:
spaceColumn()默认返回"f_space_id",列表/详情/更新/删除全部自动附加空间条件。 全局字典类实体(如内置策略模板)覆写该方法返回null退出隔离。 - 存活过滤:常量
ALIVE=f_delete_mark IS NULL,拼进每个 QueryWrapper。
泛型擦除后拿不到字段的 lambda 引用,所以基类里的条件一律用字符串列名写 QueryWrapper。
4. 合约状态机(国标编码)
01 待签署 ──签署(供)──▶ 0301 供方已签 ──┐
│ ├──▶ 02 已生效 ──▶ 05 已终止
└──签署(需)──▶ 0302 需方已签 ────────┘ │
└──▶ 06 已到期
| 编码 | 含义 | 允许的后继 |
|---|---|---|
01 |
待签署 | 0301 / 0302 |
0301 |
提供方已签 | 02(待需方签完) |
0302 |
使用方已签 | 02(待供方签完) |
02 |
已生效 | 05 / 06 |
05 |
已终止 | — |
06 |
已到期 | — |
约束:生效中(02)的合约不允许删除,必须先终止。
5. 使用控制策略基线
国标要求策略种类 ≥34、组合模板 ≥10、单合约可组合策略 ≥20。种子数据在
boot/db/tds/V1.0.1__tds_policy_seed.sql:
分类 f_category |
数量 | 编码区间 | sort |
|---|---|---|---|
CONSTRAINT 约束类 |
16 | pt_c01 ~ pt_c16 |
1–16 |
ACTION 行为类 |
18 | pt_a17 ~ pt_a34 |
17–34 |
TEMPLATE 组合模板 |
12 | pt_t01 ~ pt_t12 |
101–112 |
内置策略 f_builtin_mark=1、f_space_id=NULL(全局可见)。
内置策略不允许删除,只能停用 —— 删除会被后端直接拒绝。
GET /PolicyTemplate/Catalog 按三桶精确返回并给出 baselineSatisfied,前端策略页顶部据此显示达标提示。
6. 审计哈希链
tds_audit_log 每条记录写入时:
f_log_no自动生成:LOG+yyyyMMddHHmmssSSS+ 4 位随机(后端beforeSave兜底,不依赖调用方)f_prev_hash取上一条的f_hash,f_hash = SHA-256(前序哈希 + 本条关键字段)- 审计日志不允许删除
GET /AuditLog/Verify?spaceId=xxx 逐条重算校验,返回 { total, checked, intact, brokenAt, brokenReason, retentionDays }。
7. 接口约定
统一前缀 /api/ssw/tds/{Module},CRUD 由基类提供:
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /{Module} |
分页列表 |
| GET | /{Module}/All |
全量列表 |
| GET | /{Module}/{id} |
详情 |
| POST | /{Module} |
新建 |
| PUT | /{Module}/{id} |
更新 |
| DELETE | /{Module}/{id} |
软删除 |
业务动作一律 PUT /{Module}/{id}/{Action},如 /Connector/{id}/Audit、/Contract/{id}/Sign。
8. 已验证行为
/tmp/ssw_tds_tdc_smoke.js 端到端烟测覆盖(62/62 通过),TDS 侧包含:
- 建空间 → 连接器接入审批 → 心跳 → 产品提交/审核/上架 → 策略基线校验
- 合约双签:
01→(供签)→(需签)→02已生效 - 审计写入 + 哈希链校验
intact=true - 约束反例:空间编码唯一、内置策略禁删、生效合约禁删、审计禁删、产品标识 C..65、合约标识 C..47