kknongchang_2506/app/Module/Activity/Models/UserActivityData.php

<?php

namespace App\Module\Activity\Models;

use Illuminate\Database\Eloquent\Relations\BelongsTo;
use UCore\ModelCore;

/**
 * 用户活动数据
 *
 * field start 
 * @property   int  $id  主键
 * @property   int  $user_id  用户ID
 * @property   int  $activity_id  活动ID
 * @property   int  $progress  活动进度（如任务完成数等）
 * @property   object|array  $progress_data  详细进度数据，JSON格式
 * @property   \Carbon\Carbon  $last_update  最后更新时间
 * @property   \Carbon\Carbon  $created_at  创建时间
 * @property   \Carbon\Carbon  $updated_at  更新时间
 * field end
 */
class UserActivityData extends ModelCore
{
    /**
     * 与模型关联的表名
     *
     * @var string
     */
    protected $table = 'user_activity_data';

    /**
     * 可批量赋值的属性
     *
     * @var array
     */
    // attrlist start 
    protected $fillable = [
        'id',
        'user_id',
        'activity_id',
        'progress',
        'progress_data',
        'last_update',
    ];
    // attrlist end

    /**
     * 应该被转换为原生类型的属性
     *
     * @var array
     */
    protected $casts = [
        'user_id' => 'integer',
        'activity_id' => 'integer',
        'progress' => 'integer',
        'progress_data' => 'json',
        'last_update' => 'datetime',
    ];

    /**
     * 获取关联的活动
     *
     * @return BelongsTo
     */
    public function activity(): BelongsTo
    {
        return $this->belongsTo(ActivityConfig::class, 'activity_id', 'id');
    }

    /**
     * 获取关联的参与记录
     *
     * @return BelongsTo
     */
    public function participation(): BelongsTo
    {
        return $this->belongsTo(ActivityParticipation::class, ['user_id', 'activity_id'], ['user_id', 'activity_id']);
    }

    /**
     * 更新进度
     *
     * @param int $progress 新的进度值
     * @param array|null $progressData 详细进度数据
     * @return bool
     */
    public function updateProgress(int $progress, ?array $progressData = null): bool
    {
        $this->progress = $progress;
        
        if ($progressData !== null) {
            $this->progress_data = $progressData;
        }
        
        $this->last_update = now();
        
        return $this->save();
    }

    /**
     * 增加进度
     *
     * @param int $increment 增加的进度值
     * @param array|null $progressData 详细进度数据
     * @return bool
     */
    public function incrementProgress(int $increment, ?array $progressData = null): bool
    {
        return $this->updateProgress($this->progress + $increment, $progressData);
    }
}