mirror of
https://github.com/crmeb/CRMEB.git
synced 2026-10-29 14:01:07 +00:00
3b5bd37bfb
为所有 MCP 内置工具实现 category() 分类方法，支持管理后台按业务分组展示；优化订单列表关键词搜索逻辑，使用闭包显式 OR 条件匹配订单号和商品标题，避免管道字段静默丢弃问题；新增优惠券库存调整原子方法，提升并发安全性；同步更新相关文档和注释，完善分类展示规则说明。
135 lines
4.3 KiB
PHP
135 lines
4.3 KiB
PHP
<?php
|
||
// +----------------------------------------------------------------------
|
||
// | CRMEB [ CRMEB赋能开发者，助力企业发展 ]
|
||
// +----------------------------------------------------------------------
|
||
// | Copyright (c) 2016~2026 https://www.crmeb.com All rights reserved.
|
||
// +----------------------------------------------------------------------
|
||
// | Licensed CRMEB并不是自由软件，未经许可不能去掉CRMEB相关版权
|
||
// +----------------------------------------------------------------------
|
||
// | Author: CRMEB Team <admin@crmeb.com>
|
||
// +----------------------------------------------------------------------
|
||
declare(strict_types=1);
|
||
|
||
namespace modules\service\mcp\tools;
|
||
|
||
use app\dao\order\OrderCenterDao;
|
||
use modules\service\mcp\McpException;
|
||
use crmeb\interfaces\McpToolInterface;
|
||
|
||
/**
|
||
* MCP 工具：订单详情
|
||
*
|
||
* 按订单号查询，仅返回面向 AI 助手的必要字段。
|
||
*/
|
||
class OrderDetailTool implements McpToolInterface
|
||
{
|
||
/**
|
||
* 订单中台 DAO
|
||
* @var OrderCenterDao
|
||
*/
|
||
private OrderCenterDao $dao;
|
||
|
||
/**
|
||
* 构造函数
|
||
* @param OrderCenterDao $dao 订单中台 DAO
|
||
*/
|
||
public function __construct(OrderCenterDao $dao)
|
||
{
|
||
$this->dao = $dao;
|
||
}
|
||
|
||
/**
|
||
* 工具名称
|
||
* @return string
|
||
*/
|
||
public function name(): string
|
||
{
|
||
return 'crmeb_order_detail';
|
||
}
|
||
|
||
/**
|
||
* 工具描述
|
||
* @return string
|
||
*/
|
||
public function description(): string
|
||
{
|
||
return '按订单号（order_no）查询单笔订单详情，返回金额、支付方式、状态码、退款状态、下单/支付/发货时间等；'
|
||
. '不含收货人姓名、电话与收货地址（订单中台不存这些字段），入参是订单号字符串而非内部ID。';
|
||
}
|
||
|
||
/**
|
||
* 工具中文名（管理后台展示）
|
||
* @return string
|
||
*/
|
||
public function label(): string
|
||
{
|
||
return '订单详情';
|
||
}
|
||
|
||
/**
|
||
* 工具分类（管理后台分组展示）
|
||
* @return string
|
||
*/
|
||
public function category(): string
|
||
{
|
||
return '订单';
|
||
}
|
||
|
||
/**
|
||
* 入参 Schema
|
||
* @return array
|
||
*/
|
||
public function inputSchema(): array
|
||
{
|
||
return [
|
||
'type' => 'object',
|
||
'properties' => [
|
||
'order_id' => ['type' => 'string', 'description' => '订单号'],
|
||
],
|
||
'required' => ['order_id'],
|
||
];
|
||
}
|
||
|
||
/**
|
||
* 执行工具
|
||
*
|
||
* @param array $args 参数（order_id）
|
||
* @return array 订单详情（已过滤敏感字段）
|
||
* @throws McpException 参数错误或订单不存在
|
||
*/
|
||
public function execute(array $args): array
|
||
{
|
||
if (empty($args['order_id'])) {
|
||
throw new McpException('参数错误：缺少 order_id');
|
||
}
|
||
$info = $this->dao->search([['order_no', '=', $args['order_id']], ['is_del', '=', 0]])
|
||
->field('id,order_no,uid,source_type,product_type,title,total_num,total_price,pay_price,pay_type,pay_status,status_code,refund_status,shipping_type,add_time,pay_time,delivery_time')
|
||
->find();
|
||
if (!$info) {
|
||
throw new McpException('订单不存在');
|
||
}
|
||
$info = is_object($info) ? $info->toArray() : (array)$info;
|
||
|
||
// 过滤敏感字段，只返回必要信息（收货人/地址等在 extra_info JSON 中）
|
||
return [
|
||
'id' => $info['id'],
|
||
'order_no' => $info['order_no'] ?? '',
|
||
'uid' => $info['uid'],
|
||
'source_type' => $info['source_type'] ?? '',
|
||
'product_type' => $info['product_type'] ?? '',
|
||
'title' => $info['title'] ?? '',
|
||
'total_num' => $info['total_num'] ?? 0,
|
||
'total_price' => $info['total_price'] ?? 0,
|
||
'pay_price' => $info['pay_price'] ?? 0,
|
||
'pay_type' => $info['pay_type'] ?? '',
|
||
'pay_status' => $info['pay_status'] ?? 0,
|
||
'status_code' => $info['status_code'] ?? '',
|
||
'refund_status' => $info['refund_status'] ?? 0,
|
||
'shipping_type' => $info['shipping_type'] ?? 0,
|
||
'add_time' => $info['add_time'] ?? 0,
|
||
'pay_time' => $info['pay_time'] ?? 0,
|
||
'delivery_time' => $info['delivery_time'] ?? 0,
|
||
];
|
||
}
|
||
}
|