kknongchang_2506/app/Module/Game/Models/GameRewardGroup.php

<?php

namespace App\Module\Game\Models;

use Illuminate\Database\Eloquent\Relations\HasMany;
use UCore\ModelCore;

/**
 * 奖励组
 *
 * field start 
 * @property  int  $id  主键
 * @property  string  $name  奖励组名称
 * @property  string  $code  奖励组编码（唯一）
 * @property  string  $description  奖励组描述
 * @property  bool  $is_random  是否随机发放（0:全部发放, 1:随机发放）
 * @property  int  $random_count  随机发放时的奖励数量
 * @property  int  $reward_mode  奖励模式（1:权重选择模式, 2:独立概率模式）
 * @property  \Carbon\Carbon  $created_at  创建时间
 * @property  \Carbon\Carbon  $updated_at  更新时间
 * field end
 */
class GameRewardGroup extends ModelCore
{

    /**
     * 与模型关联的表名
     *
     * @var string
     */
    protected $table = 'game_reward_groups';

    // attrlist start 
    protected $fillable = [
        'id',
        'name',
        'code',
        'description',
        'is_random',
        'random_count',
        'reward_mode',
    ];
    // attrlist end

    /**
     * 应该被转换为原生类型的属性
     *
     * @var array
     */
    protected $casts = [
        'is_random'    => 'boolean',
        'random_count' => 'integer',
        'reward_mode'  => 'integer',
    ];

    /**
     * 获取奖励组中的所有奖励项
     *
     * @return HasMany
     */
    public function rewardItems(): HasMany
    {
        return $this->hasMany(GameRewardItem::class, 'group_id', 'id');
    }

    /**
     * 获取关联的标签（多态关联）
     *
     * @return \Illuminate\Database\Eloquent\Relations\MorphToMany
     */
    public function tags()
    {
        return $this->morphToMany(GameTag::class, 'taggable', 'game_tag_relations', 'taggable_id', 'tag_id');
    }


    /**
     * 格式化奖励详情用于显示
     *
     * @return string
     */
    public function formatRewardDetails(): string
    {
        if ($this->rewardItems->isEmpty()) {
            return '<span class="text-muted">暂无奖励项</span>';
        }

        $details = [];
        foreach ($this->rewardItems as $item) {
            $detail    = $this->formatSingleRewardItem($item);
            $details[] = $detail;
        }

        return '<div class="reward-details">' . implode('<br>', $details) . '</div>';
    }

    /**
     * 格式化标签用于显示
     *
     * @return string
     */
    public function formatTags(): string
    {
        if ($this->tags->isEmpty()) {
            return '<span class="text-muted">无标签</span>';
        }

        $tagHtml = [];
        foreach ($this->tags as $tag) {
            $tagHtml[] = $tag->formatTag();
        }

        return implode(' ', $tagHtml);
    }

    /**
     * 格式化单个奖励项
     *
     * @param GameRewardItem $item
     * @return string
     */
    private function formatSingleRewardItem(GameRewardItem $item): string
    {
        // 使用统一的奖励类型描述器
        $displayText = \App\Module\Game\Services\RewardTypeDescriptor::formatRewardDisplayFromModel($item, true);

        $weight     = $item->weight;
        $guaranteed = $item->is_guaranteed ? '必中' : '非必中';

        return sprintf(
            '%s (权重: %.2f, %s)',
            $displayText,
            $weight,
            $guaranteed
        );
    }



}