kknongchang_2506/app/Module/Mex/AdminControllers

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位小数精度