owl-admin/app/Services/Coach/OrderService.php

<?php

namespace App\Services\Coach;

use App\Models\Order;
use App\Enums\OrderType;
use App\Models\CoachUser;
use App\Enums\OrderSource;
use App\Enums\OrderStatus;
use App\Models\MemberUser;
use App\Models\OrderRecord;
use App\Enums\ProjectStatus;
use App\Models\SettingGroup;
use App\Jobs\AutoFinishOrder;
use App\Enums\TechnicianStatus;
use App\Models\OrderGrabRecord;
use App\Enums\OrderRecordStatus;
use Illuminate\Support\Facades\DB;
use App\Enums\TechnicianAuthStatus;
use Illuminate\Support\Facades\Log;
use App\Enums\OrderGrabRecordStatus;
use App\Services\SettingItemService;
use App\Enums\TechnicianLocationType;
use Illuminate\Support\Facades\Cache;
use Illuminate\Support\Facades\Redis;
use App\Enums\PaymentMethod;

class OrderService
{
    private const DEFAULT_PER_PAGE = 10;

    private const MAX_DISTANCE = 40; // 最大距离限制（公里）

    private SettingItemService $settingService;

    private CommissionService $commissionService;

    public function __construct(SettingItemService $settingService, CommissionService $commissionService)
    {
        $this->settingService = $settingService;
        $this->commissionService = $commissionService;
    }

    /**
     * 根据标签页获取订单状态
     */
    private function getOrderStatesByTab(int $tab): array
    {
        return match ($tab) {
            1 => [ // 待接单
                OrderStatus::PAID->value,
            ],
            2 => [ // 进行中
                OrderStatus::ACCEPTED->value,
                OrderStatus::DEPARTED->value,
                OrderStatus::ARRIVED->value,
                OrderStatus::SERVICE_START->value,
                OrderStatus::SERVICING->value,
                OrderStatus::SERVICE_END->value,
                OrderStatus::LEAVING->value,
            ],
            3 => [ // 已完成
                OrderStatus::COMPLETED->value,
            ],
            4 => [ // 待评价
                OrderStatus::LEFT->value,
            ],
            5 => [ // 已取消
                OrderStatus::CANCELLED->value,
                OrderStatus::REFUNDED->value,
                OrderStatus::REJECTED->value,
                OrderStatus::REFUNDING->value,
                OrderStatus::REFUND_FAILED->value,
            ],
            default => [], // 全部订单（已在基础查询中排除未支付和已分配状态）
        };
    }

    /**
     * 获取技师订单列表
     */
    public function getOrderList(int $coachId, array $params = [])
    {
        // 1. 构建基础查询
        $query = Order::query()
            ->where('coach_id', $coachId)
            ->whereNotIn('state', [
                OrderStatus::CREATED->value,    // 排除未支付订单
                OrderStatus::ASSIGNED->value,   // 排除已分配状态订单
            ])
            ->with(['project', 'user']);

        // 2. 获取状态过滤条件
        $states = $this->getOrderStatesByTab($params['tab'] ?? 0);
        if (!empty($states)) {
            $query->whereIn('state', $states);
        }

        // 3. 分页查询
        $perPage = $params['per_page'] ?? 10;
        $page = $params['page'] ?? 1;

        $paginatedOrders = $query->orderBy('created_at', 'desc')
            ->paginate($perPage, ['*'], 'page', $page);

        // 4. 格式化数据
        $formattedOrders = collect($paginatedOrders->items())->map(function ($order) {
            return $this->formatOrderListItem($order);
        });

        return [
            'items' => $formattedOrders,
            'total' => $paginatedOrders->total(),
        ];
    }

    /**
     * 获取可抢订单列表
     *
     * @param  int  $userId  技师用户ID
     * @param  array  $params  请求参数
     * @return \Illuminate\Pagination\LengthAwarePaginator
     */
    public function getGrabList(int $userId, array $params)
    {
        try {
            // 加载用户和技师信息
            $user = MemberUser::with([
                'coach',
                'coach.info',
                'coach.real',
                'coach.qual',
                'coach.locations',
                'coach.projects',
            ])->findOrFail($userId);

            // 验证技师信息
            [$coach, $location] = $this->validateCoach($user);

            // 获取技师项目信
            $coachProjects = $coach->projects;
            $coachProjectIds = $coachProjects->pluck('project_id')->toArray();

            // 获取系统配置
            $settings = $this->getSystemSettings();

            // 获取附近订单
            $orderDistances = $this->getNearbyOrders($location);

            // 构建订单查询
            $query = $this->buildOrderQuery($coachProjectIds, $orderDistances);

            // 处理订单数据
            $this->processOrderData($query, $orderDistances, $coachProjects, $settings);

            // 分页获取数据
            return $query->paginate(
                $params['per_page'] ?? 10,
                ['*'],
                'page',
                $params['page'] ?? 1
            );
        } catch (\Exception $e) {
            Log::error('获取可抢订单列表失败', [
                'user_id' => $userId,
                'params' => $params,
                'error' => $e->getMessage(),
                'trace' => $e->getTraceAsString(),
            ]);
            throw $e;
        }
    }

