# 订单表功能实现报告

## 概述
根据需求，重新设计并实现了一个新的订单管理系统，包含订单表的数据库设计、后端接口以及前端页面。

## 实现内容

### 1. 数据库设计

**表结构：** `order`

| 字段名 | 类型 | 说明 |
|--------|------|------|
| id | int(11) | 主键ID，自增 |
| buyer_id | varchar(500) | 买方ID（多个买家用逗号分隔） |
| seller_id | varchar(500) | 卖方ID（多个卖家用逗号分隔） |
| settlement_type | int(11) | 结算方式：1-上车重量，2-下车重量，3-按肉价结算 |
| is_delete | tinyint(1) | 逻辑删除标记(0-正常,1-已删除) |
| create_time | datetime | 创建时间 |
| created_by | int(11) | 创建人ID |
| update_time | datetime | 更新时间 |
| updated_by | int(11) | 更新人ID |

**SQL文件位置：** `tradeCattle/create_order_table.sql`

### 2. 后端实现

#### 2.1 实体类（Entity）
- **文件：** `Order.java`
- **位置：** `aiotagro-cattle-trade/src/main/java/com/aiotagro/cattletrade/business/entity/Order.java`
- **特性：**
  - 使用MyBatis-Plus注解
  - 包含@TableLogic注解实现逻辑删除
  - 包含显示字段：buyerName、sellerName、createdByName、settlementTypeDesc

#### 2.2 Mapper接口
- **文件：** `OrderMapper.java`
- **位置：** `aiotagro-cattle-trade/src/main/java/com/aiotagro/cattletrade/business/mapper/OrderMapper.java`
- **说明：** 继承BaseMapper，提供基础的CRUD操作

#### 2.3 Service层
- **接口：** `IOrderService.java`
- **实现类：** `OrderServiceImpl.java`
- **位置：** `aiotagro-cattle-trade/src/main/java/com/aiotagro/cattletrade/business/service/`
- **方法：**
  - `pageQuery` - 分页查询订单列表
  - `addOrder` - 新增订单
  - `updateOrder` - 更新订单
  - `deleteOrder` - 逻辑删除订单
  - `getOrderDetail` - 查询订单详情
  - `fillOrderInfo` - 填充订单关联信息（买方名称、卖方名称等）

**日志记录：** 所有操作都通过Logger记录详细日志

#### 2.4 Controller层
- **文件：** `OrderController.java`
- **位置：** `aiotagro-cattle-trade/src/main/java/com/aiotagro/cattletrade/business/controller/OrderController.java`
- **接口列表：**
  - `POST /order/list` - 查询订单列表（分页）
  - `POST /order/add` - 新增订单
  - `POST /order/edit` - 更新订单
  - `GET /order/delete` - 删除订单（逻辑删除）
  - `GET /order/detail` - 查询订单详情

**权限控制：** 使用SaCheckPermission注解进行权限验证
  - `order:list` - 列表查询权限
  - `order:add` - 新增权限
  - `order:edit` - 编辑权限
  - `order:delete` - 删除权限
  - `order:view` - 查看权限

### 3. 前端实现

#### 3.1 API接口
**文件：** `pc-cattle-transportation/src/api/shipping.js`

新增接口方法：
- `orderPageQuery(data)` - 订单列表查询
- `orderAddNew(data)` - 新增订单
- `orderUpdate(data)` - 更新订单
- `orderDelete(id)` - 删除订单
- `orderGetDetail(id)` - 查询订单详情

#### 3.2 前端页面
**文件：** `pc-cattle-transportation/src/views/shipping/orderDialog.vue`

**功能特性：**
- 简化的表单设计，只包含必要字段
- 支持多选买方和卖方（使用multiple属性）
- 下拉选择结算方式
- 远程搜索支持
- 分页功能
- 支持新增和编辑两种模式

**表单字段：**
- 卖方（sellerId）：多选下拉框，支持搜索和分页
- 买方（buyerId）：多选下拉框，支持搜索和分页
- 结算方式（settlementType）：单选下拉框，3个选项

## 核心特性

### 1. 逻辑删除
- 使用MyBatis-Plus的@TableLogic注解
- 删除操作不会真正删除数据，只是将is_delete字段设置为1
- 查询时会自动过滤已删除的记录

### 2. 操作日志
所有操作都记录详细日志：
- 操作类型（新增/修改/删除/查询）
- 操作参数
- 操作结果
- 异常信息

### 3. 关联查询
自动填充关联信息：
- 买方名称：从member_user表查询username
- 卖方名称：从member_user表查询username
- 创建人姓名：从sys_user表查询user_name
- 结算方式描述：自动转换（1→上车重量，2→下车重量，3→按肉价结算）

### 4. 数据校验
- 后端参数校验
- 前端表单验证
- 结算方式枚举值校验

## 使用方法

### 后端部署
1. 执行SQL脚本创建订单表
```sql
-- 执行 tradeCattle/create_order_table.sql
```

2. 重启后端服务

### 前端使用
```javascript
// 在需要使用的组件中引入
import orderDialog from '@/views/shipping/orderDialog.vue'

// 调用方法
const dialogRef = ref(null)
dialogRef.value.onShowDialog() // 新增模式
dialogRef.value.onShowDialog(orderData) // 编辑模式
```

## 权限配置

需要在菜单权限系统中配置以下权限：
- `order:list` - 订单列表
- `order:add` - 新增订单
- `order:edit` - 编辑订单
- `order:delete` - 删除订单
- `order:view` - 查看订单详情

## 技术栈

### 后端
- Java 8+
- Spring Boot
- MyBatis-Plus
- Sa-Token（权限管理）
- SLF4J（日志）

### 前端
- Vue 3
- Element Plus
- Axios

## 后续优化建议

1. 添加订单状态字段
2. 添加更多业务字段（如金额、数量等）
3. 实现订单导出功能
4. 添加订单统计功能
5. 实现订单审核流程

## 文件清单

### 后端文件
- `create_order_table.sql` - 数据库表结构
- `Order.java` - 实体类
- `OrderMapper.java` - Mapper接口
- `IOrderService.java` - Service接口
- `OrderServiceImpl.java` - Service实现
- `OrderController.java` - Controller

### 前端文件
- `shipping.js` - API接口（新增部分）
- `orderDialog.vue` - 订单弹窗组件

## 注意事项

1. order是MySQL的保留关键字，创建表时需要用反引号包裹：`` `order` ``
2. 买方ID和卖方ID存储为逗号分隔的字符串，使用时需要拆分
3. 逻辑删除功能需要确保相关查询都使用正确的字段过滤
4. 关联查询可能会影响性能，大量数据时建议添加缓存