owl-admin/app/Services/Client/UserService.php

<?php

namespace App\Services\Client;

use App\Enums\TechnicianAuthStatus;
use App\Enums\TechnicianStatus;
use App\Models\CoachInfoRecord;
use App\Models\MemberUser;
use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Log;
use Illuminate\Support\Facades\Redis;
use SimpleSoftwareIO\QrCode\Facades\QrCode;

/**
 * 用户服务类
 *
 * 处理用户相关的业务逻辑，包括：
 * - 用户信息的获取和更新
 * - 用户注册
 * - 用户反馈
 * - 技师申请
 * - 邀请码生成
 */
class UserService
{
    protected $marketDistTeamService;

    public function __construct(MarketDistTeamService $marketDistTeamService)
    {
        $this->marketDistTeamService = $marketDistTeamService;
    }

    /**
     * 获取当前用户信息
     *
     * 业务逻辑：
     * 1. 通过 Auth 门面获取当前登录用户信息
     * 2. 加载用户的技师信息
     * 3. 翻译技师状态
     *
     * @return MemberUser 返回用户信息
     *
     * @throws \Exception 获取用户信息失败时抛出异常
     */
    public function getUserInfo(): MemberUser
    {
        try {
            /** @var MemberUser $user */
            $user = Auth::user();

            // 加载技师信息
            $user->load('coach:id,user_id,state');

            // 如果有技师信息，添加状态文本
            if ($user->coach) {
                $user->coach->makeVisible(['state']);
                $user->coach->state_text = TechnicianStatus::fromValue($user->coach->state)?->label() ?? '未知状态';
            }

            return $user;
        } catch (\Exception $e) {
            // 记录错误日志
            Log::error('获取用户信息失败', ['error' => $e->getMessage()]);
            throw $e;
        }
    }

    /**
     * 用户注册
     *
     * 业务逻辑：
     * 1. 验证手机号是否已被注册
     * 2. 验证短信验证码
     * 3. 创建新用户记录
     * 4. 处理邀请关系（如果有）
     *
     * @param  string  $mobile  手机号
     * @param  string  $code  验证码
     * @param  string|null  $invite_code  邀请码(选填)
     * @param  int|null  $invite_id  邀请人ID(选填)
     * @param  string|null  $invite_role  邀请人角色(选填)
     * @return \Illuminate\Http\JsonResponse 返回注册结果
     *
     * @throws \Exception 注册过程中出现错误时抛出异常
     */
    public function register(string $mobile, string $code, ?string $invite_code = null, ?int $invite_id = null, ?string $invite_role = null): array
    {
        try {
            DB::beginTransaction();

            // 检查手机号是否已注册
            abort_if(MemberUser::where('mobile', $mobile)->exists(), 422, '该手机号已注册');

            // 验证短信验证码
            abort_if(! $this->verifySmsCode($mobile, $code), 422, '验证码错误或已过期');

            // 创建用户
            $user = MemberUser::create([
                'mobile' => $mobile,
                'password' => bcrypt(substr($mobile, -6)), // 默认密码为手机号后6位
                'nickname' => substr_replace($mobile, '****', 3, 4), // 默认昵称为手机号(中间4位隐藏)
            ]);

            // 处理邀请关系
            if ($invite_code && $invite_role && $invite_id) {
                $this->marketDistTeamService->createInviteRelation($user, $invite_code, $invite_id, $invite_role);
            }

            DB::commit();

            return [
                'user_id' => $user->id,
                'mobile' => $mobile,
                'invite_code' => $user->invite_code,
            ];
        } catch (\Exception $e) {
            DB::rollBack();
            Log::error('用户注册', ['error' => $e->getMessage(), 'mobile' => $mobile]);
            throw $e;
        }
    }

    /**
     * 验证短信验证码
     *
     * 业务逻辑：
     * 1. 从 Redis 获取存储的验证码
     * 2. 比对验证码是否匹配
     * 3. 验证成功后删除缓存的验证码
     *
     * @param  string  $mobile  手机号
     * @param  string  $code  待验证的验证码
     * @return bool 返回验证结果
     */
    private function verifySmsCode(string $mobile, string $code): bool
    {
        try {
            $cacheKey = "sms_code:{$mobile}";
            $cacheCode = Redis::get($cacheKey);

            if (! $cacheCode || $cacheCode !== $code) {
                return false;
            }

            Redis::del($cacheKey); // 验证成功后删除验证码

            return true;
        } catch (\Exception $e) {
            Log::error('验证码验证失败', ['error' => $e->getMessage(), 'mobile' => $mobile]);

            return false;
        }
    }

