8.8 KiB
8.8 KiB
前端质量门根修 + Dashboard 信息密度重构 人工验收单(2026-11-13 深夜)
范围:web/ 前端(FE-Design P0~P3)。设计基线 demo-c-aurora 的 tokens/EP 换肤/布局壳/31 业务页零改动。
一、变更清单
| # | 任务 | 文件 | 说明 |
|---|---|---|---|
| P0 | vitest 91/137 红 → 138/138 绿 | web/vitest.setup.ts(+7 行) |
根因:vitest(mode=test)不加载 .env.development → request.ts 顶层 baseURL=undefined,spec 内 vi.stubEnv 晚于模块求值无效 → msw 全量 unhandled(实测请求裸奔为 POST /auth/login);修法=setup 顶部 stubEnv(setupFiles 先于被测模块求值,一处生效)。老机靠 gitignored 本地 env 掩盖,新机首跑暴露 |
| P1 | Dashboard 信息密度重构 | web/src/views/home/DashboardView.vue(241→约 470 行重写) |
见下节 |
| P2 | 图标体系统一 | 同上 | 指标卡 emoji(📮✓⚡⚠)+快捷卡符号(✉≡↻◐)→ EP icon;brand ✦ 保留 |
| P3 | 细节打磨 | 同上 + web/src/styles/shell.scss(+6 行) |
count-up(rAF 600ms/reduced-motion 跳过)、走势 hover 十字线+气泡(纯 SVG)、全局 :focus-visible |
| 附 | Teleport 冷启动竞态修复 | 同上 | #page-head-extra(MainLayout 渲染)晚于 Dashboard mount 时(Vue 3.4 无 <Teleport defer>)直接挂载 → 后续 patch 崩溃(TypeError: setText null nodeValue,fe_error_log 实证 2 条)→ 组件更新全中断(数据已返回但 UI 冻结);修法=v-if 门控延后一拍(该 bug 旧版同样存在,新机慢冷启动放大暴露) |
二、P1 信息密度(12 维 rubric 审计 54/110「精美的快照」档 → 预计 ~78)
| 变更 | 维度 | 内容 |
|---|---|---|
| 删假数据×3 | D3 | rateNow=1180+random(160) 假速率卡、8 条硬编码"示例"通道表、快捷卡死文案("5 条待复核/1,204 条可补") |
| 假速率→真审核卡 | D3/D9 | 「实时速率」→「待人工审核」(接口 pending_audit_count 早已返回但 UI 从未消费;点击直跳 /audit) |
| Hero 决策句 | D2/D8 | 四指标实时翻译为一句话判定(ok/warn/err/dim 四态+左光条+直达处置页),数据不可用时诚实降级 |
| 数据脉象 | D10 | live-chip → 「实时·HH:MM:SS / 连接异常·数据截至 / 不可用·点击重试」三态;catch 不再静默吞错 |
| 通道表真数据 | D3/D4 | channelApi.list 配置域快照(code/协议/运营商/限速/连接/优先级/状态徽章),表头诚实标注"运行统计待 S5 压测后接入";失败显式重试态 |
| 快捷卡联动 | D9 | desc 接实时指标(12 条待审/3 个预警),热态 amber |
| 7/30 日切换 | D1/D11 | trend(days) mock/后端双端已支持;30d x 轴抽稀 |
三、质量门(前端四件 + 实机)
| 项 | 结果 | 证据 |
|---|---|---|
| eslint(--max-warnings 0) | ✅ RC=0 | /tmp/fe-lint3.log |
| vue-tsc --noEmit | ✅ RC=0 | /tmp/fe-tsc3.log |
| vitest | ✅ 138/138(修复前 91 红) | /tmp/fe-test4.log |
| vite build | ✅ RC=0 | /tmp/fe-build3.log |
| verify-layout(18 断言) | ✅ 全过(Playwright 实渲染,mock 实例 :5174) | 唯一侧栏/双菜单/EP 壳零残留/收起 224→64/汉堡抽屉等 |
| Dashboard 运行时断言(15 项,自建脚本) | ✅ 全过 | hero warn 态+12 待审+3 预警文案、stat-audit=12、stat-speed 已删、脉象"实时·时刻"、快捷卡联动、通道表 3 行真数据+停用徽章、30 日切换、hover 气泡含提交/成功数 |
| 截图矩阵 | ✅ 5 页×双主题重刷 | web/shots/(home 修复后含真实数据态) |
| data-testid 兼容 | ✅ | 全保留(stat-speed 删除,tests/scripts grep 确认无引用) |
四、人工走查明细(协议 v3 · 本人执行,逐项勾选)
环境:
cd web && VITE_API_MODE=mock npx vite(:5173,admin/admin123);real 走查另起默认.env.development(:5173→proxy→:8080)。标 ★ 为自动化已覆盖、人工抽验即可;标 ☆ 为必须人眼/人手验证。
A · Hero 决策句(D2/D8,新增件)
| # | 操作 | 预期 | 级 |
|---|---|---|---|
| A1 | mock 登录 → /home | amber 左光条 + Warning 图标:「今日需要关注:3 个账号余额低于预警线 · 12 条短信待人工审核」,副行「其余指标正常 · 回执成功率 98.3%」 | ★ |
| A2 | 点击 hero | 跳转 /audit(待审优先);Tab 聚焦时 hero 有 teal focus 描边,Enter 可跳 | ☆ |
| A3 | real 模式 /home | 按真实指标呈对应态:ok=teal「平台运行平稳…」/ err=红「回执成功率…低于 95%」 | ☆ |
B · 四指标卡(P2 图标/P3 count-up)
| # | 操作 | 预期 | 级 |
|---|---|---|---|
| B1 | 刷新 /home 观察数字 | 今日提交从 0 滚动至 1,286,430(600ms,千分位);成功率滚至 98.3% | ☆ |
| B2 | 检查图标 | 四卡均为 EP icon(Promotion/CircleCheck/Bell/Wallet),全页无 emoji | ★ |
| B3 | 「待人工审核」卡 | mock=12 条、数值与铃铛 amber;点击整卡 → /audit | ★ |
| B4 | 「余额预警」卡 | mock=3 条、数值红;点击 → /account/list | ★ |
| B5 | 确认假卡已删 | 页面不存在「实时速率」卡(原 1180+random 假数据) | ★ |
| B6 | 系统「减少动态」开启后刷新 | 数字直接显示终值,无滚动 | ☆ |
C · 数据脉象 chip(D10,page-head 右侧)
| # | 操作 | 预期 | 级 |
|---|---|---|---|
| C1 | 静置观察 | teal 脉动圆点 +「实时 · HH:MM:SS」;悬停出 title;停留 >60s 时刻自动更新 | ☆ |
| C2 | 点击 chip | 立即刷新,时刻跳变 | ☆ |
| C3 | DevTools → Network Offline → 点 chip | 变 amber「连接异常 · 数据截至 HH:MM:SS」,旧数据保留不闪空;恢复网络后点击回 teal | ☆ |
| C4 | 保持 Offline 刷新整页 | chip 红「指标不可用 · 点击重试」+ hero 同步 err 态;恢复后点击重试回绿 | ☆ |
D · 发送走势(P3 hover/7-30 日切换)
| # | 操作 | 预期 | 级 |
|---|---|---|---|
| D1 | 点「30 日」 | 图重载不崩溃;real 模式下 30 点、x 轴标签抽稀(≤8 个 + 「今日」恒显);mock 仅 7 点属正常(mock 数据源限制) | ★ |
| D2 | 鼠标在图上横移 | teal 虚线十字 + 放大圆点 + 玻璃气泡(日期 / 提交 x,xxx · 成功 x,xxx);气泡近右缘时自动左翻不裁切 | ★ |
| D3 | 移出图表 | 十字线与气泡消失 | ☆ |
E · 快捷操作(D9 联动)
| # | 操作 | 预期 | 级 |
|---|---|---|---|
| E1 | 看「待人工审核」desc | mock:「12 条待审,点击进入审核中心」+ 图标底 amber;随 C3 断网联动显示 | ★ |
| E2 | 看「余额预警」desc | mock:「3 个账号低于预警线」 | ★ |
| E3 | 看「失败补推」desc | 诚实文案「按批次 / 手机号查询重推」(无编造数字) | ☆ |
| E4 | 四项逐一点击/Enter | 分别跳 /sms/batch、/audit、/record/repush、/account/list | ☆ |
F · 通道配置快照(D3/D4 真数据)
| # | 操作 | 预期 | 级 |
|---|---|---|---|
| F1 | mock 表内容 | 3 行:CM-001 移动全国(CMPP·violet)/HX-201 联信HTTP(HTTP·warn)/DX-301 电信SGIP(SGIP)且状态=停用红徽章;运营商列「移动 / 联通 / 电信」映射正确 | ★ |
| F2 | 表头 small | 「N 条 · 配置域数据 · 运行统计待 S5 压测后接入」诚实标注;右上 ch-refresh 可刷新 | ★ |
| F3 | real 模式 | 与「通道配置」页列表一致(配置域字段);管理员视角可用 | ☆ |
| F4 | 停网关后点 ch-refresh | 显式「通道列表加载失败 · 重试」,重试链接可用 | ☆ |
| F5 | 窗口缩至 <1100px | 表格横向滚动,不挤压布局 | ☆ |
G · 布局与主题回归(verify-layout 已覆盖,抽验)
| # | 操作 | 预期 | 级 |
|---|---|---|---|
| G1 | 侧栏收起/展开 | 224↔64;≤900px 汉堡抽屉正常 | ★ |
| G2 | 暗/亮主题切换 | hero 光条、amber warn、气泡、focus 描边在亮色下对比度均可读 | ☆ |
| G3 | brand 区 | 「✦ go-sms / AURORA CONSOLE」不变;菜单 icon 不变 | ★ |
| G4 | Tab 全键盘走查 | hero→指标卡→radio→刷新→快捷卡…,focus-visible teal 描边全程可见 | ☆ |
H · 双模式与回归面
| # | 操作 | 预期 | 级 |
|---|---|---|---|
| H1 | mock 全流程 | A~G 全部在 mock 模式通过 | — |
| H2 | real 全流程 | 真网关登录后指标/通道/趋势为真实数;customer 角色登录 /home 无 JS 报错(后端按角色返回) | ☆ |
| H3 | 浏览器 Console | 全程无 error(fe_error_log 无新增 VueHandler 记录) | ☆ |
| H4 | 旁证回归 | account / channel / sms-batch / sms-downlink-detail 四页与旧版无差异(本次未改动,截图已重刷) | ☆ |
五、环境遗留(非本次范围,已知悉)
- pnpm-lock.yaml 曾被 pnpm 自动 install 重排 → 已
git checkout回滚(最小变更纪律);新机跑 pnpm 命令会自动 install 且可能改 lockfile,建议后续统一pnpm install --frozen-lockfile。 - Playwright 浏览器新机首装:官方 CDN 停滞 →
PLAYWRIGHT_DOWNLOAD_HOST=https://cdn.npmmirror.com/binaries/playwright镜像 + apt 系统库(libnspr4/libnss3 等)。