    /**
     * 验证技师信息
     */
    private function validateCoach(MemberUser $user): array
    {
        $coach = $user->coach;
        abort_if(! $coach, 404, '技师不存在');
        abort_if(! $coach->info, 404, '技师信息不存在');
        abort_if($coach->info->state != TechnicianStatus::ACTIVE->value, 404, '技师状态异常');
        abort_if($coach->real->state != TechnicianAuthStatus::PASSED->value, 404, '技师实名认证未通过');
        abort_if($coach->qual->state != TechnicianAuthStatus::PASSED->value, 404, '技师资质认证未通过');

        $location = $coach->locations()
            ->where('type', TechnicianLocationType::COMMON->value)
            ->first();
        abort_if(! $location, 404, '技师定位地址不存在');

        return [$coach, $location];
    }

    /**
     * 获取系统配置
     */
    private function getSystemSettings(): array
    {
        return [
            'coach_income' => $this->settingService->getItemDetail('coach_income')->default_value ?? 0,
            'min_distance' => $this->settingService->getItemDetail('qibugongli')->default_value ?? 0,
            'base_price' => $this->settingService->getItemDetail('qibujia')->default_value ?? 0,
            'per_km_price' => $this->settingService->getItemDetail('meigonglijiage')->default_value ?? 0,
        ];
    }

    /**
     * 获取附近订单
     */
    private function getNearbyOrders($location, float $maxDistance = 40): array
    {

        $nearbyOrders = Redis::georadius(
            'order_locations',
            $location->longitude,
            $location->latitude,
            $maxDistance,
            'km',
            ['WITHCOORD', 'WITHDIST']
        );

        if (! $nearbyOrders) {
            Log::warning('获取附近订单失败', [
                'location' => [
                    'longitude' => $location->longitude,
                    'latitude' => $location->latitude,
                ],
            ]);

            return [];
        }

        $orderDistances = [];
        foreach ($nearbyOrders as $order) {
            $orderId = str_replace('order:', '', $order[0]);
            $distance = round($order[1], 1);
            $orderDistances[$orderId] = $distance;
        }

        return $orderDistances;
    }

    /**
     * 构建订单查询
     */
    private function buildOrderQuery(array $coachProjectIds, array $orderDistances)
    {
        return Order::query()
            ->select([
                'id',
                'order_no',
                'project_id',
                'location',
                'address',
                'latitude',
                'longitude',
                'service_time',
                'created_at',
                'agent_id',
                DB::raw('0 as distance'),
            ])
            ->with(['project', 'agent.projects'])
            ->where('state', OrderStatus::CREATED)
            ->whereIn('project_id', $coachProjectIds)
            ->whereIn('id', array_keys($orderDistances))
            ->orderBy('created_at', 'desc');
    }

    /**
     * 处理订单数据
     */
    private function processOrderData($query, array $orderDistances, $coachProjects, array $settings): void
    {
        $query->get()->each(function ($order) use ($orderDistances, $coachProjects, $settings) {
            // 设置距离
            $order->distance = $orderDistances[$order->id];

            // 处理代理商项目价格
            $this->processAgentPrice($order);

            // 处理技师项目信息
            $this->processCoachProject($order, $coachProjects, $settings);
        });
    }

    /**
     * 处理代理商价格
     */
    private function processAgentPrice($order): void
    {
        if ($order->agent_id && $order->agent && $order->agent->projects) {
            $agentProject = $order->agent->projects
                ->where('id', $order->project_id)
                ->where('state', 1)
                ->first();

            if ($agentProject) {
                $order->project->price = $agentProject->agent_price;
                $order->project->duration = $agentProject->duration;
            }
        }
    }

