Files
ssw-mvp/docs/tds/DOMAIN_MODEL.md
T
admin 3247e9fd15 init: ssw-mvp initial commit
- 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
2026-08-05 18:29:12 +08:00

6.8 KiB
Raw Blame History

TDS 领域模型 — 可信数据空间管理服务平台

数据库:独立库 tds(PostgreSQL,schema public),通过 @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 控制器的基类,它固化了两件事:

  1. 空间隔离:spaceColumn() 默认返回 "f_space_id",列表/详情/更新/删除全部自动附加空间条件。 全局字典类实体(如内置策略模板)覆写该方法返回 null 退出隔离。
  2. 存活过滤:常量 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