尚数网可信数据空间(SSW / SSWFlow)

对标国家标准的可信数据空间体系,在 SSWFlow 隐私计算编排平台之上构建。核心特征:数据不经平台——平台只流转元数据/合约/控制指令,实际数据在 TDC(数据持有方)之间点对点交付,或在密态计算底座中"可用不可见"。

完整工程视角与三子系统边界见 docs/arch/ARCHITECTURE.md §2;给 AI 编码 agent 的操作红线见 AGENTS.md;文档总索引见 docs/README.md。

三子系统边界(速览)

代号 全称 职责 Maven 模块 业务库 @DS API 前缀
TDS 可信数据空间管理服务平台 运营方中枢:身份·空间·连接器·目录·合约·授权·计量·存证 ssw-tds tds @DS("tds") /api/ssw/tds
TDC 数据接入连接器 数据持有方本地代理:接入数据源·封装产品·交付·使用控制 ssw-tdc tdc @DS("tdc") /api/ssw/tdc
SSWFLOW 隐私计算流程编排引擎 密态计算执行后端:DAG 编排·运行引擎·Nax 算子·产物 ssw-sswflow-{entity,biz,controller} sswflow @DS("sswflow") /api/ssw/sswflow

三库物理隔离(同 PostgreSQL 实例,各自独立数据库):j7(JNPF 主库) / tds / tdc / sswflow,表前缀 tds_* / tdc_* / flow_*,均建于 public schema。

关键原则与红线

  • 🚫 禁止编译期跨边界耦合。 任一子系统模块(如 ssw-tdc-*)的 pom 不得依赖另一子系统的 -*controller/-*biz/-*entity;跨系统读/写只经各子系统的 HTTP Client 抽象(见下),绝不允许 import 对方 Service/Entity/Mapper。
  • 🔌 跨子系统仅走 HTTP 契约,现有解耦客户端:
    • TdcTdsClient(TDC→TDS,配 ssw.tds.base-url 走 HttpTdcTdsClient,缺则 NoopTdcTdsClient 降级)
    • TdcSswflowClient(TDC→SSWFLOW)
    • SswflowClient(TDS→SSWFLOW)
    • TdsCallbackClient(SSWFLOW→TDS 回调)
  • 🗄️ @DS 严格模式:Mapper 与 ServiceImpl 都必须显式标注本子系统 @DS;ssw-tdc 模块内零 @DS("tds")。
  • 🔒 TDC 正式部署落在 scard 安全平面(软 PKI + 软 TPM,数据可用不可见),不当普通 web 服务裸跑。

部署形态矩阵

形态 Maven profile 连哪些业务库 场景
运营主节点 full(默认) tds + tdc + sswflow 运营方全量中枢
纯 TDC 数据持有方 tdc-only tdc 正式 TDC 节点(scard 安全平面)
j7node(TDC+SSWFLOW 开发/演示节点) 当前 full jar tdc + sswflow(不连 tds) VM 内 k3s 业务栈;TdcTdsClient→Noop,不提供 TDS 服务。详情见 docs/scard/VM_DEPLOY.md
密态计算节点 sswflow-only(2026-08-13 预留) sswflow 预留

j7node 目前以 full jar + application-j7node.yml(只声明 tdc+sswflow 数据源)运行,TdcTdsClient 因未配 ssw.tds.base-url 走 Noop——运行时零 TDS 查询,符合红线。后续可构建 tdc+sswflow-only jar 进一步消除日志噪音(见 VM_DEPLOY §9)。

文档导航

S
Description
SSW MVP - 尚数网项目主仓库
Readme
192 MiB
0 Stars 1 Watchers 0 Forks
Languages
Java 52.6%
Vue 17.7%
Go 13.5%
Python 7.1%
TypeScript 3.7%
Other 5.3%