    /**
     * 更新当前用户信息
     *
     * 业务逻辑：
     * 1. 获取当前登录用户
     * 2. 更新用户基本信息
     *
     * @param  array  $data  待更新的用户数据
     * @return \Illuminate\Http\JsonResponse 返回更新结果
     *
     * @throws \Exception 更新失败时抛出异常
     */
    public function updateUserInfo(array $data): MemberUser
    {
        try {
            DB::beginTransaction();

            // 更新用户信息
            $user = Auth::user();
            $user->update($data);

            DB::commit();

            return $user->fresh();
        } catch (\Exception $e) {
            DB::rollBack();
            Log::error('更新用户信息失败', ['error' => $e->getMessage(), 'data' => $data]);
            throw $e;
        }
    }

    /**
     * 提交用户反馈
     *
     * 业务逻辑：
     * 1. 创建用户反馈记录
     * 2. 保存反馈内容和图片
     * 3. 记录用户联系方式（如果提供）
     *
     * @param  string  $content  反馈内容
     * @param  array  $images  反馈图片数组
     * @param  string|null  $contact  联系方式
     * @return \Illuminate\Http\JsonResponse 返回提交结果
     *
     * @throws \Exception 提交反馈失败时抛出异常
     */
    public function feedback(string $content, array $images = [], ?string $contact = null): void //Feedback
    {
        try {
            DB::beginTransaction();

            // 创建反馈记录
            // $feedback = Feedback::create([
            //     'user_id' => Auth::user()->id,
            //     'content' => $content,
            //     'images' => $images,
            //     'contact' => $contact,
            // ]);

            DB::commit();

            // return $feedback;
        } catch (\Exception $e) {
            DB::rollBack();
            Log::error('提交反馈失败', ['error' => $e->getMessage(), 'content' => $content]);
            throw $e;
        }
    }

    /**
     * 申请成为技师
     *
     * 业务逻辑：
     * 1. 检查户申请资格
     * 2. 创建或更新技师基础信息
     * 3. 创建申请记录
     *
     * @param  int  $age  年龄
     * @param  string  $mobile  联系电话
     * @param  int  $gender  性别(1:男/2:女)
     * @param  string  $work_years  工作年限
     * @param  string  $intention_city  意向城市
     * @param  array  $portrait_images  形象照片数组
     * @param  string|null  $introduction  个人简介
     * @return \App\Models\CoachInfoRecord 返回申请记录
     *
     * @throws \Exception 申请失败时抛出异常
     */
    public function applyCoach(
        int $age,
        string $mobile,
        int $gender,
        string $work_years,
        string $intention_city,
        array $portrait_images,
        ?string $introduction = null
    ): CoachInfoRecord {
        try {
            DB::beginTransaction();

            // 1. 获取验证用户信息
            $user = $this->getAndValidateUser();

            // 2. 创建技师和基础信息记录
            $infoRecord = $this->getOrCreateCoach(
                $user,
                $mobile,
                $gender,
                $age,
                $work_years,
                $intention_city,
                $portrait_images,
                $introduction
            );

            DB::commit();

            // 记录成功日志
            $this->logApplicationSuccess($user, $user->coach, $infoRecord);

            return $infoRecord;
        } catch (\Exception $e) {
            DB::rollBack();
            $this->logApplicationError($e, $mobile);
            throw $e;
        }
    }

    /**
     * 获取并验证用户信息
     *
     * 业务逻辑：
     * 1. 获取当前登录用户
     * 2. 验证用户是否存在
     * 3. 返回用户模型
     *
     * @return \App\Models\MemberUser 返回用户模型
     *
     * @throws \Illuminate\Http\Exceptions\HttpResponseException 用户未登录时抛出异常
     */
    private function getAndValidateUser(): MemberUser
    {
        /** @var MemberUser $user */
        $user = Auth::user();

        // 确保用户存在
        abort_if(! $user, 401, '用户未登录');

        return $user;
    }