    /**
     * 处理技师项目信息
     */
    private function processCoachProject($order, $coachProjects, array $settings): void
    {
        $coachProject = $coachProjects->where('project_id', $order->project_id)->first();
        if (! $coachProject) {
            return;
        }

        // 计算技师佣金
        $order->project->coach_income = round($order->project->price * $settings['coach_income'], 2);

        // 处理优惠金额
        if ($coachProject->discount_amount > 0) {
            $order->project->discount_amount = $coachProject->discount_amount;
            $order->project->final_price = $order->project->price - $coachProject->discount_amount;
        }

        // 处理路费
        if ($coachProject->traffic_fee > 0) {
            $this->calculateTrafficFee($order, $coachProject, $settings);
        }
    }

    /**
     * 计算路费
     */
    private function calculateTrafficFee($order, $coachProject, array $settings): void
    {
        $trafficFee = $settings['base_price'];

        if ($order->distance > $settings['min_distance']) {
            $trafficFee += ($order->distance - $settings['min_distance']) * $settings['per_km_price'];
        }

        $order->project->traffic_fee = round($trafficFee, 2);

        // 程收费
        if ($coachProject->is_round_trip) {
            $order->project->traffic_fee *= 2;
        }

        // 计算最终价格
        $order->project->final_price = ($order->project->final_price ?? $order->project->price)
            + $order->project->traffic_fee;
    }

    /**
     * 技师抢单
     *
     * @param  int  $userId  技师用户ID
     * @param  int  $orderId  订单ID
     * @return array
     */
    public function grabOrder(int $userId, int $orderId)
    {
        return DB::transaction(function () use ($userId, $orderId) {
            try {
                // 加载用户和技师信息
                $user = MemberUser::with([
                    'coach',
                    'coach.info',
                    'coach.real',
                    'coach.qual',
                    'coach.locations',
                    'coach.projects',
                ])->findOrFail($userId);

                // 验证技师信息
                [$coach, $location] = $this->validateCoach($user);

                // 获取订单信息
                $order = Order::lockForUpdate()->findOrFail($orderId);

                // 验证订单状态
                abort_if($order->state !== OrderStatus::CREATED->value, 400, '订单状态异常，无法抢单');

                // 验证订单类型
                abort_if($order->type !== OrderType::GRAB->value, 400, '该订单不是抢单类型');

                // 检查技师是否已参与抢单
                $existingGrab = $coach->grabRecords()
                    ->where('order_id', $orderId)
                    ->first();
                abort_if($existingGrab, 400, '您已参与抢单，请勿重复操作');

                // 验证订单是否在技师服务范围内
                // 通过Redis GEO计算订单与技师的距离
                $distance = Redis::geodist(
                    'order_locations',
                    'order:' . $order->id,
                    $location->longitude . ',' . $location->latitude,
                    'km'
                ) ?? PHP_FLOAT_MAX;
                abort_if($distance > self::MAX_DISTANCE, 400, '订单超出服务范围');

                // 验证技师是否具备该项目服务资格
                $coachProject = $coach->projects()
                    ->where('project_id', $order->project_id)
                    ->where('state', ProjectStatus::OPEN->value)
                    ->first();
                abort_if(! $coachProject, 400, '未开通该项目服务资格');

                // 添加抢单记录
                OrderGrabRecord::create([
                    'order_id' => $order->id,
                    'coach_id' => $coach->id,
                    'distance' => $distance,
                    'state' => OrderGrabRecordStatus::JOINED->value,
                    'created_at' => now(),
                ]);

                // 记录日志
                Log::info('技师参与抢单', [
                    'user_id' => $userId,
                    'coach_id' => $coach->id,
                    'order_id' => $orderId,
                ]);

                return [
                    'message' => '已参与抢单',
                    'order_id' => $orderId,
                ];
            } catch (\Exception $e) {
                Log::error('技师参与抢单失败', [
                    'user_id' => $userId,
                    'order_id' => $orderId,
                    'error_message' => $e->getMessage(),
                    'error_trace' => $e->getTraceAsString(),
                ]);
                throw $e;
            }
        });
    }

