From c83f45789e3e5f5e5188d34c1e8e6509eb4ac33e Mon Sep 17 00:00:00 2001
From: “mitao” <“2763622819@qq.com”>
Date: 星期四, 07 五月 2026 14:28:05 +0800
Subject: [PATCH] feat:兑换码后台接口增加注释
---
ruoyi-service/ruoyi-other/src/main/java/com/ruoyi/other/service/TExchangeCodePackageService.java | 106 +++++++++++++++++++++++++++++++++++++++++++++++++++++
1 files changed, 106 insertions(+), 0 deletions(-)
diff --git a/ruoyi-service/ruoyi-other/src/main/java/com/ruoyi/other/service/TExchangeCodePackageService.java b/ruoyi-service/ruoyi-other/src/main/java/com/ruoyi/other/service/TExchangeCodePackageService.java
index c603c11..93fec4d 100644
--- a/ruoyi-service/ruoyi-other/src/main/java/com/ruoyi/other/service/TExchangeCodePackageService.java
+++ b/ruoyi-service/ruoyi-other/src/main/java/com/ruoyi/other/service/TExchangeCodePackageService.java
@@ -23,39 +23,145 @@
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);
}
--
Gitblit v1.7.1