126 lines
3.3 KiB
PHP
126 lines
3.3 KiB
PHP
<?php
|
|
|
|
/**
|
|
* 文件功能：神秘箱子模型
|
|
*
|
|
* 管理聊天室内投放的神秘箱记录，提供领取状态管理及类型标签工具方法。
|
|
* 对应表：mystery_boxes
|
|
*
|
|
* @author ChatRoom Laravel
|
|
*
|
|
* @version 1.0.0
|
|
*/
|
|
|
|
namespace App\Models;
|
|
|
|
use Illuminate\Database\Eloquent\Model;
|
|
use Illuminate\Database\Eloquent\Relations\HasMany;
|
|
use Illuminate\Database\Eloquent\Relations\HasOne;
|
|
|
|
class MysteryBox extends Model
|
|
{
|
|
protected $fillable = [
|
|
'box_type',
|
|
'passcode',
|
|
'reward_min',
|
|
'reward_max',
|
|
'status',
|
|
'expires_at',
|
|
'dropped_by',
|
|
];
|
|
|
|
/**
|
|
* 属性类型转换。
|
|
*/
|
|
protected function casts(): array
|
|
{
|
|
return [
|
|
'reward_min' => 'integer',
|
|
'reward_max' => 'integer',
|
|
'expires_at' => 'datetime',
|
|
];
|
|
}
|
|
|
|
// ─── 关联关系 ────────────────────────────────────────────────────
|
|
|
|
/**
|
|
* 领取记录（一个箱子只能被一人领取，但关联为 HasOne）
|
|
*/
|
|
public function claim(): HasOne
|
|
{
|
|
return $this->hasOne(MysteryBoxClaim::class);
|
|
}
|
|
|
|
/**
|
|
* 所有领取记录（逻辑上只有一条，保留 HasMany 供统计使用）
|
|
*/
|
|
public function claims(): HasMany
|
|
{
|
|
return $this->hasMany(MysteryBoxClaim::class);
|
|
}
|
|
|
|
// ─── 查询作用域 ──────────────────────────────────────────────────
|
|
|
|
/**
|
|
* 当前可领取（open 状态 + 未过期）的箱子。
|
|
*/
|
|
public static function currentOpenBox(): ?static
|
|
{
|
|
return static::query()
|
|
->where('status', 'open')
|
|
->where(fn ($q) => $q->whereNull('expires_at')->orWhere('expires_at', '>', now()))
|
|
->latest()
|
|
->first();
|
|
}
|
|
|
|
// ─── 工具方法 ────────────────────────────────────────────────────
|
|
|
|
/**
|
|
* 返回箱子类型的 emoji 前缀。
|
|
*/
|
|
public function typeEmoji(): string
|
|
{
|
|
return match ($this->box_type) {
|
|
'normal' => '📦',
|
|
'rare' => '💎',
|
|
'trap' => '☠️',
|
|
default => '📦',
|
|
};
|
|
}
|
|
|
|
/**
|
|
* 返回箱子类型中文名称。
|
|
*/
|
|
public function typeName(): string
|
|
{
|
|
return match ($this->box_type) {
|
|
'normal' => '普通箱',
|
|
'rare' => '稀有箱',
|
|
'trap' => '黑化箱',
|
|
default => '神秘箱',
|
|
};
|
|
}
|
|
|
|
/**
|
|
* 随机生成奖励金额（trap 类型为负数）。
|
|
*/
|
|
public function rollReward(): int
|
|
{
|
|
$amount = random_int(
|
|
min(abs($this->reward_min), abs($this->reward_max)),
|
|
max(abs($this->reward_min), abs($this->reward_max)),
|
|
);
|
|
|
|
// trap 类型：倒扣金币（负数）
|
|
return $this->box_type === 'trap' ? -$amount : $amount;
|
|
}
|
|
|
|
/**
|
|
* 判断箱子是否已过期
|
|
*/
|
|
public function isExpired(): bool
|
|
{
|
|
return $this->expires_at !== null && $this->expires_at->isPast();
|
|
}
|
|
}
|