# 前端质量门根修 + 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 无 ``)直接挂载 → 后续 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 等)。