mirror of
https://github.com/crmeb/CRMEB.git
synced 2026-10-29 05:50:50 +00:00
3b5bd37bfb
为所有 MCP 内置工具实现 category() 分类方法，支持管理后台按业务分组展示；优化订单列表关键词搜索逻辑，使用闭包显式 OR 条件匹配订单号和商品标题，避免管道字段静默丢弃问题；新增优惠券库存调整原子方法，提升并发安全性；同步更新相关文档和注释，完善分类展示规则说明。
71 lines
2.9 KiB
PHP
71 lines
2.9 KiB
PHP
<?php
|
||
declare(strict_types=1);
|
||
|
||
namespace modules\service\mcp\tools;
|
||
|
||
use app\dao\order\AfterSaleDao;
|
||
use crmeb\interfaces\McpToolInterface;
|
||
use modules\service\mcp\McpException;
|
||
|
||
/** MCP 工具：真实售后单列表，不用订单退款状态替代售后记录。 */
|
||
class AfterSaleListTool implements McpToolInterface
|
||
{
|
||
/** @var AfterSaleDao 售后 DAO */
|
||
private AfterSaleDao $dao;
|
||
/** @param AfterSaleDao $dao 售后 DAO */
|
||
public function __construct(AfterSaleDao $dao) { $this->dao = $dao; }
|
||
/** @return string 工具名 */
|
||
public function name(): string { return 'crmeb_after_sale_list'; }
|
||
/** @return string 工具描述 */
|
||
public function description(): string
|
||
{
|
||
return '查询真实售后申请记录，支持订单号、售后状态筛选；包括仅退款、退货退款、换货、补发、维修，'
|
||
. '与 crmeb_refund_list 按订单退款标记筛选不同。不返回买家理由、备注或退货地址。';
|
||
}
|
||
|
||
/**
|
||
* 工具中文名（管理后台展示）
|
||
* @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', 'properties' => [
|
||
'order_no' => ['type' => 'string', 'description' => '精确订单号'],
|
||
'status' => ['type' => 'string', 'description' => '售后状态码，如 pending_audit/refunded/completed'],
|
||
'page' => ['type' => 'integer', 'description' => '页码，默认1'],
|
||
'limit' => ['type' => 'integer', 'description' => '每页最多50'],
|
||
]];
|
||
}
|
||
/** @param array $args 筛选条件 @return array 售后列表 @throws McpException 参数错误 */
|
||
public function execute(array $args): array
|
||
{
|
||
$page = max(1, (int)($args['page'] ?? 1));
|
||
$limit = min(50, max(1, (int)($args['limit'] ?? 20)));
|
||
$where = [['is_del', '=', 0]];
|
||
if (!empty($args['order_no'])) {
|
||
$where[] = ['order_no', '=', (string)$args['order_no']];
|
||
}
|
||
if (!empty($args['status'])) {
|
||
if (!preg_match('/^[a-z_]{1,32}$/', (string)$args['status'])) {
|
||
throw new McpException('status 格式错误');
|
||
}
|
||
$where[] = ['status', '=', (string)$args['status']];
|
||
}
|
||
$list = $this->dao->search($where)
|
||
->field('id,after_sale_no,order_no,uid,type as after_sale_type,status as status_code,refund_price,actual_refund_price,refund_num,add_time,refund_time')
|
||
->order('id desc')->page($page, $limit)->select()->toArray();
|
||
return ['list' => $list, 'count' => $this->dao->search($where)->count(), 'page' => $page, 'limit' => $limit];
|
||
}
|
||
}
|