jiawei.chen 6f6053ff51 feat: TestAgent 智能测试平台 v1.0
- CLI + Web 双平台,基于 LLM 的 TDD+DDD 自动化测试生成
- 集成 unified-test-platform 903 个 D-Cloud 用例 + 13 个 Robogo 场景
- Agent 5 步流水线: 扫描 -> DDD -> LLM 生成测试
- 精确回归 + UI 变更检查
- 可视化 HTML 测试报告
- 暗色/亮色主题切换
- 19 个 API 端点 + 6 个 SPA 页面
- 15/15 项 TDD+DDD 合规
2026-07-08 11:27:38 +08:00
..

工作台(Workbench)测试套件

工作台是网站的主入口页面(URL: /d-cloud/workbench/list),包含工作台卡片列表、导航菜单、快捷操作入口和统计信息展示。

测试文件结构

tests/workbench/
├── __init__.py                    # 模块初始化
├── workbench_page.py              # 页面对象模型
├── tests/
│   ├── __init__.py               # 测试目录初始化
│   ├── test_workbench_ui.py      # UI 界面测试
│   ├── test_workbench_api.py     # API 接口测试
│   └── test_workbench_flow.py    # 业务流程测试
└── README.md                     # 本文档

页面对象(WorkbenchPage)

主要功能

  • 导航功能: 导航到工作台页面,等待页面加载
  • 元素定位: 定义了页面所有关键元素的定位器
  • 卡片操作: 获取卡片信息、点击卡片操作按钮
  • 导航菜单: 获取菜单项、点击菜单项、检查激活状态
  • 快捷操作: 获取快捷操作按钮、点击快捷操作
  • 统计信息: 获取统计卡片数据
  • 最近活动: 获取活动记录
  • 搜索功能: 搜索、清除搜索
  • 用户菜单: 打开用户菜单、获取菜单项
  • 通知功能: 打开通知面板、获取通知数量
  • 页面状态: 检查页面加载状态、元素可见性

关键定位器

  • page_title: 页面标题(包含"工作台")
  • nav_menu: 导航菜单
  • workbench_cards: 工作台卡片列表
  • quick_action_buttons: 快捷操作按钮
  • stat_cards: 统计信息卡片
  • activity_items: 最近活动记录
  • search_input: 搜索输入框
  • user_avatar: 用户头像/菜单
  • notification_bell: 通知铃铛

测试分类

1. UI 测试 (test_workbench_ui.py)

  • 导航测试: 验证页面导航功能
  • 元素显示测试: 验证所有关键元素正常显示
  • 卡片功能测试: 验证卡片信息完整性和操作按钮
  • 搜索功能测试: 验证搜索框功能
  • 用户界面测试: 验证用户相关UI元素
  • 统计信息测试: 验证统计卡片显示
  • 最近活动测试: 验证活动记录显示
  • 响应式测试: 验证页面在不同屏幕尺寸下的布局
  • 页面操作测试: 验证页面刷新和导航状态保持

2. API 测试 (test_workbench_api.py)

  • 工作台API测试: 验证工作台数据接口
  • 统计信息API测试: 验证统计接口
  • 最近活动API测试: 验证活动记录接口
  • 卡片配置API测试: 验证卡片配置接口
  • API端点可用性测试: 验证所有相关API端点
  • API响应时间测试: 验证接口响应性能
  • API错误处理测试: 验证错误处理机制

3. 流程测试 (test_workbench_flow.py)

  • 导航流程测试: 测试完整的导航流程
  • 卡片交互流程: 测试与卡片的完整交互
  • 快捷操作流程: 测试快捷操作的使用流程
  • 搜索流程测试: 测试完整的搜索流程
  • 用户菜单流程: 测试用户菜单操作流程
  • 通知流程测试: 测试通知功能流程
  • 完整用户流程: 模拟用户完整的使用流程
  • 错误恢复流程: 测试页面错误后的恢复能力
  • 性能流程测试: 测试页面加载和刷新性能

测试标记(pytest markers)

  • @pytest.mark.ui: UI 测试
  • @pytest.mark.api: API 测试
  • @pytest.mark.flow: 流程测试
  • @pytest.mark.workbench: 工作台模块测试

运行测试

运行所有工作台测试

pytest tests/workbench/ -v

运行特定类型的测试

# 只运行UI测试
pytest tests/workbench/tests/test_workbench_ui.py -v -m "ui"

# 只运行API测试
pytest tests/workbench/tests/test_workbench_api.py -v -m "api"

# 只运行流程测试
pytest tests/workbench/tests/test_workbench_flow.py -v -m "flow"

运行特定测试类

pytest tests/workbench/tests/test_workbench_ui.py::TestWorkbenchNavigation -v

依赖的 Fixture

测试依赖以下 pytest fixture(在 conftest.py 中定义):

  • authenticated_page: 已认证的 Playwright 页面
  • api_client: API 客户端实例
  • workbench_page: 工作台页面对象(自定义fixture)

测试设计原则

  1. 独立性: 每个测试用例独立运行,不依赖其他测试的状态
  2. 原子性: 每个测试验证单一功能或场景
  3. 健壮性: 包含适当的错误处理和跳过机制
  4. 可维护性: 清晰的文档和结构化的代码
  5. 实用性: 测试实际可运行的功能,不使用 mock 数据

页面元素适配说明

由于实际页面结构可能有所不同,部分定位器可能需要根据实际DOM结构进行调整:

  1. CSS 类名: 实际页面可能使用不同的类名(如 .dashboard-card 代替 .workbench-card)
  2. 文本内容: 实际页面可能使用不同的文本(如"我的工作台"可能为"工作空间")
  3. 区域划分: 页面区域划分可能不同

建议在首次运行前检查实际页面的DOM结构,必要时调整定位器。

扩展建议

  1. 添加数据驱动测试: 使用 @pytest.mark.parametrize 扩展测试场景
  2. 集成性能监控: 添加页面性能指标收集
  3. 截图对比: 添加视觉回归测试
  4. 跨浏览器测试: 扩展支持不同浏览器
  5. 移动端适配: 添加移动端响应式测试