package cn.iocoder.yudao.module.aftersales.service.problem;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.aftersales.controller.admin.problem.vo.AfterSaleProblemPageReqVO;
import cn.iocoder.yudao.module.aftersales.controller.admin.problem.vo.AfterSaleProblemSaveReqVO;
import cn.iocoder.yudao.module.aftersales.dal.dataobject.problem.AfterSaleProblemDO;
import cn.iocoder.yudao.module.aftersales.dal.dataobject.ticket.AfterSaleTicketDO;
import jakarta.validation.Valid;

import java.util.Collection;
import java.util.List;

/**
 * 售后问题库 Service 接口
 */
public interface AfterSaleProblemService {

    /**
     * 创建问题(人工建档)，初始状态草稿
     *
     * @param createReqVO 创建信息
     * @param userId      当前用户编号(沉淀人)
     * @return 问题编号
     */
    Long createProblem(@Valid AfterSaleProblemSaveReqVO createReqVO, Long userId);

    /**
     * 更新问题
     *
     * @param updateReqVO 更新信息
     */
    void updateProblem(@Valid AfterSaleProblemSaveReqVO updateReqVO);

    /**
     * 删除问题(仅草稿)
     *
     * @param id 问题编号
     */
    void deleteProblem(Long id);

    /**
     * 获得问题
     *
     * @param id 问题编号
     * @return 问题
     */
    AfterSaleProblemDO getProblem(Long id);

    /**
     * 获得问题列表
     *
     * @param ids 编号列表
     * @return 问题列表
     */
    List<AfterSaleProblemDO> getProblemList(Collection<Long> ids);

    /**
     * 获得问题分页
     *
     * @param pageReqVO 分页查询
     * @return 问题分页
     */
    PageResult<AfterSaleProblemDO> getProblemPage(AfterSaleProblemPageReqVO pageReqVO);

    /**
     * 发布问题
     *
     * @param id 问题编号
     */
    void publishProblem(Long id);

    /**
     * 停用问题
     *
     * @param id 问题编号
     */
    void disableProblem(Long id);

    /**
     * 新工单受理参考检索：命中已发布历史问题
     *
     * @param pageReqVO 参考检索条件(取 itemId/issueCategory/issueType/rootCauseCategory/keyword)
     * @return 已发布问题列表(至多10条)
     */
    List<AfterSaleProblemDO> getReferenceList(AfterSaleProblemPageReqVO pageReqVO);

    /**
     * 工单归档时自动沉淀问题(草稿态)；同一工单仅沉淀一次(幂等)
     *
     * @param ticket 售后工单
     * @return 沉淀出的问题
     */
    AfterSaleProblemDO createProblemFromTicket(AfterSaleTicketDO ticket);

}