    /**
     * 技师接单
     *
     * @param  int  $userId  技师用户ID
     * @param  int  $orderId  订单ID
     */
    public function acceptOrder(int $userId, int $orderId): array
    {
        return DB::transaction(function () use ($userId, $orderId) {
            try {
                // 加载用户和技师信息
                $user = MemberUser::with([
                    'coach',
                    'coach.info',
                    'coach.real',
                    'coach.qual',
                ])->findOrFail($userId);

                // 验证技师信息
                [$coach, $location] = $this->validateCoach($user);

                // 获取订单信息并加锁
                $order = Order::lockForUpdate()->findOrFail($orderId);

                // 验证订单状态
                abort_if($order->state !== OrderStatus::PAID->value, 400, '订单状态异常，无法接单');

                // 验证订单是否分配给该技师
                abort_if($order->coach_id !== $coach->id, 403, '该订单未分配给您');

                // 更新订单状态
                $order->state = OrderStatus::ACCEPTED->value;
                $order->save();

                // 清理技师相关缓存
                $this->clearCoachCache($coach->id, $order->service_time);

                // 记录日志
                Log::info('技师接单成功', [
                    'user_id' => $userId,
                    'coach_id' => $coach->id,
                    'order_id' => $orderId,
                    'order_no' => $order->order_no,
                ]);

                return [
                    'message' => '接单成功',
                    'order_id' => $orderId,
                    'order_no' => $order->order_no,
                ];
            } catch (\Exception $e) {
                Log::error('技师接单失败', [
                    'user_id' => $userId,
                    'order_id' => $orderId,
                    'error' => $e->getMessage(),
                    'file' => $e->getFile(),
                    'line' => $e->getLine(),
                ]);
                throw $e;
            }
        });
    }

    /**
     * 技师拒单
     *
     * @param  int  $userId  用户ID
     * @param  int  $orderId  订单ID
     * @param  string  $reason  拒单原因
     */
    public function rejectOrder(int $userId, int $orderId, string $reason): array
    {
        return DB::transaction(function () use ($userId, $orderId, $reason) {
            try {
                // 获取技师信息(优化关联加载)
                $user = MemberUser::with([
                    'coach',
                    'coach.info',
                    'coach.real',
                    'coach.qual',
                ])->findOrFail($userId);

                // 验证技师信息
                [$coach, $location] = $this->validateCoach($user);

                // 获取订单信息并加锁
                $order = Order::lockForUpdate()->findOrFail($orderId);

                // 验证订单状态(修正状态判断)
                abort_if(! in_array($order->state, [
                    OrderStatus::ASSIGNED->value,
                    OrderStatus::PAID->value,
                ]), 400, '订单状态异常，无法拒单');

                // 验证订单是否分配给该技师
                abort_if($order->coach_id !== $coach->id, 403, '该订单未分配给您');

                // 检查拒单次数限制
                $rejectCount = OrderRecord::where('object_id', $coach->id)
                    ->where('object_type', CoachUser::class)
                    ->where('state', OrderRecordStatus::REJECTED->value)
                    ->whereDate('created_at', today())
                    ->count();

                // 更新订单状态
                $order->update([
                    'state' => OrderStatus::REJECTED->value,
                ]);

                // 创建订单记录
                OrderRecord::create([
                    'order_id' => $order->id,
                    'object_id' => $coach->id,
                    'object_type' => CoachUser::class,
                    'state' => OrderRecordStatus::REJECTED->value,
                    'remark' => $reason,
                ]);

                // 发送消息通知
                try {
                    // event(new OrderRejectedEvent($order, $coach, $reason));
                } catch (\Exception $e) {
                    Log::error('发送拒单通知失败', [
                        'order_id' => $orderId,
                        'coach_id' => $coach->id,
                        'error' => $e->getMessage(),
                    ]);
                }

                // 记录日志
                Log::info('技师拒单成功', [
                    'user_id' => $userId,
                    'coach_id' => $coach->id,
                    'order_id' => $orderId,
                    'order_no' => $order->order_no,
                    'reason' => $reason,
                    'reject_count' => $rejectCount + 1,
                ]);

                return [
                    'message' => '拒单成功',
                    'order_id' => $orderId,
                    'order_no' => $order->order_no,
                    'reject_count' => $rejectCount + 1,
                    'max_reject_count' => 5,
                ];
            } catch (\Exception $e) {
                Log::error('技师拒单失败', [
                    'user_id' => $userId,
                    'order_id' => $orderId,
                    'reason' => $reason,
                    'error' => $e->getMessage(),
                    'file' => $e->getFile(),
                    'line' => $e->getLine(),
                ]);
                throw $e;
            }
        });
    }

