pllx
60 lines
1.3 KiB
PHP
60 lines
1.3 KiB
PHP
<?php
|
|
|
|
/**
|
|
* 文件功能：用户成就解锁记录模型。
|
|
*
|
|
* 保存每个用户在固定成就目录中的进度快照、达成时间与通知状态。
|
|
*/
|
|
|
|
namespace App\Models;
|
|
|
|
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
|
use Illuminate\Database\Eloquent\Model;
|
|
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
|
|
|
/**
|
|
* 类功能：封装用户成就记录字段、类型转换与用户关联。
|
|
*/
|
|
class UserAchievement extends Model
|
|
{
|
|
/** @use HasFactory<\Database\Factories\UserAchievementFactory> */
|
|
use HasFactory;
|
|
|
|
/**
|
|
* 允许批量赋值的字段。
|
|
*
|
|
* @var array<int, string>
|
|
*/
|
|
protected $fillable = [
|
|
'user_id',
|
|
'achievement_key',
|
|
'progress_value',
|
|
'achieved_at',
|
|
'notified_at',
|
|
'metadata',
|
|
];
|
|
|
|
/**
|
|
* 属性类型转换。
|
|
*
|
|
* @return array<string, string>
|
|
*/
|
|
protected function casts(): array
|
|
{
|
|
return [
|
|
'progress_value' => 'integer',
|
|
'achieved_at' => 'datetime',
|
|
'notified_at' => 'datetime',
|
|
'metadata' => 'array',
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 关联：成就记录所属用户。
|
|
*/
|
|
public function user(): BelongsTo
|
|
{
|
|
return $this->belongsTo(User::class);
|
|
}
|
|
}
|