- 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
105 lines
7.6 KiB
Markdown
105 lines
7.6 KiB
Markdown
# 尚数网可信数据空间 — 文档索引
|
||
|
||
本目录是「尚数网可信数据空间」(Shangshuwang Trusted Data Space)的需求与设计文档中心。
|
||
|
||
## 需求基线(必须实现,不可裁剪)
|
||
|
||
| 文件 | 说明 | 地位 |
|
||
|---|---|---|
|
||
| [`功能清单.md`](./功能清单.md) | 19 个章节、约 100 个功能点,覆盖服务平台与接入连接器 | **需求基线 A** |
|
||
| [`附件1:技术协议_可信数据空间_0512.docx`](./附件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` | 随平台 |
|
||
|
||
## 阅读顺序
|
||
|
||
1. **先读** [`arch/ARCHITECTURE.md`](./arch/ARCHITECTURE.md) —— 理解三子系统边界与交互
|
||
2. **再读** [`arch/REQUIREMENT_MATRIX.md`](./arch/REQUIREMENT_MATRIX.md) —— 掌握需求全景与实现进度
|
||
3. **按需读** `tds/` 或 `tdc/` 下的需求规格与领域模型
|
||
4. **开发前读** [`JNPF_BACKEND_GUIDE.md`](./JNPF_BACKEND_GUIDE.md) —— 后端编码规范(JNPF 7.0 框架约定)
|
||
5. **看落地实现读** [`tdd/P1P2_CHAIN_K8S_REPORT.md`](./tdd/P1P2_CHAIN_K8S_REPORT.md) —— 飞梭链存证 + k8s 沙箱/TEE 的设计、回退机制与端到端验证
|
||
|
||
## 参考资料
|
||
|
||
`../refs/` 目录:
|
||
|
||
- `refs/国标/` —— 7 份可信数据空间国家标准技术文件(技术架构、数字合约、使用控制、接入管理、安全能力、功能节点、评价规范)
|
||
- `refs/INDEX.md` —— 国标要点索引与条款映射
|
||
- `refs/secretpad/` —— 蚂蚁 SecretPad 开源实现,隐私计算平台参考
|
||
|
||
## 关键约束(来自功能清单「特别说明」)
|
||
|
||
1. **服务平台与连接器分开部署**,独立的包、独立的数据库;连接器支持多虚拟连接器,**多租户隔离**(复用 JNPF 内置租户字段,不单独设计)
|
||
2. **区块链**采用开源**飞梭链**集成
|
||
3. **数据沙箱**采用 **kata confidential containers**(K8s 标准接口调用)
|
||
4. **数字合约**采用 **OPA + 区块链** 实现
|
||
5. **隐私计算**采用沙箱调度,集成隐语 SecretFlow / WeDPR 星隐 / PrimiHub 原语
|
||
6. 集成 **JupyterLab** 作为通用数据线上开发能力,生产时将数据、算法调度到沙箱自动执行
|
||
7. 采用**研发/生产分离、审核、审计**机制保障数据过程安全
|
||
8. **用户、角色、权限、授权复用 JNPF 平台默认能力**,不重新建表
|
||
|
||
## 已落地能力(best-effort 集成,非合同基线强制部分)
|
||
|
||
以下扩展以「**零 SDK 依赖 + 进程外适配器 + best-effort 回退**」模式落地,对应关键约束 2/3/4/5/6。设计与端到端验证见 [`tdd/P1P2_CHAIN_K8S_REPORT.md`](./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`,context `orbstack`,镜像须用国内源如 `docker.m.daocloud.io/library/python:3.11-slim`)。
|
||
- **鉴权**:`CIPHER_KEY=EY8WePvjM5GGwQzn`,登录密码 `123456`,`account=admin`。
|
||
- ⚠️ 后端须以**宿主机网络**启动(如 `run_in_background`),否则连不上 Redis/Postgres 映射端口。
|