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

12 KiB
Raw Blame History

上游控制台 · 浏览器级验收(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. 怎么复现

# ① 起连接器(首启会打印一次性 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 + 裸三字段:

{"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 正常跑,抽屉正常滑入)。

自动化里怎么绕过(本次验收用的就是这个):

// ① 关掉 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)。