    /**
     * 技师出发
     *
     * @param  int  $userId  技师用户ID
     * @param  int  $orderId  订单ID
     */
    public function depart(int $userId, int $orderId): array
    {
        try {
            return DB::transaction(function () use ($userId, $orderId) {

                // 获取技师信息
                $user = MemberUser::with(['coach'])->findOrFail($userId);

                // 获取订单信息
                $order = Order::query()->where('id', $orderId)->lockForUpdate()->first();

                // 检查订单是否存在
                abort_if(! $order, 404, '订单不存在');

                // 检查是否是该技师的订单
                abort_if($order->coach_id !== $user->coach->id, 403, '无权操作此订单');

                // 根据订单类型判断订单状态
                if ($order->type == OrderType::VISIT->value) {
                    abort_if($order->state != OrderStatus::ACCEPTED->value, 400, '订单状态不正确');
                } elseif ($order->type == OrderType::GRAB->value) {
                    abort_if($order->state != OrderStatus::PAID->value, 400, '订单状态不正确');
                }

                // 更新订单状态为技师出发
                $order->state = OrderStatus::DEPARTED->value;
                $order->save();

                // 记录订单状态变更日志
                OrderRecord::create([
                    'order_id' => $orderId,
                    'state' => OrderRecordStatus::DEPARTED->value,
                    'object_id' => $user->coach->id,
                    'object_type' => CoachUser::class,
                    'remark' => '技师已出发',
                ]);

                // 发送通知给用户
                // TODO: 发送通知
                // event(new TechnicianDepartedEvent($order));

                return [
                    'status' => true,
                    'message' => '操作成功',
                    'data' => [
                        'order_id' => $orderId,
                        'status' => $order->state,
                        'created_at' => $order->created_at,
                    ],
                ];
            });
        } catch (\Exception $e) {
            \Log::error('技师出发失败', [
                'user_id' => $userId,
                'order_id' => $orderId,
                'error' => $e->getMessage(),
            ]);
            throw $e;
        }
    }

    /**
     * 技师到达
     *
     * @param  int  $userId  技师用户ID
     * @param  int  $orderId  订单ID
     */
    public function arrive(int $userId, int $orderId): array
    {
        return DB::transaction(function () use ($userId, $orderId) {
            try {
                // 获取技师信息
                $user = MemberUser::with(['coach'])->findOrFail($userId);
                $coach = $user->coach;
                abort_if(! $coach, 404, '技师信息不存在');

                // 获取订单信息
                $order = Order::query()->where('id', $orderId)->lockForUpdate()->first();
                abort_if(! $order, 404, '订单不存在');

                // 检查是否是该技师的订单
                abort_if($order->coach_id !== $coach->id, 403, '无权操作此订单');

                // 检查订单状态
                abort_if(! in_array($order->state, [
                    OrderStatus::DEPARTED->value,
                ]), 400, '订单状态不正确');

                $now = now();

                // 更新订单状态为技师到达
                $order->state = OrderStatus::ARRIVED->value;
                $order->save();

                // 记录订单状态变更日志
                OrderRecord::create([
                    'order_id' => $orderId,
                    'state' => OrderRecordStatus::ARRIVED->value,
                    'object_id' => $coach->id,
                    'object_type' => CoachUser::class,
                    'remark' => '技师已到达',
                ]);

                // 更新技师当前位置到Redis GEO
                try {
                    Redis::geoadd(
                        'coach_locations',
                        $order->longitude,
                        $order->latitude,
                        $coach->id . '_' . TechnicianLocationType::CURRENT->value
                    );
                } catch (\Exception $e) {
                    Log::error('更新技师位置失败', [
                        'coach_id' => $coach->id,
                        'order_id' => $orderId,
                        'error' => $e->getMessage(),
                    ]);
                }

                // TODO: 发送通知给用户
                // event(new TechnicianArrivedEvent($order));

                Log::info('技师到达成功', [
                    'coach_id' => $coach->id,
                    'order_id' => $orderId,
                    'arrived_at' => $now,
                ]);

                return [
                    'status' => true,
                    'message' => '操作成功',
                    'data' => [
                        'order_id' => $orderId,
                        'status' => $order->state,
                        'arrived_at' => $now,
                    ],
                ];
            } catch (\Exception $e) {
                Log::error('技师到达失败', [
                    'user_id' => $userId,
                    'order_id' => $orderId,
                    'error' => $e->getMessage(),
                    'trace' => $e->getTraceAsString(),
                ]);
                throw $e;
            }
        });
    }

