135880aab67ae1a0c19e677ee1a1354637456f43
尚数网可信数据空间(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 目前以
fulljar +application-j7node.yml(只声明 tdc+sswflow 数据源)运行,TdcTdsClient因未配ssw.tds.base-url走Noop——运行时零 TDS 查询,符合红线。后续可构建 tdc+sswflow-only jar 进一步消除日志噪音(见 VM_DEPLOY §9)。
文档导航
docs/arch/ARCHITECTURE.md— 工程总览 + 三子系统边界(职责表/架构图/13 步流程)AGENTS.md— AI agent 操作红线、命令速查、DB 铁律docs/scard/VM_DEPLOY.md— scard 安全平面 + j7node k3s 业务栈部署docs/README.md— 文档中心索引
Languages
Java
52.6%
Vue
17.7%
Go
13.5%
Python
7.1%
TypeScript
3.7%
Other
5.3%