package com.service;  // 声明包名为com.service，表示该接口位于服务层

import com.baomidou.mybatisplus.service.IService;  // 导入MyBatis-Plus服务接口
import com.utils.PageUtils;  // 导入分页工具类
import com.entity.JianshenkechengEntity;  // 导入健身课程实体类
import java.util.Map;  // 导入Map接口，用于传递查询参数
import javax.servlet.http.HttpServletRequest;  // 导入HTTP请求类（保留参数）
import org.springframework.lang.Nullable;  // 导入Spring的Nullable注解（保留参数）
import java.util.List;  // 导入List接口（保留参数）


 // 健身课程服务接口
 //继承MyBatis-Plus的IService接口，提供健身课程相关业务方法

public interface JianshenkechengService extends IService<JianshenkechengEntity> {


     // 分页查询健身课程信息
     //@param params 查询参数Map，包含以下常用键值：
     //              - page：当前页码（从1开始）
     //              - limit：每页记录数
     //              - courseName：课程名称（模糊查询）
     //              - courseType：课程类型
     //              - coachId：授课教练ID
     //              - status：课程状态（1-可预约，0-已满员）
     //              - startTime：课程开始时间
     //              - endTime：课程结束时间
     //@return PageUtils分页对象，包含：
     //        - list：当前页课程数据列表
     //        - totalCount：总记录数
     //        - pageSize：每页条数
     //        - totalPage：总页数
     //        - currPage：当前页码

    PageUtils queryPage(Map<String, Object> params);

    // 可扩展的业务方法示例：
    // List<JianshenkechengEntity> getPopularCourses(int limit); // 获取热门课程
    // boolean updateCourseStatus(Long courseId, Integer status); // 更新课程状态
    // List<JianshenkechengEntity> getCoursesByCoach(Long coachId); // 按教练查询课程
    // List<JianshenkechengEntity> getAvailableCourses(Date date); // 获取可预约课程
}