    /**
     * 技师扫码开始服务
     *
     * @param  int  $userId  技师用户ID
     * @param  int  $orderId  订单ID
     * @param  string  $qrCode  客户二维码
     */
    public function startService(int $userId, int $orderId, string $qrCode): array
    {
        return DB::transaction(function () use ($userId, $orderId, $qrCode) {
            try {
                // 获取技师信息
                $user = MemberUser::with(['coach'])->findOrFail($userId);
                $coach = $user->coach;
                abort_if(! $coach, 404, '技师信息不存在');

                // 获取订单信息
                $order = Order::query()
                    ->where('id', $orderId)
                    ->lockForUpdate()
                    ->first();
                abort_if(! $order, 404, '订单不存在');

                // 检查是否是该技师的订单
                abort_if($order->coach_id !== $coach->id, 403, '无权操作此订单');

                // 检查订单状态
                abort_if(! in_array($order->state, [
                    OrderStatus::ARRIVED->value,
                    OrderStatus::PAID->value,
                ]), 400, '订单状态不正确');

                // 验证二维码
                $this->validateQrCode($order, $qrCode);

                $now = now();

                // 更新订单状态为服务中
                $order->state = OrderStatus::SERVICING->value;
                $order->service_start_time = $now;
                $order->service_end_time = $now->copy()->addMinutes($order->project_duration);
                $order->save();

                // 记录订单状态变更日志
                OrderRecord::create([
                    'order_id' => $orderId,
                    'state' => OrderRecordStatus::STARTED->value,
                    'object_id' => $coach->id,
                    'object_type' => CoachUser::class,
                    'remark' => '开始服务',
                ]);

                // 获取项目服务时长(分钟)
                $duration = $order->project->duration ?? 60;

                // 派发延迟任务,在服务时长到期后自动完成订单
                AutoFinishOrder::dispatch($order)
                    ->delay(now()->addMinutes($duration));

                // TODO: 发送通知给用户
                // event(new ServiceStartedEvent($order));

                Log::info('技师开始服务', [
                    'coach_id' => $coach->id,
                    'order_id' => $orderId,
                    'service_start_time' => $now,
                ]);

                return [
                    'status' => true,
                    'message' => '开始服务成功',
                    'data' => [
                        'order_id' => $orderId,
                        'status' => $order->state,
                        'service_start_time' => $now,
                    ],
                ];
            } catch (\Exception $e) {
                Log::error('开始服务失败', [
                    'user_id' => $userId,
                    'order_id' => $orderId,
                    'qr_code' => $qrCode,
                    'error' => $e->getMessage(),
                    'trace' => $e->getTraceAsString(),
                ]);
                throw $e;
            }
        });
    }

    /**
     * 验证客户二维码
     *
     * @param  Order  $order  订单对象
     * @param  string  $qrCode  扫描的二维码
     */
    private function validateQrCode(Order $order, string $qrCode): void
    {
        // 二维码格式: order_{order_id}_{timestamp}_{sign}
        $parts = explode('_', $qrCode);
        abort_if(count($parts) !== 4, 400, '二维码格式错误');

        [$prefix, $scanOrderId, $timestamp, $sign] = $parts;

        // 验证前缀
        abort_if($prefix !== 'order', 400, '无效的二维码');

        // 验证订单ID
        abort_if((int) $scanOrderId !== $order->id, 400, '二维码与订单不匹配');

        // 验证时间戳(二维码5分钟内有效)
        // $qrTimestamp = (int) $timestamp;
        // $now = time();
        // abort_if($now - $qrTimestamp > 300, 400, '二维码已过期');

        // 验证签名
        $correctSign = md5("order_{$order->id}_{$timestamp}_" . config('app.key'));
        abort_if($sign !== $correctSign, 400, '二维码签名错误');
    }

    /**
     * 技师撤离
     *
     * @param  int  $userId  技师户ID
     * @param  int  $orderId  订单ID
     *
     * @throws \Exception
     */
    public function leave(int $userId, int $orderId): array
    {
        return DB::transaction(function () use ($userId, $orderId) {
            try {
                // 获取技师信息,同时加载钱包关联
                $user = MemberUser::with(['coach', 'coach.wallet'])->findOrFail($userId);
                $coach = $user->coach;

                abort_if(! $coach, 404, '技师信息不存在');

                $coach->load('wallet');

                // 获取订单信息
                $order = Order::query()
                    ->with(['coach', 'coach.wallet'])
                    ->where('id', $orderId)
                    ->lockForUpdate()
                    ->firstOrFail();

                // 验证订单状态和权限
                $this->validateLeaveOrder($order, $coach);

                // 更新订单状态
                $this->updateOrderStatus($order);

                // 记录订单状态变更
                $this->createLeaveRecord($order, $coach);

                // 处理订单分佣
                $this->commissionService->handleOrderCommission($order);

                // 清理技师位置信息
                $this->cleanCoachLocation($coach);

                // TODO: 发送通知给用户
                // event(new ServiceCompletedEvent($order));

                return [
                    'status' => true,
                    'message' => '撤离成功',
                    'data' => [
                        'order_id' => $orderId,
                        'state' => $order->state,
                        'leave_time' => now(),
                    ],
                ];
            } catch (\Exception $e) {
                Log::error('技师撤离失败', [
                    'user_id' => $userId,
                    'order_id' => $orderId,
                    'error' => $e->getMessage(),
                    'trace' => $e->getTraceAsString(),
                ]);
                throw $e;
            }
        });
    }

