kknongchang_2506/app/Module/Game/Models/UserLog.php

<?php

namespace App\Module\Game\Models;

use App\Module\Game\Casts\UserLogSourceTypeCast;
use App\Module\Game\Enums\REWARD_SOURCE_TYPE;
use UCore\ModelCore;

/**
 * 用户日志模型
 *
 * field start 
 * @property  int  $id  主键ID
 * @property  int  $user_id  用户ID
 * @property  string  $message  日志消息内容
 * @property  string  $source_type  来源类型（fund, item, farm等）
 * @property  int  $source_id  来源记录ID
 * @property  string  $source_table  来源表名
 * @property  \Carbon\Carbon  $original_time  原始日志时间（业务发生时间）
 * @property  \Carbon\Carbon  $collected_at  收集时间（日志收集时间）
 * @property  \Carbon\Carbon  $created_at  创建时间（兼容字段，等同于collected_at）
 * field end
 */
class UserLog extends ModelCore
{
    /**
     * 与模型关联的表名
     *
     * @var string
     */
    protected $table = 'user_logs';

    /**
     * 指示模型是否应该被打上时间戳
     * 只需要创建时间，不需要更新时间
     *
     * @var bool
     */
    public $timestamps = true;

    /**
     * 更新时间戳字段名
     * 设置为null表示不使用updated_at字段
     *
     * @var string|null
     */
    const UPDATED_AT = null;

    // attrlist start 
    protected $fillable = [
        'id',
        'user_id',
        'message',
        'source_type',
        'source_id',
        'source_table',
        'original_time',
        'collected_at',
    ];
    // attrlist end

    /**
     * 应该被转换为日期的属性
     *
     * @var array
     */
    protected $dates = [
        'original_time',
        'collected_at',
        'created_at',
    ];

    /**
     * 应该被转换为原生类型的属性
     *
     * @var array
     */
    protected $casts = [
        'user_id' => 'integer',
        'source_id' => 'integer',
        'source_type' => UserLogSourceTypeCast::class,
        'original_time' => 'datetime',
        'collected_at' => 'datetime',
        'created_at' => 'datetime',
    ];

    /**
     * 关联用户模型
     *
     * @return \Illuminate\Database\Eloquent\Relations\BelongsTo
     */
    public function user()
    {
        return $this->belongsTo(\App\Module\User\Models\User::class, 'user_id', 'id');
    }

    /**
     * 按用户ID查询日志
     *
     * @param \Illuminate\Database\Eloquent\Builder $query
     * @param int $userId
     * @return \Illuminate\Database\Eloquent\Builder
     */
    public function scopeByUser($query, int $userId)
    {
        return $query->where('user_id', $userId);
    }

    /**
     * 按来源类型查询日志
     *
     * @param \Illuminate\Database\Eloquent\Builder $query
     * @param string $sourceType
     * @return \Illuminate\Database\Eloquent\Builder
     */
    public function scopeBySourceType($query, string $sourceType)
    {
        return $query->where('source_type', $sourceType);
    }

    /**
     * 按时间范围查询日志
     *
     * @param \Illuminate\Database\Eloquent\Builder $query
     * @param string $startTime
     * @param string $endTime
     * @return \Illuminate\Database\Eloquent\Builder
     */
    public function scopeByTimeRange($query, string $startTime, string $endTime)
    {
        return $query->whereBetween('created_at', [$startTime, $endTime]);
    }

    /**
     * 最新日志优先（按原始时间排序）
     *
     * @param \Illuminate\Database\Eloquent\Builder $query
     * @return \Illuminate\Database\Eloquent\Builder
     */
    public function scopeLatest($query)
    {
        return $query->orderBy('original_time', 'desc');
    }

    /**
     * 按原始时间排序（升序）
     *
     * @param \Illuminate\Database\Eloquent\Builder $query
     * @return \Illuminate\Database\Eloquent\Builder
     */
    public function scopeByOriginalTime($query)
    {
        return $query->orderBy('original_time', 'asc');
    }

    /**
     * 按收集时间排序
     *
     * @param \Illuminate\Database\Eloquent\Builder $query
     * @return \Illuminate\Database\Eloquent\Builder
     */
    public function scopeByCollectedTime($query)
    {
        return $query->orderBy('collected_at', 'desc');
    }

