docs: 新增 lite 版 TDC 拆分/打包说明

- 单容器形态矩阵与工程拆分 7 步
- fastUUID 36→VARCHAR(50) 关键坑与 ALTER 迁移
- fat-jar 构建/平台裁剪/红线校验 (零 ssw.tds 耦合)
- 单容器冒烟 + connector+lite-TDC+nax 镜像化
- scard security-server 独立部署红线
- 迁移回 jnpf 标准栈契约与验证检查单
This commit is contained in:
admin committed 2026-08-17 13:41:10 +08:00
1 parent cf02a7891c
commit ff4c021b45
3 files changed
+332

No files matched your search

+46
View File
@@ -0,0 +1,46 @@
# 2026-08-17
## 诊断:nax 大改后 demo/** 算子是否还能跑通
**背景**:苏苏担心 nax 最近一次大改(commit `62f54f5` V1.5 Nax 2P connector 模式)破坏 demo 算子面板。
nax 大改实际只动了 5 个文件:`nax/nax/crypto/share.py`、`nax/nax/device/{vault,plain,offline}.py`、
`nax/nax/ml/vertical.py`(166 行),以及 Spring 后端 `boot/.../nax/nax_2p.py`(920 行)。
**验证方法**:
- venv:`/Users/xs/.workbuddy/binaries/python/envs/nax-psi-demo/bin/python`(flask+numpy+pandas,nax 用源码 `sys.path` 注入)
- 启动 `demo/server.py --host 127.0.0.1 --port 18850`(顶层 import 全部 23 个 blueprint = 全量 import 体检)
- 用 curl 实跑全部 24 个主端点(含 secure_scenario 的 `/api/run/epidemiology`)
- 对空 body 返回 400 的 7 个算子(secure_compare/stats/metrics/dp_primitives/aggregator_chain/vframe_hframe/scql_explain)补合法 body 再跑
- `demo/nax-2p-docker` 用到的 nax 签名(allow_plain_fetch / put(label=) / VFrame 双位置)做静态 import 体检
**结论:全部跑通,零 500,nax 大改向后兼容,未破坏任何 demo 调用。**
- 核心路径验证:hello(share/vault 基础)、psi(crypto.psi + data.intersect)、vertical_lr(ml.vertical AUC=0.964 算法正确)
- 24 个算子主端点全部 200;nax-2p-docker API 面也全兼容
- 之前 7 个 400 纯属测试 body 缺字段被 demo 自身参数校验拦下,与 nax 无关
**文档过时(非运行问题,建议择机修)**:
- `demo/README.md` 写 `nax 默认 backend='LocalBackend'` 是错的——当前 nax 只接受 `local`/`ray`/`auto`,拒绝 `LocalBackend`。但 demo 代码实际用 `"local"`,所以没断。
- `demo/README.md` 说"12 个算子 = 100% 覆盖 nax examples/01_~12_",实际 `server.py` 注册 23 个 blueprint(多了 security_audit/secure_scenario/zkp/nax-2p 等)。
- `demo/server.py` docstring 也过期(列旧清单)。
## 交付:lite 版 TDC 单容器 PoC(tdc-lite,/tmp 沙箱,未污染主工程)
**诉求链路**:苏苏问能否用 `ssw-jnpf-lite` 方案拆 TDC(降低参与方设备要求、支持单容器);进而问能否 `scard + lite-tdc + nax` 打一个镜像;最后落地「按推荐方案做一个,lite-tdc 到 /tmp 环境去弄」。
**推荐方案 = Path A(tdc-lite PoC)**:一个 fat-jar + 内嵌 PG(zonky) + 内存 Sa-Token 承载真实 TDC 业务切片(`Space*` 研发/生产空间隔离),零外部 PG/Redis/任何 TDS 类,单容器即可跑。
**做法(已在 /tmp/tdc-lite 跑通)**:
- 删模板 `ssw-demo` → 建 `ssw-tdc-lite`(entity/biz/controller) + 聚合进 `boot/pom.xml`
- 抽取真实 TDC 切片 `Space*`(entity/mapper/service/impl 全 `@DS("tdc")`) + 跨系统契约客户端 `TdcTdsClient`(接口)/`NoopTdcTdsClient`/`HttpTdcTdsClient`/`TdcSswflowClient`(纯 HttpClient) —— **零 `import ssw.tds.*`**,红线验证:`unzip -l jar | grep ssw/tds` 为空
- `SpaceController` 用轻量承载版(不复用 `TdcCrudController`,避免拉入权限框架)
- 修复三处阻断:① 编译器 `source/target=17`(HttpClient 需 11+);② `MybatisPlusConfig` 补 `@MapperScan({"ssw.**.mapper","jnpf.**.mapper"})`;③ `application-dev.yml` 加 `tdc` 数据源
**🔴 关键坑(已写进 ssw-jnpf-lite skill §F)**:hutool 5.8.x 的 `IdUtil.fastUUID()` 实测返回 **36 字符(带横线)**(非直觉的 32 位)。模板 `RandomUtil.uuId()` 因此产 36 位主键;`schema.sql` 若把 `f_id` 等写成 `VARCHAR(32)` 插入必报 `value too long for type character varying(32)`。正确做法:UUID 列用 `VARCHAR(50)`(与 jnpf/ssw 真实约定一致)。旧表需 `ALTER COLUMN ... TYPE VARCHAR(50)`。
**验证**:登录 + Space/List/ByEnv/POST 创建(36位id)/Promote DEV→PROD/ByEnv PROD/Check/DELETE 全 200;fat jar 143M(含 5 平台 PG 二进制 + ssw-jnpf-lite + ssw-tdc-lite-*)。
**镜像化结论**:参与方镜像 = `connector + lite-TDC + nax` 三件打一个容器即可(单容器运行、低设备要求);**scard `security-server` 必须独立部署**(软 PKI+软 TPM 远程证明),不可与业务同镜像(避免循环证明)。
**位置**:`/tmp/tdc-lite`(沙箱,未碰 `/Users/xs/Desktop/ssw` 主工程)。后续若纳入主工程,按 ssw-jnpf-lite 迁移契约替换依赖即可。
**文档交付**:`docs/TDC_LITE_拆分打包说明.md` —— lite 版 TDC 拆分/打包单一事实来源(形态矩阵、工程拆分 7 步、fastUUID 36→VARCHAR(50) 坑、fat-jar 构建与平台裁剪、单容器冒烟、connector+lite-TDC+nax 镜像化、scard 独立部署红线、迁移回 jnpf 契约、验证检查单)。PoC 实据在 `/tmp/tdc-lite`。
+1
View File
@@ -25,3 +25,4 @@
- 前端双栈真源 jweb(`web/src/views/ssw` 软链);DAG e2e;V1.5 Nax sidecar 化(原始数据不出域):见对应日 md。
- Git 远端 main;跨 agent 软链 `.claude/{memory,skills}`→`.workbuddy/`。
- **scard 安全平面 + TDC 连接器 VM 部署**(详见 2026-08-13.md):`scard/code/bin/security-server`(:8443, 软PKI+golden measurement) + `connector`(TDC 本地代理) 远程证明入网。⚠️ `connector-linux-amd64` 曾被误标为 macOS Mach-O,**必须 `cd scard/code && GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o bin/connector-linux-amd64 ./connector` 重编**;VM 传文件用 `base64 -i|orb -m j7node bash -c 'base64 -d|sudo tee'`(`orbctl push` 2.2.1 有 path bug);宿主机 OrbStack 网段 IP=192.168.139.3 即 server 地址,VM 可达。
- **demo 算子集市面板(与 nax 兼容性)**:`demo/server.py` 注册 23 个 blueprint,用 venv `nax-psi-demo` 启动(`--host 127.0.0.1 --port 18850`),nax 源码经 `sys.path` 注入。**nax 大改(62f54f5 V1.5)向后兼容 demo**——2026-08-17 全量实跑 24 端点(含 nax-2p-docker 静态体检)全 200,零 500。验证流程见 `memory/2026-08-17.md`。⚠️ `demo/README.md` 严重过时:`backend='LocalBackend'` 已错(现只认 `local`/`ray`/`auto`,但代码用 `"local"` 没断);"12 个算子覆盖 examples" 也错(实际 23 个 blueprint,多了 security_audit/secure_scenario/zkp/nax-2p 等)。
+285
View File
@@ -0,0 +1,285 @@
# TDC lite 版拆分与打包说明
> 本文是「用 ssw-jnpf-lite 轻量方案拆分 TDC、并打包成可单容器运行的参与方镜像」的**唯一事实来源(single source of truth)**。
> 配套技能:`~/.workbuddy/skills/ssw-jnpf-lite`(§F 节有 tdc-lite PoC 配方与踩坑);已落地 PoC 在 `/tmp/tdc-lite`(沙箱,未污染主工程)。
> 适用读者:要把 TDC 作为「数据持有方本地连接器」交付给参与方、希望**参与方设备要求低、可单容器运行**的同事 / agent。
---
## 0. 一句话结论
TDC 可以用 `ssw-jnpf-lite` 兼容垫片「lite 化」成一个 **fat-jar + 内嵌 PostgreSQL(zonky) + 内存态 Sa-Token** 的单容器服务,承载真实 TDC 业务切片(如 `Space*` 研发/生产空间隔离),**零外部 PG / 零 Redis / 零任何 TDS 类**。参与方镜像 = `connector + lite-TDC + nax` 三件套打一个容器即可;**scard `security-server`(软 PKI + 软 TPM 远程证明)必须独立部署**,不可与业务同镜像(避免循环证明)。
---
## 1. 为什么要 lite 拆 TDC
| 维度 | 标准 TDC(jnpf 标准栈) | lite-TDC(本方案) |
|---|---|---|
| 中间件依赖 | 外部 PostgreSQL 服务 + Redis 服务 + 可选 Nacos/私服 | **无**——PG 由 zonky 在进程内拉起,Sa-Token 内存态 |
| 参与方设备要求 | 中(要能跑 PG/Redis 或能连到中心服务) | **低**——一个容器即可,甚至单容器裸跑 |
| 跨系统耦合 | 经 HTTP 契约客户端(红线:编译期零 TDS 依赖) | 同左,红线不变 |
| 业务代码 | 复用真实 TDC 切片(entity/mapper/service `@DS("tdc")`) | **同一份代码零改动**,只换依赖 |
| 适用阶段 | 试点 / 生产 / 跨库事务 / 工作流 | 参与方快速接入、演示、轻量节点 |
> 红线不变:无论 lite 还是标准,**TDC 永远不在编译期依赖 `ssw-tds` 模块**,跨系统只走 `TdcTdsClient` / `TdcSswflowClient` HTTP 抽象(详见 §3.6)。lite 只是把「运行载体」从轻,不改变「三子系统边界」。
---
## 2. 部署形态矩阵(回顾 + 本方案定位)
| 形态 | 组成 | 场景 |
|---|---|---|
| 运营主节点 | TDS + TDC + SSWFLOW(标准栈) | 运营方全量中枢 |
| 纯 TDC 数据持有方(标准栈 + scard) | TDC + scard 安全平面 | 正式 TDC 节点(安全模型交付) |
| **lite-TDC 参与方容器(本方案)** | **connector + lite-TDC + nax** 单容器 | 参与方快速接入、低设备要求 |
| scard `security-server` | 软 PKI + 软 TPM 远程证明 | **独立部署**,为 connector 入网做远程证明 |
> ⚠️ 本方案解决的是「**TDC 运行载体轻量化**」,**不改 scard 安全平面的独立部署红线**。参与方容器里装 connector + lite-TDC + nax;security-server 仍是独立平面。
---
## 3. 工程拆分(基于 /tmp/tdc-lite PoC 实测)
PoC 目录:`/tmp/tdc-lite/boot/`,结构与标准 `boot/` 同级:
```
boot/
├── pom.xml # 聚合(ssw-boot-lite)
├── ssw-jnpf-lite/ # 兼容垫片(jnpf.* FQN,26 个类,内嵌 PG + 内存 Sa-Token)
├── ssw-tdc-lite/ # TDC 业务切片父模块
│ ├── ssw-tdc-lite-entity/ # ssw.tdc.entity.* (@DS("tdc"))
│ ├── ssw-tdc-lite-biz/ # ssw.tdc.service/mapper.*(@DS("tdc"))
│ └── ssw-tdc-lite-controller/ # ssw.tdc.controller.* / ssw.tdc.client.* / ssw.tdc.lite.*
└── ssw-lite-admin/ # 可执行入口(fat-jar,mainClass ssw.lite.LiteApplication)
```
### 3.1 删模板 demo,建真实业务模块
模板自带 `ssw-demo`(空骨架)。改造时删掉它,新建 `ssw-tdc-lite`(entity/biz/controller 三个子模块),聚合进 `boot/pom.xml` 的 `<modules>`。
### 3.2 垫片替换(迁移安全核心)
业务模块的 pom 把 `jnpf-common-all` 换成 `ssw-jnpf-lite`:
```xml
<dependency>
<groupId>com.ssw</groupId>
<artifactId>ssw-jnpf-lite</artifactId>
<version>7.0.0-RELEASE</version>
</dependency>
```
垫片 26 个 `jnpf.*` 类签名与 jnpf 7.0.0 一致,业务代码**零改动**。
### 3.3 编译器 source/target 抬到 17(必改,否则编译失败)
jnpf 父 pom 锁 `source=8`,而跨系统契约客户端(`TdcSswflowClient`)用了 `java.net.http.HttpClient`(Java 11+),会报 `程序包 java.net.http 不存在 / 找不到符号 HttpClient`。在 `ssw-tdc-lite/pom.xml` 显式抬版本:
```xml
<properties>
<maven.compiler.source>17</maven.compiler.source>
<maven.compiler.target>17</maven.compiler.target>
</properties>
```
### 3.4 补 `@MapperScan`(删 demo 后必丢,否则启动失败)
模板的 `@MapperScan({"ssw.**.mapper","jnpf.**.mapper"})` 原本在 `ssw-demo-biz` 的 `SswMapperConfig` 里;删掉 `ssw-demo` 后会**丢失 mapper 注册**,启动报 `No qualifying bean of type 'ssw.tdc.mapper.SpaceMapper' available`。
在 `ssw-lite-admin` 的 `MybatisPlusConfig` 上加(同时兼做分页拦截器注册):
```java
package ssw.lite.config;
import org.mybatis.spring.annotation.MapperScan;
// ...
@Configuration
@MapperScan(basePackages = {"ssw.**.mapper", "jnpf.**.mapper"})
public class MybatisPlusConfig {
@Bean
public MybatisPlusInterceptor mybatisPlusInterceptor() {
MybatisPlusInterceptor i = new MybatisPlusInterceptor();
i.addInnerInterceptor(new PaginationInnerInterceptor(DbType.POSTGRE_SQL));
return i;
}
}
```
> 分页拦截器必须在业务模块注册(MyBatis-Plus 3.5.16 起 `PaginationInnerInterceptor` 收进独立 artifact `mybatis-plus-jsqlparser`,shim 的 starter 未以 compile 传进来);biz 模块 pom 需显式加 `mybatis-plus-jsqlparser:3.5.16`。
### 3.5 `@DS("tdc")` 数据源
`application-dev.yml` 的 `spring.datasource.dynamic.datasource` 下新增 `tdc`(与其它库同指向内嵌 PG),否则业务 `@DS("tdc")` 类启动报 `can not find datasource`:
```yaml
spring:
datasource:
dynamic:
datasource:
master:
url: jdbc:postgresql://localhost:${SSW_LITE_PG_PORT:5432}/postgres
# ...
tdc: # ← 新增,与 master 同库(lite 单库多 schema/表)
url: jdbc:postgresql://localhost:${SSW_LITE_PG_PORT:5432}/postgres
# ...
```
真实 TDC 切片(`SpaceEntity`/`SpaceMapper`/`SpaceService`/`SpaceServiceImpl`)全部 `@DS("tdc")`,可直接从标准工程拷过来复用。
### 3.6 轻量承载 Controller(勿继承通用 CrudController)
真实 `SpaceController extends TdcCrudController` 会拉入 `SswPermissionGuard` / `SswDataScopeResolver` / `AuditAction` 等权限框架,lite 垫片**没有这些类 → 直接崩**。改用「轻量承载版」:
- Controller 不复用基类,只 `@Autowired` 真实 `SpaceService`;
- 暴露 List / Detail / Save / Delete / ByEnv / Promote / Check 同一套接口,路径 `/api/ssw/tdc/Space`;
- 业务语义(研发/生产空间隔离、DEV→PROD 提升、运行前校验)完全保留。
### 3.7 跨系统契约客户端(红线证明)
`ssw.tdc.client` 包下全部纯 HTTP、零 `import ssw.tds.*`:
- `TdcTdsClient`(接口)+ `NoopTdcTdsClient`(base-url 缺失降级)+ `HttpTdcTdsClient`(base-url 配则走 HTTP)
- `TdcSswflowClient`(纯 `java.net.http.HttpClient`)
启动日志会打印 `[TDC-SSWFLOW] 已装载 baseUrl=... secret-configured=false`,即证明降级链路正常。
---
## 4. 🔴 关键坑:hutool `fastUUID()` 返回 36 字符(带横线)
直觉以为 `IdUtil.fastUUID()` 是 32 位去横线 UUID,**实测 hutool 5.8.x 返回 36 字符(标准 UUID 带横线)**。模板 `RandomUtil.uuId()` → `IdUtil.fastUUID()` 因此产出 36 位主键。
若 `schema.sql` 把 `f_id` / `f_*_user_id` / `f_promoted_from_space_id` 写成 `VARCHAR(32)`,插入必报:
```
ERROR: value too long for type character varying(32)
```
**正确做法**:所有承载 UUID 的列用 `VARCHAR(50)`(与 jnpf/ssw 真实约定一致——真实库主键 `f_id` 本就是 `varchar(50)`)。`f_environment` / `f_status` 等枚举列保持 `VARCHAR(32)` 即可。
```sql
CREATE TABLE IF NOT EXISTS tdc_space (
f_id VARCHAR(50) PRIMARY KEY,
f_tenant_id VARCHAR(50),
f_creator_user_id VARCHAR(50),
f_last_modify_user_id VARCHAR(50),
f_delete_user_id VARCHAR(50),
f_promoted_from_space_id VARCHAR(50),
f_environment VARCHAR(32),
f_status VARCHAR(32),
...
);
```
> 已存在旧表不会因改 SQL 自动迁移(`DbInitRunner` 只 `CREATE TABLE IF NOT EXISTS` + 幂等种子)。改列宽需手动:
> `ALTER TABLE tdc_space ALTER COLUMN f_id TYPE VARCHAR(50);`(其余 id 列同理)。
---
## 5. 打包(构建 fat-jar)
必须在 `boot/` 目录下、用 `-am` 把垫片与业务模块一起拉起来:
```bash
cd /tmp/tdc-lite/boot
mvn -pl ssw-lite-admin -am package -DskipTests
# 产物:ssw-lite-admin/target/ssw-lite-admin-7.0.0-RELEASE.jar(≈ 143 MB)
```
### 5.1 体积与平台裁剪
fat-jar 默认打 **5 个平台 PG 二进制**(zonky embedded-postgres,≈ 100 MB,是最大头)。按目标 OS 裁剪可压到 ≈ 72 MB:
- 单平台开发机 / 容器镜像:只留目标平台(`darwin-arm64v8` / `linux-amd64` / `linux-amd64-alpine` 等),并给 `embedded-postgres` 父依赖加 `<exclusions>` 排除其余 4 个(否则它们绕过显式依赖继续被打进 jar);
- 跨平台发布:保留全量 5 平台。
> 裁剪只影响体积,不影响启动逻辑(zonky 启动时按当前 OS 自动选匹配二进制)。裁剪后必须在目标 OS 启动一次验证。
### 5.2 红线打包校验(必跑)
```bash
# 编译产物里绝不能出现 ssw.tds / ssw.sswflow 业务类(允许 ssw.tdc 与 jnpf 垫片)
unzip -l ssw-lite-admin/target/ssw-lite-admin-7.0.0-RELEASE.jar \
| grep -E "ssw/tds/|ssw/sswflow/" && echo "❌ 红线回归" || echo "✅ 零 TDS 耦合"
```
---
## 6. 单容器启动与冒烟验证
```bash
cd /tmp/tdc-lite/boot
# 用托管后台直接跑(别套 nohup &,agent 子 shell 一退进程就被回收)
java -jar ssw-lite-admin/target/ssw-lite-admin-7.0.0-RELEASE.jar --server.port=30000
```
> localhost 调试若走系统代理会返回空响应:curl 一律加 `--noproxy '*'`。
### 6.1 密码加密自检
`admin / 123456` 的加密 hex(与 `web/src/utils/cipher.ts` 完全一致):
```
d4958348e22108119b3ef57b022c83f4bf857dd0b247eaab15b9a43d47ee3c503900f7135bf0de255bc33620c3cdc02b
```
### 6.2 冒烟检查单(已全部 200 验证通过)
```bash
BASE=http://127.0.0.1:30000
PW=d4958348e22108119b3ef57b022c83f4bf857dd0b247eaab15b9a43d47ee3c503900f7135bf0de255bc33620c3cdc02b
# 1) 登录
TOKEN=$(curl -s -X POST "$BASE/api/oauth/Login" \
-H 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode "account=admin" --data-urlencode "password=$PW" \
--data-urlencode "grant_type=password" | python3 -c "import sys,json;print(json.load(sys.stdin)['data']['token'])")
AUTH="Authorization: bearer $TOKEN"
curl -s "$BASE/api/ssw/tdc/Space/List" -H "$AUTH" # 列表
curl -s "$BASE/api/ssw/tdc/Space/ByEnv?env=DEV" -H "$AUTH" # 按环境
curl -s -X POST "$BASE/api/ssw/tdc/Space" -H "$AUTH" \
-H 'Content-Type: application/json' \
-d '{"name":"测试空间","environment":"DEV"}' # 创建(36位id)
curl -s -X POST "$BASE/api/ssw/tdc/Space/{id}/Promote" -H "$AUTH" \
-H 'Content-Type: application/json' -d '{"name":"测试空间-PROD"}' # DEV→PROD
curl -s -X DELETE "$BASE/api/ssw/tdc/Space/{id}" -H "$AUTH" # 软删
```
---
## 7. 镜像化(参与方容器 = connector + lite-TDC + nax)
### 7.1 三种件套打一个镜像
```
participant-image/
├── scard/connector/ # TDC 本地代理(数据持有方本地连接器)
├── ssw-lite-admin.jar # lite-TDC(内嵌 PG + 内存 Sa-Token,单进程)
└── nax/ # 隐私计算引擎(PSI/LR/MLP/FedAvg/SCQL)
```
- 内嵌 PG 由 lite-TDC 在进程内拉起,nax 通过 `TdcSswflowClient` 与 lite-TDC 同容器通信,无需外部中间件;
- 单容器即可完成「连接器接入 → 空间管理 → 密态计算」全链路,参与方设备要求降到最低。
### 7.2 scard `security-server` 独立部署(红线)
```
security-plane/ # 单独容器 / 单独 VM
└── scard/code/bin/security-server (:8443, 软 PKI + golden measurement)
```
- connector 启动时向 `security-server` 做远程证明(RA)入网;
- **绝不与 connector/lite-TDC/nax 同镜像**——否则出现「谁证明谁」的循环依赖,安全模型失效。
> 安全平面 VM 部署范式见 `docs/scard/VM_DEPLOY.md`;connector-linux-amd64 必须用 `GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build` 重编(历史踩坑:曾被误标为 macOS Mach-O)。
---
## 8. 迁移回 jnpf 标准栈(不绑死)
进试点 / 生产、需跨库事务 / 工作流 / 门户时:
1. 业务模块 pom 的 `ssw-jnpf-lite` → `jnpf-common-all`;
2. 删 `ssw.tdc.lite.LiteLoginController` 整个包——真实 `jnpf-oauth-controller` 接管 `/api/oauth/*`,前端零改动;
3. 去掉 `LiteApplication.main()` 的 zonky 启动段;`application-dev.yml` 的 `tdc.url` 指向**真实 PG 服务**地址(`db/schema.sql` 可直接复用,无需改写);
4. 前端 `lite-web/` 可继续用,或换回 `jweb` 官方前端。
反向(lite 化)即上述逆向。垫片 26 个 `jnpf.*` 类签名与 jnpf 7.0.0 一致,可无缝切换;业务 `Space*` 切片代码一行不改。
---
## 9. 验证检查单(交付前必勾)
- [ ] `mvn -pl ssw-lite-admin -am package -DskipTests` 构建通过,产物 ≈ 143 MB(或裁剪后 ≈ 72 MB)
- [ ] `unzip -l jar | grep -E "ssw/tds/|ssw/sswflow/"` 为空(零 TDS 耦合红线)
- [ ] 三个 tdc-lite lib jar 只含 `ssw/tdc/`
- [ ] `schema.sql` 的 UUID 列均为 `VARCHAR(50)`(非 32)
- [ ] 启动日志出现 `dynamic-datasource - add a datasource named [tdc] success`
- [ ] 启动日志出现 `[TDC-SSWFLOW] 已装载 baseUrl=... secret-configured=false`
- [ ] §6.2 冒烟 9 项全 200
- [ ] 裁剪后已在目标 OS 启动验证(若做了平台裁剪)
---
## 附:关键文件地图(PoC 实测)
```
/tmp/tdc-lite/boot/
├── ssw-jnpf-lite/src/main/java/jnpf/util/ # 垫片:RandomUtil / UserProvider / ...
├── ssw-tdc-lite/ssw-tdc-lite-entity/.../ssw/tdc/entity/SpaceEntity.java @DS("tdc")
├── ssw-tdc-lite/ssw-tdc-lite-biz/.../ssw/tdc/{mapper,service,service/impl}/* @DS("tdc")
├── ssw-tdc-lite/ssw-tdc-lite-controller/.../ssw/tdc/controller/SpaceController.java 轻量承载
├── ssw-tdc-lite/ssw-tdc-lite-controller/.../ssw/tdc/client/ TdcTdsClient/Noop/Http + TdcSswflowClient
├── ssw-tdc-lite/ssw-tdc-lite-controller/.../ssw/tdc/lite/LiteLoginController.java 登录
└── ssw-lite-admin/src/main/
├── java/ssw/lite/LiteApplication.java # 内嵌 PG 启动 + Spring 引导
├── java/ssw/lite/config/MybatisPlusConfig.java # @MapperScan + 分页拦截器
└── resources/db/schema.sql # VARCHAR(50) 主键
```