163 lines
5.7 KiB
Markdown
163 lines
5.7 KiB
Markdown
# 样品界面修改说明
|
||
|
||
## 修改时间
|
||
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仍然可以正常处理带有出库字段的数据
|
||
|
||
## 注意事项
|
||
|
||
- 出库相关信息已从样品管理界面移除
|
||
- 如需记录出库信息，建议未来创建独立的"出库管理"模块
|
||
- 现有的出库数据仍然保存在数据库中，不会丢失
|
||
- 样品的"状态"字段可以用来标识样品是否已完成、已退回等
|
||
|