<?php

namespace App\Module\Activity\Dtos;

use UCore\Dto\BaseDto;

/**
 * 活动奖励数据传输对象
 */
class ActivityRewardDto extends BaseDto
{
    /**
     * 奖励组ID
     *
     * @var int|null
     */
    public ?int $rewardGroupId;

    /**
     * 奖励组编码
     *
     * @var string|null
     */
    public ?string $rewardGroupCode;

    /**
     * 奖励组名称
     *
     * @var string|null
     */
    public ?string $rewardGroupName;

    /**
     * 奖励组描述
     *
     * @var string|null
     */
    public ?string $rewardGroupDescription;

    /**
     * 奖励项列表
     *
     * @var array
     */
    public array $rewardItems = [];

    /**
     * 创建一个新的活动奖励DTO实例
     *
     * @param int|null $rewardGroupId 奖励组ID
     * @param string|null $rewardGroupCode 奖励组编码
     * @param string|null $rewardGroupName 奖励组名称
     * @param string|null $rewardGroupDescription 奖励组描述
     * @return self
     */
    public static function create(
        ?int $rewardGroupId = null,
        ?string $rewardGroupCode = null,
        ?string $rewardGroupName = null,
        ?string $rewardGroupDescription = null
    ): self {
        $dto = new self();
        $dto->rewardGroupId = $rewardGroupId;
        $dto->rewardGroupCode = $rewardGroupCode;
        $dto->rewardGroupName = $rewardGroupName;
        $dto->rewardGroupDescription = $rewardGroupDescription;
        return $dto;
    }

    /**
     * 添加奖励项
     *
     * @param array $item 奖励项数据
     * @return self
     */
    public function addRewardItem(array $item): self
    {
        $this->rewardItems[] = $item;
        return $this;
    }

    /**
     * 设置奖励项列表
     *
     * @param array $items 奖励项列表
     * @return self
     */
    public function setRewardItems(array $items): self
    {
        $this->rewardItems = $items;
        return $this;
    }
}