- 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
7.6 KiB
7.6 KiB
TDC 领域模型 — 数据接入连接器
数据库:独立库
tdc(PostgreSQL,schemapublic),通过@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
强约束(均已烟测验证):
- 未配置
f_cert_pem不允许发起注册 —— mTLS 双向认证要求连接器持证 - 未达 REGISTERED 不允许心跳 —— 心跳接口直接拒绝
Register只把状态推到REGISTERING,真正置REGISTERED的是 TDS 审批完成后的RegisterCallback- 心跳成功后
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