kknongchang_2506/ThirdParty/Urs/Services/UrsService.php

<?php

namespace ThirdParty\Urs\Services;

use ThirdParty\Urs\Request\UrsGetUserInfoRequest;
use ThirdParty\Urs\Request\UrsGetUserTeamRequest;
use ThirdParty\Urs\Request\UrsGetUserLevelCountRequest;
use ThirdParty\Urs\Request\UrsLoginRequest;

/**
 * URS服务类
 *
 * 统一管理所有URS相关的请求操作，提供简洁的API接口
 * 每个方法对应一个专用的Request类，遵循单一职责原则
 *
 * 注意：包含URS实际提供的业务接口
 */
class UrsService
{
    /**
     * 用户登录
     *
     * 对应URS接口：POST /api/ecology/{ecology_id}/login
     *
     * @param string $mobile 手机号码
     * @param string $password 登录密码
     * @return array
     * @throws \Exception
     */
    public static function login(string $mobile, string $password): array
    {
        $request = new UrsLoginRequest();
        return $request->request([
            'mobile' => $mobile,
            'password' => $password
        ]);
    }
    /**
     * 获取用户信息
     *
     * 对应URS接口：POST /api/ecology/{ecology_id}/userInfo
     *
     * @param string $userKey 用户密钥
     * @return array
     * @throws \Exception
     */
    public static function getUserInfo(string $userKey): array
    {
        $request = new UrsGetUserInfoRequest();
        return $request->request(['userKey' => $userKey]);
    }

    /**
     * 获取用户团队关系
     *
     * 对应URS接口：POST /api/ecology/{ecology_id}/userTeam
     *
     * @param int $userId 用户ID
     * @return array
     * @throws \Exception
     */
    public static function getUserTeam(int $userId): array
    {
        $request = new UrsGetUserTeamRequest();
        return $request->request(['userId' => $userId]);
    }

    /**
     * 获取用户下级统计
     *
     * 对应URS接口：POST /api/ecology/{ecology_id}/userLevelCount
     *
     * @param int $userId 用户ID
     * @param int $level 统计级别（1或3）
     * @return array
     * @throws \Exception
     */
    public static function getUserLevelCount(int $userId, int $level): array
    {
        if (!in_array($level, [1, 3])) {
            throw new \InvalidArgumentException('level参数必须是1或3');
        }

        $request = new UrsGetUserLevelCountRequest();
        return $request->request([
            'userId' => $userId,
            'level' => $level
        ]);
    }
}