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

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.aftersales.controller.admin.ticket.vo.ticket.AfterSaleTicketPageReqVO;
import cn.iocoder.yudao.module.aftersales.controller.admin.ticket.vo.ticket.AfterSaleTicketSaveReqVO;
import cn.iocoder.yudao.module.aftersales.dal.dataobject.ticket.AfterSaleTicketDO;
import cn.iocoder.yudao.module.aftersales.dal.dataobject.ticket.AfterSaleTicketItemDO;
import jakarta.validation.Valid;

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

/**
 * 售后工单 Service 接口
 */
public interface AfterSaleTicketService {

    /**
     * 创建工单
     *
     * @param createReqVO 创建信息
     * @param userId      用户编号
     * @return 编号
     */
    Long createTicket(@Valid AfterSaleTicketSaveReqVO createReqVO, Long userId);

    /**
     * 更新工单
     *
     * @param updateReqVO 更新信息
     */
    void updateTicket(@Valid AfterSaleTicketSaveReqVO updateReqVO);

    /**
     * 删除工单
     *
     * @param id 编号
     */
    void deleteTicket(Long id);

    /**
     * 获得工单
     *
     * @param id 编号
     * @return 工单
     */
    AfterSaleTicketDO getTicket(Long id);

    /**
     * 获得工单列表
     *
     * @param ids 编号列表
     * @return 工单列表
     */
    List<AfterSaleTicketDO> getTicketList(Collection<Long> ids);

    /**
     * 获得工单分页
     *
     * @param pageReqVO 分页查询
     * @param userId    用户编号
     * @return 工单分页
     */
    PageResult<AfterSaleTicketDO> getTicketPage(AfterSaleTicketPageReqVO pageReqVO, Long userId);

    /**
     * 获得工单明细行列表
     *
     * @param ticketId 工单编号
     * @return 明细行列表
     */
    List<AfterSaleTicketItemDO> getTicketItemListByTicketId(Long ticketId);

    /**
     * 分配处理人
     *
     * @param id              工单编号
     * @param handlerUserId   处理人用户编号
     */
    void assignTicket(Long id, Long handlerUserId);

    /**
     * 问题判定（确定问题类型、分类、严重程度）
     *
     * @param id            工单编号
     * @param issueType     问题类型
     * @param issueCategory 问题分类
     * @param severityLevel 严重程度
     */
    void classifyTicket(Long id, Integer issueType, String issueCategory, Integer severityLevel);

    /**
     * 完结工单
     *
     * @param id 工单编号
     */
    void resolveTicket(Long id);

    /**
     * 关闭工单
     *
     * @param id 工单编号
     */
    void closeTicket(Long id);

    /**
     * 取消工单
     *
     * @param id 工单编号
     */
    void cancelTicket(Long id);

}