# 出国申请附件功能-快速部署指南

## 🚀 快速部署（3步完成）

### 第1步：执行数据库脚本（1分钟）

```bash
# 使用MySQL客户端执行
mysql -h 主机地址 -u 用户名 -p 数据库名 < docs/设计文档/database/rs_overseas_application_attachment.sql
```

或者在数据库管理工具中执行该SQL文件。

**验证**：检查是否创建了表 `rs_overseas_application_attachment`

---

### 第2步：重启后端服务（2-3分钟）

```bash
cd backend
mvn clean install -DskipTests
./start-all.sh
```

**验证**：访问 http://localhost:8080 确认服务启动成功

---

### 第3步：重新构建前端（2-3分钟）

```bash
cd web
npm run build:prod
```

**验证**：检查 `web/dist` 目录是否生成新的文件

---

## ✅ 功能测试（5分钟）

### 测试1：新增申请并上传附件

1. 登录系统
2. 进入【出国管理】-【出国申请】
3. 点击"新增申请"
4. 阅读文件通知（30秒）
5. 填写申请表单
6. 滚动到底部，点击"添加附件"
7. 填写附件标题（如："护照复印件"）
8. 填写附件说明（选填，如："护照信息页"）
9. 选择文件上传
10. 点击"确认上传"
11. 验证附件列表显示新上传的文件
12. 点击"提交"保存申请

### 测试2：查看详情中显示附件

1. 在申请列表中找到刚才的申请
2. 点击"查看详情"
3. 滚动到底部查看"申请附件"区域
4. 验证显示附件标题、内容、文件名等信息
5. 点击"下载"按钮测试下载功能

---

## 📁 关键文件清单

### 数据库
- `docs/设计文档/database/rs_overseas_application_attachment.sql` - 附件表SQL脚本

### 后端（7个文件）
- `backend/ruoyi-modules/ruoyi-rs/src/main/java/org/dromara/rs/domain/RsOverseasApplicationAttachment.java` - Entity
- `backend/ruoyi-modules/ruoyi-rs/src/main/java/org/dromara/rs/domain/vo/RsOverseasApplicationAttachmentVo.java` - VO
- `backend/ruoyi-modules/ruoyi-rs/src/main/java/org/dromara/rs/domain/bo/RsOverseasApplicationAttachmentBo.java` - BO
- `backend/ruoyi-modules/ruoyi-rs/src/main/java/org/dromara/rs/mapper/RsOverseasApplicationAttachmentMapper.java` - Mapper
- `backend/ruoyi-modules/ruoyi-rs/src/main/resources/mapper/rs/RsOverseasApplicationAttachmentMapper.xml` - Mapper XML
- `backend/ruoyi-modules/ruoyi-rs/src/main/java/org/dromara/rs/service/IRsOverseasApplicationAttachmentService.java` - Service接口
- `backend/ruoyi-modules/ruoyi-rs/src/main/java/org/dromara/rs/service/impl/RsOverseasApplicationAttachmentServiceImpl.java` - Service实现
- `backend/ruoyi-modules/ruoyi-rs/src/main/java/org/dromara/rs/controller/RsOverseasApplicationAttachmentController.java` - Controller

### 前端（2个文件）
- `web/src/api/rs/overseas.ts` - API接口定义
- `web/src/views/rs/overseas/index.vue` - 页面组件

---

## 🐛 常见问题排查

### 问题1：上传附件时提示"请先保存申请表单"
**原因**：申请还没有保存到数据库，没有applicationId  
**解决**：需要先填写必填项并点击"提交"保存申请，再上传附件

### 问题2：上传失败，提示"文件上传失败"
**原因**：OSS配置不正确或网络问题  
**解决**：
1. 检查OSS配置是否正确
2. 检查网络连接是否正常
3. 查看后端日志确认具体错误

### 问题3：查看详情时不显示附件
**原因**：前端没有正确调用附件列表API  
**解决**：
1. 打开浏览器开发者工具
2. 查看Network标签，确认是否调用了 `/rs/overseas/attachment/list/{applicationId}` 接口
3. 检查接口返回数据是否正常

### 问题4：下载附件时无响应
**原因**：OSS URL不可访问或权限问题  
**解决**：
1. 复制附件URL在浏览器中直接访问
2. 确认OSS bucket配置允许外部访问
3. 检查文件是否真实存在

---

## 📊 API接口列表

| 接口路径 | 方法 | 说明 |
|---------|------|------|
| `/rs/overseas/attachment/list/{applicationId}` | GET | 查询附件列表 |
| `/rs/overseas/attachment/{attachmentId}` | GET | 查询附件详情 |
| `/rs/overseas/attachment/upload` | POST | 上传附件 |
| `/rs/overseas/attachment` | PUT | 更新附件 |
| `/rs/overseas/attachment/{attachmentId}` | DELETE | 删除附件 |
| `/rs/overseas/attachment/batch` | DELETE | 批量删除 |

---

## 💡 使用技巧

1. **快速上传**：可以拖拽文件到上传区域
2. **批量管理**：在编辑页面可以一次性上传多个附件
3. **文件命名**：建议使用有意义的附件标题，方便查找
4. **内容说明**：详细的内容说明有助于审批人员快速了解附件内容
5. **格式选择**：推荐使用PDF格式，兼容性最好

---

**部署时间**：约5-10分钟  
**测试时间**：约5分钟  
**总计**：15分钟完成部署和测试

如有问题，请参考详细的《出国申请附件管理功能实现报告.md》文档。