Files
go-sms-V2/docs/acceptance/fe-dashboard-density.md

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 等)。