simon/wecom_it_smart_desk
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
9294cf12c11f57e7d6553acb1777a7def40fcb28
wecom_it_smart_desk/docs/03-测试文档/03-功能测试用例/TC-REQ-用户-007-自助诊断面板优化.md
T
Simon facc04aa65 chore: docs 结构整改 + compose 双目录对齐（合并重建提交） 
本提交为 .git 对象库损坏后的重建提交，内容等价于原先三个本地提交
（5e2fd4c2 / 57a53c98 / 5d7e1873）的累积结果，未做任何额外改动。

一、docs 结构整改（整改 #14）
根因：重构时新结构为 untracked 文件，执行 git stash（未带 -u）未纳入，
随后 git reset 拉回 HEAD 旧 tracked 树，导致旧树复活、新旧两棵目录
树并存于 docs/，共 791 文件、双分类体系冲突。

修复动作：
- b2 同名异主题文件改名迁移保全 9 个
- C 类 39 个孤立文件按主题正确归类
- A/B1 类 222 个重复文件删除（新结构已有内容副本）
- 9 个旧独有空目录删除
- 270 处内部引用按 verified 映射改写
- 整改记录 #14 登记于 04-运维文档/部署运维

结果：docs 791 → 569 文件，顶层仅规范 8 类 + 治理文件，单树恢复。
残留：约 20 处指向从未存在文件的陈旧死链，归入独立文档卫生任务。

二、compose 双目录对齐（消除踩坑 A）
- docker-compose.yml：nginx 前端挂载全部由根目录 frontend-*/dist
  改为 src/frontend-*/dist（h5 / agent / admin / terminal）
- docker-compose.dev.yml：dev 服务 build context 与卷同步改 src/
- 效果：本地 docker compose up 不再把根目录 stale dist 挂回，
  与线上一致，分叉隐患消除（已 docker compose config 校验通过）

防复发铁律：
- 重构须提交；仓库修复须 git stash -u 或先 commit
- 新结构须 git add 并提交，避免再次 untracked 复活
- H5 改动只动 src/frontend-h5/，禁改根目录遗留 frontend-*/
2026-08-07 22:31:32 +08:00

13 KiB
Raw Blame History

测试用例 - H5 自助诊断面板优化

REQ 编号: REQ-用户-007 版本: v1.0 日期: 2026-07-29 作者: 宋献 (Simon) + Duckula 状态: 🟡 待评审（基于 PRD v1.0-Frozen + 技术方案 v1.0） 关联文档:

  • PRD（冻结）：docs/01-产品文档/05-用户端H5/PRD-REQ-用户-007-自助诊断面板优化-v1.0.md
  • 技术方案：docs/02-技术文档/技术架构/技术方案-REQ-用户-007-自助诊断面板优化-v1.0.md
  • 任务说明书：docs/07-项目管理/任务说明书/任务说明书-REQ-用户-007-自助诊断面板优化.md
  • 原型图：docs/01-产品文档/05-用户端H5/原型-REQ-用户-007-自助诊断面板优化-v1.0.html

一、基本信息

项目 内容
用例集名称 TC-REQ-用户-007 H5 自助诊断面板优化
关联 PRD REQ-用户-007 v1.0-Frozen（7 项决策已冻结）
用例总数 50 条（8 大类）
优先级分布 P0 14 条 / P1 22 条 / P2 14 条
关联决策 必须 100% 覆盖 PRD 7 项核心决策
自动化目标 单元测试 100% 自动化 / E2E 关键路径自动化 / 边界场景手动验证

二、测试范围

2.1 In-scope

  • SelfDiagnosis.vue 新增 totalBadge computed（warn/fail 拆分 + 0 异常达标动画）
  • 标题栏徽章 5 种状态（分级/含 fail/旧版兼容/达标动画/静态正常）
  • 6 Tab 横向并排标签页（激活态 + 异常 Tab 双层下划线）
  • ChatView.vue 移动端 toggle 切换（仅 isMobile=true 显示）
  • QueueWaiting.vue 新增 showPosition prop
  • RightPanel.vue queue-header-v3 合并位置/LV/分
  • 异常 + 接入混合 M1 双角标并存
  • Tab 切换只显示当前 Tab 数据（行为已天然，需 e2e 验证）

