package cc.mrbird.febs.ai.service;

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

/**
 * AI用户答题记录子表 Service接口
 *
 * @author yourname
 * @date 2025-07-29
 */
public interface AiMemberAnswerItemService extends IService<AiMemberAnswerItem> {

    /**
     * 根据ID查询答题记录项
     * @param id 答题记录项ID
     * @return 答题记录项信息
     */
    AiMemberAnswerItem getById(String id);

    /**
     * 根据答题记录ID查询答题记录项列表
     * @param answerId 答题记录ID
     * @return 答题记录项列表
     */
    List<AiMemberAnswerItem> getByAnswerId(String answerId);

    /**
     * 根据用户ID查询答题记录项列表
     * @param memberId 用户ID
     * @return 答题记录项列表
     */
    List<AiMemberAnswerItem> getByMemberId(String memberId);

    /**
     * 根据产品ID查询答题记录项列表
     * @param productId 产品ID
     * @return 答题记录项列表
     */
    List<AiMemberAnswerItem> getByProductId(String productId);

    /**
     * 根据题目父ID查询答题记录项列表
     * @param productQuestionParentId 题目父ID
     * @return 答题记录项列表
     */
    List<AiMemberAnswerItem> getByProductQuestionParentId(String productQuestionParentId);

    /**
     * 根据题目ID查询答题记录项列表
     * @param productQuestionId 题目ID
     * @return 答题记录项列表
     */
    List<AiMemberAnswerItem> getByProductQuestionId(String productQuestionId);

    /**
     * 根据用户回答状态查询答题记录项列表
     * @param memberAnswerState 用户回答状态 0-未回答 1-答对了 2-答错了
     * @return 答题记录项列表
     */
    List<AiMemberAnswerItem> getByMemberAnswerState(Integer memberAnswerState);

    /**
     * 根据是否加入错题集查询答题记录项列表
     * @param isCollected 是否加入错题集：0-否，1-是
     * @return 答题记录项列表
     */
    List<AiMemberAnswerItem> getByIsCollected(Integer isCollected);

    /**
     * 根据公司ID和用户ID查询答题记录项列表
     * @param companyId 公司ID
     * @param memberId 用户ID
     * @return 答题记录项列表
     */
    List<AiMemberAnswerItem> getByCompanyIdAndMemberId(String companyId, String memberId);

    /**
     * 保存答题记录项
     * @param aiMemberAnswerItem 答题记录项实体
     * @return 是否保存成功
     */
    boolean saveAnswerItem(AiMemberAnswerItem aiMemberAnswerItem);

    /**
     * 批量保存答题记录项
     * @param answerItems 答题记录项列表
     * @return 是否保存成功
     */
    boolean saveBatchAnswerItems(List<AiMemberAnswerItem> answerItems);

    /**
     * 更新答题记录项
     * @param aiMemberAnswerItem 答题记录项实体
     * @return 是否更新成功
     */
    boolean updateAnswerItem(AiMemberAnswerItem aiMemberAnswerItem);

    /**
     * 根据ID删除答题记录项
     * @param id 答题记录项ID
     * @return 是否删除成功
     */
    boolean deleteById(String id);

    /**
     * 根据答题记录ID删除答题记录项
     * @param answerId 答题记录ID
     * @return 是否删除成功
     */
    boolean deleteByAnswerId(String answerId);
}