    /**
     * 获取或创建技师信息
     *
     * 业务逻辑：
     * 1. 检查用户是否已经是技师
     *    - 如果是技师，验证是否可以再次申请
     * 2. 如果不是技师，创建技师记录
     * 3. 创建新的申请记录
     *    - 创建技师申请记录，包含详细信息
     *    - 关联技师记录和申请记录
     *
     * @param  MemberUser  $user  用户模型
     * @param  string  $mobile  手机号
     * @param  int  $gender  性别(1:男/2:女)
     * @param  int  $age  年龄
     * @param  string  $work_years  工作年限
     * @param  string  $intention_city  意向城市
     * @param  array  $portrait_images  形象照片
     * @param  string|null  $introduction  个人简介
     * @return CoachInfoRecord 返回申请记录
     *
     * @throws \Illuminate\Http\Exceptions\HttpResponseException 当技师已存在且不能再次申请时抛出异常
     */
    private function getOrCreateCoach(
        MemberUser $user,
        string $mobile,
        int $gender,
        int $age,
        string $work_years,
        string $intention_city,
        array $portrait_images,
        ?string $introduction = null
    ): CoachInfoRecord {
        // 1. 获取用户关联的技师信息
        $coach = $user->coach;

        // 2. 如果已是技师，验证是否可以再次申请
        if ($coach) {
            // 验证现有申请状态，如果不能申请会抛出异常
            $this->validateExistingApplication($coach);
        } else {
            // 3. 如果不是技师，创建技师记录，初始状态为待认证
            $coach = $user->coach()->create([
                'state' => TechnicianStatus::PENDING->value,
            ]);
        }

        // 4. 创建技师申请记录，状态为待审核
        $infoRecord = CoachInfoRecord::create([
            'coach_id' => $coach->id,          // 关联技师ID
            'mobile' => $mobile,               // 联系电话
            'gender' => $gender,               // 性别
            'age' => $age,                     // 年龄
            'work_years' => $work_years,       // 工作年限
            'intention_city' => $intention_city, // 意向城市
            'portrait_images' => $portrait_images, // 形象照片，让 Laravel 自动处理数组转换
            'introduction' => $introduction,    // 个人简介
            'state' => TechnicianAuthStatus::AUDITING->value, // 申请状态：待审核
        ]);

        // 5. 更新技师记，关联申请信息
        $coach->update([
            'info_record_id' => $infoRecord->id,
        ]);

        return $infoRecord;
    }

    /**
     * 验证技师的现有申请状态
     *
     * 业务逻辑：
     * 1. 检查技师的最新申请记录状态
     * 2. 如果申请记录状态为待审核或审核通过，不允许再次申请
     * 3. 如果申请记录状态为审核拒绝，允许再次申请
     *
     * @param  Coach  $coach  技师模型
     * @return bool 如果可以申请返回 true
     *
     * @throws \Illuminate\Http\Exceptions\HttpResponseException 当不能申请时抛出异常
     */
    private function validateExistingApplication($coach): bool
    {
        // 获取最新的申请记录
        $latestApplication = $coach->info;

        // 如果没有申请记录，允许申请
        if (! $latestApplication) {
            return true;
        }

        // 如果申请状态为待审核，不允许申请
        if ($latestApplication->state === TechnicianAuthStatus::AUDITING->value) {
            abort(422, '您有一个正在审核中的申请，请等待审核结果');
        }

        // 如果申请状态为审核通过，不允许申请
        if ($latestApplication->state === TechnicianAuthStatus::PASSED->value) {
            abort(422, '您的申请已通过，无需再次申请');
        }

        // 其他状态（如审核拒绝）允许再次申请
        return true;
    }

    /**
     * 记录申请成功日志
     *
     * 业务逻辑：
     * 1. 记录用户ID和技师ID
     * 2. 记录申请记录ID和状态
     * 3. 记录联方式
     *
     * @param  \App\Models\MemberUser  $user  用户模型
     * @param  \App\Models\Coach  $coach  技师模型
     * @param  \App\Models\CoachInfoRecord  $application  申请记录
     */
    private function logApplicationSuccess(MemberUser $user, $coach, CoachInfoRecord $application): void
    {
        Log::info('技师申请提交成功', [
            'user_id' => $user->id,
            'coach_id' => $coach->id,
            'application_id' => $application->id,
            'mobile' => $application->mobile,
            'state' => $application->state,
        ]);
    }

    /**
     * 记录申请错误日志
     *
     * 业务逻辑：
     * 1. 记录错误信息和堆栈跟踪
     * 2. 记录用户ID和联方式
     * 3. 记录错误发生的文件和行号
     *
     * @param  \Exception  $e  异常对象
     * @param  string  $mobile  联系电话
     */
    private function logApplicationError(\Exception $e, string $mobile): void
    {
        Log::error('申请成为技师失败', [
            'error' => $e->getMessage(),
            'user_id' => Auth::id(),
            'mobile' => $mobile,
            'trace' => $e->getTraceAsString(),
            'file' => $e->getFile(),
            'line' => $e->getLine(),
        ]);
    }