2.2 Out-of-scope

  • 诊断数据源接入（SIEM/IDS、联软代理等 → 2026-Q4）
  • 触达 0 异常时的自助解决率统计
  • 移动端右栏个性化配置（折叠状态本地记忆）
  • 诊断结果 NLP 摘要

三、测试环境

项 配置
前端 Vue 3 / TypeScript / Vitest
E2E agent-browser（Playwright）
浏览器 Chrome / Edge / Safari 最新版
设备 桌面端（≥500px）/ iPhone iOS Safari 14+ / Android Chrome 8+
屏宽 320px / 375px / 720px / 1920px
环境 dev → staging → 生产

四、用例分类规则

前缀 模块 用例数
TC-001 异常徽章 5 种状态（决策 ①） 10
TC-002 6 Tab 横向并排（决策 ②） 8
TC-003 移动端 toggle 切换（决策 ⑤） 8
TC-004 queue 标题栏合并（决策 ⑥） 6
TC-005 Tab 切换只显示当前项（决策 ④） 4
TC-006 异常 + 接入混合 M1（决策 ⑦） 4
TC-007 接入中角标位置（决策 ③） 4
TC-008 跨浏览器/跨设备兼容性 6
合计 50

五、详细用例

TC-001 异常徽章 5 种状态（决策 ①，10 条）

ID 标题 优先级 前置 步骤 预期
TC-001-01 0 异常显示"✓ 全部正常"绿色 P0 Mock 全部正常 1. 打开自助诊断
2. 验证 6 Tab 都无异常
3. 不点击任何项		 标题栏显示绿色徽章 "✓ 全部正常"
TC-001-02 5 warning 显示 5W · 0F 分级 P0 Mock 5W·0F 同上 标题栏显示红色徽章 5W · 0F（左 5W 暖黄字 + 右 0F 粉字）
TC-001-03 2W + 1F 含 fail 样例 P0 Mock 2W·1F 1. 模拟 2 warning + 1 fail 标题栏显示 2W · 1F
TC-001-04 0 异常达标动画触发 P0 5W 状态 → 模拟清零 1. 起始 5W
2. 模拟清除所有异常		 触发"✓ 今日安全"绿色脉冲动画，3 秒后渐隐
TC-001-05 达标动画渐隐后显示静态"✓ 全部正常" P1 TC-001-04 等待 3 秒 动画停止，显示静态绿色徽章 "✓ 全部正常"
TC-001-06 异常徽章 hover 提示 P1 5W 状态 1. 鼠标悬停徽章 提示："共 5 个待处理异常:5 警告 0 失败"
TC-001-07 一键诊断按钮联动 P1 5W 状态 1. 验证"一键诊断"按钮 按钮 disabled（因为有异常），hover 提示"建议先处理后再批量诊断"
TC-001-08 0 异常时一键诊断可点击 P1 0 异常状态 1. 验证"一键诊断"按钮 按钮可点击，无 disable
TC-001-09 徽章实时刷新（WS 推送） P0 起始 5W 1. 模拟 1 个异常被处理 徽章立即从 5W · 0F 变为 4W · 0F（< 200ms）
TC-001-10 旧版单数字徽章（兼容） P2 config 设置 showLegacy=true 1. 启用兼容模式 显示 !5 单数字徽章（已锁定为可选关闭）

TC-002 6 Tab 横向并排（决策 ②，8 条）

