ccdi/doc/test-scripts/FILE_LIST.md

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

## 本次创建的文件列表

### 核心测试文件

#### 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: 批处理脚本(推荐)
```bash
# Windows
双击 run_duplicate_test.bat

# Linux/Mac
bash run_duplicate_test.sh
```

### 方式2: Python命令
```bash
python doc/test-scripts/test_import_duplicate_detection.py
```

### 方式3: 只生成测试数据
```bash
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文件操作库

### 系统要求
- Python 3.7+
- 后端服务运行在 http://localhost:8080
- 测试账号: admin / admin123

## 文件大小

| 文件 | 大小(约) | 说明 |
|------|----------|------|
| 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字