- static/migrate.sql ⇒ schema/migrate.sql(编译期内嵌不变,运行期不在 web root) ⇒ 大小写 / %2E / 尾斜杠 / 双斜杠等路径变体全部拿不到 DDL - 404 与 SPA 兜底从二进制 crate 抽进 lib(src/routes/fallback.rs) ⇒ /api 与 /api/ 统一回 404 JSON,SPA 深链回 index.html - 新增 tests/spa_fallback.rs:6 条断言锁住兜底行为 - README 整段重写为现行 18 实体 CRUD + 鉴权面 + 上游 SPA 托管 - build-frontend.sh 可执行;产物目录缺失时回落 npm 构建路径 - registry::validate() 挪到 PGlite::open 之前,注册表写坏即秒退 - mw.rs 注释点明两套 4xx 形状并存是刻意分歧 Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
7.0 KiB
TDC 数据接入连接器 · Rust + 上游前端 SPA + PGlite
把 ssw-mvp/boot/ssw-tdc(Spring Boot / JNPF 重底座的「数据接入连接器」子系统)重做成
本地优先、零外部服务的 MVP:
- Rust (axum) —— 控制面 + 数据面 + 静态托管 + 契约网关
- 上游(Java/Vue)完整前端的构建产物 —— 托管在
static/,零自研前端、零构建步骤 - PGlite(pglite-rs,进程内原生 PostgreSQL) —— 内嵌在 Rust 进程里,承载全部
tdc_*业务数据, 数据落在data/tdc.pg/(磁盘持久化,非浏览器 WASM/IndexedDB)
关键点:PGlite 用的是 pglite-rs(
crate pglite-rs,import 为pglite)—— 把 postgres-pglite 编译成原生静态库、链接进二进制,是真实 PostgreSQL 语义 (类型 / MVCC / 事务 / 扩展 / 线协议),进程内单 backend 运行,无服务器、无 Docker。 前端只发 REST 请求,不直接持有数据库。
红线:原 TDC 与 TDS 只走 HTTP 契约、不编译期耦合。 本实现不代理 TDS(TDS 侧出向客户端属后续任务);前端登录走 JNPF 门户账号 (
POST /api/oauth/Login),该端点属后续任务。
运行
cd tdc-rs
cargo build # 编译(自动走 sccache + 统一 registry 缓存)
PORT=30000 ./target/debug/tdc-connector
# 浏览器打开 http://localhost:30000
- 启动即初始化:Rust 进程内
PGlite::open(data/tdc.pg),若tdc_identity不存在则执行 内嵌的schema/migrate.sql(include_str!进二进制,30 张表 + 6 条内置脱敏规则 + 默认开发环境空间)。 - 数据全部落在 Rust 进程内嵌库;控制台(上游 SPA)通过
/api/ssw/tdc/*读写。 - schema DDL 在
schema/migrate.sql(编译期内嵌,刻意不在 web root)⇒ 不可从 HTTP 下载。
控制台(前端)
前端 = 上游(Java/Vue)完整版的构建产物,托管在 static/:
static/
├── index.html # SPA 外壳(vite base=/ ⇒ 引用 /assets/...)
├── logo.png
└── assets/ # index-*.js / index-*.css / tdc-*.js / vendor-*.js / Login-*.js …
- 产物由
scripts/build-frontend.sh落盘(可重放;默认走「搬运已构建好的 dist」,SKIP_NPM=0才跑npm ci+VITE_SSW_APP=tdc npx vite build)。 - SPA 深链(
/tdc/home、/login…)回退到index.html(200text/html),前端路由接管。 /api/**未命中回 404 + JSON({"success":false,"code":404,"msg":"接口不存在"}), 不是 SPA 的 HTML —— 前端 axios 错误分支据此显示「接口不存在」; 若回 HTML,前端会判body.code === undefined而不 reject ⇒ 静默渲染空表, 把「接口没了」误读成「没有数据」。- 🔴 保留红线:前端不直接持有数据库(它只发 REST 请求)。
编译缓存(按 dev-cache-layout 规范)
本机已统一:~/.cargo/registry → ~/.cache/cargo/registry(软链),
sccache 0.18 经 ~/.cargo/config.toml 的 [build] rustc-wrapper + [env] SCCACHE_DIR
启用,缓存实体在 ~/.cache/sccache(经 ~/Library/Caches/Mozilla.sccache 软链透明访问)。
cargo build 直接命中,无需额外操作。pglite-rs 为预编译原生库,依赖编译结果一并入缓存。
后端 API
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/health |
健康检查(tables: 30) |
| POST | /api/ssw/tdc/Auth/Login |
连接器身份登录(软 PKI,签发会话令牌) |
| GET | /api/ssw/tdc/Auth/Me |
当前身份视图(去敏:不含私钥/一次性密钥) |
| GET | /api/ssw/tdc/Auth/Spaces |
环境空间列表 |
| GET | /api/ssw/tdc/Auth/SsoConfig |
SSO 配置(上游前端登录页用) |
| GET / POST | /api/ssw/tdc/{Entity} |
18 个实体的列表 / 新建 |
| GET | /api/ssw/tdc/{Entity}/All |
不分页全量 |
| GET / PUT / DELETE | /api/ssw/tdc/{Entity}/{id} |
详情 / 修改 / 逻辑删除 |
| GET | /api/ssw/tdc/Resource/{id}/Detail、/api/ssw/tdc/Dataset/{id}/Detail |
资源 / 数据集聚合详情 |
{Entity} 的 18 个全名:
ApiConsumeLog / AuditLog / Contract / Credential / DataInterface / Dataset /
Datasource / DeliveryLog / DeliveryTask / DestroyLog / Identity / Notification /
Order / Policy / PolicyCheckLog / PolicyTemplate / Product / Resource
鉴权:
X-Internal-Token(内部令牌通道)或X-Auth-Token/Authorization: bearer <token>(会话通道)。 业务失败一律 HTTP 200 +{code,msg,data};鉴权失败是另一种形状: HTTP 401/403 +{"success":false,"code":401,"msg":"…"}(无data键)。 内部库为单 in-process backend,所有 DB 访问由tokio::Mutex串行化。
已实现范围
30 张表(上游 tdc_* schema 的生成产物,含 9 系统列 / 逻辑删除 / partial 唯一索引):
身份、数据源、资源、资源字段、脱敏规则、产品、需求、订单、合约、使用控制策略、
策略校验记录、API 交付服务、交付任务、交付日志、TDS 同步日志、审计日志、环境空间、成员、机密文件。
控制台能力(schema 自省驱动的通用 CRUD + 按表生命周期操作):
- 通用:新建 / 编辑 / 逻辑删除 / 搜索(所有表)
- 数据源:测试连接、同步资源
- 资源:启用 / 停用
- 产品:发布 / 下架 / 提交审核
- 需求:发布 / 关闭
- 订单:通过 / 驳回 / 签署
- 合约:生效 / 终止
- 交付任务:策略校验(写
tdc_policy_check_log)/ 完成 / 取消 / 销毁(留证写tdc_delivery_log) - 身份(Rust 侧):登录 / 会话 / 空间列表
明确不在 MVP 内(原 ssw-tdc 的隐私计算作业)
原 NaxJob / Nax2PJob / TeeJob / Sandbox / Privacy / AnnotationTask / Notebook / VizChart / Quality* / HostingJob 等控制器依赖 Nax 隐私计算引擎与 scard 安全平面(软 PKI / 软 TPM),
未纳入本次重做。若需这部分,应保留原 Java/Scala 服务,或将其作为独立后端通过 HTTP 契约接入本连接器。
目录
tdc-rs/
├── Cargo.toml # 含 pglite-rs = "0.2"
├── src/
│ ├── main.rs # axum:内嵌 PGlite + 路由装配 + 中间件
│ └── routes/ # 按域装配:health / auth / crud / mw(405 改写)/ fallback(404 + SPA 兜底)
├── static/ # 上游 SPA 构建产物(index.html + logo.png + assets/)
├── schema/
│ └── migrate.sql # tdc_* schema(include_str! 内嵌进二进制;**不在 web root**)
├── scripts/ # build-frontend.sh(前端产物)/ gen-migrate.sh(schema 生成)/ reset-data.sh
├── docs/ # 补充文档
├── tds-stub/ # 本地 TDS 契约桩(零依赖,仅供端到端调试)
└── data/ # 运行期数据(tdc.pg/,已 gitignore)