    /**
     * 验证撤离订单
     */
    private function validateLeaveOrder(Order $order, CoachUser $coach): void
    {
        // 检查是否是该技师的订单
        abort_if($order->coach_id !== $coach->id, 403, '无权操作此订单');

        // 检查订单状态
        abort_if(! in_array($order->state, [
            OrderStatus::LEAVING->value,
        ]), 400, '订单状态不正确，无法撤离');

        // 检查钱包状态
        abort_if(! $coach->wallet, 400, '技师钱包信息不存在');
    }

    /**
     * 更新订单状态
     */
    private function updateOrderStatus(Order $order): void
    {
        $order->state = OrderStatus::LEFT->value;
        $order->save();
    }

    /**
     * 创建撤离记录
     */
    private function createLeaveRecord(Order $order, CoachUser $coach): void
    {
        OrderRecord::create([
            'order_id' => $order->id,
            'state' => OrderRecordStatus::COMPLETED->value,
            'object_id' => $coach->id,
            'object_type' => CoachUser::class,
            'remark' => '技师已撤离,服务完成',
        ]);
    }

    /**
     * 清理技师位置信息
     */
    private function cleanCoachLocation(CoachUser $coach): void
    {
        try {
            Redis::zrem(
                'coach_locations',
                $coach->id . '_' . TechnicianLocationType::CURRENT->value
            );
        } catch (\Exception $e) {
            Log::error('删除技师位置失败', [
                'coach_id' => $coach->id,
                'error' => $e->getMessage(),
            ]);
            // 不抛出异常，继续执行
        }
    }

    /**
     * 清理技师相关缓存
     *
     * @param  int  $coachId  技师ID
     * @param  string|null  $date  服务日期
     */
    private function clearCoachCache(int $coachId, ?string $date = null): void
    {
        try {
            // 清理技师时间段缓存
            $date = $date ?: now()->toDateString();
            $cacheKey = "coach:timeslots:{$coachId}:{$date}";
            Cache::forget($cacheKey);

            Log::info('成功清理技师缓存', [
                'coach_id' => $coachId,
                'date' => $date,
            ]);
        } catch (\Exception $e) {
            Log::error('清理技师缓存失败', [
                'coach_id' => $coachId,
                'date' => $date,
                'error' => $e->getMessage(),
            ]);
            // 缓存清理失败不影响主流程
        }
    }

    /**
     * 获取设置项
     *
     * @param string $groupCode 设置组编码
     * @param string $itemCode 设置项编码
     * @return object 设置项对象
     * @throws \Symfony\Component\HttpKernel\Exception\HttpException
     */
    private function getSettingItem(string $groupCode, string $itemCode): object
    {
        // 获取设置组
        $settingGroup = SettingGroup::where('code', $groupCode)->first();
        abort_if(!$settingGroup, 404, "设置组[{$groupCode}]不存在");

        // 获取设置项
        $settingItem = $settingGroup->items()->where('code', $itemCode)->first();
        abort_if(!$settingItem, 404, "设置项[{$itemCode}]不存在");

        return $settingItem;
    }

    /**
     * 更新订单设置
     *
     * 业务流程：
     * 1. 获取订单配置项
     * 2. 验证服务距离范围
     * 3. 更新技师设置
     * 4. 返回最新设置
     *
     * @param CoachUser $coach 技师对象
     * @param array $data 设置数据，包含：
     *        - distance: float 服务距离(公里)
     * @return array 返回最新设置信息，包含：
     *        - distance: float 当前服务距离
     *        - distance_max: float 最大服务距离限制
     *        - distance_min: float 最小服务距离限制
     * @throws \Exception 当更新失败时抛出异常
     */
    public function setOrder(CoachUser $coach, array $data): array
    {
        return DB::transaction(function () use ($coach, $data) {
            // 获取订单距离配置项
            $distanceItem = $this->getSettingItem('order', 'distance');

            // 验证服务距离范围
            $distance = (float)$data['distance'];
            abort_if(
                $distance > $distanceItem->max_value || $distance < $distanceItem->min_value,
                422,
                sprintf('服务距离必须在 %.1f-%.1f 公里之间', $distanceItem->min_value, $distanceItem->max_value)
            );

            // 更新技师服务距离设置
            $coach->settingValues()->updateOrCreate(
                [
                    'item_id' => $distanceItem->id,
                    'object_type' => $coach::class,
                    'object_id' => $coach->id,
                ],
                ['value' => $distance]
            );

            // 返回最新设置
            return [
                'distance' => $distance,
                'distance_max' => (float)$distanceItem->max_value,
                'distance_min' => (float)$distanceItem->min_value,
            ];
        });
    }

