refactor(pricing): 重构券码使用记录相关接口和映射

- 移除了 VoucherUsageController 中的 Swagger 注解
- 更新了 PriceVoucherUsageRecordMapper 中的 SQL 查询
- 新增了 PriceVoucherUsageRecordMapper.xml 文件，用于定义分页查询

src/main/java/com/ycwl/basic/pricing/controller/VoucherUsageController.java

@@ -1,14 +1,11 @@
 package com.ycwl.basic.pricing.controller;
 
 import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
-import com.ycwl.basic.common.ApiResponse;
+import com.ycwl.basic.utils.ApiResponse;
 import com.ycwl.basic.pricing.dto.req.VoucherUsageHistoryReq;
 import com.ycwl.basic.pricing.dto.resp.VoucherUsageRecordResp;
 import com.ycwl.basic.pricing.dto.resp.VoucherUsageStatsResp;
 import com.ycwl.basic.pricing.service.IVoucherUsageService;
-import io.swagger.v3.oas.annotations.Operation;
-import io.swagger.v3.oas.annotations.Parameter;
-import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.web.bind.annotation.*;
@@ -22,13 +19,11 @@ import java.util.List;
 @RestController
 @RequestMapping("/api/pricing/voucher/usage")
 @RequiredArgsConstructor
-@Tag(name = "券码使用记录管理", description = "券码使用历史和统计API")
 public class VoucherUsageController {
 
     private final IVoucherUsageService voucherUsageService;
 
     @PostMapping("/history")
-    @Operation(summary = "分页查询券码使用记录")
     public ApiResponse<Page<VoucherUsageRecordResp>> getUsageHistory(@RequestBody VoucherUsageHistoryReq req) {
         try {
             Page<VoucherUsageRecordResp> result = voucherUsageService.getUsageHistory(req);
@@ -40,9 +35,8 @@ public class VoucherUsageController {
     }
 
     @GetMapping("/{voucherCode}/records")
-    @Operation(summary = "获取指定券码的使用记录")
     public ApiResponse<List<VoucherUsageRecordResp>> getRecordsByCode(
-            @Parameter(description = "券码") @PathVariable String voucherCode) {
+            @PathVariable String voucherCode) {
         try {
             List<VoucherUsageRecordResp> records = voucherUsageService.getUsageRecordsByCode(voucherCode);
             return ApiResponse.success(records);
@@ -53,9 +47,8 @@ public class VoucherUsageController {
     }
 
     @GetMapping("/{voucherCode}/stats")
-    @Operation(summary = "获取券码使用统计信息")
     public ApiResponse<VoucherUsageStatsResp> getUsageStats(
-            @Parameter(description = "券码") @PathVariable String voucherCode) {
+            @PathVariable String voucherCode) {
         try {
             VoucherUsageStatsResp stats = voucherUsageService.getUsageStats(voucherCode);
             if (stats == null) {
@@ -69,10 +62,9 @@ public class VoucherUsageController {
     }
 
     @GetMapping("/user/{faceId}/scenic/{scenicId}")
-    @Operation(summary = "获取用户在指定景区的券码使用记录")
     public ApiResponse<List<VoucherUsageRecordResp>> getUserUsageRecords(
-            @Parameter(description = "用户faceId") @PathVariable Long faceId,
+            @PathVariable Long faceId,
-            @Parameter(description = "景区ID") @PathVariable Long scenicId) {
+            @PathVariable Long scenicId) {
         try {
             List<VoucherUsageRecordResp> records = voucherUsageService.getUserUsageRecords(faceId, scenicId);
             return ApiResponse.success(records);
@@ -83,9 +75,8 @@ public class VoucherUsageController {
     }
 
     @GetMapping("/batch/{batchId}/stats")
-    @Operation(summary = "获取批次券码使用统计信息")
     public ApiResponse<List<VoucherUsageStatsResp>> getBatchUsageStats(
-            @Parameter(description = "批次ID") @PathVariable Long batchId) {
+            @PathVariable Long batchId) {
         try {
             List<VoucherUsageStatsResp> statsList = voucherUsageService.getBatchUsageStats(batchId);
             return ApiResponse.success(statsList);

src/main/java/com/ycwl/basic/pricing/mapper/PriceVoucherUsageRecordMapper.java

@@ -102,13 +102,13 @@ public interface PriceVoucherUsageRecordMapper extends BaseMapper<PriceVoucherUs
      * @return 分页结果
      */
     @Select("<script>" +
-            "SELECT * FROM price_voucher_usage_record WHERE deleted = 0 " +
+            "SELECT * FROM price_voucher_usage_record WHERE deleted = 0" +
-            "<if test='batchId != null'>AND batch_id = #{batchId}</if> " +
+            "<if test='batchId != null'>AND batch_id = #{batchId}</if>" +
-            "<if test='voucherCode != null and voucherCode != \"\"'>AND voucher_code LIKE CONCAT('%', #{voucherCode}, '%')</if> " +
+            "<if test=\"voucherCode != null and voucherCode.length() > 0\">AND voucher_code LIKE CONCAT('%', #{voucherCode}, '%')</if>" +
-            "<if test='faceId != null'>AND face_id = #{faceId}</if> " +
+            "<if test=\"faceId != null\">AND face_id = #{faceId}</if>" +
-            "<if test='scenicId != null'>AND scenic_id = #{scenicId}</if> " +
+            "<if test=\"scenicId != null\">AND scenic_id = #{scenicId}</if>" +
-            "<if test='startTime != null'>AND use_time >= #{startTime}</if> " +
+            "<if test=\"startTime != null\">AND use_time >= #{startTime}</if>" +
-            "<if test='endTime != null'>AND use_time <= #{endTime}</if> " +
+            "<if test=\"endTime != null\">AND use_time &lt;= #{endTime}</if>" +
             "ORDER BY use_time DESC" +
             "</script>")
     Page<PriceVoucherUsageRecord> selectPageWithConditions(Page<PriceVoucherUsageRecord> page,