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

5.7 KiB
Raw Blame History

样品界面修改说明

修改时间

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仍然可以正常处理带有出库字段的数据

注意事项

  • 出库相关信息已从样品管理界面移除
  • 如需记录出库信息,建议未来创建独立的"出库管理"模块
  • 现有的出库数据仍然保存在数据库中,不会丢失
  • 样品的"状态"字段可以用来标识样品是否已完成、已退回等