ID 标题 优先级 前置 步骤 预期
TC-002-01 6 Tab 文字精简版渲染 P0 默认 Mock 1. 打开自助诊断 6 Tab 显示"网络 / 账号 / 设备 / 系统软件 / 安全 / 合规"
TC-002-02 默认激活 Tab"网络" P0 默认 1. 打开自助诊断 "网络" Tab 文字加粗 + 底部蓝色下划线
TC-002-03 异常 Tab 双层下划线 P0 Mock 5W·0F 1. 验证 4 个异常 Tab 账号/设备/系统软件/合规 Tab 底部红色半透明线 + 蓝色下划线（双层）
TC-002-04 Tab 切换激活态变化 P0 默认 1. 点击"账号" Tab 账号 Tab 变蓝色下划线 + 文字加粗；网络 Tab 失去激活态
TC-002-05 切换 Tab 内容区更新 P0 默认 1. 点击"设备" Tab 内容区显示设备相关诊断项/风险项
TC-002-06 异常 Tab 数字徽章渲染 P0 Mock 5W·0F 1. 验证 4 个异常 Tab 账号 Tab 显示红色 1，设备 Tab 显示红色 1，系统软件 Tab 显示红色 2，合规 Tab 显示红色 1
TC-002-07 桌面端 720px 6 Tab 等分布局 P1 浏览器 720px 1. 打开自助诊断 6 Tab flex 等分，每个约 120px 宽
TC-002-08 桌面端 375px 6 Tab 全部放下 P1 浏览器 375px 1. 打开自助诊断 6 Tab 全部显示无横向滚动（每个约 62px）

TC-003 移动端 toggle 切换（决策 ⑤，8 条）

ID 标题 优先级 前置 步骤 预期
TC-003-01 移动端 <500px 默认显示左对话 P0 浏览器 375px 1. 打开页面 显示左对话（聊天窗口），右栏隐藏
TC-003-02 移动端 toggle 按钮显示 P0 375px 1. 验证顶部 顶部出现"💬 对话 / 🩺 信息"双按钮（按钮高度 36px）
TC-003-03 默认激活态为"💬 对话" P0 375px 1. 验证按钮 "💬 对话"按钮蓝底白字，"🩺 信息"灰底
TC-003-04 点击"🩺 信息"切换到右栏 P0 TC-003-03 1. 点击"🩺 信息"按钮 显示右栏（手风琴 + 智能推荐 + 排队），按钮变"🩺 信息"激活态
TC-003-05 点击"💬 对话"切回左对话 P0 TC-003-04 1. 点击"💬 对话"按钮 显示左对话，按钮变"💬 对话"激活态
TC-003-06 切换后左对话滚动位置保留 P0 375px 1. 滚动对话到底部
2. 切换到右栏
3. 切换回左对话		 左对话滚动位置保留（仍显示原位置）
TC-003-07 切换后输入栏文本保留 P0 375px 1. 在输入栏输入"测试"
2. 切换到右栏
3. 切换回左对话		 输入栏文本"测试"保留
TC-003-08 桌面端 ≥500px 不显示 toggle 按钮 P0 浏览器 720px 1. 打开页面 顶部无 toggle 按钮，双栏正常显示

TC-004 queue 标题栏合并（决策 ⑥，6 条）

ID 标题 优先级 前置 步骤 预期
TC-004-01 标题栏显示位置 #5 P0 Mock 排队中 1. 展开排队区 标题栏显示 "#5 前面4人"（蓝色徽章）
TC-004-02 标题栏显示 LV.3 P0 Mock 积分等级 同上 标题栏显示 "LV.3"（灰色 tag）
TC-004-03 标题栏显示 120 分 P0 Mock 120 分 同上 标题栏显示 "120分"（粗体）
TC-004-04 queue-content 不重复显示位置卡片 P0 TC-004-01 1. 验证展开内容 内容区只有答题区，无独立位置卡片
TC-004-05 整体高度压缩 ~40px P1 前后对比 1. 测量高度 比 v2.0 减少约 40px
TC-004-06 窄屏（<360px）标题栏换行 P1 浏览器 320px 1. 打开排队区 标题栏内联三件套自动换行（flex-wrap: wrap）

TC-005 Tab 切换只显示当前项（决策 ④，4 条）

ID 标题 优先级 前置 步骤 预期
TC-005-01 切到"网络" Tab 只显示网络项 P0 Mock 6 Tab 数据 1. 点击"网络" Tab 内容区只显示网络相关诊断项（连通性/DNS/网关/代理/VPN/文件共享）
TC-005-02 切到"账号" Tab 只显示账号项 P0 同上 1. 点击"账号" Tab 内容区只显示账号相关风险项（域账号/零信任/云盘/邮箱）
TC-005-03 切到"系统软件" Tab 只显示系统项 P0 同上 1. 点击"系统软件" Tab 内容区只显示系统相关（系统补丁/高危软件/邮件客户端/打印机）
TC-005-04 切 Tab 时总徽章不变 P0 5W·0F 1. 反复切 Tab 总徽章始终是 5W·0F（不会因为切 Tab 而变化）

