diff --git a/.workbuddy/memory/2026-08-17.md b/.workbuddy/memory/2026-08-17.md new file mode 100644 index 0000000..b4df3f4 --- /dev/null +++ b/.workbuddy/memory/2026-08-17.md @@ -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`。 diff --git a/.workbuddy/memory/MEMORY.md b/.workbuddy/memory/MEMORY.md index 48a34f2..708decb 100644 --- a/.workbuddy/memory/MEMORY.md +++ b/.workbuddy/memory/MEMORY.md @@ -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 等)。 diff --git a/docs/TDC_LITE_拆分打包说明.md b/docs/TDC_LITE_拆分打包说明.md new file mode 100644 index 0000000..c10829d --- /dev/null +++ b/docs/TDC_LITE_拆分打包说明.md @@ -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` 的 ``。 + +### 3.2 垫片替换(迁移安全核心) +业务模块的 pom 把 `jnpf-common-all` 换成 `ssw-jnpf-lite`: +```xml + + com.ssw + ssw-jnpf-lite + 7.0.0-RELEASE + +``` +垫片 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 + + 17 + 17 + +``` + +### 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` 父依赖加 `` 排除其余 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) 主键 +```