package com.aurora.service;

import com.aurora.model.dto.CommentAdminDTO;
import com.aurora.model.dto.CommentDTO;
import com.aurora.model.dto.ReplyDTO;// 导入回复数据传输对象（ReplyDTO），专门用于封装评论的回复信息，通常包含被回复对象标识和回复内容
import com.aurora.entity.Comment;
import com.aurora.model.vo.CommentVO;// 导入评论值对象（CommentVO），用于接收前端传递的评论新增或修改参数，通常进行参数校验
import com.aurora.model.vo.ConditionVO;
import com.aurora.model.dto.PageResultDTO;
import com.aurora.model.vo.ReviewVO;// 导入审核值对象（ReviewVO），用于接收评论审核操作的相关参数，如评论ID集合和审核状态
import com.baomidou.mybatisplus.extension.service.IService;

import java.util.List;
//主要用于处理评论的增删改查、回复管理、热门评论筛选和审核等核心业务逻辑
public interface CommentService extends IService<Comment> {

    void saveComment(CommentVO commentVO);//保存评论信息（包含评论和回复的保存逻辑）

    PageResultDTO<CommentDTO> listComments(CommentVO commentVO);//分页获取评论列表（支持条件查询，用于文章详情页的评论展示）

    List<ReplyDTO> listRepliesByCommentId(Integer commentId);//根据评论ID获取该评论的所有回复列表（实现楼中楼功能）

    List<CommentDTO> listTopSixComments();//获取前六条热门评论（通常用于首页或侧边栏展示）
    /**
     * 分页获取后台评论管理列表（管理员功能，支持复杂条件查询）,该方法通常用于管理员审核评论，可查看评论状态、操作日志等管理信息
     * @param conditionVO 封装查询条件的值对象，包含关键词、审核状态、时间范围等参数
     * @return PageResultDTO<CommentAdminDTO> 分页结果对象，包含评论管理数据列表
     */
    PageResultDTO<CommentAdminDTO> listCommentsAdmin(ConditionVO conditionVO);

    void updateCommentsReview(ReviewVO reviewVO);//更新评论的审核状态（批量审核通过或拒绝）,需要权限校验，确保只有管理员可执行审核操作

}