Commit 979ba0f9161f36e76aeb14486f1549c9180669c0
1 parent
035c2cf2
promotion:实现优惠劵模板的逻辑
Showing
14 changed files
with
699 additions
and
8 deletions
yudao-module-mall/yudao-module-promotion-api/src/main/java/cn/iocoder/yudao/module/promotion/enums/ErrorCodeConstants.java
| ... | ... | @@ -19,4 +19,8 @@ public interface ErrorCodeConstants { |
| 19 | 19 | ErrorCode COUPON_NO_MATCH_SPU = new ErrorCode(1003003000, "优惠劵没有可使用的商品!"); |
| 20 | 20 | ErrorCode COUPON_NO_MATCH_MIN_PRICE = new ErrorCode(1003003000, "不满足优惠劵使用的最低金额"); |
| 21 | 21 | |
| 22 | + // ========== 优惠劵模板 1003004000 ========== | |
| 23 | + ErrorCode COUPON_TEMPLATE_NOT_EXISTS = new ErrorCode(1003004000, "优惠劵模板不存在"); | |
| 24 | + ErrorCode COUPON_TEMPLATE_TOTAL_COUNT_TOO_SMALL = new ErrorCode(1003004001, "发放数量不能小于已领取数量({})"); | |
| 25 | + | |
| 22 | 26 | } | ... | ... |
yudao-module-mall/yudao-module-promotion-api/src/main/java/cn/iocoder/yudao/module/promotion/enums/coupon/CouponTemplateValidityTypeEnum.java
| ... | ... | @@ -15,8 +15,8 @@ import java.util.Arrays; |
| 15 | 15 | @Getter |
| 16 | 16 | public enum CouponTemplateValidityTypeEnum implements IntArrayValuable { |
| 17 | 17 | |
| 18 | - FIXED_DATE(1, "固定日期"), | |
| 19 | - FIXED_TERM_TODAY(2, "领取日期"), | |
| 18 | + DATE(1, "固定日期可用"), | |
| 19 | + TERM(2, "领取之后可用"), | |
| 20 | 20 | ; |
| 21 | 21 | |
| 22 | 22 | public static final int[] ARRAYS = Arrays.stream(values()).mapToInt(CouponTemplateValidityTypeEnum::getType).toArray(); | ... | ... |
yudao-module-mall/yudao-module-promotion-biz/src/main/java/cn/iocoder/yudao/module/promotion/controller/admin/coupon/CouponTemplateController.java
0 → 100755
| 1 | +package cn.iocoder.yudao.module.promotion.controller.admin.coupon; | |
| 2 | + | |
| 3 | +import cn.iocoder.yudao.framework.common.pojo.CommonResult; | |
| 4 | +import cn.iocoder.yudao.framework.common.pojo.PageResult; | |
| 5 | +import cn.iocoder.yudao.module.promotion.controller.admin.coupon.vo.CouponTemplateCreateReqVO; | |
| 6 | +import cn.iocoder.yudao.module.promotion.controller.admin.coupon.vo.CouponTemplatePageReqVO; | |
| 7 | +import cn.iocoder.yudao.module.promotion.controller.admin.coupon.vo.CouponTemplateRespVO; | |
| 8 | +import cn.iocoder.yudao.module.promotion.controller.admin.coupon.vo.CouponTemplateUpdateReqVO; | |
| 9 | +import cn.iocoder.yudao.module.promotion.convert.coupon.CouponTemplateConvert; | |
| 10 | +import cn.iocoder.yudao.module.promotion.dal.dataobject.coupon.CouponTemplateDO; | |
| 11 | +import cn.iocoder.yudao.module.promotion.service.coupon.CouponTemplateService; | |
| 12 | +import io.swagger.annotations.Api; | |
| 13 | +import io.swagger.annotations.ApiImplicitParam; | |
| 14 | +import io.swagger.annotations.ApiOperation; | |
| 15 | +import org.springframework.security.access.prepost.PreAuthorize; | |
| 16 | +import org.springframework.validation.annotation.Validated; | |
| 17 | +import org.springframework.web.bind.annotation.*; | |
| 18 | + | |
| 19 | +import javax.annotation.Resource; | |
| 20 | +import javax.validation.Valid; | |
| 21 | + | |
| 22 | +import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success; | |
| 23 | + | |
| 24 | +@Api(tags = "管理后台 - 优惠劵模板") | |
| 25 | +@RestController | |
| 26 | +@RequestMapping("/promotion/coupon-template") | |
| 27 | +@Validated | |
| 28 | +public class CouponTemplateController { | |
| 29 | + | |
| 30 | + @Resource | |
| 31 | + private CouponTemplateService couponTemplateService; | |
| 32 | + | |
| 33 | + @PostMapping("/create") | |
| 34 | + @ApiOperation("创建优惠劵模板") | |
| 35 | + @PreAuthorize("@ss.hasPermission('promotion:coupon-template:create')") | |
| 36 | + public CommonResult<Long> createCouponTemplate(@Valid @RequestBody CouponTemplateCreateReqVO createReqVO) { | |
| 37 | + return success(couponTemplateService.createCouponTemplate(createReqVO)); | |
| 38 | + } | |
| 39 | + | |
| 40 | + @PutMapping("/update") | |
| 41 | + @ApiOperation("更新优惠劵模板") | |
| 42 | + @PreAuthorize("@ss.hasPermission('promotion:coupon-template:update')") | |
| 43 | + public CommonResult<Boolean> updateCouponTemplate(@Valid @RequestBody CouponTemplateUpdateReqVO updateReqVO) { | |
| 44 | + couponTemplateService.updateCouponTemplate(updateReqVO); | |
| 45 | + return success(true); | |
| 46 | + } | |
| 47 | + | |
| 48 | + @DeleteMapping("/delete") | |
| 49 | + @ApiOperation("删除优惠劵模板") | |
| 50 | + @ApiImplicitParam(name = "id", value = "编号", required = true, dataTypeClass = Long.class) | |
| 51 | + @PreAuthorize("@ss.hasPermission('promotion:coupon-template:delete')") | |
| 52 | + public CommonResult<Boolean> deleteCouponTemplate(@RequestParam("id") Long id) { | |
| 53 | + couponTemplateService.deleteCouponTemplate(id); | |
| 54 | + return success(true); | |
| 55 | + } | |
| 56 | + | |
| 57 | + @GetMapping("/get") | |
| 58 | + @ApiOperation("获得优惠劵模板") | |
| 59 | + @ApiImplicitParam(name = "id", value = "编号", required = true, example = "1024", dataTypeClass = Long.class) | |
| 60 | + @PreAuthorize("@ss.hasPermission('promotion:coupon-template:query')") | |
| 61 | + public CommonResult<CouponTemplateRespVO> getCouponTemplate(@RequestParam("id") Long id) { | |
| 62 | + CouponTemplateDO couponTemplate = couponTemplateService.getCouponTemplate(id); | |
| 63 | + return success(CouponTemplateConvert.INSTANCE.convert(couponTemplate)); | |
| 64 | + } | |
| 65 | + | |
| 66 | + @GetMapping("/page") | |
| 67 | + @ApiOperation("获得优惠劵模板分页") | |
| 68 | + @PreAuthorize("@ss.hasPermission('promotion:coupon-template:query')") | |
| 69 | + public CommonResult<PageResult<CouponTemplateRespVO>> getCouponTemplatePage(@Valid CouponTemplatePageReqVO pageVO) { | |
| 70 | + PageResult<CouponTemplateDO> pageResult = couponTemplateService.getCouponTemplatePage(pageVO); | |
| 71 | + return success(CouponTemplateConvert.INSTANCE.convertPage(pageResult)); | |
| 72 | + } | |
| 73 | + | |
| 74 | +} | ... | ... |
yudao-module-mall/yudao-module-promotion-biz/src/main/java/cn/iocoder/yudao/module/promotion/controller/admin/coupon/vo/CouponTemplateBaseVO.java
0 → 100755
| 1 | +package cn.iocoder.yudao.module.promotion.controller.admin.coupon.vo; | |
| 2 | + | |
| 3 | +import cn.hutool.core.collection.CollUtil; | |
| 4 | +import cn.hutool.core.util.ObjectUtil; | |
| 5 | +import cn.iocoder.yudao.framework.common.validation.InEnum; | |
| 6 | +import cn.iocoder.yudao.module.promotion.enums.common.PromotionDiscountTypeEnum; | |
| 7 | +import cn.iocoder.yudao.module.promotion.enums.common.PromotionProductScopeEnum; | |
| 8 | +import cn.iocoder.yudao.module.promotion.enums.coupon.CouponTemplateValidityTypeEnum; | |
| 9 | +import io.swagger.annotations.ApiModelProperty; | |
| 10 | +import lombok.Data; | |
| 11 | +import org.springframework.format.annotation.DateTimeFormat; | |
| 12 | + | |
| 13 | +import javax.validation.constraints.AssertTrue; | |
| 14 | +import javax.validation.constraints.Min; | |
| 15 | +import javax.validation.constraints.NotNull; | |
| 16 | +import java.util.Date; | |
| 17 | +import java.util.List; | |
| 18 | +import java.util.Objects; | |
| 19 | + | |
| 20 | +import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND; | |
| 21 | + | |
| 22 | +/** | |
| 23 | +* 优惠劵模板 Base VO,提供给添加、修改、详细的子 VO 使用 | |
| 24 | +* 如果子 VO 存在差异的字段,请不要添加到这里,影响 Swagger 文档生成 | |
| 25 | +*/ | |
| 26 | +@Data | |
| 27 | +public class CouponTemplateBaseVO { | |
| 28 | + | |
| 29 | + @ApiModelProperty(value = "优惠劵名", required = true, example = "春节送送送") | |
| 30 | + @NotNull(message = "优惠劵名不能为空") | |
| 31 | + private String name; | |
| 32 | + | |
| 33 | + @ApiModelProperty(value = "发行总量", required = true, example = "1024", notes = "-1 - 则表示不限制发放数量") | |
| 34 | + @NotNull(message = "发行总量不能为空") | |
| 35 | + private Integer totalCount; | |
| 36 | + | |
| 37 | + @ApiModelProperty(value = "每人限领个数", required = true, example = "66", notes = "-1 - 则表示不限制") | |
| 38 | + @NotNull(message = "每人限领个数不能为空") | |
| 39 | + private Integer takeLimitCount; | |
| 40 | + | |
| 41 | + @ApiModelProperty(value = "领取方式", required = true, example = "1", notes = "参见 CouponTakeTypeEnum 枚举类") | |
| 42 | + @NotNull(message = "领取方式不能为空") | |
| 43 | + private Integer takeType; | |
| 44 | + | |
| 45 | + @ApiModelProperty(value = "是否设置满多少金额可用", required = true, example = "100", notes = "单位:分;0 - 不限制") | |
| 46 | + @NotNull(message = "是否设置满多少金额可用不能为空") | |
| 47 | + private Integer usePrice; | |
| 48 | + | |
| 49 | + @ApiModelProperty(value = "商品范围", required = true, example = "1", notes = "参见 PromotionProductScopeEnum 枚举类") | |
| 50 | + @NotNull(message = "商品范围不能为空") | |
| 51 | + @InEnum(PromotionProductScopeEnum.class) | |
| 52 | + private Integer productScope; | |
| 53 | + | |
| 54 | + @ApiModelProperty(value = "商品 SPU 编号的数组", example = "1,3") | |
| 55 | + private List<Long> productSpuIds; | |
| 56 | + | |
| 57 | + @ApiModelProperty(value = "生效日期类型", required = true, example = "1") | |
| 58 | + @NotNull(message = "生效日期类型不能为空") | |
| 59 | + @InEnum(CouponTemplateValidityTypeEnum.class) | |
| 60 | + private Integer validityType; | |
| 61 | + | |
| 62 | + @ApiModelProperty(value = "固定日期 - 生效开始时间") | |
| 63 | + @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND) | |
| 64 | + private Date validStartTime; | |
| 65 | + | |
| 66 | + @ApiModelProperty(value = "固定日期 - 生效结束时间") | |
| 67 | + @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND) | |
| 68 | + private Date validEndTime; | |
| 69 | + | |
| 70 | + @ApiModelProperty(value = "领取日期 - 开始天数") | |
| 71 | + @Min(value = 0L, message = "开始天数必须大于 0") | |
| 72 | + private Integer fixedStartTerm; | |
| 73 | + | |
| 74 | + @ApiModelProperty(value = "领取日期 - 结束天数") | |
| 75 | + @Min(value = 1L, message = "开始天数必须大于 1") | |
| 76 | + private Integer fixedEndTerm; | |
| 77 | + | |
| 78 | + @ApiModelProperty(value = "优惠类型", required = true, example = "1", notes = "参见 PromotionDiscountTypeEnum 枚举") | |
| 79 | + @NotNull(message = "优惠类型不能为空") | |
| 80 | + @InEnum(PromotionDiscountTypeEnum.class) | |
| 81 | + private Integer discountType; | |
| 82 | + | |
| 83 | + @ApiModelProperty(value = "折扣百分比", example = "80", notes = "例如说,80% 为 80") | |
| 84 | + @Min(value = 1) | |
| 85 | + private Integer discountPercent; | |
| 86 | + | |
| 87 | + @ApiModelProperty(value = "优惠金额", example = "10", notes = "单位:分") | |
| 88 | + @Min(value = 1) | |
| 89 | + private Integer discountPrice; | |
| 90 | + | |
| 91 | + @ApiModelProperty(value = "折扣上限", example = "100", notes = "单位:分,仅在 discountType 为 PERCENT 使用") | |
| 92 | + private Integer discountPriceLimit; | |
| 93 | + | |
| 94 | + @AssertTrue(message = "商品 SPU 编号的数组不能为空") | |
| 95 | + public boolean isProductSpuIdsValid() { | |
| 96 | + return Objects.equals(productScope, PromotionProductScopeEnum.ALL.getScope()) // 全部范围时,可以为空 | |
| 97 | + || CollUtil.isNotEmpty(productSpuIds); | |
| 98 | + } | |
| 99 | + | |
| 100 | + @AssertTrue(message = "生效开始时间不能为空") | |
| 101 | + public boolean isValidStartTimeValid() { | |
| 102 | + return ObjectUtil.notEqual(validityType, CouponTemplateValidityTypeEnum.DATE.getType()) | |
| 103 | + || validStartTime != null; | |
| 104 | + } | |
| 105 | + | |
| 106 | + @AssertTrue(message = "生效结束时间不能为空") | |
| 107 | + public boolean isValidEndTimeValid() { | |
| 108 | + return ObjectUtil.notEqual(validityType, CouponTemplateValidityTypeEnum.DATE.getType()) | |
| 109 | + || validEndTime != null; | |
| 110 | + } | |
| 111 | + | |
| 112 | + @AssertTrue(message = "开始天数不能为空") | |
| 113 | + public boolean isFixedStartTermValid() { | |
| 114 | + return ObjectUtil.notEqual(validityType, CouponTemplateValidityTypeEnum.TERM.getType()) | |
| 115 | + || fixedStartTerm != null; | |
| 116 | + } | |
| 117 | + | |
| 118 | + @AssertTrue(message = "结束天数不能为空") | |
| 119 | + public boolean isFixedEndTermValid() { | |
| 120 | + return ObjectUtil.notEqual(validityType, CouponTemplateValidityTypeEnum.TERM.getType()) | |
| 121 | + || fixedEndTerm != null; | |
| 122 | + } | |
| 123 | + | |
| 124 | + @AssertTrue(message = "折扣百分比不能为空") | |
| 125 | + public boolean isDiscountPercentValid() { | |
| 126 | + return ObjectUtil.notEqual(discountType, PromotionDiscountTypeEnum.PERCENT.getType()) | |
| 127 | + || discountPercent != null; | |
| 128 | + } | |
| 129 | + | |
| 130 | + @AssertTrue(message = "优惠金额不能为空") | |
| 131 | + public boolean isDiscountPriceValid() { | |
| 132 | + return ObjectUtil.notEqual(discountType, PromotionDiscountTypeEnum.PRICE.getType()) | |
| 133 | + || discountPrice != null; | |
| 134 | + } | |
| 135 | + | |
| 136 | + @AssertTrue(message = "折扣上限不能为空") | |
| 137 | + public boolean isDiscountPriceLimit() { | |
| 138 | + return ObjectUtil.notEqual(discountType, PromotionDiscountTypeEnum.PERCENT.getType()) | |
| 139 | + || discountPriceLimit != null; | |
| 140 | + } | |
| 141 | + | |
| 142 | +} | ... | ... |
yudao-module-mall/yudao-module-promotion-biz/src/main/java/cn/iocoder/yudao/module/promotion/controller/admin/coupon/vo/CouponTemplateCreateReqVO.java
0 → 100755
| 1 | +package cn.iocoder.yudao.module.promotion.controller.admin.coupon.vo; | |
| 2 | + | |
| 3 | +import io.swagger.annotations.ApiModel; | |
| 4 | +import lombok.Data; | |
| 5 | +import lombok.EqualsAndHashCode; | |
| 6 | +import lombok.ToString; | |
| 7 | + | |
| 8 | +@ApiModel("管理后台 - 优惠劵模板创建 Request VO") | |
| 9 | +@Data | |
| 10 | +@EqualsAndHashCode(callSuper = true) | |
| 11 | +@ToString(callSuper = true) | |
| 12 | +public class CouponTemplateCreateReqVO extends CouponTemplateBaseVO { | |
| 13 | + | |
| 14 | +} | ... | ... |
yudao-module-mall/yudao-module-promotion-biz/src/main/java/cn/iocoder/yudao/module/promotion/controller/admin/coupon/vo/CouponTemplatePageReqVO.java
0 → 100755
| 1 | +package cn.iocoder.yudao.module.promotion.controller.admin.coupon.vo; | |
| 2 | + | |
| 3 | +import cn.iocoder.yudao.framework.common.pojo.PageParam; | |
| 4 | +import cn.iocoder.yudao.framework.common.validation.InEnum; | |
| 5 | +import cn.iocoder.yudao.module.promotion.enums.common.PromotionDiscountTypeEnum; | |
| 6 | +import io.swagger.annotations.ApiModel; | |
| 7 | +import io.swagger.annotations.ApiModelProperty; | |
| 8 | +import lombok.Data; | |
| 9 | +import lombok.EqualsAndHashCode; | |
| 10 | +import lombok.ToString; | |
| 11 | +import org.springframework.format.annotation.DateTimeFormat; | |
| 12 | + | |
| 13 | +import javax.validation.constraints.NotNull; | |
| 14 | +import java.util.Date; | |
| 15 | + | |
| 16 | +import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND; | |
| 17 | + | |
| 18 | +@ApiModel("管理后台 - 优惠劵模板分页 Request VO") | |
| 19 | +@Data | |
| 20 | +@EqualsAndHashCode(callSuper = true) | |
| 21 | +@ToString(callSuper = true) | |
| 22 | +public class CouponTemplatePageReqVO extends PageParam { | |
| 23 | + | |
| 24 | + @ApiModelProperty(value = "优惠劵名", example = "你好") | |
| 25 | + private String name; | |
| 26 | + | |
| 27 | + @ApiModelProperty(value = "状态", example = "1", notes = "参见 CommonStatusEnum 枚举类") | |
| 28 | + private Integer status; | |
| 29 | + | |
| 30 | + @ApiModelProperty(value = "优惠类型", example = "1", notes = "参见 PromotionDiscountTypeEnum 枚举") | |
| 31 | + private Integer discountType; | |
| 32 | + | |
| 33 | + @ApiModelProperty(value = "创建时间") | |
| 34 | + @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND) | |
| 35 | + private Date[] createTime; | |
| 36 | + | |
| 37 | +} | ... | ... |
yudao-module-mall/yudao-module-promotion-biz/src/main/java/cn/iocoder/yudao/module/promotion/controller/admin/coupon/vo/CouponTemplateRespVO.java
0 → 100755
| 1 | +package cn.iocoder.yudao.module.promotion.controller.admin.coupon.vo; | |
| 2 | + | |
| 3 | +import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum; | |
| 4 | +import cn.iocoder.yudao.framework.common.validation.InEnum; | |
| 5 | +import io.swagger.annotations.ApiModel; | |
| 6 | +import io.swagger.annotations.ApiModelProperty; | |
| 7 | +import lombok.Data; | |
| 8 | +import lombok.EqualsAndHashCode; | |
| 9 | +import lombok.ToString; | |
| 10 | + | |
| 11 | +import java.util.Date; | |
| 12 | + | |
| 13 | +@ApiModel("管理后台 - 优惠劵模板 Response VO") | |
| 14 | +@Data | |
| 15 | +@EqualsAndHashCode(callSuper = true) | |
| 16 | +@ToString(callSuper = true) | |
| 17 | +public class CouponTemplateRespVO extends CouponTemplateBaseVO { | |
| 18 | + | |
| 19 | + @ApiModelProperty(value = "模板编号", required = true, example = "1024") | |
| 20 | + private Long id; | |
| 21 | + | |
| 22 | + @ApiModelProperty(value = "状态", required = true, example = "1") | |
| 23 | + @InEnum(CommonStatusEnum.class) | |
| 24 | + private Integer status; | |
| 25 | + | |
| 26 | + @ApiModelProperty(value = "领取优惠券的数量", required = true, example = "1024") | |
| 27 | + private Integer takeNum; | |
| 28 | + | |
| 29 | + @ApiModelProperty(value = "使用优惠券的次数", required = true, example = "2048") | |
| 30 | + private Integer useCount; | |
| 31 | + | |
| 32 | + @ApiModelProperty(value = "创建时间", required = true) | |
| 33 | + private Date createTime; | |
| 34 | + | |
| 35 | +} | ... | ... |
yudao-module-mall/yudao-module-promotion-biz/src/main/java/cn/iocoder/yudao/module/promotion/controller/admin/coupon/vo/CouponTemplateUpdateReqVO.java
0 → 100755
| 1 | +package cn.iocoder.yudao.module.promotion.controller.admin.coupon.vo; | |
| 2 | + | |
| 3 | +import io.swagger.annotations.ApiModel; | |
| 4 | +import io.swagger.annotations.ApiModelProperty; | |
| 5 | +import lombok.Data; | |
| 6 | +import lombok.EqualsAndHashCode; | |
| 7 | +import lombok.ToString; | |
| 8 | + | |
| 9 | +import javax.validation.constraints.NotNull; | |
| 10 | + | |
| 11 | +@ApiModel("管理后台 - 优惠劵模板更新 Request VO") | |
| 12 | +@Data | |
| 13 | +@EqualsAndHashCode(callSuper = true) | |
| 14 | +@ToString(callSuper = true) | |
| 15 | +public class CouponTemplateUpdateReqVO extends CouponTemplateBaseVO { | |
| 16 | + | |
| 17 | + @ApiModelProperty(value = "模板编号", required = true, example = "1024") | |
| 18 | + @NotNull(message = "模板编号不能为空") | |
| 19 | + private Long id; | |
| 20 | + | |
| 21 | +} | ... | ... |
yudao-module-mall/yudao-module-promotion-biz/src/main/java/cn/iocoder/yudao/module/promotion/convert/coupon/CouponTemplateConvert.java
0 → 100755
| 1 | +package cn.iocoder.yudao.module.promotion.convert.coupon; | |
| 2 | + | |
| 3 | +import cn.iocoder.yudao.framework.common.pojo.PageResult; | |
| 4 | +import cn.iocoder.yudao.module.promotion.controller.admin.coupon.vo.CouponTemplateCreateReqVO; | |
| 5 | +import cn.iocoder.yudao.module.promotion.controller.admin.coupon.vo.CouponTemplateRespVO; | |
| 6 | +import cn.iocoder.yudao.module.promotion.controller.admin.coupon.vo.CouponTemplateUpdateReqVO; | |
| 7 | +import cn.iocoder.yudao.module.promotion.dal.dataobject.coupon.CouponTemplateDO; | |
| 8 | +import org.mapstruct.Mapper; | |
| 9 | +import org.mapstruct.factory.Mappers; | |
| 10 | + | |
| 11 | +/** | |
| 12 | + * 优惠劵模板 Convert | |
| 13 | + * | |
| 14 | + * @author 芋道源码 | |
| 15 | + */ | |
| 16 | +@Mapper | |
| 17 | +public interface CouponTemplateConvert { | |
| 18 | + | |
| 19 | + CouponTemplateConvert INSTANCE = Mappers.getMapper(CouponTemplateConvert.class); | |
| 20 | + | |
| 21 | + CouponTemplateDO convert(CouponTemplateCreateReqVO bean); | |
| 22 | + | |
| 23 | + CouponTemplateDO convert(CouponTemplateUpdateReqVO bean); | |
| 24 | + | |
| 25 | + CouponTemplateRespVO convert(CouponTemplateDO bean); | |
| 26 | + | |
| 27 | + PageResult<CouponTemplateRespVO> convertPage(PageResult<CouponTemplateDO> page); | |
| 28 | + | |
| 29 | +} | ... | ... |
yudao-module-mall/yudao-module-promotion-biz/src/main/java/cn/iocoder/yudao/module/promotion/dal/dataobject/coupon/CouponTemplateDO.java
| ... | ... | @@ -73,7 +73,7 @@ public class CouponTemplateDO extends BaseDO { |
| 73 | 73 | * 是否设置满多少金额可用,单位:分 |
| 74 | 74 | * |
| 75 | 75 | * 0 - 不限制 |
| 76 | - * 大于0 - 多少金额可用 | |
| 76 | + * 大于 0 - 多少金额可用 | |
| 77 | 77 | */ |
| 78 | 78 | private Integer usePrice; |
| 79 | 79 | /** |
| ... | ... | @@ -96,19 +96,19 @@ public class CouponTemplateDO extends BaseDO { |
| 96 | 96 | /** |
| 97 | 97 | * 固定日期 - 生效开始时间 |
| 98 | 98 | * |
| 99 | - * 当 {@link #validityType} 为 {@link CouponTemplateValidityTypeEnum#FIXED_DATE} | |
| 99 | + * 当 {@link #validityType} 为 {@link CouponTemplateValidityTypeEnum#DATE} | |
| 100 | 100 | */ |
| 101 | 101 | private Date validStartTime; |
| 102 | 102 | /** |
| 103 | 103 | * 固定日期 - 生效结束时间 |
| 104 | 104 | * |
| 105 | - * 当 {@link #validityType} 为 {@link CouponTemplateValidityTypeEnum#FIXED_DATE} | |
| 105 | + * 当 {@link #validityType} 为 {@link CouponTemplateValidityTypeEnum#DATE} | |
| 106 | 106 | */ |
| 107 | 107 | private Date validEndTime; |
| 108 | 108 | /** |
| 109 | 109 | * 领取日期 - 结束天数 |
| 110 | 110 | * |
| 111 | - * 当 {@link #validityType} 为 {@link CouponTemplateValidityTypeEnum#FIXED_TERM_TODAY} | |
| 111 | + * 当 {@link #validityType} 为 {@link CouponTemplateValidityTypeEnum#TERM} | |
| 112 | 112 | */ |
| 113 | 113 | private Integer fixedEndTerm; |
| 114 | 114 | // ========== 使用规则 END ========== |
| ... | ... | @@ -129,11 +129,11 @@ public class CouponTemplateDO extends BaseDO { |
| 129 | 129 | /** |
| 130 | 130 | * 优惠金额,单位:分 |
| 131 | 131 | * |
| 132 | - * 当 {@link #discountType} 为 {@link PromotionDiscountTypeEnum#PRICE} | |
| 132 | + * 当 {@link #discountType} 为 {@link PromotionDiscountTypeEnum#PRICE} 生效 | |
| 133 | 133 | */ |
| 134 | 134 | private Integer discountPrice; |
| 135 | 135 | /** |
| 136 | - * 折扣上限,仅在 {@link #discountType} 等于 {@link PromotionDiscountTypeEnum#PRICE} 时生效 | |
| 136 | + * 折扣上限,仅在 {@link #discountType} 等于 {@link PromotionDiscountTypeEnum#PERCENT} 时生效 | |
| 137 | 137 | * |
| 138 | 138 | * 例如,折扣上限为 20 元,当使用 8 折优惠券,订单金额为 1000 元时,最高只可折扣 20 元,而非 80 元。 |
| 139 | 139 | */ | ... | ... |
yudao-module-mall/yudao-module-promotion-biz/src/main/java/cn/iocoder/yudao/module/promotion/dal/mysql/coupon/CouponTemplateMapper.java
0 → 100755
| 1 | +package cn.iocoder.yudao.module.promotion.dal.mysql.coupon; | |
| 2 | + | |
| 3 | +import cn.iocoder.yudao.framework.common.pojo.PageResult; | |
| 4 | +import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX; | |
| 5 | +import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX; | |
| 6 | +import cn.iocoder.yudao.module.promotion.controller.admin.coupon.vo.CouponTemplatePageReqVO; | |
| 7 | +import cn.iocoder.yudao.module.promotion.dal.dataobject.coupon.CouponTemplateDO; | |
| 8 | +import org.apache.ibatis.annotations.Mapper; | |
| 9 | + | |
| 10 | +/** | |
| 11 | + * 优惠劵模板 Mapper | |
| 12 | + * | |
| 13 | + * @author 芋道源码 | |
| 14 | + */ | |
| 15 | +@Mapper | |
| 16 | +public interface CouponTemplateMapper extends BaseMapperX<CouponTemplateDO> { | |
| 17 | + | |
| 18 | + default PageResult<CouponTemplateDO> selectPage(CouponTemplatePageReqVO reqVO) { | |
| 19 | + return selectPage(reqVO, new LambdaQueryWrapperX<CouponTemplateDO>() | |
| 20 | + .likeIfPresent(CouponTemplateDO::getName, reqVO.getName()) | |
| 21 | + .eqIfPresent(CouponTemplateDO::getStatus, reqVO.getStatus()) | |
| 22 | + .eqIfPresent(CouponTemplateDO::getDiscountType, reqVO.getDiscountType()) | |
| 23 | + .betweenIfPresent(CouponTemplateDO::getCreateTime, reqVO.getCreateTime()) | |
| 24 | + .orderByDesc(CouponTemplateDO::getId)); | |
| 25 | + } | |
| 26 | + | |
| 27 | +} | ... | ... |
yudao-module-mall/yudao-module-promotion-biz/src/main/java/cn/iocoder/yudao/module/promotion/service/coupon/CouponTemplateService.java
0 → 100755
| 1 | +package cn.iocoder.yudao.module.promotion.service.coupon; | |
| 2 | + | |
| 3 | +import cn.iocoder.yudao.framework.common.pojo.PageResult; | |
| 4 | +import cn.iocoder.yudao.module.promotion.controller.admin.coupon.vo.CouponTemplateCreateReqVO; | |
| 5 | +import cn.iocoder.yudao.module.promotion.controller.admin.coupon.vo.CouponTemplatePageReqVO; | |
| 6 | +import cn.iocoder.yudao.module.promotion.controller.admin.coupon.vo.CouponTemplateUpdateReqVO; | |
| 7 | +import cn.iocoder.yudao.module.promotion.dal.dataobject.coupon.CouponTemplateDO; | |
| 8 | + | |
| 9 | +import javax.validation.Valid; | |
| 10 | + | |
| 11 | +/** | |
| 12 | + * 优惠劵模板 Service 接口 | |
| 13 | + * | |
| 14 | + * @author 芋道源码 | |
| 15 | + */ | |
| 16 | +public interface CouponTemplateService { | |
| 17 | + | |
| 18 | + /** | |
| 19 | + * 创建优惠劵模板 | |
| 20 | + * | |
| 21 | + * @param createReqVO 创建信息 | |
| 22 | + * @return 编号 | |
| 23 | + */ | |
| 24 | + Long createCouponTemplate(@Valid CouponTemplateCreateReqVO createReqVO); | |
| 25 | + | |
| 26 | + /** | |
| 27 | + * 更新优惠劵模板 | |
| 28 | + * | |
| 29 | + * @param updateReqVO 更新信息 | |
| 30 | + */ | |
| 31 | + void updateCouponTemplate(@Valid CouponTemplateUpdateReqVO updateReqVO); | |
| 32 | + | |
| 33 | + /** | |
| 34 | + * 删除优惠劵模板 | |
| 35 | + * | |
| 36 | + * @param id 编号 | |
| 37 | + */ | |
| 38 | + void deleteCouponTemplate(Long id); | |
| 39 | + | |
| 40 | + /** | |
| 41 | + * 获得优惠劵模板 | |
| 42 | + * | |
| 43 | + * @param id 编号 | |
| 44 | + * @return 优惠劵模板 | |
| 45 | + */ | |
| 46 | + CouponTemplateDO getCouponTemplate(Long id); | |
| 47 | + | |
| 48 | + /** | |
| 49 | + * 获得优惠劵模板分页 | |
| 50 | + * | |
| 51 | + * @param pageReqVO 分页查询 | |
| 52 | + * @return 优惠劵模板分页 | |
| 53 | + */ | |
| 54 | + PageResult<CouponTemplateDO> getCouponTemplatePage(CouponTemplatePageReqVO pageReqVO); | |
| 55 | + | |
| 56 | +} | ... | ... |
yudao-module-mall/yudao-module-promotion-biz/src/main/java/cn/iocoder/yudao/module/promotion/service/coupon/CouponTemplateServiceImpl.java
0 → 100755
| 1 | +package cn.iocoder.yudao.module.promotion.service.coupon; | |
| 2 | + | |
| 3 | +import cn.iocoder.yudao.framework.common.pojo.PageResult; | |
| 4 | +import cn.iocoder.yudao.module.promotion.controller.admin.coupon.vo.CouponTemplateCreateReqVO; | |
| 5 | +import cn.iocoder.yudao.module.promotion.controller.admin.coupon.vo.CouponTemplatePageReqVO; | |
| 6 | +import cn.iocoder.yudao.module.promotion.controller.admin.coupon.vo.CouponTemplateUpdateReqVO; | |
| 7 | +import cn.iocoder.yudao.module.promotion.convert.coupon.CouponTemplateConvert; | |
| 8 | +import cn.iocoder.yudao.module.promotion.dal.dataobject.coupon.CouponTemplateDO; | |
| 9 | +import cn.iocoder.yudao.module.promotion.dal.mysql.coupon.CouponTemplateMapper; | |
| 10 | +import org.springframework.stereotype.Service; | |
| 11 | +import org.springframework.validation.annotation.Validated; | |
| 12 | + | |
| 13 | +import javax.annotation.Resource; | |
| 14 | + | |
| 15 | +import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception; | |
| 16 | +import static cn.iocoder.yudao.module.promotion.enums.ErrorCodeConstants.*; | |
| 17 | + | |
| 18 | +/** | |
| 19 | + * 优惠劵模板 Service 实现类 | |
| 20 | + * | |
| 21 | + * @author 芋道源码 | |
| 22 | + */ | |
| 23 | +@Service | |
| 24 | +@Validated | |
| 25 | +public class CouponTemplateServiceImpl implements CouponTemplateService { | |
| 26 | + | |
| 27 | + @Resource | |
| 28 | + private CouponTemplateMapper couponTemplateMapper; | |
| 29 | + | |
| 30 | + @Override | |
| 31 | + public Long createCouponTemplate(CouponTemplateCreateReqVO createReqVO) { | |
| 32 | + // 插入 | |
| 33 | + CouponTemplateDO couponTemplate = CouponTemplateConvert.INSTANCE.convert(createReqVO); | |
| 34 | + couponTemplateMapper.insert(couponTemplate); | |
| 35 | + // 返回 | |
| 36 | + return couponTemplate.getId(); | |
| 37 | + } | |
| 38 | + | |
| 39 | + @Override | |
| 40 | + public void updateCouponTemplate(CouponTemplateUpdateReqVO updateReqVO) { | |
| 41 | + // 校验存在 | |
| 42 | + CouponTemplateDO couponTemplate = validateCouponTemplateExists(updateReqVO.getId()); | |
| 43 | + // 校验发放数量不能过小 | |
| 44 | + if (updateReqVO.getTotalCount() < couponTemplate.getTakeCount()) { | |
| 45 | + throw exception(COUPON_TEMPLATE_TOTAL_COUNT_TOO_SMALL, couponTemplate.getTakeCount()); | |
| 46 | + } | |
| 47 | + | |
| 48 | + // 更新 | |
| 49 | + CouponTemplateDO updateObj = CouponTemplateConvert.INSTANCE.convert(updateReqVO); | |
| 50 | + couponTemplateMapper.updateById(updateObj); | |
| 51 | + } | |
| 52 | + | |
| 53 | + @Override | |
| 54 | + public void deleteCouponTemplate(Long id) { | |
| 55 | + // 校验存在 | |
| 56 | + validateCouponTemplateExists(id); | |
| 57 | + // 删除 | |
| 58 | + couponTemplateMapper.deleteById(id); | |
| 59 | + } | |
| 60 | + | |
| 61 | + private CouponTemplateDO validateCouponTemplateExists(Long id) { | |
| 62 | + CouponTemplateDO couponTemplate = couponTemplateMapper.selectById(id); | |
| 63 | + if (couponTemplate == null) { | |
| 64 | + throw exception(COUPON_TEMPLATE_NOT_EXISTS); | |
| 65 | + } | |
| 66 | + return couponTemplate; | |
| 67 | + } | |
| 68 | + | |
| 69 | + @Override | |
| 70 | + public CouponTemplateDO getCouponTemplate(Long id) { | |
| 71 | + return couponTemplateMapper.selectById(id); | |
| 72 | + } | |
| 73 | + | |
| 74 | + @Override | |
| 75 | + public PageResult<CouponTemplateDO> getCouponTemplatePage(CouponTemplatePageReqVO pageReqVO) { | |
| 76 | + return couponTemplateMapper.selectPage(pageReqVO); | |
| 77 | + } | |
| 78 | + | |
| 79 | +} | ... | ... |
yudao-module-mall/yudao-module-promotion-biz/src/test/java/cn/iocoder/yudao/module/promotion/service/coupon/CouponTemplateServiceImplTest.java
0 → 100755
| 1 | +package cn.iocoder.yudao.module.promotion.service.coupon; | |
| 2 | + | |
| 3 | +import org.junit.jupiter.api.Disabled; | |
| 4 | +import org.junit.jupiter.api.Test; | |
| 5 | +import org.springframework.boot.test.mock.mockito.MockBean; | |
| 6 | + | |
| 7 | +import javax.annotation.Resource; | |
| 8 | + | |
| 9 | +import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest; | |
| 10 | + | |
| 11 | +import cn.iocoder.yudao.module.promotion.controller.admin.coupon.vo.*; | |
| 12 | +import cn.iocoder.yudao.module.promotion.dal.dataobject.coupon.CouponTemplateDO; | |
| 13 | +import cn.iocoder.yudao.module.promotion.dal.mysql.coupon.CouponTemplateMapper; | |
| 14 | +import cn.iocoder.yudao.framework.common.pojo.PageResult; | |
| 15 | + | |
| 16 | +import javax.annotation.Resource; | |
| 17 | +import org.springframework.context.annotation.Import; | |
| 18 | +import java.util.*; | |
| 19 | + | |
| 20 | +import static cn.hutool.core.util.RandomUtil.*; | |
| 21 | +import static cn.iocoder.yudao.module.promotion.enums.ErrorCodeConstants.*; | |
| 22 | +import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.*; | |
| 23 | +import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.*; | |
| 24 | +import static cn.iocoder.yudao.framework.common.util.object.ObjectUtils.*; | |
| 25 | +import static cn.iocoder.yudao.framework.common.util.date.DateUtils.*; | |
| 26 | +import static org.junit.jupiter.api.Assertions.*; | |
| 27 | +import static org.mockito.Mockito.*; | |
| 28 | + | |
| 29 | +/** | |
| 30 | +* {@link CouponTemplateServiceImpl} 的单元测试类 | |
| 31 | +* | |
| 32 | +* @author 芋道源码 | |
| 33 | +*/ | |
| 34 | +@Import(CouponTemplateServiceImpl.class) | |
| 35 | +public class CouponTemplateServiceImplTest extends BaseDbUnitTest { | |
| 36 | + | |
| 37 | + @Resource | |
| 38 | + private CouponTemplateServiceImpl couponTemplateService; | |
| 39 | + | |
| 40 | + @Resource | |
| 41 | + private CouponTemplateMapper couponTemplateMapper; | |
| 42 | + | |
| 43 | + @Test | |
| 44 | + public void testCreateCouponTemplate_success() { | |
| 45 | + // 准备参数 | |
| 46 | + CouponTemplateCreateReqVO reqVO = randomPojo(CouponTemplateCreateReqVO.class); | |
| 47 | + | |
| 48 | + // 调用 | |
| 49 | + Long couponTemplateId = couponTemplateService.createCouponTemplate(reqVO); | |
| 50 | + // 断言 | |
| 51 | + assertNotNull(couponTemplateId); | |
| 52 | + // 校验记录的属性是否正确 | |
| 53 | + CouponTemplateDO couponTemplate = couponTemplateMapper.selectById(couponTemplateId); | |
| 54 | + assertPojoEquals(reqVO, couponTemplate); | |
| 55 | + } | |
| 56 | + | |
| 57 | + @Test | |
| 58 | + public void testUpdateCouponTemplate_success() { | |
| 59 | + // mock 数据 | |
| 60 | + CouponTemplateDO dbCouponTemplate = randomPojo(CouponTemplateDO.class); | |
| 61 | + couponTemplateMapper.insert(dbCouponTemplate);// @Sql: 先插入出一条存在的数据 | |
| 62 | + // 准备参数 | |
| 63 | + CouponTemplateUpdateReqVO reqVO = randomPojo(CouponTemplateUpdateReqVO.class, o -> { | |
| 64 | + o.setId(dbCouponTemplate.getId()); // 设置更新的 ID | |
| 65 | + }); | |
| 66 | + | |
| 67 | + // 调用 | |
| 68 | + couponTemplateService.updateCouponTemplate(reqVO); | |
| 69 | + // 校验是否更新正确 | |
| 70 | + CouponTemplateDO couponTemplate = couponTemplateMapper.selectById(reqVO.getId()); // 获取最新的 | |
| 71 | + assertPojoEquals(reqVO, couponTemplate); | |
| 72 | + } | |
| 73 | + | |
| 74 | + @Test | |
| 75 | + public void testUpdateCouponTemplate_notExists() { | |
| 76 | + // 准备参数 | |
| 77 | + CouponTemplateUpdateReqVO reqVO = randomPojo(CouponTemplateUpdateReqVO.class); | |
| 78 | + | |
| 79 | + // 调用, 并断言异常 | |
| 80 | + assertServiceException(() -> couponTemplateService.updateCouponTemplate(reqVO), COUPON_TEMPLATE_NOT_EXISTS); | |
| 81 | + } | |
| 82 | + | |
| 83 | + @Test | |
| 84 | + public void testDeleteCouponTemplate_success() { | |
| 85 | + // mock 数据 | |
| 86 | + CouponTemplateDO dbCouponTemplate = randomPojo(CouponTemplateDO.class); | |
| 87 | + couponTemplateMapper.insert(dbCouponTemplate);// @Sql: 先插入出一条存在的数据 | |
| 88 | + // 准备参数 | |
| 89 | + Long id = dbCouponTemplate.getId(); | |
| 90 | + | |
| 91 | + // 调用 | |
| 92 | + couponTemplateService.deleteCouponTemplate(id); | |
| 93 | + // 校验数据不存在了 | |
| 94 | + assertNull(couponTemplateMapper.selectById(id)); | |
| 95 | + } | |
| 96 | + | |
| 97 | + @Test | |
| 98 | + public void testDeleteCouponTemplate_notExists() { | |
| 99 | + // 准备参数 | |
| 100 | + Long id = randomLongId(); | |
| 101 | + | |
| 102 | + // 调用, 并断言异常 | |
| 103 | + assertServiceException(() -> couponTemplateService.deleteCouponTemplate(id), COUPON_TEMPLATE_NOT_EXISTS); | |
| 104 | + } | |
| 105 | + | |
| 106 | + @Test | |
| 107 | + @Disabled // TODO 请修改 null 为需要的值,然后删除 @Disabled 注解 | |
| 108 | + public void testGetCouponTemplatePage() { | |
| 109 | + // mock 数据 | |
| 110 | + CouponTemplateDO dbCouponTemplate = randomPojo(CouponTemplateDO.class, o -> { // 等会查询到 | |
| 111 | + o.setName(null); | |
| 112 | + o.setStatus(null); | |
| 113 | + o.setType(null); | |
| 114 | + o.setCreateTime(null); | |
| 115 | + }); | |
| 116 | + couponTemplateMapper.insert(dbCouponTemplate); | |
| 117 | + // 测试 name 不匹配 | |
| 118 | + couponTemplateMapper.insert(cloneIgnoreId(dbCouponTemplate, o -> o.setName(null))); | |
| 119 | + // 测试 status 不匹配 | |
| 120 | + couponTemplateMapper.insert(cloneIgnoreId(dbCouponTemplate, o -> o.setStatus(null))); | |
| 121 | + // 测试 type 不匹配 | |
| 122 | + couponTemplateMapper.insert(cloneIgnoreId(dbCouponTemplate, o -> o.setType(null))); | |
| 123 | + // 测试 createTime 不匹配 | |
| 124 | + couponTemplateMapper.insert(cloneIgnoreId(dbCouponTemplate, o -> o.setCreateTime(null))); | |
| 125 | + // 准备参数 | |
| 126 | + CouponTemplatePageReqVO reqVO = new CouponTemplatePageReqVO(); | |
| 127 | + reqVO.setName(null); | |
| 128 | + reqVO.setStatus(null); | |
| 129 | + reqVO.setType(null); | |
| 130 | + reqVO.setCreateTime((new Date[]{})); | |
| 131 | + | |
| 132 | + // 调用 | |
| 133 | + PageResult<CouponTemplateDO> pageResult = couponTemplateService.getCouponTemplatePage(reqVO); | |
| 134 | + // 断言 | |
| 135 | + assertEquals(1, pageResult.getTotal()); | |
| 136 | + assertEquals(1, pageResult.getList().size()); | |
| 137 | + assertPojoEquals(dbCouponTemplate, pageResult.getList().get(0)); | |
| 138 | + } | |
| 139 | + | |
| 140 | + @Test | |
| 141 | + @Disabled // TODO 请修改 null 为需要的值,然后删除 @Disabled 注解 | |
| 142 | + public void testGetCouponTemplateList() { | |
| 143 | + // mock 数据 | |
| 144 | + CouponTemplateDO dbCouponTemplate = randomPojo(CouponTemplateDO.class, o -> { // 等会查询到 | |
| 145 | + o.setName(null); | |
| 146 | + o.setStatus(null); | |
| 147 | + o.setType(null); | |
| 148 | + o.setCreateTime(null); | |
| 149 | + }); | |
| 150 | + couponTemplateMapper.insert(dbCouponTemplate); | |
| 151 | + // 测试 name 不匹配 | |
| 152 | + couponTemplateMapper.insert(cloneIgnoreId(dbCouponTemplate, o -> o.setName(null))); | |
| 153 | + // 测试 status 不匹配 | |
| 154 | + couponTemplateMapper.insert(cloneIgnoreId(dbCouponTemplate, o -> o.setStatus(null))); | |
| 155 | + // 测试 type 不匹配 | |
| 156 | + couponTemplateMapper.insert(cloneIgnoreId(dbCouponTemplate, o -> o.setType(null))); | |
| 157 | + // 测试 createTime 不匹配 | |
| 158 | + couponTemplateMapper.insert(cloneIgnoreId(dbCouponTemplate, o -> o.setCreateTime(null))); | |
| 159 | + // 准备参数 | |
| 160 | + CouponTemplateExportReqVO reqVO = new CouponTemplateExportReqVO(); | |
| 161 | + reqVO.setName(null); | |
| 162 | + reqVO.setStatus(null); | |
| 163 | + reqVO.setType(null); | |
| 164 | + reqVO.setCreateTime((new Date[]{})); | |
| 165 | + | |
| 166 | + // 调用 | |
| 167 | + List<CouponTemplateDO> list = couponTemplateService.getCouponTemplateList(reqVO); | |
| 168 | + // 断言 | |
| 169 | + assertEquals(1, list.size()); | |
| 170 | + assertPojoEquals(dbCouponTemplate, list.get(0)); | |
| 171 | + } | |
| 172 | + | |
| 173 | +} | ... | ... |