docs: 补上游控制台浏览器级验收(R3 收口)—— 逐页实测 + 两个 TDS 代理页定性

- docs/CONSOLE-ACCEPTANCE.md: 新增。上游完整前端(SPA)在真实浏览器里
  逐页走查的记录:17 个路由全部渲染、15 个页面调用全 200;复现命令;
  契约核对(上游 cipher.ts 的登录密文链、令牌落 localStorage 且不带
  bearer 前缀、401 裸三字段无 data 键);写路径/账号分层的正负向实测。
- 两个 404 定性:服务目录(ServiceCatalog)与我的账单(Billing/List)
  是 TDS 代理页(上游 controller 直接转发 TDS,本地无表)⇒ 属 P4,
  不是缺陷。
- 顺带确认只读分档与上游 UI 天然对齐:/tdc/datasets 上游本来就没有
  「新建」按钮 ⇒ Dataset 禁增分档在控制台里不会变成报错。
- 踩坑记录:内核浏览器在后台标签时 visibilityState=hidden ⇒ rAF 与
  CSS transition 全冻结 ⇒ antd 抽屉卡在 enter-start(停在屏幕外),
  表现为「点不到保存按钮」。这是测试环境假象,注入
  *{transition:none !important} + 摘掉卡住的 motion 类可绕过。
- README: 控制台(前端)小节补实测结论与文档指针;「明确不在 MVP 内」
  补两个 TDS 代理页;目录树补 docs/CONSOLE-ACCEPTANCE.md。
- .workbuddy/memory/2026-10-25.md: 工作日志。
- 验收数据已清理:探针账号 r3probe 已删;测试数据源已逻辑删除。
- 本轮未改源码 ⇒ cargo test 仍 207 passed / 0 failed / 1 ignored。

Co-Authored-By: Claude Code <[email protected]>
This commit is contained in:
adminandClaude Code committed 2026-10-25 12:23:26 +08:00
1 parent 3586333a7a
commit 3bb545513d
3 files changed
+252 -1

No files matched your search

