package cc.mrbird.febs.ai.service;

import cc.mrbird.febs.ai.entity.AiProductPoint;
import com.baomidou.mybatisplus.extension.service.IService;
import java.util.List;

/**
 * AI产品知识点 Service接口
 *
 * @author yourname
 * @date 2025-07-29
 */
public interface AiProductPointService extends IService<AiProductPoint> {

    /**
     * 根据ID查询AI产品知识点
     * @param id 知识点ID
     * @return AI产品知识点信息
     */
    AiProductPoint getById(String id);

    /**
     * 根据公司ID查询AI产品知识点列表
     * @param companyId 公司ID
     * @return AI产品知识点列表
     */
    List<AiProductPoint> getByCompanyId(String companyId);

    /**
     * 根据类型查询AI产品知识点列表
     * @param isNormal 类型1:普通内容 2:视频号内容
     * @return AI产品知识点列表
     */
    List<AiProductPoint> getByIsNormal(Integer isNormal);

    /**
     * 根据视频号用户名查询AI产品知识点列表
     * @param finderUserName 视频号用户名
     * @return AI产品知识点列表
     */
    List<AiProductPoint> getByFinderUserName(String finderUserName);

    /**
     * 根据标题查询AI产品知识点列表
     * @param title 标题
     * @return AI产品知识点列表
     */
    List<AiProductPoint> getByTitle(String title);

    /**
     * 根据公司ID和类型查询AI产品知识点列表
     * @param companyId 公司ID
     * @param isNormal 类型1:普通内容 2:视频号内容
     * @return AI产品知识点列表
     */
    List<AiProductPoint> getByCompanyIdAndIsNormal(String companyId, Integer isNormal);

    /**
     * 模糊查询标题或描述包含关键字的AI产品知识点列表
     * @param keyword 关键字
     * @return AI产品知识点列表
     */
    List<AiProductPoint> searchByKeyword(String keyword);

    /**
     * 保存AI产品知识点
     * @param aiProductPoint AI产品知识点实体
     * @return 是否保存成功
     */
    boolean saveProductPoint(AiProductPoint aiProductPoint);

    /**
     * 批量保存AI产品知识点
     * @param productPoints AI产品知识点列表
     * @return 是否保存成功
     */
    boolean saveBatchProductPoints(List<AiProductPoint> productPoints);

    /**
     * 更新AI产品知识点
     * @param aiProductPoint AI产品知识点实体
     * @return 是否更新成功
     */
    boolean updateProductPoint(AiProductPoint aiProductPoint);

    /**
     * 根据ID删除AI产品知识点
     * @param id 知识点ID
     * @return 是否删除成功
     */
    boolean deleteById(String id);

    /**
     * 根据公司ID删除AI产品知识点
     * @param companyId 公司ID
     * @return 是否删除成功
     */
    boolean deleteByCompanyId(String companyId);

    /**
     * 根据视频号FeedID删除AI产品知识点
     * @param feedId 视频号FeedID
     * @return 是否删除成功
     */
    boolean deleteByFeedId(String feedId);
}