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:
1 parent
3586333a7a
commit
3bb545513d
3 files changed
+252
-1
No files matched your search
@@ -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 台账追加。
|
||||
@@ -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)
|
||||
```
|
||||
@@ -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)。
|
||||
Reference in new issue
Block a user