package com.taoke.autopay.service.js2;
|
|
import com.taoke.autopay.dao.OrderTaskExecutionDetailMapper;
|
import com.taoke.autopay.entity.js2.OrderTaskExecutionDetail;
|
import com.taoke.autopay.exception.OrderTaskExecutionDetailException;
|
import org.apache.ibatis.annotations.Param;
|
|
import java.util.Date;
|
import java.util.List;
|
|
/**
|
* @author
|
* @title: OrderTaskExecutionDetailService
|
* @description: 下单任务执行详情服务接口
|
* @date 2025/7/28
|
*/
|
public interface OrderTaskExecutionDetailService {
|
|
/**
|
* 创建下单任务执行详情
|
*
|
* @param orderTaskExecutionDetail 下单任务执行详情实体
|
* @return 创建后的任务执行详情实体
|
* @throws OrderTaskExecutionDetailException 任务执行详情创建异常
|
*/
|
OrderTaskExecutionDetail createOrderTaskExecutionDetail(OrderTaskExecutionDetail orderTaskExecutionDetail) throws OrderTaskExecutionDetailException;
|
|
/**
|
* 根据ID查询下单任务执行详情
|
*
|
* @param id 任务执行详情ID
|
* @return 下单任务执行详情实体
|
*/
|
OrderTaskExecutionDetail getOrderTaskExecutionDetailById(String id);
|
|
/**
|
* 根据ID更新下单任务执行详情（带锁）
|
*
|
* @param id 任务执行详情ID
|
* @return 下单任务执行详情实体
|
*/
|
OrderTaskExecutionDetail getOrderTaskExecutionDetailByIdForUpdate(String id);
|
|
/**
|
* 更新下单任务执行详情
|
*
|
* @param orderTaskExecutionDetail 下单任务执行详情实体
|
* @throws OrderTaskExecutionDetailException 任务执行详情更新异常
|
*/
|
void updateOrderTaskExecutionDetail(OrderTaskExecutionDetail orderTaskExecutionDetail) throws OrderTaskExecutionDetailException;
|
|
/**
|
* 删除下单任务执行详情
|
*
|
* @param id 任务执行详情ID
|
* @throws OrderTaskExecutionDetailException 任务执行详情删除异常
|
*/
|
void deleteOrderTaskExecutionDetail(String id) throws OrderTaskExecutionDetailException;
|
|
/**
|
* 查询下单任务执行详情列表
|
*
|
* @param query 查询条件
|
* @param page 页码
|
* @param pageSize 每页数量
|
* @return 下单任务执行详情列表
|
*/
|
List<OrderTaskExecutionDetail> listOrderTaskExecutionDetails(OrderTaskExecutionDetailMapper.DaoQuery query, int page, int pageSize);
|
|
/**
|
* 统计下单任务执行详情数量
|
*
|
* @param query 查询条件
|
* @return 任务执行详情数量
|
*/
|
long countOrderTaskExecutionDetails(OrderTaskExecutionDetailMapper.DaoQuery query);
|
|
/**
|
* 下单成功
|
*
|
* @param id 任务执行详情ID
|
* @param orderNo 订单号
|
* @param productTitle 商品标题
|
* @param shopName 店铺名称
|
* @param orderTime 下单时间
|
* @throws OrderTaskExecutionDetailException 任务执行详情更新异常
|
*/
|
void orderSuccess(String id, String orderNo, String productTitle, String shopName, Date orderTime) throws OrderTaskExecutionDetailException;
|
|
/**
|
* 下单失败
|
*
|
* @param id 任务执行详情ID
|
* @param failureReason 失败原因
|
* @throws OrderTaskExecutionDetailException 任务执行详情更新异常
|
*/
|
void orderFailure(String id, String failureReason) throws OrderTaskExecutionDetailException;
|
|
/**
|
* 确认收货成功
|
*
|
* @param id 任务执行详情ID
|
* @param couponCode 券码
|
* @throws OrderTaskExecutionDetailException 任务执行详情更新异常
|
*/
|
void confirmReceiptSuccess(String id, String couponCode) throws OrderTaskExecutionDetailException;
|
|
/**
|
* 确认收货失败
|
*
|
* @param id 任务执行详情ID
|
* @param reason 失败原因
|
* @throws OrderTaskExecutionDetailException 任务执行详情更新异常
|
*/
|
void confirmReceiptFailure(String id, String reason) throws OrderTaskExecutionDetailException;
|
|
/**
|
* 评价成功
|
*
|
* @param id 任务执行详情ID
|
* @throws OrderTaskExecutionDetailException 任务执行详情更新异常
|
*/
|
void reviewSuccess(String id) throws OrderTaskExecutionDetailException;
|
|
/**
|
* 评价失败
|
*
|
* @param id 任务执行详情ID
|
* @param reason 失败原因
|
* @throws OrderTaskExecutionDetailException 任务执行详情更新异常
|
*/
|
void reviewFailure(String id, String reason) throws OrderTaskExecutionDetailException;
|
|
/**
|
* 获取可执行的任务详情列表
|
* @param clientId
|
* @return
|
*/
|
List<OrderTaskExecutionDetail> listCanExcuteTaskDetail(Long clientId, int page, int pageSize);
|
|
/**
|
* 统计可执行任务详情数量
|
* @param clientId
|
* @return
|
*/
|
long countCanExcuteTaskDetail(@Param("clientId") Long clientId);
|
|
}
|
