<?php

/**
 * 文件功能：聊天室座驾模型。
 *
 * 对应 rides 表，保存座驾名称、特效 key、价格、使用天数、欢迎语与上下架状态。
 */

namespace App\Models;

use Illuminate\Database\Eloquent\Collection;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;

/**
 * 聊天室座驾模型
 * 负责提供座驾定义、全屏特效 key 和购买记录关系。
 */
class Ride extends Model
{
    protected $fillable = [
        'name', 'slug', 'effect_key', 'icon', 'description', 'price',
        'duration_days', 'welcome_message', 'sort_order', 'is_active',
    ];

    protected $casts = [
        'is_active' => 'boolean',
    ];

    /**
     * 获取座驾对应的所有购买记录。
     */
    public function purchases(): HasMany
    {
        return $this->hasMany(UserRidePurchase::class);
    }

    /**
     * 获取座驾全屏特效 key。
     */
    public function rideKey(): string
    {
        return $this->effect_key;
    }

    /**
     * 获取所有上架座驾。
     *
     * @return Collection<int, self>
     */
    public static function active(): Collection
    {
        return static::query()
            ->where('is_active', true)
            ->orderBy('sort_order')
            ->orderBy('id')
            ->get();
    }
}
