chatroom/app/Models/IdiomGameRound.php

<?php

/**
 * 文件功能：猜成语游戏回合模型
 *
 * 每次出题对应一个回合，记录题目、状态、奖励和获胜者。
 *
 * @author   ChatRoom Laravel
 *
 * @version  1.0.0
 */

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;

/**
 * 类功能：记录猜成语每一轮的题目、奖励与结算状态。
 */
class IdiomGameRound extends Model
{
    /**
     * 方法功能：声明可批量赋值的回合字段。
     *
     * @var array<int, string>
     */
    protected $fillable = [
        'room_id',
        'idiom_id',
        'status',
        'reward_gold',
        'reward_exp',
        'winner_id',
        'winner_username',
        'started_at',
        'ended_at',
    ];

    /**
     * 方法功能：定义回合字段的类型转换规则。
     *
     * @return array<string, string>
     */
    protected function casts(): array
    {
        return [
            'reward_gold' => 'integer',
            'reward_exp' => 'integer',
            'started_at' => 'datetime',
            'ended_at' => 'datetime',
        ];
    }

    /**
     * 方法功能：关联本回合对应的成语题目。
     */
    public function idiom(): BelongsTo
    {
        return $this->belongsTo(Idiom::class);
    }
}