Files
tdc-rs/docs/CONSOLE-ACCEPTANCE.md
T
adminandClaude Code 3bb545513d 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]>
2026-10-25 12:23:26 +08:00

217 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 上游控制台 · 浏览器级验收(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)。