- 来历:9340b3d 曾在本地作为 main 的 HEAD(从未 push),后按决策 reset --soft 改写掉并把 boot/ 还原为原 MaxKey 方案 —— 故它不属于 main 历史,该分支是唯一留存 - 内容清单:仅 2 个文件(application.yml + SsoBindController.java),基线f9d8169- 取回:git difff9d8169sso-real-token-9340b3d -- boot/ | git apply - 明确「长期备份,不要在其上直接开发」+ 确认不采用时的删除命令 - 顶部「代码落地状态」的分支说明改为指向 §8
尚数网可信数据空间 — 文档索引
本目录是「尚数网可信数据空间」(Shangshuwang Trusted Data Space)的需求与设计文档中心。
需求基线(必须实现,不可裁剪)
| 文件 | 说明 | 地位 |
|---|---|---|
功能清单.md |
19 个章节、约 100 个功能点,覆盖服务平台与接入连接器 | 需求基线 A |
附件1:技术协议_可信数据空间_0512.docx |
吉利控股 2026 年可信数据空间平台能力建设项目技术协议,38 个功能点 + 非功能要求 + 验收标准 | 需求基线 B |
两份文档是合同级需求,全部功能点必须实现。所有设计文档中的需求条目都带
[FL-x.y](功能清单)或[TP-n](技术协议)编号,可双向追溯。
文档结构
docs/
├── README.md # 本文件:索引与阅读顺序
├── 功能清单.md # 需求基线 A
├── 附件1:技术协议_*.docx # 需求基线 B
│
├── arch/ # 全局架构
│ ├── ARCHITECTURE.md # 三子系统总体架构、部署形态、通信协议
│ ├── REQUIREMENT_MATRIX.md # 需求追溯矩阵(功能清单 × 技术协议 × 模块 × 状态)
│ └── MIGRATION.md # sswflow → 尚数网可信数据空间 升级方案
│
├── tds/ # 可信数据空间管理服务平台
│ ├── REQUIREMENTS.md # 需求规格
│ └── DOMAIN_MODEL.md # 领域模型与库表设计
│
├── tdc/ # 数据接入连接器
│ ├── REQUIREMENTS.md # 需求规格
│ └── DOMAIN_MODEL.md # 领域模型与库表设计
│
├── tdd/ # TDD 验证报告与端到端烟测
│ ├── P1P2_CHAIN_K8S_REPORT.md # P1/P2:飞梭链存证 + k8s 沙箱/TEE 落地与验证(核心)
│ ├── P1P2_GAP_REPORT.md # P1/P2 能力缺口分析
│ ├── P0_GAP_REPORT.md # P0 缺口分析
│ └── B1~B7_REPORT.md # 绿色场景端到端验证报告
│
├── security/ # 安全平面(scard)
│ └── SECURITY_PLANE.md # 根密钥/安全启动/远程证明/隧道/通讯加密/国密,软实现与端到端跑通
└── sswflow/ # 隐私计算流程编排(既有子系统)
├── PROJECT.md # 既有项目说明
└── NAX_ENGINE.md # Nax 真实隐私计算执行层(V0.13,ComputeEngine SPI 接入)
三个子系统
| 代号 | 全称 | 定位 | 业务库 | 独立部署 |
|---|---|---|---|---|
| TDS | 可信数据空间管理服务平台 | 空间运营方视角:身份、空间、连接器、目录、合约、使用控制、审计、运营 | tds |
是 |
| TDC | 数据接入连接器 | 数据提供方/使用方视角:本地资源、产品封装、合约履行、交付、使用控制、数据治理 | tdc |
是(多虚拟连接器,租户隔离) |
| SSWFLOW | 隐私计算流程编排 | 密态计算引擎的编排层,被 TDS 使用控制环境调用 | sswflow |
随平台 |
阅读顺序
- 先读
arch/ARCHITECTURE.md—— 理解三子系统边界与交互 - 再读
arch/REQUIREMENT_MATRIX.md—— 掌握需求全景与实现进度 - 按需读
tds/或tdc/下的需求规格与领域模型 - 开发前读
JNPF_BACKEND_GUIDE.md—— 后端编码规范(JNPF 7.0 框架约定) - 看落地实现读
tdd/P1P2_CHAIN_K8S_REPORT.md—— 飞梭链存证 + k8s 沙箱/TEE 的设计、回退机制与端到端验证
参考资料
../refs/ 目录:
refs/国标/—— 7 份可信数据空间国家标准技术文件(技术架构、数字合约、使用控制、接入管理、安全能力、功能节点、评价规范)refs/INDEX.md—— 国标要点索引与条款映射refs/secretpad/—— 蚂蚁 SecretPad 开源实现,隐私计算平台参考
关键约束(来自功能清单「特别说明」)
- 服务平台与连接器分开部署,独立的包、独立的数据库;连接器支持多虚拟连接器,多租户隔离(复用 JNPF 内置租户字段,不单独设计)
- 区块链采用开源飞梭链集成
- 数据沙箱采用 kata confidential containers(K8s 标准接口调用)
- 数字合约采用 OPA + 区块链 实现
- 隐私计算采用沙箱调度,集成隐语 SecretFlow / WeDPR 星隐 / PrimiHub 原语
- 集成 JupyterLab 作为通用数据线上开发能力,生产时将数据、算法调度到沙箱自动执行
- 采用研发/生产分离、审核、审计机制保障数据过程安全
- 用户、角色、权限、授权复用 JNPF 平台默认能力,不重新建表
已落地能力(best-effort 集成,非合同基线强制部分)
以下扩展以「零 SDK 依赖 + 进程外适配器 + best-effort 回退」模式落地,对应关键约束 2/3/4/5/6。设计与端到端验证见 tdd/P1P2_CHAIN_K8S_REPORT.md。
| 能力 | 设计约束 | 实现 | 状态 |
|---|---|---|---|
| 飞梭链存证 | 约束 2:开源飞梭链 | FiscoChainClient + ChainEvidenceService + 60s 补偿 ticker;ProcessBuilder 调 fisco/fisco_adapter.py(pyweb3sdk)。禁用/失败落 LOCAL/PENDING 不阻断主流程 |
✅ best-effort(本环境未起链,走回退) |
| k8s 安全沙箱(JupyterLab) | 约束 4/6:kata + JupyterLab | K8sSandboxClient(零 kubernetes-client-java,直接 kubectl)拉起 Notebook Pod+Service;runtimeClass 可选,无 kata 时整行删除字段 |
✅ OrbStack k8s 真起 Pod / JupyterLab |
| k8s TEE 交付 | 约束 3:kata confidential containers | runTeeJob 渲染 tee-job.yaml 起 TEE Job;k8s → NAX → 本地模拟 三级回退 |
✅ OrbStack 真跑 tee-<taskId> Job(Complete 1/1) |
| 隐私计算引擎 | 约束 5:SecretFlow/WeDPR/PrimiHub 原语 | NaxComputeEngine(ComputeEngine SPI),ProcessBuilder 调 nax/nax_adapter.py |
✅ 已接入(mpc 模拟) |
| 前端页面 | — | web/ 新增 TDS 链存证、TDC 沙箱 / 隐私计算 / Notebook 四页,驱动上述能力 |
✅ 已构建验证 |
引擎识别:Privacy 交付
runLog含[K8S]/[NAX]/[模拟]标记,前端据此显示实际执行引擎。
本地运行要点(开发)
- 后端
boot/ssw-admin(Spring Boot 3 + JNPF 7.0,Java 21),三业务包ssw-sswflow/ssw-tds/ssw-tdc,API 前缀/api/ssw/{sswflow,tds,tdc}。 - 启动:
cd boot && java -DDB_HOST=127.0.0.1 -DDB_PORT=15432 -DREDIS_HOST=127.0.0.1 -DREDIS_PORT=16379 -Dserver.port=30000 -jar ssw-admin/target/ssw-admin-7.0.0-RELEASE.jar(端口必须 30000;Redis DB=8 已写死在application-*.yml,避免与其他实例重复)。 - 前端
web/:pnpm dev(http://localhost:5173,proxy/api→30000)。 - 依赖映射:Redis 经容器映射端口
16379(DB 8),Postgres 映射15432;k8s 走 OrbStack(kubeconfig ~/.orbstack/k8s/config.yml,contextorbstack,镜像须用国内源如docker.m.daocloud.io/library/python:3.11-slim)。 - 鉴权:
CIPHER_KEY=EY8WePvjM5GGwQzn,登录密码123456,account=admin。 - ⚠️ 后端须以宿主机网络启动(如
run_in_background),否则连不上 Redis/Postgres 映射端口。