package com.seer.teach.admin.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.seer.teach.admin.request.KnowSummariesQueryReq;
import com.seer.teach.admin.request.KnowSummariesReq;
import com.seer.teach.admin.response.KnowSummaryResp;

/**
 * <p>
 * 知识点摘要管理服务接口
 * </p>
 *
 * @author ZS
 * @since 2025-10-24
 */
public interface AdminKnowSummaryService {

    /**
     * 分页查询知识点摘要列表
     *
     * @param req 查询条件
     * @return 知识点摘要分页数据
     */
    IPage<KnowSummaryResp> pageKnowSummaries(KnowSummariesQueryReq req);

    /**
     * 根据ID获取知识点摘要详情
     *
     * @param id 知识点摘要ID
     * @return 知识点摘要实体
     */
    KnowSummaryResp getKnowSummaryById(Integer id);

    /**
     * 添加知识点摘要
     *
     * @param req 知识点摘要信息
     * @return 是否添加成功
     */
    boolean addKnowSummary(KnowSummariesReq req);

    /**
     * 更新知识点摘要信息
     *
     * @param id  知识点摘要ID
     * @param req 知识点摘要信息
     * @return 是否更新成功
     */
    boolean updateKnowSummary(Integer id, KnowSummariesReq req);

    /**
     * 删除知识点摘要
     *
     * @param id 知识点摘要ID
     * @return 是否删除成功
     */
    boolean deleteKnowSummary(Integer id);
}