🎯 项目概述
这是一个 疫苗接种平台 UI 自动化测试项目 ,采用 Python + Playwright 技术栈,遵循 Page Object Model (POM) 设计模式,支持多地区、多模块的自动化测试。
🏗️ 整体架构
vaccplatform_online/
├── config/ # 全局配置(地区、菜单)
│ ├── menus/ # 菜单路径映射配置
│ └── regions/ # 各地区环境配置
├── pages/ # Page Object Model 层
│ ├── base_page.py # 页面基类
│ ├── login_page.py # 登录页
│ ├── home_page.py # 首页(菜单导航)
│ ├── bpms/ # 疫苗管理子系统页面
│ ├── VaccinationManagement/ # 接种管理子系统页面
│ └── check_page/ # 查验子系统页面
├── tests/ # 测试用例层
│ ├── cases/ # 测试用例(按模块组织)
│ ├── config/ # 测试配置管理
│ ├── data/ # 测试数据
│ └── utils/ # 工具类
└── conftest.py # pytest 全局 Fixtures
🛠️ 技术栈

📦 核心模块
- 配置管理模块
- config_manager.py - 单例模式,集中管理所有配置
- 支持 按地区配置 :每个地区独立的环境地址、账号、菜单路径
- 支持 菜单路径映射 :feature_id → 菜单路径列表
- 页面层 (POM)
- base_page.py - 页面基类,提供通用操作(点击、输入、等待等)
- 各业务模块页面类继承基类,封装页面特有操作
- 测试用例层
- 按业务模块组织: bpms/ 、 VaccinationManagement/ 、 check/ 等
- 每个测试类包含: module_conf_data (模块配置)、测试方法
- 工具类
- logger.py - 日志管理
- assertion_tool.py - 断言工具
- table_utils.py - 表格数据处理
- file_handler/ - 文件处理(Excel、PDF、JSON)
- db_utils.py - 数据库操作
- retry_utils.py - 重试机制
🔄 测试执行流程
- pytest 启动
↓ - conftest.py 加载配置
↓ - browser_context fixture 创建浏览器上下文
↓ - logged_in_page fixture 自动登录
↓ - menu_operation fixture 根据 feature_id 自动导航菜单
↓ - 执行测试方法(查询、导出、打印等)
↓ - 生成 Allure 测试报告
🎨 设计模式

🌍 多地区支持
config/regions/henan.yaml 示例
base_url: "http://xxxx/platform/"
accounts:
super_admin:
username: "admin"
password: "xxx"
department: "河南省"
enabled_features:
- monthly_inventory_report
- inventory_ledger
通过环境变量 TEST_REGION 切换地区:
TEST_REGION=henan python -m pytest tests/
📊 测试报告
- 使用 Allure 生成可视化报告
- 报告存储在 output/allure-results/
- 支持截图、日志、附件等信息收集
🧪 测试用例命名规范
- 文件命名 : test_xxx.py
- 类命名 : TestXxx
- 方法命名 : test_xxx_query/export/print
- 标记 : @pytest.mark.case_id("query")
💡 核心特点
- 自动化菜单导航 :通过 feature_id 自动解析菜单路径,无需硬编码
- 多地区适配 :一套代码支持多个地区的差异化测试
- 自动登录 :通过 fixture 实现测试前自动登录
- iframe 处理 :自动识别和切换 iframe
- 失败重试 :测试失败自动重试机制
- 并行执行 :支持分布式并行测试