    /**
     * 按原始时间范围查询
     *
     * @param \Illuminate\Database\Eloquent\Builder $query
     * @param string $startTime
     * @param string $endTime
     * @return \Illuminate\Database\Eloquent\Builder
     */
    public function scopeByOriginalTimeRange($query, string $startTime, string $endTime)
    {
        return $query->whereBetween('original_time', [$startTime, $endTime]);
    }

    /**
     * 获取格式化的创建时间
     *
     * @return string
     */
    public function getFormattedCreatedAtAttribute(): string
    {
        return $this->created_at ? $this->created_at->format('Y-m-d H:i:s') : '';
    }

    /**
     * 获取格式化的时间戳（使用原始时间）
     *
     * @return string
     */
    public function getTimeAttribute(): string
    {
        return $this->original_time ? $this->original_time->format('m-d H:i') : '';
    }

    /**
     * 获取格式化的原始时间
     *
     * @return string
     */
    public function getFormattedOriginalTimeAttribute(): string
    {
        return $this->original_time ? $this->original_time->format('Y-m-d H:i:s') : '';
    }

    /**
     * 获取格式化的收集时间
     *
     * @return string
     */
    public function getFormattedCollectedAtAttribute(): string
    {
        return $this->collected_at ? $this->collected_at->format('Y-m-d H:i:s') : '';
    }

    /**
     * 获取时间差（收集时间 - 原始时间）
     *
     * @return int 秒数
     */
    public function getCollectionDelayAttribute(): int
    {
        if (!$this->original_time || !$this->collected_at) {
            return 0;
        }
        return $this->collected_at->timestamp - $this->original_time->timestamp;
    }

    /**
     * 获取来源类型名称
     *
     * @return string
     */
    public function getSourceTypeNameAttribute(): string
    {
        if (!$this->source_type) {
            return '未知';
        }

        if ($this->source_type instanceof REWARD_SOURCE_TYPE) {
            $info = REWARD_SOURCE_TYPE::getTypeInfo($this->source_type->value);
            return $info['name'];
        }

        // 兼容旧数据
        if (is_string($this->source_type) && REWARD_SOURCE_TYPE::isValid($this->source_type)) {
            $info = REWARD_SOURCE_TYPE::getTypeInfo($this->source_type);
            return $info['name'];
        }

        return $this->source_type;
    }

    /**
     * 获取来源类型图标
     *
     * @return string
     */
    public function getSourceTypeIconAttribute(): string
    {
        if (!$this->source_type) {
            return '❓';
        }

        if ($this->source_type instanceof REWARD_SOURCE_TYPE) {
            $info = REWARD_SOURCE_TYPE::getTypeInfo($this->source_type->value);
            return $info['icon'];
        }

        // 兼容旧数据
        if (is_string($this->source_type) && REWARD_SOURCE_TYPE::isValid($this->source_type)) {
            $info = REWARD_SOURCE_TYPE::getTypeInfo($this->source_type);
            return $info['icon'];
        }

        return '❓';
    }

    /**
     * 获取来源类型分类
     *
     * @return string
     */
    public function getSourceTypeCategoryAttribute(): string
    {
        if (!$this->source_type) {
            return 'unknown';
        }

        if ($this->source_type instanceof REWARD_SOURCE_TYPE) {
            $info = REWARD_SOURCE_TYPE::getTypeInfo($this->source_type->value);
            return $info['category'];
        }

        // 兼容旧数据
        if (is_string($this->source_type) && REWARD_SOURCE_TYPE::isValid($this->source_type)) {
            $info = REWARD_SOURCE_TYPE::getTypeInfo($this->source_type);
            return $info['category'];
        }

        return 'unknown';
    }

    /**
     * 获取来源类型完整信息
     *
     * @return array
     */
    public function getSourceTypeInfoAttribute(): array
    {
        if (!$this->source_type) {
            return [
                'name' => '未知',
                'description' => '未知来源类型',
                'category' => 'unknown',
                'icon' => '❓',
                'priority' => 999
            ];
        }

        if ($this->source_type instanceof REWARD_SOURCE_TYPE) {
            return REWARD_SOURCE_TYPE::getTypeInfo($this->source_type->value);
        }

        // 兼容旧数据
        if (is_string($this->source_type) && REWARD_SOURCE_TYPE::isValid($this->source_type)) {
            return REWARD_SOURCE_TYPE::getTypeInfo($this->source_type);
        }

        return [
            'name' => $this->source_type,
            'description' => '未知来源类型',
            'category' => 'unknown',
            'icon' => '❓',
            'priority' => 999
        ];
    }
}