158 lines
3.9 KiB
Markdown
158 lines
3.9 KiB
Markdown
# CSV和PDF文件上传支持实施计划
|
||
|
||
> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
|
||
|
||
**目标:** 扩展流水导入功能，支持CSV和PDF格式文件上传
|
||
|
||
**架构:** 修改后端文件类型校验逻辑，添加 `.csv` 和 `.pdf` 支持，使前后端校验规则一致
|
||
|
||
**技术栈:** Spring Boot 3.5.8, Java 21, MyBatis Plus
|
||
|
||
---
|
||
|
||
## 任务1: 修改后端文件类型校验
|
||
|
||
**文件:**
|
||
- 修改: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/controller/CcdiFileUploadController.java:65-67`
|
||
|
||
**步骤1: 修改文件类型校验逻辑**
|
||
|
||
定位到 `CcdiFileUploadController.java` 第65-67行，修改校验逻辑：
|
||
|
||
**修改前:**
|
||
```java
|
||
if (!fileName.endsWith(".xlsx") && !fileName.endsWith(".xls")) {
|
||
return AjaxResult.error("文件 " + fileName + " 格式不支持，仅支持Excel文件");
|
||
}
|
||
```
|
||
|
||
**修改后:**
|
||
```java
|
||
String lowerFileName = fileName.toLowerCase();
|
||
if (!lowerFileName.endsWith(".xlsx") && !lowerFileName.endsWith(".xls")
|
||
&& !lowerFileName.endsWith(".csv") && !lowerFileName.endsWith(".pdf")) {
|
||
return AjaxResult.error("文件 " + fileName + " 格式不支持，仅支持 PDF、CSV、Excel 文件");
|
||
}
|
||
```
|
||
|
||
**步骤2: 验证修改**
|
||
|
||
- 确认代码语法正确
|
||
- 确认导入语句无缺失（无需新增导入）
|
||
|
||
---
|
||
|
||
## 任务2: 通过Swagger测试接口
|
||
|
||
**前置条件:** 后端服务已启动（端口8080）
|
||
|
||
**步骤1: 访问Swagger UI**
|
||
|
||
浏览器打开: http://localhost:8080/swagger-ui/index.html
|
||
|
||
**步骤2: 测试CSV文件上传**
|
||
|
||
1. 找到 `POST /upload/batch/{projectId}` 接口
|
||
2. 点击 "Try it out"
|
||
3. 选择 projectId（如：1）
|
||
4. 上传一个 `.csv` 测试文件
|
||
5. 点击 "Execute"
|
||
6. **预期结果**: 返回成功响应，包含 batchId
|
||
|
||
**步骤3: 测试PDF文件上传**
|
||
|
||
1. 使用同一接口
|
||
2. 上传一个 `.pdf` 测试文件
|
||
3. **预期结果**: 返回成功响应，包含 batchId
|
||
|
||
**步骤4: 测试大小写不敏感**
|
||
|
||
1. 上传文件名为 `.CSV`（大写）的文件
|
||
2. **预期结果**: 返回成功响应
|
||
|
||
**步骤5: 测试不支持格式**
|
||
|
||
1. 上传 `.txt` 文件
|
||
2. **预期结果**: 返回错误 "格式不支持，仅支持 PDF、CSV、Excel 文件"
|
||
|
||
---
|
||
|
||
## 任务3: 前端功能验证
|
||
|
||
**前置条件:** 前端服务已启动（端口80）
|
||
|
||
**步骤1: 访问前端页面**
|
||
|
||
浏览器打开: http://localhost
|
||
|
||
登录账号: admin / admin123
|
||
|
||
**步骤2: 进入项目详情页面**
|
||
|
||
导航到: 项目管理 → 选择项目 → 详情 → 数据上传
|
||
|
||
**步骤3: 测试CSV文件上传**
|
||
|
||
1. 点击 "批量上传" 按钮
|
||
2. 拖拽或选择 `.csv` 文件
|
||
3. 点击 "开始上传"
|
||
4. **预期结果**: 文件成功上传，无格式错误提示
|
||
|
||
**步骤4: 测试PDF文件上传**
|
||
|
||
1. 选择 `.pdf` 文件
|
||
2. 点击 "开始上传"
|
||
3. **预期结果**: 文件成功上传，无格式错误提示
|
||
|
||
---
|
||
|
||
## 任务4: 提交代码
|
||
|
||
**步骤1: 查看修改状态**
|
||
|
||
运行:
|
||
```bash
|
||
cd D:/ccdi/ccdi
|
||
git status
|
||
```
|
||
|
||
预期输出:
|
||
```
|
||
modified: ccdi-project/src/main/java/com/ruoyi/ccdi/project/controller/CcdiFileUploadController.java
|
||
```
|
||
|
||
**步骤2: 提交代码**
|
||
|
||
```bash
|
||
git add ccdi-project/src/main/java/com/ruoyi/ccdi/project/controller/CcdiFileUploadController.java
|
||
git commit -m "feat(ccdi-project): 流水导入支持CSV和PDF文件格式"
|
||
```
|
||
|
||
**步骤3: 推送到远程仓库（可选）**
|
||
|
||
```bash
|
||
git push origin dev
|
||
```
|
||
|
||
---
|
||
|
||
## 实施检查清单
|
||
|
||
- [ ] 后端文件类型校验已修改
|
||
- [ ] CSV文件上传测试通过（Swagger）
|
||
- [ ] PDF文件上传测试通过（Swagger）
|
||
- [ ] 大小写不敏感测试通过
|
||
- [ ] 不支持格式被正确拒绝
|
||
- [ ] 前端CSV上传功能正常
|
||
- [ ] 前端PDF上传功能正常
|
||
- [ ] 代码已提交到git
|
||
|
||
---
|
||
|
||
## 注意事项
|
||
|
||
1. **测试文件准备**: 准备好 `.csv`、`.pdf`、`.xlsx`、`.txt` 格式的测试文件
|
||
2. **文件大小**: 测试文件不超过50MB
|
||
3. **流水分析平台**: 确认平台支持CSV和PDF格式（已确认支持）
|
||
4. **不影响现有功能**: Excel文件上传功能保持不变
|