kknongchang_2506/app/Module/Game/Dtos/RewardResultDto.php

<?php

namespace App\Module\Game\Dtos;

/**
 * 奖励结果DTO
 */
class RewardResultDto
{
    /**
     * 用户ID
     *
     * @var int
     */
    public int $userId;

    /**
     * 奖励组ID
     *
     * @var int
     */
    public int $groupId;

    /**
     * 奖励组编码
     *
     * @var string
     */
    public string $groupCode;

    /**
     * 奖励组名称
     *
     * @var string
     */
    public string $groupName;

    /**
     * 来源类型
     *
     * @var string
     */
    public string $sourceType;

    /**
     * 来源ID
     *
     * @var int
     */
    public int $sourceId;

    /**
     * 发放的奖励项
     *
     * @var RewardItemDto[]
     */
    public array $items = [];

    /**
     * 是否成功
     *
     * @var bool
     */
    public bool $success = false;

    /**
     * 错误信息
     *
     * @var string|null
     */
    public ?string $errorMessage = null;

    /**
     * 创建成功的奖励结果
     *
     * @param int $userId 用户ID
     * @param int $groupId 奖励组ID
     * @param string $groupCode 奖励组编码
     * @param string $groupName 奖励组名称
     * @param string $sourceType 来源类型
     * @param int $sourceId 来源ID
     * @param array $items 发放的奖励项
     * @return self
     */
    public static function success(
        int $userId,
        int $groupId,
        string $groupCode,
        string $groupName,
        string $sourceType,
        int $sourceId,
        array $items
    ): self {
        $dto = new self();
        $dto->userId = $userId;
        $dto->groupId = $groupId;
        $dto->groupCode = $groupCode;
        $dto->groupName = $groupName;
        $dto->sourceType = $sourceType;
        $dto->sourceId = $sourceId;
        $dto->items = $items;
        $dto->success = true;
        return $dto;
    }

    /**
     * 创建失败的奖励结果
     *
     * @param string $errorMessage 错误信息
     * @return self
     */
    public static function fail(string $errorMessage): self
    {
        $dto = new self();
        $dto->success = false;
        $dto->errorMessage = $errorMessage;
        return $dto;
    }
}