package com.ruoyi.other.service;
|
|
import com.baomidou.mybatisplus.extension.service.IService;
|
import com.ruoyi.common.core.web.page.PageInfo;
|
import com.ruoyi.other.api.domain.TExchangeCodePackage;
|
import com.ruoyi.other.api.dto.ExchangeCodeBindDTO;
|
import com.ruoyi.other.api.dto.ExchangeCodeConsumeDTO;
|
import com.ruoyi.other.api.dto.ExchangeCodePackageSaveDTO;
|
import com.ruoyi.other.api.dto.ExchangeCodeUseRecordQuery;
|
import com.ruoyi.other.api.domain.TExchangeCodeUseRecord;
|
import com.ruoyi.other.api.vo.ExchangeCodeBindResultVO;
|
import com.ruoyi.other.api.vo.ExchangeCodeConsumeResultVO;
|
import com.ruoyi.other.api.vo.ExchangeCodePackageDetailVO;
|
import com.ruoyi.other.query.ExchangeCodeBatchInvalidDTO;
|
import com.ruoyi.other.query.ExchangeCodeDetailQuery;
|
import com.ruoyi.other.query.ExchangeCodePackageQuery;
|
import com.ruoyi.other.vo.ExchangeCodeBatchInvalidResultVO;
|
import com.ruoyi.other.vo.ExchangeCodeDetailVO;
|
|
import java.util.List;
|
import java.util.Map;
|
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
|
|
public interface TExchangeCodePackageService extends IService<TExchangeCodePackage> {
|
|
/**
|
* 分页查询兑换码卡包列表。
|
*
|
* @param query 查询条件
|
* @return 卡包分页结果
|
*/
|
PageInfo<TExchangeCodePackage> pageList(ExchangeCodePackageQuery query);
|
|
/**
|
* 新增兑换码卡包。
|
*
|
* @param dto 卡包保存参数
|
*/
|
void savePackage(ExchangeCodePackageSaveDTO dto);
|
|
/**
|
* 编辑兑换码卡包。
|
*
|
* @param dto 卡包保存参数
|
*/
|
void updatePackage(ExchangeCodePackageSaveDTO dto);
|
|
/**
|
* 更新兑换码卡包启用状态。
|
*
|
* @param id 卡包ID
|
* @param status 启用状态
|
*/
|
void updatePackageStatus(Long id, Integer status);
|
|
/**
|
* 刷新所有已过领取截止日期的兑换码卡包未绑定兑换码状态。
|
*/
|
void refreshExpiredPackageCodes();
|
|
/**
|
* 删除兑换码卡包。
|
*
|
* @param ids 卡包ID，多个ID用英文逗号分隔
|
*/
|
void deletePackage(String ids);
|
|
/**
|
* 查询兑换码卡包详情。
|
*
|
* @param id 卡包ID
|
* @return 卡包详情
|
*/
|
ExchangeCodePackageDetailVO getDetail(Long id);
|
|
/**
|
* 分页查询兑换码明细。
|
*
|
* @param query 查询条件
|
* @return 兑换码明细分页结果
|
*/
|
PageInfo<ExchangeCodeDetailVO> codePage(ExchangeCodeDetailQuery query);
|
|
/**
|
* 导出兑换码明细。
|
*
|
* @param query 查询条件
|
* @return 兑换码明细导出数据
|
*/
|
List<ExchangeCodeDetailVO> exportCodes(ExchangeCodeDetailQuery query);
|
|
/**
|
* 批量失效兑换码。
|
*
|
* @param dto 失效参数
|
* @return 失效结果
|
*/
|
ExchangeCodeBatchInvalidResultVO batchInvalidate(ExchangeCodeBatchInvalidDTO dto);
|
|
/**
|
* 查询可下载二维码的兑换码列表。
|
*
|
* @param packageId 卡包ID
|
* @param onlyUnbound 是否只查询未绑定兑换码
|
* @return 可下载二维码的兑换码列表
|
*/
|
List<ExchangeCodeDetailVO> listDownloadableCodes(Long packageId, boolean onlyUnbound);
|
|
/**
|
* 查询兑换码明细。
|
*
|
* @param id 兑换码明细ID
|
* @return 兑换码明细
|
*/
|
ExchangeCodeDetailVO getCodeDetail(Long id);
|
|
/**
|
* 绑定兑换码。
|
*
|
* @param dto 绑定参数
|
* @param userId 用户ID
|
* @param phone 手机号
|
* @return 绑定结果
|
*/
|
ExchangeCodeBindResultVO bindExchangeCode(ExchangeCodeBindDTO dto, Long userId, String phone);
|
|
/**
|
* 查询用户兑换码余额映射。
|
*
|
* @param userIds 用户ID集合
|
* @return 用户余额映射
|
*/
|
Map<Long, java.math.BigDecimal> getUserExchangeCodeBalanceMap(List<Long> userIds);
|
|
/**
|
* 扣减用户兑换码余额。
|
*
|
* @param dto 扣减参数
|
* @return 扣减结果
|
*/
|
ExchangeCodeConsumeResultVO consumeBalance(ExchangeCodeConsumeDTO dto);
|
|
/**
|
* 退款返还用户兑换码余额。
|
*
|
* @param dto 退款参数
|
* @return 退款结果
|
*/
|
ExchangeCodeConsumeResultVO refundBalance(ExchangeCodeConsumeDTO dto);
|
|
/**
|
* 分页查询兑换码余额流水。
|
*
|
* @param query 查询条件
|
* @return 流水分页结果
|
*/
|
Page<TExchangeCodeUseRecord> useRecordPage(ExchangeCodeUseRecordQuery query);
|
|
/**
|
* 查询兑换码余额流水详情。
|
*
|
* @param id 流水ID
|
* @param userId 用户ID
|
* @return 流水详情
|
*/
|
TExchangeCodeUseRecord useRecordDetail(Long id, Long userId);
|
}
|
