111 lines
4.5 KiB
Markdown
111 lines
4.5 KiB
Markdown
# 设备维修单页面增加附件、富文本功能
|
||
|
||
## 功能说明
|
||
为设备维修单添加富文本编辑和附件上传功能，支持以下内容：
|
||
1. 在维修单主表增加富文本编辑器，用于详细描述维修内容（维修描述）
|
||
2. 在维修单明细中增加富文本编辑器，用于详细描述每项维修说明
|
||
3. 支持上传附件到维修单（通过附件管理按钮）
|
||
4. 支持查看、下载和删除已上传的附件
|
||
5. 富文本编辑器支持插入图片（自动上传到服务器）
|
||
|
||
## 数据库变更
|
||
|
||
### 新增表
|
||
1. `dm_repair_order_attachment` - 维修单附件表
|
||
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | bigint | 主键ID |
|
||
| repair_order_id | bigint | 维修单ID |
|
||
| entry_id | bigint | 明细ID（可为空，表示主单附件） |
|
||
| file_name | varchar(255) | 文件名称 |
|
||
| file_path | varchar(1000) | 文件路径（格式：/profile/upload/yyyy/MM/dd/xxx.jpg） |
|
||
| file_size | bigint | 文件大小（字节） |
|
||
| file_type | varchar(100) | 文件类型 |
|
||
| create_by | varchar(32) | 创建人 |
|
||
| create_time | datetime | 创建时间 |
|
||
| update_by | varchar(32) | 更新人 |
|
||
| update_time | datetime | 更新时间 |
|
||
| status | char(1) | 状态（0正常 1删除） |
|
||
| remark | varchar(500) | 备注 |
|
||
|
||
### 表结构变更
|
||
1. `dm_repair_order` 主表新增字段：
|
||
- `rich_text_content` longtext - 富文本内容/维修描述（位于remark字段之后）
|
||
|
||
2. `dm_repair_order_entry` 明细表新增字段：
|
||
- `rich_text_content` longtext - 富文本内容/维修说明（位于fault_name字段之后）
|
||
|
||
## API 变更
|
||
|
||
### 新增接口
|
||
1. `POST /equipment/repairOrder/attachment/upload` - 上传附件
|
||
- 参数：file（文件）、repairOrderId（维修单ID）、entryId（明细ID，可选）
|
||
- 返回：附件信息
|
||
2. `GET /equipment/repairOrder/attachment/download/{id}` - 下载附件（匿名访问）
|
||
3. `GET /equipment/repairOrder/attachment/list/{repairOrderId}` - 获取附件列表
|
||
4. `DELETE /equipment/repairOrder/attachment/{ids}` - 删除附件
|
||
|
||
### 修改接口
|
||
1. `POST /equipment/repairOrder` - 支持保存富文本内容和附件信息
|
||
2. `PUT /equipment/repairOrder` - 支持更新富文本内容
|
||
|
||
## 前端修改
|
||
|
||
### 主表单
|
||
1. 新增"维修描述"字段，使用Editor富文本编辑器组件
|
||
|
||
### 明细表格
|
||
1. 新增"维修说明"列，点击弹出富文本编辑对话框
|
||
2. 新增"附件管理"按钮，点击弹出附件管理对话框
|
||
|
||
### 附件管理对话框
|
||
1. 支持上传附件（新增模式：临时存储，保存时一起提交；修改模式：直接上传到服务器）
|
||
2. 显示附件列表（文件名、大小、上传时间）
|
||
3. 支持下载和删除附件
|
||
|
||
### 查看详情对话框
|
||
1. 显示主表维修描述（富文本渲染）
|
||
2. 明细列表中显示"维修说明"查看按钮
|
||
3. 显示附件列表，支持下载
|
||
|
||
### Editor组件修复
|
||
1. 修复图片上传按钮点击无效的问题（v-if条件修复）
|
||
2. 兼容不同版本Element UI的文件选择触发方式
|
||
|
||
## 约束条件
|
||
- 单个文件大小限制：50MB
|
||
- 支持的文件类型：图片（jpg/png/gif）、文档（doc/docx/pdf/xls/xlsx）、压缩包（zip/rar）
|
||
- 富文本图片大小限制：5MB
|
||
|
||
## 涉及文件
|
||
|
||
### 后端
|
||
- `RepairOrder.java` - 主表实体，新增richTextContent和attachmentList字段
|
||
- `RepairOrderEntry.java` - 明细实体，新增richTextContent字段
|
||
- `RepairOrderAttachment.java` - 附件实体（新增）
|
||
- `RepairOrderAttachmentMapper.java` - 附件Mapper接口（新增）
|
||
- `RepairOrderAttachmentMapper.xml` - 附件Mapper XML（新增）
|
||
- `IRepairOrderAttachmentService.java` - 附件Service接口（新增）
|
||
- `RepairOrderAttachmentServiceImpl.java` - 附件Service实现（新增）
|
||
- `RepairOrderController.java` - 新增附件上传/下载/删除接口
|
||
- `RepairOrderServiceImpl.java` - 新增时处理附件保存
|
||
- `RepairOrderMapper.xml` - 查询时映射richTextContent字段
|
||
|
||
### 前端
|
||
- `repairOrder.js` - 新增getAttachmentList、deleteAttachment接口
|
||
- `index.vue` - 主页面，新增富文本编辑、附件管理、查看详情功能
|
||
- `Editor/index.vue` - 修复图片上传功能
|
||
|
||
### SQL脚本
|
||
- `2025-12-05_v1.0.37_周启威_设备维修单增加附件、富文本.sql`
|
||
|
||
## 测试要点
|
||
1. 主表富文本编辑和保存功能
|
||
2. 明细富文本编辑和保存功能
|
||
3. 富文本中插入图片功能
|
||
4. 新增模式下附件上传和保存
|
||
5. 修改模式下附件上传和删除
|
||
6. 附件下载功能
|
||
7. 查看详情页面富文本和附件展示
|
||
8. 文件大小和类型校验 |