Files
ssw-mvp/docs/tdc/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

7.6 KiB
Raw Blame History

TDC 领域模型 — 数据接入连接器

数据库:独立库 tdc(PostgreSQL,schema public),通过 @DS("tdc") 路由。 TDC 的定位是部署在数据持有方本地的组件,因此库、路由、前端页面、API 前缀全部独立, 将来单独打包成连接器控制台时可整体搬走,不依赖 TDS 的任何模块。


1. 领域全景

TDC 管的是"本地这一侧"的事:我是谁、我有什么数据、我对外开放什么、别人怎么取。

   ┌───────────────┐   注册/心跳    ┌──────────┐
   │  连接器身份    │ ────────────▶ │   TDS    │
   │ tdc_identity  │ ◀──────────── │  管理平台 │
   └───────┬───────┘   合约下发     └──────────┘
           │
   ┌───────▼───────┐    ┌──────────────┐    ┌───────────────┐
   │  本地数据源    │───▶│   数据资源    │───▶│  本地数据产品  │
   │tdc_datasource │    │ tdc_resource │    │  tdc_product  │
   └───────────────┘    └──────────────┘    └───────┬───────┘
                                                    │ 发布
   ┌───────────────┐    ┌──────────────────┐        ▼
   │   交付任务     │◀───│   本地合约副本    │◀── TDS 生效合约同步
   │tdc_delivery_  │    │  tdc_contract    │
   │    task       │    └──────────────────┘
   └───────┬───────┘
           │ 每次出域前强制策略判定
           ▼
   ┌────────────────────┐
   │ tdc_policy_check_log│
   └────────────────────┘

2. 核心实体

表 列数 聚合根 说明
tdc_identity 39 ✔ 连接器身份与证书,注册到 TDS 的凭证;同一时刻仅一个默认身份
tdc_datasource 30 ✔ 本地数据源连接配置,凭据只落本地不出域
tdc_resource 35 ✔ 从数据源同步的表/视图/接口/文件,须完成分类分级
tdc_resource_field 24 资源字段明细与敏感标记
tdc_product 37 ✔ 本地数据产品(资源 + 脱敏 + 过滤 + 开放字段),发布到 TDS
tdc_mask_rule 20 脱敏规则库
tdc_api_service 28 API 型交付的服务定义
tdc_contract 34 ✔ TDS 生效合约在本地的执行副本,交付准入唯一依据
tdc_policy 25 合约携带的使用控制策略本地副本
tdc_delivery_task 36 ✔ 数据交付任务,一次出域一条
tdc_delivery_log 17 交付过程日志
tdc_policy_check_log 27 策略判定留痕(判定依据、结论、拒绝原因)
tdc_audit_log 31 ✔ 连接器本地审计
tdc_sync_log 24 与 TDS 的同步流水

系统列与软删除规则同 TDS(f_delete_mark=1 + f_delete_mark IS NULL)。

3. 隔离规则

TdcCrudController<T> 为所有 TDC 控制器基类:

  • tenantColumn() 默认 "f_tenant_id" —— TDC 是本地部署组件,隔离维度是租户而非空间
  • 同样固化 ALIVE 存活过滤

这与 TDS 按 f_space_id 隔离是两套不同的维度,不要互相套用。

4. 身份注册状态机

  UNREGISTERED ──配置证书──▶ (可注册)
        │
        └─ Register ──▶ REGISTERING ──RegisterCallback──┬──▶ REGISTERED ──▶ 可心跳
                                                        └──▶ REJECTED

强约束(均已烟测验证):

  1. 未配置 f_cert_pem 不允许发起注册 —— mTLS 双向认证要求连接器持证
  2. 未达 REGISTERED 不允许心跳 —— 心跳接口直接拒绝
  3. Register 只把状态推到 REGISTERING,真正置 REGISTERED 的是 TDS 审批完成后的 RegisterCallback
  4. 心跳成功后 f_status=ONLINE、f_heartbeat_fail_count=0,默认间隔 5 秒

5. 产品发布状态机

  DRAFT ──Publish──▶ PUBLISHING ──PublishCallback──┬──▶ PUBLISHED ──Offline──▶ OFFLINE
    ▲                                              └──▶ REJECTED
    └──────────────────────────────────────────────────────┘(可重新发布)

本地 f_publish_status 与 TDS 侧产品上架状态是两套独立状态,靠 f_tds_product_id 关联,不要混用。

6. 交付任务状态机 —— 策略判定前置

  PENDING ──Policy──┬── ALLOW/LIMIT/OBLIGATION ──▶ RUNNING ──Finish──┬──▶ SUCCESS ──Report──▶ 已上报
                    │                                                └──▶ FAIL
                    └── DENY ──▶ DENIED(立即终止,不产生任何结果数据)
判定结果 含义 后续
ALLOW 放行 进入 RUNNING
DENY 拒绝 直接 DENIED,f_result_uri 保持 NULL
LIMIT 限制放行 进入 RUNNING,按限制条件裁剪
OBLIGATION 附义务放行 进入 RUNNING,附带义务履行要求

强约束:

  • DENY 时必须写明原因,否则接口拒绝
  • 已 DENIED / CANCELLED 的任务不允许再回填结果
  • 交付任务记录是审计证据,不允许删除(后端硬拒绝,前端连按钮都不给)

7. 合约副本准入检查

PUT /Contract/{id}/Effective 返回三项独立判定,全真才可交付:

{ "effective": true, "statusOk": true, "periodOk": true, "quotaOk": true, "status": "02" }
  • statusOk —— 合约状态为 02 已生效
  • periodOk —— 当前时间在生效期与到期时间之间
  • quotaOk —— f_quota_used < f_quota_total

合约副本不允许在连接器侧新建或删除:合约只能由 TDS 下发,本地只做同步/检查/消耗配额。

8. 接口约定

统一前缀 /api/ssw/tdc/{Module},CRUD 端点与 TDS 同构。业务动作:

模块 动作
Identity Default / Register / RegisterCallback / Heartbeat
Datasource Types(GET) / Test / Sync
Resource Classify / Sync
Product Publish / PublishCallback / Offline
Contract Sync / Effective / Consume
DeliveryTask Policy / Finish / Report / Cancel

支持的数据源类型(GET /Datasource/Types 为准): MYSQL、POSTGRESQL、ORACLE、SQLSERVER、DM、KINGBASE、CLICKHOUSE、DORIS、HIVE、MONGODB、API、FILE。

9. 已验证行为

/tmp/ssw_tds_tdc_smoke.js TDC 侧覆盖:

  • 建身份 → 设默认 → 未注册禁止心跳(反例)→ 无证书禁止注册(反例) → 配证书 → Register(REGISTERING) → RegisterCallback(REGISTERED) → 心跳(ONLINE)
  • 数据源建档 → 连通测试 → 资源建档 → 分类分级(SENSITIVE)
  • 产品发布 → 发布回调 → 合约同步(02) → 准入检查三项全真 → 消耗配额
  • 交付放行链路:Policy(ALLOW) → Finish(SUCCESS) → Report
  • 交付拒绝链路:Policy(DENY) → 状态 DENIED 且 resultUri=null