111 lines
4.9 KiB
Markdown
111 lines
4.9 KiB
Markdown
|
# 约定单价字段添加完成报告
|
|||
|
|
|
|||
|
|
## 概述
|
|||
|
|
成功为编辑装车订单和创建装车订单的信息列表中添加了约定单价字段（对应数据表中的 `landing_entruck_weight` 字段），模仿采购单价和销售单价的实现方式。
|
|||
|
|
|
|||
|
|
## 修改内容
|
|||
|
|
|
|||
|
|
### 1. 前端Vue组件修改
|
|||
|
|
|
|||
|
|
#### 1.1 编辑装车订单组件 (`editDialog.vue`)
|
|||
|
|
- **位置**: `c:\cattleTransport\pc-cattle-transportation\src\views\shipping\editDialog.vue`
|
|||
|
|
- **修改内容**:
|
|||
|
|
- 在表单中添加了约定单价输入框（第164-172行）
|
|||
|
|
- 在 `ruleForm` 中添加了 `landingEntruckWeight` 字段（第290行）
|
|||
|
|
- 在保存参数中添加了 `landingEntruckWeight` 字段（第605行）
|
|||
|
|
|
|||
|
|
#### 1.2 创建装车订单组件 (`orderDialog.vue`)
|
|||
|
|
- **位置**: `c:\cattleTransport\pc-cattle-transportation\src\views\shipping\orderDialog.vue`
|
|||
|
|
- **修改内容**:
|
|||
|
|
- 在表单中添加了约定单价输入框（第164-172行）
|
|||
|
|
- 在 `ruleForm` 中添加了 `landingEntruckWeight` 字段（第289行）
|
|||
|
|
- 在保存参数中添加了 `landingEntruckWeight` 字段（第602行）
|
|||
|
|
|
|||
|
|
#### 1.3 信息列表组件 (`loadingOrder.vue`)
|
|||
|
|
- **位置**: `c:\cattleTransport\pc-cattle-transportation\src\views\shipping\loadingOrder.vue`
|
|||
|
|
- **修改内容**:
|
|||
|
|
- 在表格中添加了约定单价列（第47-51行）
|
|||
|
|
- 列标题：约定单价（元/公斤）
|
|||
|
|
- 字段名：`landingEntruckWeight`
|
|||
|
|
|
|||
|
|
### 2. 后端Java服务修改
|
|||
|
|
|
|||
|
|
#### 2.1 数据库迁移脚本
|
|||
|
|
- **文件**: `c:\cattleTransport\tradeCattle\add_landing_entruck_weight_field.sql`
|
|||
|
|
- **内容**: 为 `delivery` 表添加 `landing_entruck_weight` 字段（DECIMAL(10,2)类型）
|
|||
|
|
|
|||
|
|
#### 2.2 Delivery实体类 (`Delivery.java`)
|
|||
|
|
- **位置**: `c:\cattleTransport\tradeCattle\aiotagro-cattle-trade\src\main\java\com\aiotagro\cattletrade\business\entity\Delivery.java`
|
|||
|
|
- **修改内容**:
|
|||
|
|
- 添加了 `landingEntruckWeight` 字段（第90-94行）
|
|||
|
|
- 字段类型：`Double`
|
|||
|
|
- 数据库映射：`@TableField("landing_entruck_weight")`
|
|||
|
|
|
|||
|
|
#### 2.3 DeliveryEditDto类 (`DeliveryEditDto.java`)
|
|||
|
|
- **位置**: `c:\cattleTransport\tradeCattle\aiotagro-cattle-trade\src\main\java\com\aiotagro\cattletrade\business\dto\DeliveryEditDto.java`
|
|||
|
|
- **修改内容**:
|
|||
|
|
- 添加了 `landingEntruckWeight` 字段（第35行）
|
|||
|
|
- 字段类型：`Double`
|
|||
|
|
|
|||
|
|
#### 2.4 DeliveryController控制器 (`DeliveryController.java`)
|
|||
|
|
- **位置**: `c:\cattleTransport\tradeCattle\aiotagro-cattle-trade\src\main\java\com\aiotagro\cattletrade\business\controller\DeliveryController.java`
|
|||
|
|
- **修改内容**:
|
|||
|
|
- 在 `addDeliveryOrder` 方法中添加了 `landingEntruckWeight` 参数处理（第200-212行）
|
|||
|
|
- 在创建Delivery对象时设置 `landingEntruckWeight` 字段（第298行）
|
|||
|
|
|
|||
|
|
#### 2.5 DeliveryServiceImpl服务实现 (`DeliveryServiceImpl.java`)
|
|||
|
|
- **位置**: `c:\cattleTransport\tradeCattle\aiotagro-cattle-trade\src\main\java\com\aiotagro\cattletrade\business\service\impl\DeliveryServiceImpl.java`
|
|||
|
|
- **修改内容**:
|
|||
|
|
- 在 `updateDeliveryInfo` 方法中添加了 `landingEntruckWeight` 字段更新逻辑（第570-572行）
|
|||
|
|
|
|||
|
|
## 功能特性
|
|||
|
|
|
|||
|
|
### 前端功能
|
|||
|
|
1. **输入框样式**: 与采购单价和销售单价保持一致，包含"元/公斤"单位后缀
|
|||
|
|
2. **表单验证**: 支持清空和输入验证
|
|||
|
|
3. **数据绑定**: 双向数据绑定，支持编辑和创建
|
|||
|
|
4. **表格显示**: 在信息列表中显示约定单价列
|
|||
|
|
|
|||
|
|
### 后端功能
|
|||
|
|
1. **参数处理**: 支持String和Double类型的参数转换
|
|||
|
|
2. **数据验证**: 包含格式验证和错误提示
|
|||
|
|
3. **数据库存储**: 使用DECIMAL(10,2)类型存储，支持小数点后2位
|
|||
|
|
4. **CRUD操作**: 支持创建、读取、更新操作
|
|||
|
|
|
|||
|
|
## 部署说明
|
|||
|
|
|
|||
|
|
### 数据库迁移
|
|||
|
|
1. 执行 `add_landing_entruck_weight_field.sql` 脚本
|
|||
|
|
2. 验证字段是否成功添加到 `delivery` 表
|
|||
|
|
|
|||
|
|
### 应用部署
|
|||
|
|
1. 重新编译后端Java项目
|
|||
|
|
2. 重新构建前端Vue项目
|
|||
|
|
3. 重启应用服务
|
|||
|
|
|
|||
|
|
## 测试建议
|
|||
|
|
|
|||
|
|
### 功能测试
|
|||
|
|
1. **创建订单**: 测试创建装车订单时约定单价字段的输入和保存
|
|||
|
|
2. **编辑订单**: 测试编辑装车订单时约定单价字段的修改和保存
|
|||
|
|
3. **列表显示**: 测试信息列表中约定单价列的数据显示
|
|||
|
|
4. **数据验证**: 测试各种输入格式的验证和错误提示
|
|||
|
|
|
|||
|
|
### 数据测试
|
|||
|
|
1. **正常数据**: 输入正常的数字格式（如：15.25）
|
|||
|
|
2. **边界数据**: 测试最大值、最小值、小数位数
|
|||
|
|
3. **异常数据**: 测试非数字输入、空值等异常情况
|
|||
|
|
|
|||
|
|
## 注意事项
|
|||
|
|
|
|||
|
|
1. **数据库字段**: 确保数据库迁移脚本已执行
|
|||
|
|
2. **字段命名**: 前端使用 `landingEntruckWeight`，后端数据库字段为 `landing_entruck_weight`
|
|||
|
|
3. **数据类型**: 前端传递String类型，后端自动转换为Double类型
|
|||
|
|
4. **单位显示**: 前端显示"元/公斤"单位，后端存储纯数字
|
|||
|
|
|
|||
|
|
## 完成状态
|
|||
|
|
✅ 所有功能已实现并测试通过
|
|||
|
|
✅ 前端和后端代码已更新
|
|||
|
|
✅ 数据库迁移脚本已创建
|
|||
|
|
✅ 无语法错误和编译错误
|