# 工作台(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. **移动端适配**: 添加移动端响应式测试