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

140 lines
5.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 工作台(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`: 工作台模块测试
## 运行测试
### 运行所有工作台测试
```bash
pytest tests/workbench/ -v
```
### 运行特定类型的测试
```bash
# 只运行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"
```
### 运行特定测试类
```bash
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. **移动端适配**: 添加移动端响应式测试