Files
ccdi/doc/test-scripts/FILE_LIST.md

7.2 KiB

导入重复检测测试 - 文件清单

本次创建的文件列表

核心测试文件

1. Python测试脚本

doc/test-scripts/test_import_duplicate_detection.py (600+ 行)
  • 主测试脚本
  • 包含4个完整测试场景
  • 自动生成测试数据
  • 自动验证结果
  • 生成JSON测试报告

2. 测试用例文档

doc/test-scripts/test_import_duplicate_detection_cases.md
  • 详细的测试用例说明
  • 4个测试场景的完整描述
  • 测试数据和预期结果

3. 使用说明文档

doc/test-scripts/README_TEST.md
  • 完整的使用指南
  • 环境准备步骤
  • 运行和查看结果说明
  • 常见问题解答

4. 文档索引

doc/test-scripts/INDEX.md
  • 所有文档的总索引
  • 快速导航指南
  • 功能概述

5. 快速开始指南

doc/test-scripts/QUICKSTART.md
  • 一分钟快速开始
  • 简化的使用步骤
  • 常见问题快速解决

6. 总结文档

doc/test-scripts/SUMMARY.md
  • 完整的工作总结
  • 测试覆盖范围
  • 验证点说明

7. 测试数据生成工具

doc/test-scripts/generate_test_data.py
  • 独立的数据生成工具
  • 可单独运行生成测试数据

执行脚本

Windows批处理

run_duplicate_test.bat
  • Windows下一键运行
  • 自动检查环境
  • 自动安装依赖

Linux/Mac脚本

run_duplicate_test.sh
  • Linux/Mac下一键运行
  • 自动检查环境
  • 自动安装依赖

说明文档

测试数据说明

doc/test-data/README.md
  • 测试数据目录说明
  • 数据结构说明
  • 使用方法

测试报告说明

doc/test-reports/README.md
  • 测试报告格式说明
  • 报告查看方法
  • 报告分析指南

目录结构

D:\ccdi\ccdi\
├── run_duplicate_test.bat                          # Windows执行脚本
├── run_duplicate_test.sh                           # Linux/Mac执行脚本
├── doc/
│   ├── test-scripts/                               # 测试脚本目录
│   │   ├── test_import_duplicate_detection.py      # 主测试脚本
│   │   ├── test_import_duplicate_detection_cases.md # 测试用例文档
│   │   ├── README_TEST.md                          # 使用说明
│   │   ├── INDEX.md                                # 文档索引
│   │   ├── QUICKSTART.md                           # 快速开始
│   │   ├── SUMMARY.md                              # 总结文档
│   │   └── generate_test_data.py                   # 数据生成工具
│   ├── test-data/                                  # 测试数据目录
│   │   ├── temp/                                   # 临时测试数据(自动生成)
│   │   ├── employee/                               # 员工测试数据
│   │   ├── recruitment/                            # 招聘测试数据
│   │   └── README.md                               # 数据说明
│   └── test-reports/                               # 测试报告目录
│       └── README.md                               # 报告说明

文件说明

测试脚本

文件名 说明 行数 用途
test_import_duplicate_detection.py 主测试脚本 600+ 执行所有测试场景
generate_test_data.py 数据生成工具 50+ 生成测试Excel文件

文档

文件名 说明 类型 用途
test_import_duplicate_detection_cases.md 测试用例文档 Markdown 详细的测试用例说明
README_TEST.md 使用说明 Markdown 完整的使用指南
INDEX.md 文档索引 Markdown 快速导航
QUICKSTART.md 快速开始 Markdown 一分钟上手指南
SUMMARY.md 总结文档 Markdown 工作总结

执行脚本

文件名 说明 类型 用途
run_duplicate_test.bat Windows执行脚本 Batch Windows下一键运行
run_duplicate_test.sh Linux/Mac执行脚本 Shell Linux/Mac下一键运行

说明文档

文件名 说明 类型 用途
doc/test-data/README.md 数据说明 Markdown 测试数据目录说明
doc/test-reports/README.md 报告说明 Markdown 测试报告说明

测试数据文件(运行时自动生成)

临时测试数据

doc/test-data/temp/
├── purchase_duplicate.xlsx                 # 采购重复数据(场景1)
├── employee_employee_id_duplicate.xlsx     # 员工柜员号重复(场景2)
├── employee_id_card_duplicate.xlsx         # 员工身份证号重复(场景3)
├── purchase_mixed_duplicate.xlsx           # 采购混合重复(场景4)
└── employee_mixed_duplicate.xlsx           # 员工混合重复(场景4)

测试报告(运行时自动生成)

doc/test-reports/
└── test_report_YYYYMMDD_HHMMSS.json       # JSON格式测试报告

使用方式

方式1: 批处理脚本(推荐)

# Windows
双击 run_duplicate_test.bat

# Linux/Mac
bash run_duplicate_test.sh

方式2: Python命令

python doc/test-scripts/test_import_duplicate_detection.py

方式3: 只生成测试数据

python doc/test-scripts/generate_test_data.py

测试场景

场景 描述 数据文件 验证点
场景1 采购交易 - Excel内采购事项ID重复 purchase_duplicate.xlsx 第1条成功,第2、3条失败
场景2 员工信息 - Excel内柜员号重复 employee_employee_id_duplicate.xlsx 第1条成功,第2、3条失败
场景3 员工信息 - Excel内身份证号重复 employee_id_card_duplicate.xlsx 第1条成功,第2、3条失败
场景4 混合重复(数据库+Excel) purchase_mixed_duplicate.xlsx, employee_mixed_duplicate.xlsx 混合场景验证

依赖项

Python依赖

  • requests: HTTP请求库
  • openpyxl: Excel文件操作库

系统要求

文件大小

文件 大小(约) 说明
test_import_duplicate_detection.py 25KB 主测试脚本
test_import_duplicate_detection_cases.md 15KB 测试用例文档
README_TEST.md 12KB 使用说明
其他文档 5-10KB/个 各种说明文档
Excel测试数据 10-20KB/个 自动生成

版本信息

  • 创建日期: 2026-02-09
  • 版本: v1.0
  • 状态: 完成

后续维护

定期清理

  • 删除临时测试数据: doc/test-data/temp/*.xlsx
  • 归档旧的测试报告: doc/test-reports/test_report_*.json

更新文档

  • 添加新测试场景时更新测试用例文档
  • 修改测试逻辑时更新使用说明
  • 定期更新常见问题解答

代码维护

  • 保持代码注释完整
  • 遵循现有代码风格
  • 添加新功能时保持一致性

联系方式

如有问题或建议,请参考:

  • 测试用例文档: doc/test-scripts/test_import_duplicate_detection_cases.md
  • 使用说明文档: doc/test-scripts/README_TEST.md
  • 快速开始: doc/test-scripts/QUICKSTART.md

最后更新: 2026-02-09 文件总数: 12个 总代码行数: 约800行 文档总字数: 约15000字