TC-006 异常 + 接入混合 M1（决策 ⑦，4 条）

ID 标题 优先级 前置 步骤 预期
TC-006-01 "安全" Tab 1 异常 + 2 接入显示 安全 1•2 P0 Mock 安全 Tab: 1W + 2pending 1. 打开自助诊断 "安全" Tab 显示红色数字徽章 1 + 灰色斜体小角标 2
TC-006-02 双角标视觉区隔 P1 TC-006-01 1. 视觉验证 红色 vs 灰色、标准字体 vs 斜体明显区分
TC-006-03 异常 + 接入混合不影响总徽章 P0 Mock 安全 Tab: 1W + 2pending 1. 验证总徽章 总徽章显示 1W · 0F（仅含 1 异常，2 接入不计入）
TC-006-04 切换到"安全" Tab 内容区 P0 TC-006-01 1. 点击"安全" Tab 内容区显示 4 项：1 异常（红色）+ 2 接入（灰色接入中 tag）+ 1 正常

TC-007 接入中角标位置（决策 ③，4 条）

ID 标题 优先级 前置 步骤 预期
TC-007-01 接入中角标位于 Tab 文字右侧 P0 Mock 0 异常 + 2 接入 1. 打开自助诊断 "安全" Tab 文字后挂灰色斜体小角标 •2
TC-007-02 接入中行内 tag 显示"接入中" P0 同上 1. 点击"安全" Tab 风险项后面显示灰色"接入中" tag
TC-007-03 接入中项不计入异常数 P0 同上 1. 验证总徽章 总徽章显示 0W · 0F（2 接入不计入）
TC-007-04 接入中角标颜色 P1 同上 1. 视觉验证 灰色 + 斜体 + 小号（与红数字徽章明显区隔）

TC-008 跨浏览器/跨设备兼容性（6 条）

ID 标题 优先级 前置 步骤 预期
TC-008-01 Chrome 最新版（桌面 1920px） P0 desktop 1. 打开自助诊断 6 Tab 全部正常显示，徽章无样式错乱
TC-008-02 Safari 最新版（macOS 1920px） P0 macOS 同上 同上
TC-008-03 iPhone iOS Safari 14+（375px） P0 iPhone 1. 打开页面 toggle 按钮正常显示 + 切换流畅
TC-008-04 Android Chrome 8+（360px） P0 Android 1. 打开页面 toggle 按钮正常显示 + 6 Tab 横向并排
TC-008-05 iPad 720px（横屏） P1 iPad 1. 打开页面 双栏正常，6 Tab 等分布局
TC-008-06 极窄屏 320px（旧 iPhone SE） P1 旧 iPhone 1. 打开自助诊断 6 Tab 横向并排无错乱（移动端不渲染右栏）

六、风险与回滚

风险 等级 缓解措施
移动端 toggle 切换导致左对话状态丢失 高 v-show 切换（不卸载 DOM），保留输入文本
异常徽章实时刷新失败 中 保留最后一次已知状态
0 异常达标动画在低端机上卡顿 低 关闭动画降级为静态"✓ 全部正常"
queue 标题栏换行后样式错乱 低 flex-wrap: wrap + gap 控间距

七、关联文档

  • PRD：docs/01-产品文档/05-用户端H5/PRD-REQ-用户-007-自助诊断面板优化-v1.0.md
  • 技术方案：docs/02-技术文档/技术架构/技术方案-REQ-用户-007-自助诊断面板优化-v1.0.md
  • 任务说明书：docs/07-项目管理/任务说明书/任务说明书-REQ-用户-007-自助诊断面板优化.md
  • 原型图：docs/01-产品文档/05-用户端H5/原型-REQ-用户-007-自助诊断面板优化-v1.0.html

八、变更日志

版本 日期 变更内容 作者
v1.0 2026-07-29 12:45 初版：基于 PRD v1.0-Frozen + 技术方案 v1.0，给出 50 条用例 / 8 大类 / P0 14 + P1 22 + P2 14 Duckula + 宋献
Reference in New Issue View Git Blame Copy Permalink