package com.aurora.service;

import com.aurora.model.dto.CategoryAdminDTO;// 导入分类管理的数据传输对象（CategoryAdminDTO），用于后台管理界面展示分类信息，通常包含管理所需的扩展字段
import com.aurora.model.dto.CategoryDTO;
import com.aurora.model.dto.CategoryOptionDTO;// 导入分类选项数据传输对象（CategoryOptionDTO），通常用于下拉选择框等场景，仅包含关键标识字段
import com.aurora.entity.Category;
import com.aurora.model.vo.CategoryVO;// 导入分类值对象（CategoryVO），用于接收前端传递的分类新增或修改参数
import com.aurora.model.vo.ConditionVO;// 导入条件查询值对象（ConditionVO），用于封装前端传递的复杂查询参数，如关键词、状态、分页信息等
import com.aurora.model.dto.PageResultDTO;// 导入分页结果数据传输对象（PageResultDTO），用于封装分页查询结果，包含数据列表和总数等信息
import com.baomidou.mybatisplus.extension.service.IService;

import java.util.List;
//主要用于处理分类的增删改查、列表查询和搜索等核心业务逻辑
public interface CategoryService extends IService<Category> {

    List<CategoryDTO> listCategories();//获取所有分类列表（通常用于前台分类展示或导航菜单）,包含分类的核心展示信息
    //分页获取后台分类管理列表（支持条件查询，用于管理员控制台）
    //用于后台管理界面，支持根据条件进行筛选和分页展示
    //@return PageResultDTO<CategoryAdminDTO> 分页结果对象，包含分类管理数据列表和分页信息
    PageResultDTO<CategoryAdminDTO> listCategoriesAdmin(ConditionVO conditionVO);
    //根据搜索条件查询分类选项列表（通常用于搜索或筛选场景）,该方法返回精简的分类选项，常用于下拉选择框或搜索联想
    List<CategoryOptionDTO> listCategoriesBySearch(ConditionVO conditionVO);

    void deleteCategories(List<Integer> categoryIds);//批量删除分类（根据分类ID列表物理删除或逻辑删除）

    void saveOrUpdateCategory(CategoryVO categoryVO);//保存或更新分类信息（根据ID自动判断是新增还是修改操作）

}