    /**
     * 生成用户邀请码
     *
     * 业务逻辑：
     * 1. 获取当前户信息
     * 2. 根据用户型生成邀请码
     * 3. 生成包含邀请参数的接
     * 4. 生成邀请维码
     * 5. 记录邀请码生成日志
     *
     * @param  string  $type  邀请码类型(user/coach)
     * @return array 返回邀请码和二维码信息
     *
     * @throws \Exception 生成邀请码失败时抛出异常
     */
    public function generateInviteCode(string $type = 'user'): array
    {
        try {
            /** @var MemberUser $user */

            // 1. 获取当前用户
            $user = Auth::user();

            // 2. 根据类型获取邀请人ID和角色
            $inviteInfo = $this->getInviteInfo($user, $type);
            if (! $inviteInfo) {
                throw new \Exception('无法生邀请码，用户类型不匹配');
            }

            // 3. 生成邀请码
            $inviteCode = $this->generateInviteCodeByType(
                $type,
                $inviteInfo['id']
            );

            // 4. 生成邀请链接和二维码
            $inviteUrl = $this->generateInviteUrl($inviteCode);
            $qrCode = $this->generateQrCode($inviteUrl);

            // 5. 记录日志
            Log::info('生成邀请码', [
                'user_id' => $user->id,
                'type' => $type,
                'invite_id' => $inviteInfo['id'],
                'invite_code' => $inviteCode,
                'invite_url' => $inviteUrl,
            ]);

            return [
                'invite_code' => $inviteCode,
                'invite_url' => $inviteUrl,
                'qr_code' => $qrCode,
            ];
        } catch (\Exception $e) {
            Log::error('生成邀请码失败', [
                'error' => $e->getMessage(),
                'user_id' => Auth::id(),
                'type' => $type,
            ]);
            throw $e;
        }
    }

    /**
     * 获取邀请人信息
     *
     * 业务逻辑：
     * 1. 根据类型判断邀请人身份
     * 2. 户类型：直接返回用信息
     * 3. 技师类型：
     *    - 验证技师状态
     *    - 返回技师信息
     *
     * @param  \App\Models\MemberUser  $user  当前用户
     * @param  string  $type  邀请类型(user/coach)
     * @return array|null 返回邀请人信息，无效类型返回null
     */
    private function getInviteInfo(MemberUser $user, string $type): ?array
    {
        switch ($type) {
            case 'user':
                return [
                    'id' => $user->id,
                    'role' => 'user',
                ];
            case 'coach':
                $coach = $user->coach;
                if ($coach && $coach->state === TechnicianAuthStatus::PASSED) {
                    return [
                        'id' => $coach->id,
                        'role' => 'coach',
                    ];
                }

                return null;
            default:
                return null;
        }
    }

    /**
     * 根据类型生成邀请码
     *
     * 业务逻辑：
     * 1. 组合类型和ID
     * 2. 生成格式化的邀请码
     *
     * @param  string  $type  邀请类型(user/coach)
     * @param  int  $id  邀请人ID
     * @return string 返回格式为 "type_id" 的邀请码
     */
    private function generateInviteCodeByType(string $type, int $id): string
    {
        return sprintf('%s_%d', $type, $id);
    }

    /**
     * 生成邀请链接
     *
     * 业务逻辑：
     * 1. 获取应用URL
     * 2. 添加邀请码参数
     * 3. 生成完整的邀请链接
     *
     * @param  string  $inviteCode  邀请码
     * @return string 返回完整的邀请链接
     */
    private function generateInviteUrl(string $inviteCode): string
    {
        // return config('app.url').'/invite?'.http_build_query(['invite_code' => $inviteCode]);
        return $inviteCode;
    }

    /**
     * 生成二维码
     *
     * 业务逻：
     * 1. 使用 QrCode 库生成 SVG 格式二维码
     * 2. 设置二维码大小和边距
     * 3. 转换为 base64 编码
     *
     * @param  string  $content  二维码内容
     * @return string 返回 base64 编码的二维码图片
     */
    private function generateQrCode(string $content): string
    {
        $qrImage = QrCode::format('svg')
            ->size(200)
            ->margin(2)
            ->encoding('UTF-8')
            ->generate($content);

        return 'data:image/svg+xml;base64,'.base64_encode($qrImage);
    }
}