diff --git a/docs/superpowers/specs/2026-10-26-tdc-rs-mvc-align-v3-design.md b/docs/superpowers/specs/2026-10-26-tdc-rs-mvc-align-v3-design.md new file mode 100644 index 0000000..37d6cdd --- /dev/null +++ b/docs/superpowers/specs/2026-10-26-tdc-rs-mvc-align-v3-design.md @@ -0,0 +1,304 @@ +# tdc-rs 对齐上游 Java TDC · v3(业务包 MVC + 账号层同源 + 单库) + +> 版本:v3(2026-10-26) 继承:`2026-10-24-tdc-rs-align-v2-design.md`(v2 的对齐面总览、状态机、协议类、TDS 契约继续有效) +> 本文只写 **v3 相对 v2 的增量与改写**;v2 未被本文改写的章节继续有效。 +> 配套:`2026-10-25-tdc-rs-p4-tds-outbound-design.md`(P4 TDS 出向,本次不改)。 + +--- + +## 0. 背景与目标 + +### 0.1 一句话 + +把 `tdc-rs` 从「**上游对齐版 TDC**」升级为「**与上游 Java TDC 同构、可互换部署**」的 Rust 实现:**同表、同实体、同端点形状、同账号体系**(同一账号在两侧可互相登录),代码组织对位上游业务包 MVC(`ssw.tdc.*`),前端继续托管上游 Vue SPA。 + +### 0.2 本次四个决定(用户拍板,不可自行推翻) + +| # | 决定 | 直接后果 | +|---|---|---| +| **D1** | **前端继续用上游 Vue**(非 JNPF 自带) | 官方 JNPF 前端 / **面 B 整块作废**(含 `Vue-Version: 3` 判别头——上游 SPA 无条件发它,见 `frontend/web/src/api/request.ts:56`)⇒ `perm-smoke-jnpf.sh` 尺子**不做** | +| **D2** | **业务与上游版本一致** | 表集 / 实体 / 端点形状 以上游最新为准;**分批**推进,本批只做**底座对齐**(B0–B4) | +| **D3** | **核心是业务包 MVC** | Rust 侧目录对位上游 `ssw.tdc.*`(entity/mapper/service/controller/support/…),**保留通用 CRUD 引擎**(不退回「每实体四件套」) | +| **D4** | **单库** | `base_*` 与 `tdc_*` 共处**一个 pglite 实例、一个 `public` schema**,靠表前缀分区(上游两库里的表也都在 `public` ⇒ DDL 逐字一致、导数据零改写) | + +### 0.3 附带决定(本轮问询) + +| # | 决定 | 说明 | +|---|---|---| +| **D5** | 账号层**一步切到 `base_user`** | 官方双 md5 口令公式 + 自动生成 `secretkey`;`data/accounts.json` 一次性导入后停用 | +| **D6** | 权限模型**按上游** | 登录态 + 角色码(`tdcProvider`/`tdcConsumer`/`tdsReadOnly`)+ 管理员位(`base_user.f_is_administrator`)三件套;**删除** tdc-rs 现有的 18 个实体级权限键与能力集判定 | + +### 0.4 非目标(显式不做) + +- ❌ 官方 JNPF 前端 / 面 B 官方形状端点 / `base_module` 菜单体系 / `f_en_code` 点权限(D1 + 上游 `ssw.jnpf-permission.enabled=false`)。 +- ❌ Nax 隐私计算作业(`Sandbox`/`Privacy`/`Notebook`/`Tee` 等依赖 Nax 引擎与 scard 软 PKI/软 TPM,本地不可行)——**注意**:`tdc_sandbox_exec_run` / `tdc_privacy_exec_run` 只是**作业记录表**,本仓照常提供 CRUD;不可行的是「跑作业」这件事。 +- ❌ 上游动作端点全量(~30–40 个,见 §6.3)——**下一批**按控制器分批做。 + +--- + +## 1. 真源与优先级 + +| 层 | 真源 | 位置 | +|---|---|---| +| 业务表 / 实体 / 端点语义 | **上游 Java TDC 最新** | `/tmp/sswtdc-probe`(只读快照,`http://192.168.1.2:8080/ssw/trusted-space/ssw-tdc`) | +| `base_*` DDL | **上游连接器自有 j7** | `boot/db/j7/V1.0.0__jnpf_base_schema.sql`(`base_user` 在 `:17384`) | +| `base_*` 契约方法论 | 技能 `ssw-jnpf-lite-rust`(`PERMISSION.md` / `MIGRATION.md §7`) | `~/.agents/skills/ssw-jnpf-lite-rust/` | +| 口令算法 | 上游 `LoginServiceImpl`(官方 JNPF) | 与 tdc-rs 现有 `src/cipher.rs` **同算法**,只改**存储公式**(§4.2) | +| 控制台前端 | 上游 `frontend/web` 构建产物 | tdc-rs `static/`(`scripts/build-frontend.sh` 可重放) | + +**冲突裁决**:业务语义以上游为准;`base_*` 表名/列名以上游 j7 为准(与技能模板逐列一致,已核);**权限宽严按上游**(D6);前端形态按 D1。 + +--- + +## 2. 目标架构:业务包 MVC 对位 + +### 2.1 目录映射 + +上游 Java 布局 = 3 个 Maven 模块(`ssw-tdc-entity` 27 文件 / `ssw-tdc-biz` 159 / `ssw-tdc-controller` 35)+ `ssw-tdc-admin`,包族 `ssw.tdc.*`:`client, config, constant, controller, engine, entity, heartbeat, mapper, notify, policy, schedule, service(+impl), sso, support, util`。 + +Rust 侧目标(单 crate,`tdc-rs`): + +``` +src/ +├── main.rs lib.rs state.rs config.rs ← 启动装配(对应 ssw-tdc-admin) +├── db.rs session.rs envelope.rs cipher.rs ids.rs +│ protocol.rs codec.rs ← 平台壳层(对应 jnpf base/oauth) +└── tdc/ ← 业务包(对位 ssw.tdc.*) + ├── entity/ 每个实体一文件:列清单 / json_key / numeric / + │ hidden_fields / frozen_columns / 分档 / filter / keyword + │ mod.rs ALL_SPECS 汇总 + 启动自检(迁自 registry::validate) + │ datasource.rs resource.rs delivery_task.rs policy.rs … + ├── mapper.rs SQL 组装与执行(对应上游 Mapper + TdcCrudController 的 SQL 部分) + ├── service/ 业务规则:分档判定、状态机、聚合详情、口令/身份规则 + │ mod.rs crud.rs delivery.rs policy.rs identity.rs account.rs + ├── controller/ HTTP 端点(按上游控制器分文件) + │ mod.rs crud.rs auth.rs delivery.rs product.rs tds_biz.rs … + ├── support/ admin_guard / internal_token / permission / crypto / constants + ├── policy/ 策略引擎(上游 ssw.tdc.policy) + ├── engine/ 执行引擎占位(上游 ssw.tdc.engine) + ├── schedule/ 定时任务占位(上游 ssw.tdc.schedule) + ├── client/ TDS 出向客户端(现 `src/tds/`,整体平移) + ├── notify/ heartbeat/ sso/ ← 占位,后续批 + ├── util/ **业务**工具(上游 ssw.tdc.util 对位);平台级通用件(ids / codec)留在 `src/` 平台层,**一份实现不复制** + ├── config.rs constant.rs +``` + +**平移映射(v2 → v3)** + +| v2 位置 | v3 位置 | 备注 | +|---|---|---| +| `src/registry.rs`(1159 行) | `src/tdc/entity/*.rs` + `entity/mod.rs` | 18 条 `TableSpec` 拆成 18 个实体文件;`ALL_SPECS` 汇总;`validate()` 迁 `entity/mod.rs` | +| `src/crud.rs`(1246 行) | `src/tdc/mapper.rs`(SQL/投影/序列化)+ `src/tdc/service/crud.rs`(分档/写路径规则)+ `src/tdc/controller/crud.rs`(HTTP handler + 路由表) | 三切,**行为零变化** | +| `src/routes/*.rs` | `src/tdc/controller/*.rs` | `routes/` 消失;`mw.rs`(405/413 改写)与 `fallback.rs`(404 + DDL 守卫)留在 `src/` 平台层 | +| `src/domain/identity.rs` | `src/tdc/service/identity.rs` + `tdc/controller/auth.rs` | 身份登录(`/api/ssw/tdc/Auth/*`) | +| `src/account.rs` | `src/tdc/service/account.rs`(存储换 `base_user`,见 §4) | 登录与用户管理 | +| `src/tds/mod.rs` | `src/tdc/client/tds.rs` | 出向客户端 | +| `src/auth.rs` | `src/` 平台层(保留原位) | 三道门 + `Principal`;仅 `Principal::Account` 语义随 §4 调整 | +| `src/registry.rs` 的 `PERMISSION_KEYS` | **删除** | D6:改由 §5 的角色码/管理员位判定 | + +### 2.2 通用引擎**保留**(D3 的另一半) + +以下能力是上游**没有**、tdc-rs 现有、且与上游**行为兼容**(照抄上游 `@JsonIgnore` 与分档语义)⇒ **保留不动**: + +- `hidden_fields`:上游 `@JsonIgnore`(`Identity.secretKey` / `DeliveryTask.devUrl` / `devToken`)的**整条删键**语义(出参删、入参静默忽略)。 +- `frozen_columns` / `create_codes` / `filter_columns` / `keyword_columns` / `tenant_column` / `default_order_column`。 +- `no_create` / `no_update` / `no_delete` **业务分档**(照上游控制器的可写性差异)——⚠️ 这是**业务规则**,不是权限机制,**不随 D6 删除**。 + +--- + +## 3. 数据层:单库 + 追平上游最新 + +### 3.1 布局 + +- **单库单 schema**:一个 pglite 实例,`base_*`(3 张)+ `tdc_*`(30 张)同处 `public`。 +- **理由**:上游两个库(`j7` / `tdc_standalone`)里的表**都在 `public` schema** ⇒ 本仓 DDL 与上游 DDL **逐字一致**,跨侧导数据不需要改写 schema 前缀;若将来要拆库,是一次性搬迁而非现在做(D4)。 +- `base_*` **只建 3 张**:`base_user` / `base_role` / `base_role_relation`。 + - 不建 `base_module` / `base_authorize`:上游 `ssw.jnpf-permission.enabled=false` ⇒ `SswPermissionGuard` 不装配、`base_module` 不种子 ⇒ 上游的菜单授权行**是死的**(`boot/db/j7/V1.0.1__connector_seed.sql` 注释明写「不建菜单」)。 + - 不建上游 j7 的其余 120 张 `base_*`:只种了 3 角色 + 6 授权行 + 84 `sys_config` + 1 本地表,**账号/角色链路只需要上面 3 张**。 + - `base_organize`:官方登录链路是否依赖,**B4 实施时按实际 SQL 决定**(先不建,缺了再补)——记为实施期检查项,不做预防性建设。 + +### 3.2 追平上游最新(B2) + +- 真源:上游迁移目录 `boot/db/tdc/*.sql` + `boot/db/*.sql`(**psql 脚本,不是 Flyway**)⇒ 排序规则 = `sort -V` 合并两处(tdc-rs 现有 `scripts/gen-migrate.sh` 同源,但需补上游后加的那批)。 +- 已知差异(**B0 只读核查要逐条确认**): + - 上游建过 `tdc_*` **43 张 → 活 30 张 → 被后续迁移删 13 张**(`V2.42.1` 删 `tdc_member`/`tdc_role_apply`/`tdc_role_grant`;`V2.55.0` 删 `tdc_api_service` 并重建 `tdc_resource_field`;`V2.89.0` 再建 `tdc_resource_field`;`V2.92.0` 删 8 张开发中心表;`V2.94.0` 删 `tdc_demand`)。 + - tdc-rs 的 `schema/migrate.sql`(3017 行)是**82 条迁移**时的快照;上游迁移号已到 `V2.94.0` ⇒ **快照很可能已落后**,须重放后逐名对账。 + - tdc-rs 现有 30 张表与上游「活 30 张」**是否同名同构**,B0 出差异表后决定。 +- 产物:`schema/migrate.sql` 仍是**唯一** schema 来源(`include_str!` 内嵌进二进制,**不在 web root**,两层 DDL 守卫不变);`scripts/gen-migrate.sh` 保证可重放。 +- 🔴 **改 schema 必须清空 `data/` 重建**(`CREATE TABLE IF NOT EXISTS` 不改已有表)——`scripts/reset-data.sh` 已有。 + +### 3.3 `base_*` 的 DDL 来源 + +- 逐字取自上游 `boot/db/j7/V1.0.0__jnpf_base_schema.sql` 的 `base_user`(`:17384`)/`base_role`/`base_role_relation` 三张 `CREATE TABLE`。 +- 与技能模板 `ssw-jnpf-lite-rust/src/backend/db/schema.sql` 的同名字段**逐列一致**(已实测:7 张表列名全等)⇒ 两边不打架,选哪份都行,取**上游 j7** 为真源。 +- 官方两个 DDL 陷阱**照上游保留不修正**(官方 JNPF 侧依赖它们):用户 id 在 `base_role_relation.f_object_id`(配 `f_object_type='user'`),**没有 `f_user_id`**;组织/岗位关系在 `base_user_relation`(本仓不建该表,因不用组织/岗位源)。 +- 主键:官方 `base_user` 的 `CREATE TABLE` **没有主键**(官方 dump 后续 `ALTER` 才加)⇒ 本仓加 `PRIMARY KEY (f_id, f_tenant_id)`,与技能模板一致(上游 j7 跑在真 PG 上有 `ALTER`,本仓 pglite 只吃 `migrate.sql` ⇒ 必须自带)。 + +--- + +## 4. 账号层:一步切 `base_user`(D5) + +### 4.1 表与种子 + +| 表 | 用途 | 种子 | +|---|---|---| +| `base_user` | 账号(`f_account` / `f_password` / `f_secretkey` / `f_is_administrator` / `f_enabled_mark` / `f_delete_mark` …) | 首个管理员(见 §4.3) | +| `base_role` | 角色(`f_en_code`) | `tdcProvider` / `tdcConsumer` / `user`(照上游 `V1.0.1__connector_seed.sql` 的三行) | +| `base_role_relation` | 用户↔角色 | 管理员 → 某角色(或直授角色码,见 §4.3) | + +- ⚠️ **上游自身的不一致,照抄并记录**:`AuthController` 的角色判据是 `f_en_code IN ('tdcProvider','tdcConsumer','tdsReadOnly')`,但 `connector_seed` 只种了 `tdcProvider`/`tdcConsumer`/`user` ⇒ **`tdsReadOnly` 是悬空角色码**(上游自己的)。本仓**照上游**:判据保留三个码,种子只种三个角色(`tdcProvider`/`tdcConsumer`/`user`),`tdsReadOnly` 不主动种。 + +### 4.2 口令:官方双 md5 公式(**不可逆**) + +- **存储**:`f_password = md5(lower(md5(明文)) + lower(f_secretkey))`,`f_secretkey` = 每账号随机 UUID(官方 `UserServiceImpl` 口径)。 +- **登录比对**:前端 cipher 不变(`md5(明文)` → AES-256-ECB-PKCS7 → hex,`src/cipher.rs` 一字不改)⇒ 服务端解密得 `md5(明文)` → 拼 `lower(secretkey)` → 再 `md5` → 与 `f_password` 比。 +- **新建/改密**:自动生成 `f_secretkey`(改密不换 secretkey,与官方一致)。 +- 🔴 **一次性换算是单向不可逆的**(技能 `MIGRATION.md §7.2`):`f_password = md5(lower(旧裸 md5 hex) || lower(新 secretkey))`。 +- 🔴 **存量 `data/accounts.json` 不导入**(D5「一步切」+ 上游是「账号体系自给」):`data/accounts.json` **文件保留不删**(个人/运行期数据不擅自删),但**后端不再读取**。存量账号不迁移 ⇒ 首次启动用 §4.3 的引导账号。 + +### 4.3 引导与管理员 + +- 首次启动(`base_user` 为空时)引导 **一个管理员**:`f_account='admin'`、`f_is_administrator=1`、`f_enabled_mark=1`、按 §4.2 公式存口令(沿用 tdc-rs 现有「首启引导 admin/admin」习惯,**用官方公式存**,不是裸 md5)。 +- 引导管理员**绑定角色**:写一行 `base_role_relation`(`f_object_type='user'`、`f_object_id=`、`f_role_id` = `user` 角色的 `f_id`)⇒ 管理员账号同时具备 `user` 角色码(对齐上游 `connector_seed` 建的第三个角色 `user`)。 +- 管理员判据 = `base_user.f_is_administrator = 1`(`f_delete_mark IS NULL OR = 0`),**查询异常 ⇒ false(fail-closed)**——与上游 `TdcConnectorAdminGuard`(`@DS("master")`)**逐条同源**。 +- 该判据守住 `/api/permission/Users*` 六个端点(上游实测:JNPF 自带用户管理端点**无门禁**,非管理员也能 `GET /api/permission/Users` ⇒ 上游自写 `TdcConnectorAdminGuard` 补门;Rust 侧现有「仅管理员」闸门**同款**)。 + +### 4.4 双账号根(与上游同构) + +| 根 | 端点 | 载体 | 用途 | +|---|---|---|---| +| JNPF 账号 | `POST /api/oauth/Login` | `base_user` | 控制台用户登录(上游走官方 `jnpf-oauth-controller`) | +| 连接器身份 | `POST /api/ssw/tdc/Auth/Login` | `tdc_identity`(`identityCode`+`secretKey` → `X-Auth-Token`,30min) | standalone 模式(上游 `AuthController`,`ssw.tdc.standalone=true` 才装配) | + +⇒ tdc-rs 现状**已是双根**(`account.rs` + `domain/identity.rs`)⇒ 本次只把「JNPF 账号根」的载体从 JSON 换成 `base_user`,身份根不动。 + +--- + +## 5. 权限模型:按上游(D6) + +### 5.1 三件套(照上游) + +1. **登录态**:`/api/oauth/Login` 成功 ⇒ 会话令牌(`Authorization: bearer` / `X-Auth-Token`)。 +2. **角色码**:`base_role.f_en_code` ∈ {`tdcProvider`, `tdcConsumer`, `tdsReadOnly`}(经 `base_role_relation` 关联用户)——照上游 `AuthController` 的 SQL 形状。 +3. **管理员位**:`base_user.f_is_administrator = 1`(fail-closed)⇒ 守用户管理端点。 + +### 5.2 删除什么(D6 的代价,**显式记账**) + +- ❌ `src/registry.rs` 的 `PERMISSION_KEYS`(18 条实体→权限键)。 +- ❌ `src/domain/identity.rs` 的 `capabilities()` 与「能力集解析不出 ⇒ fail-open」的判定。 + (⚠️ **只删这两个函数,不动该文件里的连接器身份登录** `/api/ssw/tdc/Auth/Login`——那是 §4.4 的第二个账号根,保留。) +- ❌ 「写操作按权限键二次校验」的整条链路(`crud.rs` 内的权限键判定分支)。 + +**后果(必须知情)**:Rust 侧**不再**有实体级写权限隔离——任何登录用户可调全部实体端点,只读/只写分档(§2.2)仍在。**这与上游一致**(上游 `TdcCrudController.requireMenuPermission()` 在 `permissionGuard == null` 时只校验「有登录态或内部令牌」)。 + +**为何不保留细粒度**:上游 `ssw.jnpf-permission.enabled=false` 是**架构决定**(连接器不读 j7 菜单、前端路由静态 + 角色分流),Rust 侧若单方面加实体级门禁 ⇒ 两边行为不一致,且需为 18 键补 `base_module` 菜单(上游明确不建)⇒ 反而制造「看似对齐实则不同」的偏差。**记为「刻意分歧」= 无分歧,本次是追平。** + +### 5.3 鉴权失败形状:**不变**(已是上游口径) + +- 上游 `TdcAuthFilter`(`boot/ssw-tdc-admin/.../TdcAuthFilter.java:129-141`)= **HTTP 401/403 + 裸 `{"success":false,"code":401,"msg":"…"}`**(**无 `data` 键**)。 +- tdc-rs 现状相同 ⇒ **不动**。(技能框架那套「HTTP 200 + `code` 600/602」是 **JNPF 平台**形状,不是 TDC 的;D1 已排除面 B。) +- 三道门顺序与文案照上游:协议版本闸门(`X-Protocol-Version`)→ 内部令牌(`X-Internal-Token`)→ 会话令牌。 + +--- + +## 6. 业务层 + +### 6.1 实体拆分(对齐上游 27 实体) + +- 现有 18 个注册表实体 → `tdc/entity/` 下 18 个文件(列清单 / json_key / numeric / hidden / frozen / 分档)。 +- 上游 27 个 Java 实体中,**tdc-rs 未暴露的 9 个**里 **7 个是子表**(`ResourceField` / `ResourceMaskRule` / `DataInterfaceField` / `DataInterfaceParam` / `DeliveryTaskParticipant` / `DeliveryOutbox` / `DemoCarInsurance`)——上游也**没有**给它们独立控制器,走父实体聚合 ⇒ **不新增端点**,改为在父实体的聚合详情里覆盖(对齐上游口径)。 +- 真正缺独立端点的上游控制器(**全部属下一批 B5+**,本批不做):`ApiDoc` / `ApiGateway` / `EngineJob` / `File` / `P2PChannel` / `Portal` / `SandboxSession` / `Topology` / `TradeOrderBridge` / `UsageMetricReport` / `Instance`(约 30–40 端点)。 +- 表集**不动**(30 张 → 追平上游后可能变,见 §3.2)——**B0 出差异表后再定**。 + +### 6.2 聚合详情 + +- 现有 `Resource/{id}/Detail` / `Dataset/{id}/Detail` 扩到上游同款口径(含子表:字段、脱敏规则、接口字段/参数、交付参与方/outbox)。 + +### 6.3 动作端点(**本批不做**) + +- 上游「~130 个动词」的实测量级 ≈ 11 个未覆盖控制器 ⇒ 约 30–40 端点(`Resource/{id}/Sync`、`Product/{id}/OnShelf`、`DeliveryTask/{id}/Policy`、`Contract/{id}/Negotiate`、`SandboxSession/*`、`File/*`、`P2P/*`、`TradeOrderBridge/*`…)。 +- 分批规则:**按控制器一批一份 spec**,每批端到端可验收;B5 起。 + +--- + +## 7. 对外契约变化清单(对上游 SPA 的影响) + +| # | 契约 | 变化 | 上游 SPA 是否受影响 | +|---|---|---|---| +| C1 | `/api/oauth/Login` | 请求体**不变**(`account`/`password`密文 hex/`grant_type=password`);**响应语义不变**(`{token, expiresIn}`)⇒ 浏览器侧 cipher 一字不改 | ❌ 无感 | +| C2 | 口令校验 | 存储公式变了(裸 md5 → 官方双 md5);**旧账号全部失效**(不导入存量)⇒ 用户须用引导账号或重建账号 | ⚠️ 需告知 | +| C3 | `/api/permission/Users*` | 存储换 `base_user`;出参形状**不变**(`account_view` 手工挑字段) | ❌ 无感 | +| C4 | 实体级写权限 | **取消**(D6)⇒ 非管理员也能写实体(只读分档仍在) | ⚠️ 行为变宽 | +| C5 | `/api/health` | `tables` 语义**改为业务表数**(`tdc_*`),新增 `baseTables`;总计 30 + 3 = 33 | ❌ 上游 SPA 不读 | +| C6 | 业务端点 | 形状**不变**(18 实体的 6 条 CRUD 路由 + 聚合详情 + 10 个 TDS 端点全部保留) | ❌ 无感 | +| C7 | 鉴权失败 | **不变**(401/403 裸 body) | ❌ 无感 | + +--- + +## 8. 分批实施与验收 + +| 批 | 内容 | 动代码? | 验收 | +|---|---|---|---| +| **B0** | **只读核查**:重放上游迁移 → 算出「建过/活/删」表集;与 tdc-rs 的 30 张逐名对账;列 27 实体 / 33 控制器的覆盖差 | ❌ | 差异表落 `docs/superpowers/2026-10-26-tdc-rs-upstream-diff.md` | +| **B1** | **包结构重组**(行为零变化):`registry.rs`→`entity/`、`crud.rs`→`mapper+service+controller`、`routes/`→`controller/`、`tds/`→`client/` | ✅(纯搬家) | `cargo test` **223 条全绿**(改完 grep 复核全部改动点)+ `docs/CONSOLE-ACCEPTANCE.md` 的浏览器验收重跑 | +| **B2** | **schema 追平**:`scripts/gen-migrate.sh` 重放到上游最新;`base_user`/`base_role`/`base_role_relation` 入 `migrate.sql` | ✅ | migrate.sql 可重放;表集与上游逐名对齐;`data/` 清空重建后 `/api/health` 的 `tables`/`baseTables` 符合预期 | +| **B3** | **子表聚合补齐**:聚合详情扩到上游口径(覆盖 7 个子表:`ResourceField` / `ResourceMaskRule` / `DataInterfaceField` / `DataInterfaceParam` / `DeliveryTaskParticipant` / `DeliveryOutbox` / `DemoCarInsurance`) | ✅ | 聚合详情字段齐全断言 + 父子表一致(建子行 → 父详情可见) | +| **B4** | **账号层切换**:删 `accounts.json` 读取路径;`base_user` 落库;官方双 md5 公式;管理员位 fail-closed;角色码三件套;`/api/permission/Users*` 改读写 `base_user`;**删除 18 权限键链路**(D6) | ✅ | 登录 / 用户管理 / 管理员位 / 角色码四组断言 + 存量导入**不做**的确认 + 上游公式自证(`md5(md5(plain)+secretkey)` 往返) | + +**尺子**:`cargo test`(B1 后应仍 223 条,B3/B4 增新断言)+ `docs/CONSOLE-ACCEPTANCE.md` 浏览器验收 + **新增两条跨端断言**: +1. 账号口令按官方公式存储且可登录(跨 Java/Rust 可通); +2. 非管理员/管理员的 `base_user.f_is_administrator` 判定与上游 `TdcConnectorAdminGuard` 同义。 + +**不做**:`perm-smoke-jnpf.sh`(面 B 作废,D1)。 + +--- + +## 9. 刻意分歧与已知不覆盖 + +| # | 分歧 | 理由 | +|---|---|---| +| S1 | 权限**无**实体级隔离(D6) | 追平上游(`jnpf-permission.enabled=false`)⇒ 不是分歧,是追平;记此以免后人误加 | +| S2 | 鉴权失败用 **401/403 裸 body**(非 200+600/602) | 上游 `TdcAuthFilter` 就是这样 ⇒ 追平 | +| S3 | `base_*` 只建 3 张(上游 j7 有 123 张) | 上游只用账号/角色链路 ⇒ 功能等价,少 120 张空表 | +| S4 | 单库单 schema(上游两库) | D4;表名逐字一致 ⇒ 导数据零改写 | +| S5 | 无 `base_module` 菜单、无 `f_en_code` 点权限 | 上游明确不建 | +| S6 | 不跑 Nax 隐私计算作业 | 依赖 Nax 引擎 + scard 软 PKI/软 TPM,本地不可行(`tdc_*_exec_run` 表仍提供 CRUD) | +| S7 | `tdsReadOnly` 判据在、种子不种 | 照抄上游自身的不一致(§4.1) | + +--- + +## 10. 风险与回滚 + +| 风险 | 等级 | 处置 | +|---|---|---| +| B1 搬家动 223 条测试与浏览器验收 | 中 | 纯搬家不改行为;**同文件多 Edit 必须串行**;每步 `cargo test` + grep 复核 | +| B2 schema 追平引发**存量数据不可用** | 中 | 全新 `data/` 重建(B2 本就要求清空);`scripts/reset-data.sh` | +| B4 换口令公式 ⇒ **旧账号全失效** | 中 | 已知且为 D5 的一部分(C2);引导账号兜底;`data/accounts.json` 保留可查 | +| 上游仍在动(迁移号已到 V2.94.0) | 中 | B0 差异表 + `gen-migrate.sh` 可重放;**快照式**对齐,不追上游 git 历史 | +| 权限放宽后暴露越权写入 | **高** | 知情决策(D6/§5.2);上线前确认账号发放只给受信人;如需收紧,回退点是「保留 18 键分支」 | +| `/api/health` 契约变动 | 低 | `tables` 语义改为业务表数 + 新增 `baseTables`;同步测试与文档 | + +--- + +## 11. 文档与记忆同步清单(B1–B4 完成后) + +- `CLAUDE.md`:目录树(`src/tdc/**`)、红线(**删**「权限键 + 能力集」那条,**加**「权限按上游三件套」)、表清单(30 + 3)、坑表补 3 条(账号层换表 / 口令公式 / 权限无实体级)。 +- `docs/`:新增 `docs/ACCOUNT-LAYER.md`(`base_user` 契约 + 官方公式 + 管理员位);`docs/CONSOLE-ACCEPTANCE.md` 重跑;`docs/known-limitations.md` 记 D6 的安全后果。 +- `.workbuddy/memory/2026-10-26.md`:工作日志(每批一段)。 +- 记忆(本机):**旧口径「tdc-rs 用 accounts.json 不建 base_* 表」已作废** ⇒ 需更新项目级记忆条目。 + +--- + +## 12. 决策记录 + +| # | 决策 | 取值 | 来源 | +|---|---|---|---| +| D1 | 前端 | 继续用上游 Vue SPA(不做面 B) | 用户拍板 | +| D2 | 业务边界 | 与上游一致,**分批**,本批只做底座 | 用户拍板 | +| D3 | 业务包 MVC | 对位上游包结构 + **保留通用引擎** | 用户拍板 | +| D4 | 库 | 单库 | 用户拍板 | +| D5 | 账号层 | 一步切 `base_user`(官方双 md5) | 用户拍板 | +| D6 | 权限 | **按上游**(角色码 + 管理员位,删 18 键) | 用户拍板 | +| D7 | 面 B / `perm-smoke-jnpf.sh` | **不做** | 由 D1 推导 | +| D8 | 存量 `accounts.json` 账号 | **不导入**(D5 推导;文件保留不删) | 由 D5 推导 | +| D9 | `tdsReadOnly` | 判据在、种子不种(照抄上游不一致) | §4.1 |