# Mex模块后台管理控制器

本目录包含Mex模块的后台管理控制器，用于管理农贸市场的各种数据。

## 控制器说明

### MexOrderController.php
- **功能**: 农贸市场订单管理
- **路由**: `/admin/mex-orders`
- **权限**: 查看订单详情，不允许编辑或删除
- **特性**: 支持按用户、商品、状态等条件筛选

### MexPriceConfigController.php
- **功能**: 农贸市场价格配置管理
- **路由**: `/admin/mex-price-configs`
- **权限**: 完整的CRUD操作
- **特性**: 配置商品的最低价、最高价和保护阈值

### MexTransactionController.php
- **功能**: 农贸市场成交记录管理
- **路由**: `/admin/mex-transactions`
- **权限**: 只读，查看成交记录
- **特性**: 支持交易统计和数据分析

### MexWarehouseController.php
- **功能**: 农贸市场仓库管理
- **路由**: `/admin/mex-warehouse`
- **权限**: 只读，查看仓库库存和统计
- **特性**: 显示库存、累计买卖数据和平均价格

### MexAdminOperationController.php
- **功能**: 农贸市场管理员操作记录
- **路由**: `/admin/mex-admin-operations`
- **权限**: 只读，查看管理员操作历史
- **特性**: 记录所有管理员的市场干预操作

## Helper类说明

### Helper/GridHelper.php
提供Grid列表页面的通用方法：
- `columnUserId()` - 用户ID列，带链接
- `columnItemId()` - 商品ID列，带链接
- `columnPrice()` - 价格列，格式化显示
- `columnAmount()` - 金额列，格式化显示
- `columnQuantity()` - 数量列，格式化显示
- `columnStatus()` - 状态列，带颜色标签

### Helper/FilterHelper.php
提供筛选器的通用方法：
- `equalUserId()` - 用户ID筛选
- `equalItemId()` - 商品ID筛选
- `equalOrderType()` - 订单类型筛选
- `betweenPrice()` - 价格范围筛选
- `betweenDatetime()` - 日期时间范围筛选

### Helper/ShowHelper.php
提供详情页面的通用方法：
- `fieldUserId()` - 用户ID字段，带链接
- `fieldPrice()` - 价格字段，格式化显示
- `fieldOrderType()` - 订单类型字段，显示描述
- `fieldBoolean()` - 布尔值字段，显示是/否

### Helper/FormHelper.php
提供表单的通用方法：
- `numberUserId()` - 用户ID数字输入
- `decimalPrice()` - 价格小数输入
- `selectOrderType()` - 订单类型选择
- `switchEnabled()` - 启用状态开关

## 路由注册

所有控制器都使用了`#[Resource]`属性自动注册路由，路由前缀为`/admin/`。

## 权限控制

- **只读控制器**: MexOrderController, MexTransactionController, MexWarehouseController, MexAdminOperationController
- **可编辑控制器**: MexPriceConfigController

## 菜单配置

需要在后台菜单中添加以下菜单项：

```
农贸市场
├── 订单管理 (/admin/mex-orders)
├── 价格配置 (/admin/mex-price-configs)
├── 成交记录 (/admin/mex-transactions)
├── 仓库管理 (/admin/mex-warehouse)
└── 操作记录 (/admin/mex-admin-operations)
```

## 注意事项

1. 所有控制器都继承自`UCore\DcatAdmin\AdminController`
2. 使用Repository模式进行数据访问
3. 订单和交易记录不允许编辑，保证数据完整性
4. 价格配置需要验证最低价小于最高价
5. 所有金额字段支持5位小数精度