    /**
     * 获取订单设置
     *
     * 业务流程：
     * 1. 获取技师的订单设置
     * 2. 获取系统配置的限制值
     * 3. 返回设置信息
     *
     * @param CoachUser $coach 技师对象
     * @return array 返回设置信息，包含：
     *        - distance: float 当前服务距离
     *        - distance_max: float 最大服务距离
     *        - distance_min: float 最小服务距离
     * @throws \Exception 当获取失败时抛出异常
     */
    public function getOrderSettings(CoachUser $coach): array
    {
        // 获取订单距离配置项
        $distanceItem = $this->getSettingItem('order', 'distance');

        // 获取技师的距离设置
        $distanceSetting = $coach->settingValues()
            ->where('item_id', $distanceItem->id)
            ->first();

        // 返回设置信息
        return [
            'distance' => (float)($distanceSetting?->value ?? $distanceItem->default_value),  // 当前服务距离
            'distance_max' => (float)$distanceItem->max_value,  // 最大服务距离限制
            'distance_min' => (float)$distanceItem->min_value,  // 最小服务距离限制
        ];
    }

    /**
     * 格式化订单列表项
     */
    private function formatOrderListItem($order): array
    {
        return [
            'id' => $order->id,                    // 订单ID
            'order_no' => $order->order_no,        // 订单编号
            'state' => $order->state,              // 订单状态值
            'state_text' => OrderStatus::fromValue($order->state)?->label(),  // 订单状态文本
            'payment_type' => $order->payment_type,     // 支付类型值
            'payment_type_text' => PaymentMethod::fromValue($order->payment_type)?->label(),  // 支付类型文本
            'total_amount' => $order->total_amount,     // 订单总金额
            'project_amount' => $order->project_amount, // 项目金额
            'traffic_amount' => $order->traffic_amount, // 交通费金额
            'discount_amount' => $order->discount_amount, // 优惠金额
            'pay_amount' => $order->pay_amount,         // 实付金额
            'refund_amount' => $order->refund_amount,   // 退款金额
            'type' => $order->type,                     // 订单类型值
            'type_text' => OrderType::fromValue($order->type)?->label(),  // 订单类型文本
            'source' => $order->source,                 // 订单来源值
            'source_text' => OrderSource::fromValue($order->source)?->label(),  // 订单来源文本
            'distance' => $order->distance,             // 目的地距离(米)
            'service_time' => $order->service_time instanceof \Carbon\Carbon  // 服务时间
                ? $order->service_time->toDateTimeString()
                : $order->service_time,
            'service_start_time' => $order->service_start_time instanceof \Carbon\Carbon  // 服务开始时间
                ? $order->service_start_time->toDateTimeString()
                : $order->service_start_time,
            'service_end_time' => $order->service_end_time instanceof \Carbon\Carbon    // 服务结束时间
                ? $order->service_end_time->toDateTimeString()
                : $order->service_end_time,
            'created_at' => $order->created_at instanceof \Carbon\Carbon     // 创建时间
                ? $order->created_at->toDateTimeString()
                : $order->created_at,
            'project' => [                             // 项目信息
                'id' => $order->project->id,           // 项目ID
                'title' => $order->project->title,     // 项目标题
                'cover' => $order->project->cover,     // 项目封面图
                'duration' => $order->project->duration // 项目时长(分钟)
            ],
            'user' => [                               // 用户信息
                'id' => $order->user->id,             // 用户ID
                'nickname' => $order->user->nickname, // 用户昵称
                'avatar' => $order->user->avatar,     // 用户头像
                'mobile' => $order->user->mobile,     // 用户手机号
            ],
            'address' => [                           // 服务地址信息
                'location' => $order->location,       // 定位地址
                'address' => $order->address,         // 详细地址
                'latitude' => $order->latitude,       // 纬度
                'longitude' => $order->longitude,     // 经度
            ],
        ];
    }
}