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

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.aftersales.controller.admin.visit.vo.AfterSaleVisitCreateReqVO;
import cn.iocoder.yudao.module.aftersales.controller.admin.visit.vo.AfterSaleVisitPageReqVO;
import cn.iocoder.yudao.module.aftersales.dal.dataobject.visit.AfterSaleVisitDO;
import jakarta.validation.Valid;

import java.util.List;

/**
 * 售后回访记录 Service 接口
 */
public interface AfterSaleVisitService {

    /**
     * 登记回访
     * <p>
     * 工单须处于已完结(待回访)状态。登记时同步推进工单：
     * 满意且未复发 → 工单回访通过(可归档)；不满意或复发 → 工单回退处理中重新处理。
     *
     * @param createReqVO 登记信息
     * @param userId      当前用户编号(回访人)
     * @return 回访记录编号
     */
    Long createVisit(@Valid AfterSaleVisitCreateReqVO createReqVO, Long userId);

    /**
     * 获得回访记录
     *
     * @param id 编号
     * @return 回访记录
     */
    AfterSaleVisitDO getVisit(Long id);

    /**
     * 获得某工单的回访记录列表
     *
     * @param ticketId 工单编号
     * @return 回访记录列表
     */
    List<AfterSaleVisitDO> getVisitListByTicketId(Long ticketId);

    /**
     * 获得回访记录分页
     *
     * @param pageReqVO 分页查询
     * @return 回访记录分页
     */
    PageResult<AfterSaleVisitDO> getVisitPage(AfterSaleVisitPageReqVO pageReqVO);

}