From 02c7bf03fa071325c201d29353330152d35ac71a Mon Sep 17 00:00:00 2001
From: wenminjie <1036699586@qq.com>
Date: 星期四, 06 八月 2026 18:16:02 +0800
Subject: [PATCH] 小程序对接
---
talent-card-server/src/main/java/com/talentcard/server/business/admin/BenefitServiceCouponAdminController.java | 38 +++++++++++++++++++-------------------
1 files changed, 19 insertions(+), 19 deletions(-)
diff --git a/talent-card-server/src/main/java/com/talentcard/server/business/admin/BenefitServiceCouponAdminController.java b/talent-card-server/src/main/java/com/talentcard/server/business/admin/BenefitServiceCouponAdminController.java
index 3833646..2f0c3d8 100644
--- a/talent-card-server/src/main/java/com/talentcard/server/business/admin/BenefitServiceCouponAdminController.java
+++ b/talent-card-server/src/main/java/com/talentcard/server/business/admin/BenefitServiceCouponAdminController.java
@@ -26,7 +26,7 @@
@RestController
@RequestMapping("/api/admin/benefit-service-config/coupons")
-@Tag(name = "\u540e\u53f0-\u6743\u76ca\u670d\u52a1\u914d\u7f6e-\u4f18\u60e0\u5238\u7ba1\u7406", description = "\u7ba1\u7406\u4f18\u60e0\u5238\u7c7b\u578b\u3001\u9762\u989d\u3001\u9002\u7528\u5546\u6237\u3001\u6709\u6548\u671f\u3001\u53d1\u653e\u6279\u6b21\u53ca\u9886\u53d6/\u4f7f\u7528\u72b6\u6001")
+@Tag(name = "后台-权益服务配置-优惠券管理", description = "管理优惠券类型、面额、适用商户、有效期、发放批次及领取/使用状态")
public class BenefitServiceCouponAdminController {
private final MerchantCouponManagementService service;
@@ -35,61 +35,61 @@
}
@GetMapping
- @Operation(summary = "\u5206\u9875\u67e5\u8be2\u4f18\u60e0\u5238\u914d\u7f6e")
+ @Operation(summary = "分页查询优惠券配置")
public ApiResponse<PageResult<Map<String, Object>>> page(
- @Parameter(description = "\u9002\u7528\u5546\u6237ID") @RequestParam(required = false) Long merchantId,
- @Parameter(description = "\u4f18\u60e0\u5238\u7c7b\u578b") @RequestParam(required = false) String couponType,
- @Parameter(description = "\u53d1\u653e\u6279\u6b21\u53f7") @RequestParam(required = false) String batchNo,
- @Parameter(description = "\u72b6\u6001\uff1a0\u4e0b\u67b6\u30011\u4e0a\u67b6") @RequestParam(required = false) Integer status,
- @Parameter(description = "\u4f18\u60e0\u5238\u6216\u5546\u6237\u540d\u79f0\u5173\u952e\u8bcd") @RequestParam(required = false) String keyword,
- @Parameter(description = "\u67e5\u8be2\u6307\u5b9a\u65e5\u671f\u6709\u6548\u7684\u4f18\u60e0\u5238") @RequestParam(required = false) LocalDate validOn,
+ @Parameter(description = "适用商户ID") @RequestParam(required = false) Long merchantId,
+ @Parameter(description = "优惠券类型") @RequestParam(required = false) String couponType,
+ @Parameter(description = "发放批次号") @RequestParam(required = false) String batchNo,
+ @Parameter(description = "状态：0下架、1上架") @RequestParam(required = false) Integer status,
+ @Parameter(description = "优惠券或商户名称关键词") @RequestParam(required = false) String keyword,
+ @Parameter(description = "查询指定日期有效的优惠券") @RequestParam(required = false) LocalDate validOn,
@RequestParam(defaultValue = "1") int page,
@RequestParam(defaultValue = "10") int size) {
return ApiResponse.success(service.coupons(merchantId, couponType, batchNo, status, keyword, validOn, page, size));
}
@GetMapping("/{id}")
- @Operation(summary = "\u67e5\u8be2\u4f18\u60e0\u5238\u914d\u7f6e\u8be6\u60c5")
+ @Operation(summary = "查询优惠券配置详情")
public ApiResponse<Map<String, Object>> detail(@PathVariable Long id) {
return ApiResponse.success(service.coupon(id));
}
@PostMapping
- @Operation(summary = "\u65b0\u589e\u4f18\u60e0\u5238\u914d\u7f6e")
+ @Operation(summary = "新增优惠券配置")
public ApiResponse<Map<String, Object>> create(@Valid @RequestBody CouponManagementSaveRequest request) {
return ApiResponse.success(service.createCoupon(request));
}
@PutMapping("/{id}")
- @Operation(summary = "\u4fee\u6539\u4f18\u60e0\u5238\u914d\u7f6e")
+ @Operation(summary = "修改优惠券配置")
public ApiResponse<Map<String, Object>> update(@PathVariable Long id,
@Valid @RequestBody CouponManagementSaveRequest request) {
return ApiResponse.success(service.updateCoupon(id, request));
}
@PatchMapping("/{id}/status")
- @Operation(summary = "\u4f18\u60e0\u5238\u4e0a\u67b6\u6216\u4e0b\u67b6")
+ @Operation(summary = "优惠券上架或下架")
public ApiResponse<Map<String, Object>> status(@PathVariable Long id,
@Valid @RequestBody CouponManagementStatusRequest request) {
return ApiResponse.success(service.updateCouponStatus(id, request.status()));
}
@PostMapping("/{id}/claims")
- @Operation(summary = "\u540e\u53f0\u53d1\u653e\u4f18\u60e0\u5238", description = "\u6309\u53d1\u653e\u6279\u6b21\u548c\u53d1\u653e\u603b\u91cf\u4e3a\u6307\u5b9a\u6301\u5361\u4eba\u751f\u6210\u9886\u53d6\u8bb0\u5f55")
+ @Operation(summary = "后台发放优惠券", description = "按发放批次和发放总量为指定持卡人生成领取记录")
public ApiResponse<Map<String, Object>> issue(@PathVariable Long id,
@Valid @RequestBody CouponClaimIssueRequest request) {
return ApiResponse.success(service.issue(id, request));
}
@GetMapping("/claims")
- @Operation(summary = "\u5206\u9875\u67e5\u8be2\u4f18\u60e0\u5238\u9886\u53d6\u548c\u4f7f\u7528\u8bb0\u5f55")
+ @Operation(summary = "分页查询优惠券领取和使用记录")
public ApiResponse<PageResult<Map<String, Object>>> claims(
@RequestParam(required = false) Long couponId,
@RequestParam(required = false) Long merchantId,
@RequestParam(required = false) String batchNo,
- @Parameter(description = "\u9886\u53d6\u72b6\u6001\uff1a0\u5f85\u9886\u53d6\u30011\u5df2\u9886\u53d6\u30012\u5df2\u53d6\u6d88") @RequestParam(required = false) Integer claimStatus,
- @Parameter(description = "\u4f7f\u7528\u72b6\u6001\uff1a0\u672a\u4f7f\u7528\u30011\u5df2\u4f7f\u7528\u30012\u5df2\u8fc7\u671f\u30013\u5df2\u4f5c\u5e9f") @RequestParam(required = false) Integer useStatus,
- @Parameter(description = "\u9886\u53d6\u7f16\u53f7/\u6301\u5361\u4eba/\u624b\u673a\u53f7/\u5361\u53f7\u5173\u952e\u8bcd") @RequestParam(required = false) String keyword,
+ @Parameter(description = "领取状态：0待领取、1已领取、2已取消") @RequestParam(required = false) Integer claimStatus,
+ @Parameter(description = "使用状态：0未使用、1已使用、2已过期、3已作废") @RequestParam(required = false) Integer useStatus,
+ @Parameter(description = "领取编号/持卡人/手机号/卡号关键词") @RequestParam(required = false) String keyword,
@RequestParam(required = false) LocalDate startDate,
@RequestParam(required = false) LocalDate endDate,
@RequestParam(defaultValue = "1") int page,
@@ -99,13 +99,13 @@
}
@GetMapping("/claims/{claimId}")
- @Operation(summary = "\u67e5\u8be2\u4f18\u60e0\u5238\u9886\u53d6\u8bb0\u5f55\u8be6\u60c5")
+ @Operation(summary = "查询优惠券领取记录详情")
public ApiResponse<Map<String, Object>> claim(@PathVariable Long claimId) {
return ApiResponse.success(service.claim(claimId));
}
@PatchMapping("/claims/{claimId}/status")
- @Operation(summary = "\u7ef4\u62a4\u4f18\u60e0\u5238\u9886\u53d6\u548c\u4f7f\u7528\u72b6\u6001")
+ @Operation(summary = "维护优惠券领取和使用状态")
public ApiResponse<Map<String, Object>> claimStatus(@PathVariable Long claimId,
@Valid @RequestBody CouponClaimStatusRequest request) {
return ApiResponse.success(service.updateClaimStatus(claimId, request));
--
Gitblit v1.7.1