- 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]>
12 KiB
上游控制台 · 浏览器级验收(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/Login200 ⇒ 跳/tdc/home。- 走的是上游前端自己的
cipher.ts:口令在浏览器里被加密成 AES-256-ECB 的 hex 才发出去 ⇒ 这条链同时验了「密文契约」与「账号库」,不依赖本仓的自造向量。
- 走的是上游前端自己的
- 令牌落在
localStorage['ssw_token_sswflow'](32 位 hex,不带bearer前缀 —— 前缀由前端setToken自己补)。 - 后续请求带
Authorization: bearer <token>⇒Auth/Me200、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):
POST /api/permission/Users200「新增成功」⇒ 列表里出现r3probe / R3探针。- 清掉
localStorage后用r3probe/123456登录 ⇒ 登录成功(非管理员也能登进控制台)。 - 打开
/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(坐标在视口外)。
定位(逐层剥):
- 抽屉容器有
ant-drawer-open,但.ant-drawer-content-wrapper的计算样式是transform: matrix(1,0,0,1,620,0)(=translateX(100%))⇒ 停在屏幕外。 - 它匹配的是
…-panel-motion-right-enter-start规则 ⇒ motion 卡在 enter 起始态。 - 页面
document.visibilityState === "hidden"(内核浏览器在后台标签) ⇒requestAnimationFrame与 CSS transition 全部冻结。 - 铁证:给页面注入
*{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)。