<?php

/**
 * 文件功能：用户身份徽章模型。
 *
 * 管理用户从签到等来源获得的当前身份展示标识。
 */

namespace App\Models;

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

/**
 * 类功能：封装用户身份徽章字段、类型转换与用户关联。
 */
class UserIdentityBadge extends Model
{
    /** @use HasFactory<\Database\Factories\UserIdentityBadgeFactory> */
    use HasFactory;

    public const SOURCE_SIGN_IN = 'sign_in';

    /**
     * 允许批量赋值的字段。
     *
     * @var array<int, string>
     */
    protected $fillable = [
        'user_id',
        'source',
        'badge_code',
        'badge_name',
        'badge_icon',
        'badge_color',
        'acquired_at',
        'expires_at',
        'is_active',
        'metadata',
    ];

    /**
     * 属性类型转换。
     *
     * @return array<string, string>
     */
    protected function casts(): array
    {
        return [
            'acquired_at' => 'datetime',
            'expires_at' => 'datetime',
            'is_active' => 'boolean',
            'metadata' => 'array',
        ];
    }

    /**
     * 关联：身份徽章所属用户。
     */
    public function user(): BelongsTo
    {
        return $this->belongsTo(User::class);
    }
}
