238 lines
5.9 KiB
Markdown
238 lines
5.9 KiB
Markdown
# 🧪 出国申请与审批PDF预览功能测试清单
|
||
|
||
## 📋 修复范围
|
||
- ✅ **出国审批页面** - 完整修复（新增+修复+优化）
|
||
- ✅ **出国申请页面** - 优化修复（图片+下载）
|
||
|
||
---
|
||
|
||
## 🎯 快速测试步骤
|
||
|
||
### 准备工作（必须！）
|
||
```bash
|
||
# 1. 清除浏览器缓存
|
||
Ctrl + Shift + Delete → 清除缓存和Cookie
|
||
|
||
# 2. 强制刷新页面
|
||
Ctrl + Shift + R
|
||
|
||
# 3. 确认环境
|
||
前端: http://localhost
|
||
后端: http://localhost:8080
|
||
```
|
||
|
||
---
|
||
|
||
## 📝 测试清单
|
||
|
||
### 一、出国审批页面测试
|
||
|
||
#### 测试路径
|
||
```
|
||
人事管理 → 出国管理 → 出国审批
|
||
```
|
||
|
||
#### 测试项目
|
||
|
||
| 序号 | 测试项 | 操作步骤 | 预期结果 | 实际结果 |
|
||
|-----|--------|---------|---------|---------|
|
||
| 1 | 附件显示 | 点击"查看详情" | ✅ 显示盖章文件和党籍附件 | ⬜ |
|
||
| 2 | 盖章文件预览 | 点击"查看"按钮 | ✅ PDF在新窗口预览 | ⬜ |
|
||
| 3 | 盖章文件下载 | 点击"下载"按钮 | ✅ 正常下载PDF | ⬜ |
|
||
| 4 | 党籍附件预览 | 点击"查看"按钮 | ✅ PDF在新窗口预览 | ⬜ |
|
||
| 5 | 党籍附件下载 | 点击"下载"按钮 | ✅ 正常下载PDF | ⬜ |
|
||
| 6 | 图片附件预览 | 点击图片附件"查看" | ✅ 图片在新窗口显示 | ⬜ |
|
||
|
||
#### 重点验证
|
||
- ❌ **不应该**: 点击"查看"后直接下载文件
|
||
- ✅ **应该**: 点击"查看"后在新标签页预览
|
||
- ✅ **应该**: PDF内容完整可滚动缩放
|
||
- ✅ **应该**: 图片清晰可见
|
||
|
||
---
|
||
|
||
### 二、出国申请页面测试
|
||
|
||
#### 测试路径
|
||
```
|
||
人事管理 → 出国管理 → 出国申请
|
||
```
|
||
|
||
#### 测试项目
|
||
|
||
| 序号 | 测试项 | 操作步骤 | 预期结果 | 实际结果 |
|
||
|-----|--------|---------|---------|---------|
|
||
| 1 | 附件显示 | 点击"查看详情" | ✅ 显示盖章文件和党籍附件 | ⬜ |
|
||
| 2 | 盖章文件预览 | 点击"查看"按钮 | ✅ PDF在新窗口预览 | ⬜ |
|
||
| 3 | 盖章文件下载 | 点击"下载"按钮 | ✅ 正常下载PDF | ⬜ |
|
||
| 4 | 党籍附件预览 | 点击"查看"按钮 | ✅ PDF在新窗口预览 | ⬜ |
|
||
| 5 | 党籍附件下载 | 点击"下载"按钮 | ✅ 正常下载PDF | ⬜ |
|
||
| 6 | 图片附件预览 | 点击图片附件"查看" | ✅ 图片在新窗口显示 | ⬜ |
|
||
|
||
#### 重点验证
|
||
- ❌ **不应该**: 点击"查看"后直接下载文件
|
||
- ✅ **应该**: 点击"查看"后在新标签页预览
|
||
- ✅ **应该**: PDF内容完整可滚动缩放
|
||
- ✅ **应该**: 图片清晰可见
|
||
|
||
---
|
||
|
||
## 🔍 详细测试场景
|
||
|
||
### 场景1: PDF预览功能
|
||
1. 进入出国审批/申请页面
|
||
2. 找到任意一条有附件的记录
|
||
3. 点击"查看详情"
|
||
4. 定位到"盖章文件"或"党籍附件"
|
||
5. 点击"查看"按钮
|
||
6. **验证**:
|
||
- ✅ 新标签页自动打开
|
||
- ✅ PDF文件正常渲染
|
||
- ✅ 可以滚动和缩放
|
||
- ❌ 不触发下载
|
||
|
||
### 场景2: 图片预览功能
|
||
1. 进入出国审批/申请页面
|
||
2. 找到图片格式的附件
|
||
3. 点击"查看"按钮
|
||
4. **验证**:
|
||
- ✅ 新窗口打开
|
||
- ✅ 图片完整显示
|
||
- ✅ 居中对齐
|
||
- ❌ 不触发下载
|
||
|
||
### 场景3: 文件下载功能
|
||
1. 进入出国审批/申请页面
|
||
2. 点击任意附件的"下载"按钮
|
||
3. **验证**:
|
||
- ✅ 触发下载
|
||
- ✅ 文件名正确
|
||
- ✅ 文件类型正确
|
||
- ✅ 文件完整可打开
|
||
|
||
### 场景4: 混合附件测试
|
||
1. 测试包含多个附件的记录
|
||
2. 分别测试PDF和图片附件
|
||
3. **验证**:
|
||
- ✅ 所有附件都能正常预览
|
||
- ✅ 所有附件都能正常下载
|
||
- ✅ 不同文件类型处理正确
|
||
|
||
---
|
||
|
||
## 🐛 常见问题排查
|
||
|
||
### 问题1: 点击"查看"还是下载
|
||
**原因**: 浏览器缓存未清除
|
||
**解决**:
|
||
```bash
|
||
Ctrl + Shift + Delete → 清除所有缓存
|
||
Ctrl + Shift + R → 强制刷新
|
||
```
|
||
|
||
### 问题2: 预览窗口空白
|
||
**原因**: 文件路径或权限问题
|
||
**排查**:
|
||
1. 检查浏览器控制台是否有404错误
|
||
2. 检查网络请求是否返回文件数据
|
||
3. 检查用户是否有查看权限
|
||
|
||
### 问题3: PDF显示不完整
|
||
**原因**: Blob大小异常
|
||
**排查**:
|
||
1. 打开浏览器开发者工具
|
||
2. 查看Console日志
|
||
3. 检查"Blob大小"日志
|
||
|
||
### 问题4: 图片无法显示
|
||
**原因**: MIME类型错误
|
||
**排查**:
|
||
1. 检查文件扩展名
|
||
2. 检查MIME类型设置
|
||
3. 确认图片文件完整性
|
||
|
||
---
|
||
|
||
## 📊 测试结果记录
|
||
|
||
### 出国审批页面
|
||
|
||
| 功能 | 状态 | 备注 |
|
||
|-----|------|------|
|
||
| 附件显示 | ⬜ | |
|
||
| PDF预览 | ⬜ | |
|
||
| 图片预览 | ⬜ | |
|
||
| 文件下载 | ⬜ | |
|
||
|
||
### 出国申请页面
|
||
|
||
| 功能 | 状态 | 备注 |
|
||
|-----|------|------|
|
||
| 附件显示 | ⬜ | |
|
||
| PDF预览 | ⬜ | |
|
||
| 图片预览 | ⬜ | |
|
||
| 文件下载 | ⬜ | |
|
||
|
||
---
|
||
|
||
## ✅ 通过标准
|
||
|
||
### 必须通过
|
||
- [ ] PDF点击"查看"在新窗口预览（不下载）
|
||
- [ ] 图片点击"查看"在新窗口显示（不下载）
|
||
- [ ] 文件点击"下载"正常下载
|
||
- [ ] 所有附件都能正确显示
|
||
|
||
### 建议测试
|
||
- [ ] 测试不同文件大小
|
||
- [ ] 测试不同文件格式
|
||
- [ ] 测试多个附件
|
||
- [ ] 测试不同浏览器（Chrome、Edge、Firefox）
|
||
|
||
---
|
||
|
||
## 📝 测试报告模板
|
||
|
||
### 测试环境
|
||
- 浏览器: ____________
|
||
- 版本: ____________
|
||
- 日期: 2025-10-13
|
||
|
||
### 测试结果
|
||
- 出国审批页面: ✅ 通过 / ❌ 失败
|
||
- 出国申请页面: ✅ 通过 / ❌ 失败
|
||
|
||
### 发现问题
|
||
1. ________________
|
||
2. ________________
|
||
3. ________________
|
||
|
||
### 备注
|
||
________________
|
||
|
||
---
|
||
|
||
## 🎯 后续优化建议
|
||
|
||
### 已完成 ✅
|
||
- [x] 统一两个页面的附件处理逻辑
|
||
- [x] 添加正确的MIME类型声明
|
||
- [x] 优化Blob创建流程
|
||
- [x] 增强文件类型识别
|
||
|
||
### 可选优化 ⏳
|
||
- [ ] 添加PDF预览进度提示
|
||
- [ ] 支持大文件分片加载
|
||
- [ ] 添加预览失败重试机制
|
||
- [ ] 支持更多文件格式预览（Word、Excel等）
|
||
|
||
---
|
||
|
||
**测试时间**: 2025-10-13
|
||
**修复文档**:
|
||
- `📋出国审批附件功能完整修复总结.md`
|
||
- `✅出国申请页面PDF预览功能修复完成.md`
|
||
|
||
**请按照清单逐项测试，并反馈结果！** 😊
|
||
|