kknongchang_2506/app/Module/Task/Repositorys/TaskUserProgressRepository.php

<?php

namespace App\Module\Task\Repositorys;

use App\Module\Task\Models\TaskUserProgress;
use Dcat\Admin\Repositories\EloquentRepository;

/**
 * 用户任务进度数据仓库类
 *
 * 提供用户任务进度数据的访问和操作功能。
 * 该类是用户任务进度模块与后台管理系统的桥梁，用于处理用户任务进度数据的CRUD操作。
 */
class TaskUserProgressRepository extends EloquentRepository
{
    /**
     * 关联的Eloquent模型类
     *
     * @var string
     */
    protected $eloquentClass = TaskUserProgress::class;

    /**
     * 默认预加载的关联关系
     *
     * @var array
     */
    protected $with = ['task', 'achievementCondition.condition', 'userTask'];

    /**
     * 获取用户任务进度
     *
     * @param int $userId 用户ID
     * @param int $achievementConditionId 达成条件ID
     * @return TaskUserProgress|null
     */
    public function getUserProgress(int $userId, int $achievementConditionId)
    {
        return TaskUserProgress::where('user_id', $userId)
            ->where('achievement_condition_id', $achievementConditionId)
            ->first();
    }

    /**
     * 创建用户任务进度
     *
     * @param array $data 进度数据
     * @return TaskUserProgress
     */
    public function createUserProgress(array $data)
    {
        return TaskUserProgress::create($data);
    }
}