mirror of
https://github.com/crmeb/CRMEB.git
synced 2026-10-28 21:40:50 +00:00
3b5bd37bfb
为所有 MCP 内置工具实现 category() 分类方法，支持管理后台按业务分组展示；优化订单列表关键词搜索逻辑，使用闭包显式 OR 条件匹配订单号和商品标题，避免管道字段静默丢弃问题；新增优惠券库存调整原子方法，提升并发安全性；同步更新相关文档和注释，完善分类展示规则说明。
79 lines
3.3 KiB
PHP
79 lines
3.3 KiB
PHP
<?php
|
|
declare(strict_types=1);
|
|
|
|
namespace modules\service\mcp\tools;
|
|
|
|
use app\dao\order\OrderCenterDao;
|
|
use app\services\order\OrderCenterServices;
|
|
use modules\service\mcp\McpException;
|
|
use crmeb\interfaces\McpToolInterface;
|
|
|
|
/** MCP 工具：订单物流轨迹，只返回快递公司、运单号及节点。 */
|
|
class OrderLogisticsTool implements McpToolInterface
|
|
{
|
|
/** @var OrderCenterDao 订单中台 DAO */
|
|
private OrderCenterDao $dao;
|
|
/** @var OrderCenterServices 订单详情服务 */
|
|
private OrderCenterServices $orders;
|
|
/** @param OrderCenterDao $dao 订单 DAO @param OrderCenterServices $orders 订单服务 */
|
|
public function __construct(OrderCenterDao $dao, OrderCenterServices $orders)
|
|
{
|
|
$this->dao = $dao;
|
|
$this->orders = $orders;
|
|
}
|
|
/** @return string 工具名 */
|
|
public function name(): string { return 'crmeb_order_logistics'; }
|
|
/** @return string 工具描述 */
|
|
public function description(): string
|
|
{
|
|
return '按订单号查询快递公司、运单号与物流轨迹；仅支持有运单号的快递配送订单。'
|
|
. '驱动未配置或轨迹查询失败时轨迹为空，不代表尚未发货；不返回收件人地址或手机号。';
|
|
}
|
|
|
|
/**
|
|
* 工具中文名（管理后台展示）
|
|
* @return string
|
|
*/
|
|
public function label(): string
|
|
{
|
|
return '订单物流';
|
|
}
|
|
|
|
/** @return string 工具分类（管理后台分组展示） */
|
|
public function category(): string
|
|
{
|
|
return '订单';
|
|
}
|
|
/** @return array 入参 JSON Schema */
|
|
public function inputSchema(): array
|
|
{
|
|
return ['type' => 'object', 'required' => ['order_no'], 'properties' => [
|
|
'order_no' => ['type' => 'string', 'description' => '精确订单号'],
|
|
]];
|
|
}
|
|
/** @param array $args 订单号 @return array 物流摘要 @throws McpException 订单不存在 */
|
|
public function execute(array $args): array
|
|
{
|
|
$orderNo = trim((string)($args['order_no'] ?? ''));
|
|
if ($orderNo === '') { throw new McpException('order_no 不能为空'); }
|
|
$order = $this->dao->search([['order_no', '=', $orderNo], ['is_del', '=', 0]])
|
|
->field('id,order_no,shipping_type,delivery_time')->find();
|
|
if (!$order) { throw new McpException('订单不存在'); }
|
|
if ((int)$order['shipping_type'] !== 1) {
|
|
return ['order_no' => $orderNo, 'shipping_type' => (int)$order['shipping_type'], 'message' => '该订单不是快递配送'];
|
|
}
|
|
$detail = $this->orders->getDetail((int)$order['id']);
|
|
$logistics = is_array($detail['extend']['logistics'] ?? null) ? $detail['extend']['logistics'] : [];
|
|
$tracks = [];
|
|
foreach (array_slice((array)($logistics['tracks'] ?? []), 0, 50) as $track) {
|
|
if (!is_array($track)) { continue; }
|
|
$status = mb_substr((string)($track['title'] ?? ''), 0, 150);
|
|
$tracks[] = ['status' => preg_replace('/(?<!\d)1[3-9]\d{9}(?!\d)/', '***', $status),
|
|
'time' => (string)($track['time'] ?? '')];
|
|
}
|
|
return ['order_no' => $orderNo, 'delivery_time' => (int)$order['delivery_time'],
|
|
'delivery_name' => (string)($logistics['delivery_name'] ?? ''),
|
|
'delivery_id' => (string)($logistics['delivery_id'] ?? ''), 'tracks' => $tracks];
|
|
}
|
|
}
|