cangku/test/README_GUI_TESTS.md

GUI测试文档

概述

本项目已为所有主要模块创建了基于PyQt的GUI集成测试，用于测试实际的用户界面交互和业务逻辑。

测试文件列表

1. test_login_gui.py - 登录对话框GUI测试

测试数量: 7个测试 测试内容:

• 管理员登录成功/失败
• 普通用户登录成功/失败
• 获取默认密码
• 设置新密码
• 使用新密码登录

2. test_stock_gui.py - 库存管理GUI测试

测试数量: 4个测试 测试内容:

• 加载原料列表
• 搜索原料
• 库存数量计算
• 库存扣除消耗后的计算

3. test_raw_material_gui.py - 原料管理GUI测试

测试数量: 7个测试 测试内容:

• 添加基本原料
• 添加重复型号（验证拒绝）
• 添加空型号（验证拒绝）
• 删除原料
• 编辑原料
• 按类目过滤
• 按型号搜索

4. test_garment_gui.py - 款式管理GUI测试

测试数量: 2个测试 测试内容:

• 加载款式列表
• 搜索款式

5. test_purchase_order_gui.py - 采购单生成GUI测试

测试数量: 2个测试 测试内容:

• 生成采购单
• 材料用量计算

测试统计

总测试数量: 22个测试 测试状态: ✓ 全部通过 测试时间: ~14秒

运行测试

运行单个模块测试

# 登录测试
python test\test_login_gui.py -v

# 库存测试
python test\test_stock_gui.py -v

# 原料测试
python test\test_raw_material_gui.py -v

# 款式测试
python test\test_garment_gui.py -v

# 采购单测试
python test\test_purchase_order_gui.py -v

运行所有GUI测试

cd test
python -m unittest test_login_gui.py test_stock_gui.py test_raw_material_gui.py test_garment_gui.py test_purchase_order_gui.py -v

测试特点

1. 真实GUI交互

• 模拟用户填写表单
• 模拟点击按钮
• 模拟选择下拉框
• 模拟输入搜索关键词

2. 业务逻辑验证

• 验证重复数据拒绝
• 验证空值验证
• 验证数据计算正确性
• 验证过滤和搜索功能

3. 独立测试环境

• 每个测试使用临时数据库
• 测试之间互不干扰
• 自动清理测试数据

4. 自动化消息框

• Mock了QMessageBox以便自动化测试
• 不需要人工点击确认对话框
• 可以验证警告和错误消息

测试架构

test/
├── test_login_gui.py          # 登录对话框测试
├── test_stock_gui.py          # 库存管理测试
├── test_raw_material_gui.py   # 原料管理测试
├── test_garment_gui.py        # 款式管理测试
├── test_purchase_order_gui.py # 采购单生成测试
└── README_GUI_TESTS.md        # 本文档

依赖项

• Python 3.x
• PyQt5
• sqlite3 (内置)
• unittest (内置)

注意事项

1. 测试需要在有GUI环境的系统上运行
2. 测试会创建临时数据库文件，测试后自动清理
3. 所有消息框已被Mock，不会弹出实际对话框
4. 测试使用独立的QApplication实例

扩展测试

如需添加新的GUI测试，请参考现有测试文件的结构：

1. 继承 unittest.TestCase
2. 在 setUpClass 中创建 QApplication 实例
3. 在 setUp 中创建临时数据库和对话框
4. Mock消息框以便自动化
5. 在 tearDown 中清理资源
6. 编写具体的测试方法

测试覆盖率

当前GUI测试覆盖了以下核心功能：

• ✓ 用户登录和密码管理
• ✓ 原料库管理（增删改查）
• ✓ 库存管理和计算
• ✓ 款式管理
• ✓ 采购单生成和计算

维护建议

1. 每次修改GUI代码后运行相关测试
2. 添加新功能时同步添加GUI测试
3. 定期运行所有测试确保系统稳定性
4. 保持测试代码的可读性和可维护性