+27
View File
@@ -0,0 +1,27 @@
# 2026-10-25 工作日志
## 上游控制台浏览器级验收(R3 收口)
**做了什么**:起 `PORT=30000 ./target/debug/tdc-connector` + xstudio 内核浏览器(`aix`),
把上游完整前端(SPA)**逐页点了一遍** —— 登录 → 连接器身份 → 用户管理 → 18 实体各列表页
→ 新建/删除写路径 → 非管理员负向用例。
**结果**(逐页表格与复现命令见 `docs/CONSOLE-ACCEPTANCE.md`):
- 17 个路由全部渲染,无白屏/无崩溃;15 个页面的后端调用全 `200`。
- 登录走**上游自己的 `cipher.ts`** ⇒ `admin`/`admin` 一键过 ⇒ 密文契约在**浏览器这一层**被验过。
- 写路径真跑通:浏览器里建了一条数据源(`POST` 200「新增成功」→ 行渲染 → 逻辑删除 → 列表清空)。
- 账号分层生效:非管理员账号登录后进 `/tdc/users` ⇒ `403` + toast「仅管理员可管理连接器用户」。
- 只读分档与上游 UI 天然对齐:`/tdc/datasets` 上游**本来就没有「新建」按钮** ⇒ 禁增分档不会变成报错。
- 两个 404(`服务目录` / `我的账单`)定性为 **TDS 代理页**(本地无表)⇒ 属 P4,**不是缺陷**。
**踩坑(已写进 `docs/CONSOLE-ACCEPTANCE.md` §5)**:内核浏览器在**后台标签**时
`document.visibilityState === "hidden"` ⇒ rAF 与 **CSS transition 全部冻结** ⇒
antd 抽屉的 motion 卡在 `enter-start`(停在屏幕外),表现为「点不到保存按钮」。
**这不是产品缺陷**(真人可见的浏览器里正常);自动化里注入 `*{transition:none !important}`
+ 摘掉卡住的 motion 类即可绕过。
**副作用清理**:探针账号 `r3probe` 已删;测试数据源已逻辑删除(留墓碑行,属产品语义)。
**本轮改动**:`docs/CONSOLE-ACCEPTANCE.md`(新)、`README.md`(目录树 + 控制台小节 +
「不在 MVP 内」补 TDS 代理页)、本日志、SDD 台账追加。
+9 -1
View File
@@ -60,6 +60,9 @@ static/
若回 HTML,前端会判 `body.code === undefined` 而**不 reject** ⇒ 静默渲染空表,
把「接口没了」误读成「没有数据」。
- 🔴 保留红线:**前端不直接持有数据库**(它只发 REST 请求)。
- ✅ **浏览器级实测**(2026-10-25):17 个路由逐个点过 —— 登录 / 鉴权 / 写路径 /
管理员闸门 / 逻辑删除全部按上游预期工作;两个 **TDS 代理页**(服务目录 / 我的账单)
按规划 404(属 P4)。逐页结果与踩坑见 **`docs/CONSOLE-ACCEPTANCE.md`**。
## 编译缓存(按 dev-cache-layout 规范)
@@ -181,6 +184,11 @@ sccache 0.18 经 `~/.cargo/config.toml` 的 `[build] rustc-wrapper` + `[env] SCC
Quality* / HostingJob` 等控制器依赖 **Nax 隐私计算引擎**与 **scard 安全平面(软 PKI / 软 TPM)**,
未纳入本次重做。若需这部分,应保留原 Java/Scala 服务,或将其作为独立后端通过 HTTP 契约接入本连接器。
另外两个上游控制台页面依赖 **TDS 侧数据**(本仓不代理 TDS ⇒ 404 `接口不存在`,属 P4):
`/tdc/service-catalog`(`ServiceCatalog` ⇒ 代理 TDS 目录查询)与
`/tdc/billing`(`Billing/List` ⇒ 账单在 TDS 侧)。二者**本地无表**,
契约清单见 `docs/TDC-TDS-CONTRACT.md`。
## 目录
```
@@ -199,7 +207,7 @@ tdc-rs/
│ └── migrate.sql # tdc_* schema(include_str! 内嵌进二进制;**不在 web root**;30 表)
├── scripts/ # build-frontend.sh(前端产物)/ gen-migrate.sh(schema 生成)/ reset-data.sh
├── tests/ # 集成测试(account_api / api_smoke / auth_flow / crud_engine / permission_gate / spa_fallback / bootstrap_fail)
├── docs/ # 补充文档(DDL-GUARD.md / TDC-TDS-CONTRACT.md)
├── docs/ # 补充文档(DDL-GUARD.md / TDC-TDS-CONTRACT.md / CONSOLE-ACCEPTANCE.md)
├── tds-stub/ # 本地 TDS 契约桩(零依赖,仅供端到端调试)
└── data/ # 运行期数据(tdc.pg/ + accounts.json,已 gitignore)
```
+216
View File
@@ -0,0 +1,216 @@
# 上游控制台 · 浏览器级验收(R3)
> 日期:2026-10-25
> 被测物:本仓 `tdc-connector`(debug 构建,`:30000`)+ `static/` 里的**上游完整前端构建产物**
> (`VITE_SSW_APP=tdc`)
> 驱动:`aix`(xstudio 内核 CDP 浏览器,`http://127.0.0.1:19999`)
> 结论:**17 个 SPA 路由逐个点过** —— 15 个页面的后端调用全 `200`;2 个页面是
> **TDS 代理页**(P4)⇒ `404 接口不存在`;登录 / 鉴权 / 写路径 / 管理员闸门 / 逻辑删除
> 全部按上游预期工作。
本文件是**实测记录**,不是设计说明。命令与结论都可复现。
---
## 1. 怎么复现
```bash
# ① 起连接器(首启会打印一次性 secretKey —— 不要把 stdout 落进文件或报告)
PORT=30000 ./target/debug/tdc-connector
# ② 起浏览器内核(幂等;健康检查 /health 的 ok:true 即就绪)
bash /Users/xs/Documents/x/xstudio/source/scripts/xstudio-up.sh
export AGENTX_XSTUDIO_BASE=http://127.0.0.1:19999
# ③ 走查
aix open http://127.0.0.1:30000/ # ⇒ 跳 /login?next=/tdc/home
aix snapshot -i # 拿 @eN(账号 / 口令 / 登录按钮)
aix fill @e41 admin && aix fill @e42 admin && aix click @e44
```
> 🔴 本机 curl 测 localhost **必须**加 `--noproxy '*'`,否则被系统代理劫持成 502。
> 🔴 页面里的 API 基址是**同源相对路径** `/api`(`axios.create({baseURL:"/api"})`),
> 所以「静态托管 + API 同端口」是上游前端能跑的前提。
---
## 2. 逐页结果
17 条路由全部渲染出页面(`h1` 标题 + 表格壳),**没有白屏、没有崩溃**。
| 路由 | 页面标题 | 页面发出的后端调用 | 结果 |
|---|---|---|---|
| `/tdc/home` | 工作台 | —(首页数字是上游自带的**示例占位值**) | ✅ |
| `/tdc/identity` | 连接器身份 | `Auth/Me`、`Identity?currentPage=1&pageSize=10`、`Identity?pageSize=1` | ✅ 全 200,**表里真的有 `LOCAL-CONNECTOR` / 本地连接器** |
| `/tdc/credentials` | 身份认证授权 | `Credential?currentPage=1&pageSize=10` | ✅ 200 |
| `/tdc/audit-local` | 本地审计日志 | `AuditLog?currentPage=1&pageSize=10` | ✅ 200 |
| `/tdc/mask-destroy` | 数据销毁 | `DestroyLog?currentPage=1&pageSize=10` | ✅ 200 |
| `/tdc/products` | 数据产品 | `Auth/Me`、`Auth/Spaces`、`Identity?pageSize=100`、`PolicyTemplate/Options`、`Product?currentPage=1&pageSize=20`、`Resource/Enabled` | ✅ 全 200,无错误 toast |
| `/tdc/policy-templates` | 策略模板 | `PolicyTemplate?currentPage=1&pageSize=10` | ✅ 200 |
| `/tdc/contracts` | 合约副本 | `Contract?currentPage=1&pageSize=10` | ✅ 200 |
| `/tdc/service-catalog` | 服务目录 | `ServiceCatalog?currentPage=1&pageSize=20` | ⚠️ **404**(TDS 代理页,见 §4) |
| `/tdc/delivery` | 数据交付 | `DeliveryTask?currentPage=1&pageSize=1`、`DeliveryTask?currentPage=1&pageSize=10`、`DeliveryTask/EngineSelfCheck?force=false` | ✅ 全 200 |
| `/tdc/demand-order` | 订单管理 | `Order?currentPage=1&pageSize=10` | ✅ 200 |
| `/tdc/billing` | 我的账单 | `Billing/List?currentPage=1&pageSize=10` | ⚠️ **404**(TDS 代理页,见 §4) |
| `/tdc/datasources` | 本地数据源 | `Datasource?currentPage=1&pageSize=10`、`Datasource/Types` | ✅ 200,**写路径实测通过(§3.3)** |
| `/tdc/data-interfaces` | 数据接口 | `DataInterface?currentPage=1&pageSize=20` | ✅ 200 |
| `/tdc/resources` | 数据资源 | `Resource?currentPage=1&pageSize=10` | ✅ 200 |
| `/tdc/datasets` | 数据集 | `Dataset?currentPage=1&pageSize=10` | ✅ 200(只读视图,见 §3.5) |
| `/tdc/users` | 用户管理 | `permission/Users?currentPage=1&pageSize=10` | ✅ 200,**表里真的有 `admin` / 管理员** |
**没有任何一个页面出现「白屏 / 路由 404 / JS 崩了」。**
---
## 3. 关键链路实测
### 3.1 登录(上游 JNPF 兼容链)
- 页面:`/login?next=/tdc/home`,**未登录直接访问深链会被弹回登录页**(前端路由守卫 ✅)。
- 填 `admin` / `admin` ⇒ `POST /api/oauth/Login` **200** ⇒ 跳 `/tdc/home`。
- 走的是**上游前端自己的 `cipher.ts`**:口令在浏览器里被加密成 AES-256-ECB 的 hex 才发出去
⇒ **这条链同时验了「密文契约」与「账号库」**,不依赖本仓的自造向量。
- 令牌落在 `localStorage['ssw_token_sswflow']`(32 位 hex,**不带 `bearer ` 前缀** ——
前缀由前端 `setToken` 自己补)。
- 后续请求带 `Authorization: bearer <token>` ⇒ `Auth/Me` 200、`accessAllowed: true`。
### 3.2 鉴权失败的形状(**契约核对**)
无凭证访问受保护端点 ⇒ **HTTP 401** + 裸三字段:
```json
{"code":401,"msg":"内部接口凭证无效","success":false}
```
**没有 `data` 键** ✅ —— 与 README「业务失败 200 + `{code,msg,data}` / 鉴权失败 401 + 裸三字段」
的约定一致;前端据此跳登录页而不是把失败当成功。
### 3.3 写路径(浏览器里真的建了一条数据源)
在 `/tdc/datasources` 点「新建」填表(名称 / 类型 POSTGRESQL / 主机 / 端口 / 库名 / 归属部门 / 备注):
```
POST /api/ssw/tdc/Datasource 200 ⇒ toast「新增成功」⇒ 抽屉自动关闭 ⇒ 列表自动刷新
GET /api/ssw/tdc/Datasource?… 200
```
表格里那一行确实带上了提交的每个字段:
```
DS-20261025-PBRRK6 | R3-浏览器验收数据源 | POSTGRESQL | 127.0.0.1 | 5432 | r3_probe | … | R3验收 | 启用
```
(`DS-20261025-xxxxxx` 是**本仓生成的标识**,不是上游的格式 —— 上游这一列是给人看的
`f_data_source_code`,值由后端生成。)
### 3.4 逻辑删除(用**浏览器自己那张令牌**)
拿 `localStorage` 里那张会话令牌调 `DELETE /api/ssw/tdc/Datasource/{id}` ⇒
**HTTP 200 `{"code":200,"msg":"删除成功"}`** ⇒ 再查列表 `total=0` ⇒ 刷新页面表格回到
「No data」。⇒ **逻辑删除 + 列表过滤在浏览器这一侧是自洽的。**
### 3.5 只读分档与上游 UI 天然对齐
| 页面 | 上游 UI 给的写入口 | 本仓 `registry.rs` 分档 | 对齐? |
|---|---|---|---|
| `/tdc/datasets` | **无「新建」按钮**(只有 查询/刷新/重置) | `Dataset` 禁增/改/删(`tdc_resource` 的只读视图) | ✅ |
| `/tdc/audit-local` | 无「新建」(另有「哈希链完整性校验」) | `AuditLog` 禁改禁删、**可增** | ✅(上游更严,多出来的能力点不到) |
| `/tdc/delivery` | 「发起交付」「引擎自检」,无新建 | `DeliveryTask` 禁增禁删、可改 | ✅ |
| `/tdc/mask-destroy` | 无新建 | `DestroyLog` 禁增禁删、可改 | ✅ |
| `/tdc/contracts` | 无新建 | `Contract` 禁删、可增可改 | ✅(上游更严) |
| `/tdc/resources` | 新建 | `Resource` 可增 | ✅ |
| `/tdc/users` | 新建 | 账号层可增 | ✅ |
⇒ **只读实体在控制台里根本点不出「新建」按钮**,所以「禁增」分档不会在 UI 上变成一条
红色报错。
### 3.6 管理员闸门(**负向用例**)
浏览器里建了一个**非管理员**账号 `r3probe`(默认口令 `123456`):
1. `POST /api/permission/Users` 200「新增成功」⇒ 列表里出现 `r3probe / R3探针`。
2. 清掉 `localStorage` 后用 `r3probe` / `123456` 登录 ⇒ **登录成功**(非管理员也能登进控制台)。
3. 打开 `/tdc/users` ⇒ `GET /api/permission/Users` ⇒ **403** ⇒ toast
**「仅管理员可管理连接器用户」** ⇒ 表格空(`No data`)。
⇒ 账号分层(管理员 / 子账号)在**浏览器这一层**是生效的,不是只在单测里。
### 3.7 顺手核对到的契约事实
- 上游 `cipher.ts` 的自检向量(`encryptPassword('123456')`)在 Node 里复算一致 ⇒
本仓 `src/cipher.rs` 的密钥/编码与上游逐字对齐。
- 前端 axios 实例是 `baseURL: "/api"`(**相对**)⇒ 后端必须与静态产物**同源同端口**。
- 未知 `/api/**` 命中的是**页面级 404 + JSON**,前端因此显示「接口不存在」而不是把
HTML 当成功数据渲染(见 README「控制台(前端)」小节)。
---
## 4. 两个 404 的定性:`服务目录` / `我的账单` 是 **TDS 代理页**,属 P4
读上游 `boot/ssw-tdc/…/controller/`:
- `ServiceCatalogController`:`GET /api/ssw/tdc/ServiceCatalog` → 走
`tdsReportClient.catalogSearch(...)` / `internalCatalog(...)` —— **跨服务代理 TDS 的目录查询**,
本地无表。
- `BillingController`:`GET /api/ssw/tdc/Billing/List` → `tdsReportClient.listBillingForConnector(...)`
—— **账单在 TDS 侧**。
⇒ 这两个端点**本来就不属于「本地 18 实体」**,`docs/TDC-TDS-CONTRACT.md` 已把它们列进
P4 的出向客户端范围。**本仓不实现它们是对的**;当前的表现是 `404 + {"code":404,…}` ⇒
前端弹「接口不存在」—— 这正是我们想要的(**别把「接口没了」静默渲染成空表**)。
> ⚠️ `服务目录` 页的 404 目前**不弹 toast**(页面自己吞了),`我的账单` 会弹。
> 两条都不影响其余功能,但要在上游侧统一的话属于前端改动 —— 本仓**不自研前端**,不动。
---
## 5. 踩坑:**后台标签页会冻结 CSS transition** ⇒ 抽屉看起来「坏在屏幕外」
**现象**:自动化里点「新建」,抽屉的表单能填、但**点不到「保存」**:
`CDP error (Input.dispatchMouseEvent): no element at 1719, 776`(坐标在视口外)。
**定位**(逐层剥):
1. 抽屉容器有 `ant-drawer-open`,但 `.ant-drawer-content-wrapper` 的计算样式是
`transform: matrix(1,0,0,1,620,0)`(= `translateX(100%)`)⇒ **停在屏幕外**。
2. 它匹配的是 `…-panel-motion-right-enter-start` 规则 ⇒ **motion 卡在 enter 起始态**。
3. 页面 `document.visibilityState === "hidden"`(内核浏览器在后台标签)
⇒ `requestAnimationFrame` 与 **CSS transition 全部冻结**。
4. 铁证:给页面注入 `*{transition:none !important}` 后,抽屉立刻回到 `x=1780`(视口内)。
**结论:这是**测试环境的假象**,不是本仓的缺陷,也不是上游前端的缺陷**(真人可见的浏览器里
transition 正常跑,抽屉正常滑入)。
**自动化里怎么绕过**(本次验收用的就是这个):
```js
// ① 关掉 transition,让 rc-motion 的 enter 立刻落位
const s = document.createElement('style');
s.textContent = '*{transition:none !important}';
document.head.appendChild(s);
// ② 顺手把卡住的 motion 类摘掉
document.querySelectorAll('[class*=motion]').forEach(e => {
e.className = e.className.split(' ')
.filter(c => !c.includes('-motion-') && !c.includes('enter-prepare') && !c.includes('enter-start'))
.join(' ');
});
```
> 同一原因也会让 **Popconfirm / Modal** 停在动画中途 —— 本次「删除」按钮的二次确认
> 就因此点不动(`Element is covered by …ant-drawer-mask-motion-leave`),
> 那一例改用**浏览器自己那张会话令牌**直接打 `DELETE` 完成验证(§3.4)。
---
## 6. 遗留 / 边界
- **P4**:两个 TDS 代理页(服务目录 / 我的账单)在本仓是 404,属**规划内**。
- **上游那 100+ 个动作端点**(发布 / 下架 / 提交审核 / 策略校验 / 销毁 …)仍是 404/405,
本次走查里点到的都属于这一类,**分期的正常状态**。
- `/tdc/home` 的数字是上游自带的**示例占位值**(页面自己也写了「本页数字与清单均为示例占位值」),
不是本仓的聚合接口(聚合接口未建)。
- 验收数据已清理:探针账号 `r3probe` 已删;测试数据源已**逻辑删除**
(`f_delete_mark`)—— 库里留着一条墓碑行,属产品语义,不是残留。
- 浏览器控制台在登录页会报 4 条 `Script error.`:**同源脚本的运行时错误会带真实消息**,
`Script error.` 是**跨源脚本**被浏览器脱敏后的固定文案 ⇒ 来自内核注入的脚本,不是本仓产物
(同源 `/assets/*` 请求在网络日志里全是 200,没有加载失败的 chunk)。