ETest-Vue-FastAPI/样品界面修改说明.md

163 lines
5.7 KiB
Markdown
Raw Permalink Normal View History

2025-12-19 10:12:59 +08:00
# 样品界面修改说明
## 修改时间
2025年11月7日
## 修改内容概述
根据用户需求,简化了"修改样品"界面,删除了与出库相关的字段,只保留核心的样品入库信息。
## 详细修改内容
### 1. ✅ 样品表单字段调整
**保留的字段(前四行内容):**
- 第一行:
- 入库单号(仅在非路由跳转时显示)
- 样品型号
- 第二行:
- 样品SN号
- 硬件版本号
- 第三行:
- 样品外观状态下拉选择PCBA、点板板、建板板
- 计划测试截止日期(日期选择器)
- 第四行:
- 计划测试项(文本域)
**保留的其他字段:**
- 状态(下拉选择:待测试、测试中、已完成、已退回)
- 备注(文本域)
**删除的字段:**
- ❌ 实际测试项
- ❌ 出库交样日期
- ❌ 出库交样方式
- ❌ 出库交样人
- ❌ 出库接样人
- ❌ 出库记录人
### 2. ✅ 样品列表显示字段调整
**保留的列:**
- 入库单号
- 样品型号
- 样品SN号
- 硬件版本号
- 外测状态
- 计划测试项
- 测试截止日期
- 状态
**删除的列:**
- ❌ 出库交样日期
- ❌ 出库交样人
### 3. ✅ 对话框宽度调整
- 原宽度900px
- 新宽度700px
- 原因:删除了多个字段后,表单更加简洁,不需要那么宽的对话框
## 修改的文件
### 前端文件
1. `ruoyi-fastapi-frontend/src/views/warehouse/sample/index.vue`
- 删除表单中的出库相关字段
- 删除 `form` 对象中的相关属性
- 调整对话框宽度从 900px 到 700px
- 删除列表中的出库相关列
### 后端文件
- 无需修改(出库相关字段保留在数据库和后端模型中,供未来可能的出库功能使用)
## 设计考虑
### 为什么保留后端字段?
虽然前端界面删除了出库相关字段,但这些字段在数据库和后端模型中保留了:
1. **数据完整性**:已有的出库数据不会丢失
2. **未来扩展**:如果将来需要单独的"出库管理"功能,这些字段可以直接使用
3. **最小改动**:只修改前端显示,不影响数据库结构和后端逻辑
保留的后端字段:
- `actual_test_items` - 实际测试项
- `delivery_date` - 出库交样日期
- `delivery_method` - 出库交样方式
- `delivery_person` - 出库交样人
- `receive_person` - 出库接样人
- `delivery_recorder` - 出库记录人
## 修改后的样品界面布局
```
┌─────────────────────────────────────────────┐
│ 修改样品 │
├─────────────────────────────────────────────┤
│ 入库单号* [RK2025001234] │
│ 样品型号 [DSM ] │
├─────────────────────────────────────────────┤
│ 样品SN号 [2402123SG ] │
│ 硬件版本号 [DSM_V4.1.2 ] │
├─────────────────────────────────────────────┤
│ 样品外观状态 [PCBA ▼ ] │
│ 计划测试截止 [2025-10-20 📅] │
├─────────────────────────────────────────────┤
│ 计划测试项 │
│ [PCBA入库测试... ] │
│ [ ] │
├─────────────────────────────────────────────┤
│ 状态 [待测试 ▼ ] │
├─────────────────────────────────────────────┤
│ 备注 │
│ [样品备注... ] │
│ [ ] │
└─────────────────────────────────────────────┘
[确定] [取消]
* 仅在非路由跳转时显示
```
## 使用说明
### 修改样品信息
1. 在样品列表中点击"修改"按钮
2. 弹出的对话框中只包含核心的样品入库信息
3. 修改需要的字段
4. 点击"确定"保存
### 字段说明
- **样品型号**:样品的型号名称
- **样品SN号**:样品的序列号
- **硬件版本号**:样品的硬件版本
- **样品外观状态**样品入库时的外观状态PCBA、点板板、建板板
- **计划测试截止日期**:计划完成测试的截止日期
- **计划测试项**:需要进行的测试项目
- **状态**:样品当前状态(待测试、测试中、已完成、已退回)
- **备注**:其他需要说明的信息
## 测试建议
1. **测试修改功能**
- 修改现有样品信息
- 验证数据是否正确保存
- 验证界面布局是否合理
2. **测试列表显示**
- 验证列表中不再显示出库相关列
- 验证数据显示是否正确
3. **测试数据兼容性**
- 对于已有出库数据的样品,验证修改操作不会影响这些数据
- 验证后端API仍然可以正常处理带有出库字段的数据
## 注意事项
- 出库相关信息已从样品管理界面移除
- 如需记录出库信息,建议未来创建独立的"出库管理"模块
- 现有的出库数据仍然保存在数据库中,不会丢失
- 样品的"状态"字段可以用来标识样品是否已完成、已退回等