kknongchang_2506/app/Module/Pet/Models/PetLevelConfig.php

<?php

namespace App\Module\Pet\Models;

use UCore\ModelCore;
use App\Module\Pet\Casts\DisplayAttributesCast;
use App\Module\Pet\Casts\NumericAttributesCast;
use App\Module\Pet\Models\PetSkill;
use App\Module\Pet\Models\PetUser;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\BelongsToMany;

/**
 * 宠物等级配置模型
 *
 * field start 
 * @property   int  $id  
 * @property   int  $pet_id  宠物 ID
 * @property   int  $level  等级
 * @property   int  $exp_required  升级所需经验值
 * @property   object|array  $skills  可用技能
 * @property   object|array  $display_attributes  等级显示属性配置
 * @property   object|array  $numeric_attributes  等级数值属性配置
 * @property   \Carbon\Carbon  $created_at  
 * @property   \Carbon\Carbon  $updated_at  
 * field end
 */
class PetLevelConfig extends ModelCore
{

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

    // attrlist start 
    protected $fillable = [
        'id',
        'pet_id',
        'level',
        'exp_required',
        'skills',
        'display_attributes',
        'numeric_attributes',
    ];
    // attrlist end

    /**
     * 应该被转换为原生类型的属性
     *
     * @var array
     */
    protected $casts = [
        'level'              => 'integer',
        'exp_required'       => 'integer',
        'skills'             => 'array',
        'display_attributes' => DisplayAttributesCast::class,
        'numeric_attributes' => NumericAttributesCast::class,
    ];

    /**
     * 获取关联的宠物
     *
     * @return BelongsTo
     */
    public function pet(): BelongsTo
    {
        return $this->belongsTo(PetUser::class, 'pet_id');
    }

    /**
     * 获取该等级可用的技能
     *
     * 通过 skills 字段中存储的技能ID数组关联到 PetSkill 模型
     *
     * @return \Illuminate\Database\Eloquent\Collection
     */
    public function getAvailableSkills()
    {
        if (empty($this->skills)) {
            return collect();
        }

        return PetSkill::whereIn('id', $this->skills)->get();
    }

    /**
     * 获取技能列表的访问器
     *
     * @return string
     */
    public function getSkillsListAttribute()
    {
        $skills = $this->getAvailableSkills();

        if ($skills->isEmpty()) {
            return '无可用技能';
        }

        $skillNames = [];
        foreach ($skills as $skill) {
            $skillNames[] = "{$skill->skill_name} (ID: {$skill->id})";
        }

        return implode('<br>', $skillNames);
    }

    /**
     * 检查指定技能是否在该等级可用
     *
     * @param int $skillId 技能ID
     * @return bool
     */
    public function hasSkill(int $skillId): bool
    {
        return !empty($this->skills) && in_array($skillId, $this->skills);
    }


}