138 lines
3.7 KiB
Markdown
138 lines
3.7 KiB
Markdown
# 订单表与装车订单表关联关系说明
|
||
|
||
## 问题说明
|
||
|
||
用户创建了新的 `order` 订单表，但装车订单接口 `/delivery/pageDeliveryOrderList` 仍然返回的是 `delivery` 装车运单表的数据，没有关联到新的 `order` 表。
|
||
|
||
## 解决方案
|
||
|
||
### 1. 数据库层面
|
||
**文件：** `add_order_id_to_delivery.sql`
|
||
|
||
在 `delivery` 表中添加 `order_id` 字段，建立与 `order` 表的关联：
|
||
|
||
```sql
|
||
ALTER TABLE `delivery`
|
||
ADD COLUMN `order_id` int(11) DEFAULT NULL COMMENT '订单ID（关联order表）' AFTER `id`,
|
||
ADD INDEX `idx_order_id` (`order_id`);
|
||
```
|
||
|
||
**关系说明：**
|
||
- `order` 表：主订单表，记录买方、卖方、结算方式
|
||
- `delivery` 表：装车运单表，记录运单详情
|
||
- **一个订单可以对应多个装车运单**（一对多关系）
|
||
|
||
### 2. 实体类更新
|
||
**文件：** `Delivery.java`
|
||
|
||
添加两个字段：
|
||
- `orderId`：订单ID，用于存储关联的订单
|
||
- `orderInfo`：订单信息对象，用于查询时填充订单详细信息
|
||
|
||
### 3. 服务层更新
|
||
**文件：** `DeliveryServiceImpl.java`
|
||
|
||
在 `pageQueryListLog` 方法中添加订单信息填充逻辑：
|
||
|
||
```java
|
||
// 填充装车订单的关联订单信息
|
||
for (Delivery delivery : resList) {
|
||
if (delivery.getOrderId() != null) {
|
||
Order order = orderMapper.selectById(delivery.getOrderId());
|
||
if (order != null) {
|
||
delivery.setOrderInfo(order);
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
## 数据流程
|
||
|
||
1. **创建订单（Order）**
|
||
- 用户在订单管理中创建订单
|
||
- 记录：买方、卖方、结算方式
|
||
- 保存到 `order` 表
|
||
|
||
2. **创建装车订单（Delivery）**
|
||
- 用户在装车订单中创建运单
|
||
- 记录：运单详情（起始地、目的地、车牌等）
|
||
- 保存时关联 `order_id`
|
||
- 保存到 `delivery` 表
|
||
|
||
3. **查询装车订单列表**
|
||
- 调用 `/delivery/pageDeliveryOrderList`
|
||
- 查询 `delivery` 表
|
||
- 根据 `order_id` 关联查询 `order` 表
|
||
- 返回装车订单信息 + 订单信息
|
||
|
||
## 返回数据格式
|
||
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"msg": "success",
|
||
"data": {
|
||
"total": 10,
|
||
"rows": [
|
||
{
|
||
"id": 89,
|
||
"orderId": 1, // 关联的订单ID
|
||
"deliveryNumber": "ZC20251027161826",
|
||
"deliveryTitle": "2222",
|
||
"orderInfo": { // 订单详细信息
|
||
"id": 1,
|
||
"buyerId": "10,11",
|
||
"sellerId": "5,6",
|
||
"settlementType": 1,
|
||
"buyerName": "张三,李四",
|
||
"sellerName": "王五,赵六",
|
||
"settlementTypeDesc": "上车重量"
|
||
}
|
||
}
|
||
]
|
||
}
|
||
}
|
||
```
|
||
|
||
## 使用步骤
|
||
|
||
1. **执行数据库迁移**
|
||
```sql
|
||
-- 先执行创建订单表的SQL
|
||
SOURCE create_order_table.sql;
|
||
|
||
-- 然后为delivery表添加order_id字段
|
||
SOURCE add_order_id_to_delivery.sql;
|
||
```
|
||
|
||
2. **重启后端服务**
|
||
|
||
3. **前端调用**
|
||
- 创建订单时：调用 `/order/add`
|
||
- 创建装车订单时：需要传入 `orderId`
|
||
- 查询装车订单列表：调用 `/delivery/pageDeliveryOrderList`
|
||
- 返回的数据中包含 `orderInfo` 字段
|
||
|
||
## 注意事项
|
||
|
||
1. 不计 `delivery` 已存在数据，`order_id` 为 `NULL`
|
||
2. 新增运单时需关联 `order_id`
|
||
3. 查询装车订单时会自动填充 `orderInfo`
|
||
4. 支持一个订单对应多个装车运单（一对多关系）
|
||
|
||
## 前端集成建议
|
||
|
||
在装车订单列表中显示订单信息：
|
||
|
||
```vue
|
||
<el-table-column label="买方" prop="orderInfo.buyerName" />
|
||
<el-table-column label="卖方" prop="orderInfo.sellerName" />
|
||
<el-table-column label="结算方式" prop="orderInfo.settlementTypeDesc" />
|
||
```
|
||
|
||
## 数据一致性
|
||
|
||
- 删除订单时：应检查是否有关联的装车订单
|
||
- 可级联删除或禁止删除（推荐阻止删除以避免数据不一致）
|
||
|