package com.seer.teach.teacher.service;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.seer.teach.teacher.module.entity.ReadingRecordsEntity;


/**
 * <p>
 * 用户阅读记录表 服务类
 * </p>
 *
 * @author Captain
 * @since 2025-06-13
 */
public interface ReadingRecordsService extends IService<ReadingRecordsEntity> {

    /**
     * 获取用户最近阅读列表（每本书取最新阅读记录）
     *
     * @param page 分页配置
     * @param userId 用户ID
     * @return 分页结果
     */
    Page<ReadingRecordsEntity> getLatestReadingByUser(Page<ReadingRecordsEntity> page, Integer userId);


    /**
     * 插入一条阅读记录
     *
     * @param userId 用户ID，标识哪个用户进行了阅读操作
     * @param bookId 书籍ID，标识用户阅读的是哪本书
     * @param chapterId 章节ID，标识用户阅读的具体章节
     */
    void insertRecord(Integer userId, Integer bookId, Integer chapterId);

}
