mall + trade：review 配置管理列表

yudao-module-mall/yudao-module-promotion-api/src/main/java/cn/iocoder/yudao/module/promotion/api/coupon/CouponApi.java

@@ -1,6 +1,8 @@
 package cn.iocoder.yudao.module.promotion.api.coupon;
 
+import cn.iocoder.yudao.module.promotion.api.coupon.dto.CouponRespDTO;
 import cn.iocoder.yudao.module.promotion.api.coupon.dto.CouponUseReqDTO;
+import cn.iocoder.yudao.module.promotion.api.coupon.dto.CouponValidReqDTO;
 
 import javax.validation.Valid;
 
@@ -18,4 +20,12 @@ public interface CouponApi {
      */
     void useCoupon(@Valid CouponUseReqDTO useReqDTO);
 
+    /**
+     * 校验优惠劵
+     *
+     * @param validReqDTO 校验请求
+     * @return 优惠劵
+     */
+    CouponRespDTO validateCoupon(@Valid CouponValidReqDTO validReqDTO);
+
 }

yudao-module-mall/yudao-module-promotion-api/src/main/java/cn/iocoder/yudao/module/promotion/api/coupon/dto/CouponRespDTO.java

@@ -0,0 +1,109 @@
+package cn.iocoder.yudao.module.promotion.api.coupon.dto;
+
+import cn.iocoder.yudao.module.promotion.enums.common.PromotionDiscountTypeEnum;
+import cn.iocoder.yudao.module.promotion.enums.coupon.CouponStatusEnum;
+import cn.iocoder.yudao.module.promotion.enums.coupon.CouponTakeTypeEnum;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * 优惠劵 Response DTO
+ *
+ * @author 芋道源码
+ */
+@Data
+public class CouponRespDTO {
+
+    // ========== 基本信息 BEGIN ==========
+    /**
+     * 优惠劵编号
+     */
+    private Long id;
+    /**
+     * 优惠劵模板编号
+     */
+    private Integer templateId;
+    /**
+     * 优惠劵名
+     */
+    private String name;
+    /**
+     * 优惠码状态
+     *
+     * 枚举 {@link CouponStatusEnum}
+     */
+    private Integer status;
+
+    // ========== 基本信息 END ==========
+
+    // ========== 领取情况 BEGIN ==========
+    /**
+     * 用户编号
+     *
+     * 关联 MemberUserDO 的 id 字段
+     */
+    private Long userId;
+    /**
+     * 领取类型
+     *
+     * 枚举 {@link CouponTakeTypeEnum}
+     */
+    private Integer takeType;
+    // ========== 领取情况 END ==========
+
+    // ========== 使用规则 BEGIN ==========
+    /**
+     * 是否设置满多少金额可用，单位：分
+     */
+    private Integer usePrice;
+    /**
+     * 生效开始时间
+     */
+    private LocalDateTime validStartTime;
+    /**
+     * 生效结束时间
+     */
+    private LocalDateTime validEndTime;
+    /**
+     * 商品范围
+     */
+    private Integer productScope;
+    /**
+     * 商品 SPU 编号的数组
+     */
+    private List<Long> productSpuIds;
+    // ========== 使用规则 END ==========
+
+    // ========== 使用效果 BEGIN ==========
+    /**
+     * 折扣类型
+     */
+    private Integer discountType;
+    /**
+     * 折扣百分比
+     */
+    private Integer discountPercent;
+    /**
+     * 优惠金额，单位：分
+     */
+    private Integer discountPrice;
+    /**
+     * 折扣上限，仅在 {@link #discountType} 等于 {@link PromotionDiscountTypeEnum#PERCENT} 时生效
+     */
+    private Integer discountLimitPrice;
+    // ========== 使用效果 END ==========
+
+    // ========== 使用情况 BEGIN ==========
+    /**
+     * 使用订单号
+     */
+    private Long useOrderId;
+    /**
+     * 使用时间
+     */
+    private LocalDateTime useTime;
+
+    // ========== 使用情况 END ==========
+}

yudao-module-mall/yudao-module-promotion-api/src/main/java/cn/iocoder/yudao/module/promotion/api/coupon/dto/CouponValidReqDTO.java

@@ -0,0 +1,27 @@
+package cn.iocoder.yudao.module.promotion.api.coupon.dto;
+
+import lombok.Data;
+
+import javax.validation.constraints.NotNull;
+
+/**
+ * 优惠劵使用 Request DTO
+ *
+ * @author 芋道源码
+ */
+@Data
+public class CouponValidReqDTO {
+
+    /**
+     * 优惠劵编号
+     */
+    @NotNull(message = "优惠劵编号不能为空")
+    private Long id;
+
+    /**
+     * 用户编号
+     */
+    @NotNull(message = "用户编号不能为空")
+    private Long userId;
+
+}

yudao-module-mall/yudao-module-promotion-api/src/main/java/cn/iocoder/yudao/module/promotion/api/discount/DiscountActivityApi.java

@@ -0,0 +1,23 @@
+package cn.iocoder.yudao.module.promotion.api.discount;
+
+import cn.iocoder.yudao.module.promotion.api.discount.dto.DiscountProductRespDTO;
+
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * 限时折扣 API 接口
+ *
+ * @author 芋道源码
+ */
+public interface DiscountActivityApi {
+
+    /**
+     * 获得商品匹配的的限时折扣信息
+     *
+     * @param skuIds 商品 SKU 编号数组
+     * @return 限时折扣信息
+     */
+    List<DiscountProductRespDTO> getMatchDiscountProductList(Collection<Long> skuIds);
+
+}

yudao-module-mall/yudao-module-promotion-api/src/main/java/cn/iocoder/yudao/module/promotion/api/discount/dto/DiscountProductRespDTO.java

@@ -0,0 +1,48 @@
+package cn.iocoder.yudao.module.promotion.api.discount.dto;
+
+import lombok.Data;
+
+/**
+ * 限时折扣活动商品 Response DTO
+ *
+ * @author 芋道源码
+ */
+@Data
+public class DiscountProductRespDTO {
+
+    /**
+     * 编号，主键自增
+     */
+    private Long id;
+    /**
+     * 商品 SPU 编号
+     */
+    private Long spuId;
+    /**
+     * 商品 SKU 编号
+     */
+    private Long skuId;
+    /**
+     * 折扣类型
+     */
+    private Integer discountType;
+    /**
+     * 折扣百分比
+     */
+    private Integer discountPercent;
+    /**
+     * 优惠金额，单位：分
+     */
+    private Integer discountPrice;
+
+    // ========== 活动字段 ==========
+    /**
+     * 限时折扣活动的编号
+     */
+    private Long activityId;
+    /**
+     * 活动标题
+     */
+    private String activityName;
+
+}

yudao-module-mall/yudao-module-promotion-api/src/main/java/cn/iocoder/yudao/module/promotion/api/package-info.java

@@ -1,4 +0,0 @@
-/**
- * 占位
- */
-package cn.iocoder.yudao.module.promotion.api;

yudao-module-mall/yudao-module-promotion-api/src/main/java/cn/iocoder/yudao/module/promotion/api/price/dto/PriceCalculateReqDTO.java

@@ -26,6 +26,11 @@ public class PriceCalculateReqDTO {
      */
     private Long couponId;
 
+    /**
+     * 收货地址编号
+     */
+    private Long addressId;
+
     /**
      * 商品 SKU 数组
      */

yudao-module-mall/yudao-module-promotion-api/src/main/java/cn/iocoder/yudao/module/promotion/api/price/dto/PriceCalculateRespDTO.java

@@ -24,6 +24,7 @@ import java.util.List;
  * @author 芋道源码
  */
 @Data
+@Deprecated
 public class PriceCalculateRespDTO {
 
     /**
@@ -174,6 +175,7 @@ public class PriceCalculateRespDTO {
      * 营销明细
      */
     @Data
+    @Deprecated
     public static class Promotion {
 
         /**
@@ -216,14 +218,14 @@ public class PriceCalculateRespDTO {
         /**
          * 是否满足优惠条件
          */
-        private Boolean meet;
+        private Boolean match;
         /**
          * 满足条件的提示
          *
-         * 如果 {@link #meet} = true 满足，则提示“圣诞价:省 150.00 元”
-         * 如果 {@link #meet} = false 不满足，则提示“购满 85 元，可减 40 元”
+         * 如果 {@link #match} = true 满足，则提示“圣诞价:省 150.00 元”
+         * 如果 {@link #match} = false 不满足，则提示“购满 85 元，可减 40 元”
          */
-        private String meetTip;
+        private String description;
 
     }
 

yudao-module-mall/yudao-module-promotion-api/src/main/java/cn/iocoder/yudao/module/promotion/api/reward/RewardActivityApi.java

@@ -0,0 +1,24 @@
+package cn.iocoder.yudao.module.promotion.api.reward;
+
+import cn.iocoder.yudao.module.promotion.api.reward.dto.RewardActivityMatchRespDTO;
+
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * 满减送活动 API 接口
+ *
+ * @author 芋道源码
+ */
+public interface RewardActivityApi {
+
+
+    /**
+     * 基于指定的 SPU 编号数组，获得它们匹配的满减送活动
+     *
+     * @param spuIds SPU 编号数组
+     * @return 满减送活动列表
+     */
+    List<RewardActivityMatchRespDTO> getMatchRewardActivityList(Collection<Long> spuIds);
+
+}

yudao-module-mall/yudao-module-promotion-api/src/main/java/cn/iocoder/yudao/module/promotion/api/reward/dto/RewardActivityMatchRespDTO.java

@@ -0,0 +1,77 @@
+package cn.iocoder.yudao.module.promotion.api.reward.dto;
+
+import cn.iocoder.yudao.module.promotion.enums.common.PromotionConditionTypeEnum;
+import lombok.Data;
+
+import java.util.List;
+
+/**
+ * 满减送活动的匹配 Response DTO
+ *
+ * @author 芋道源码
+ */
+@Data
+public class RewardActivityMatchRespDTO {
+
+    /**
+     * 活动编号，主键自增
+     */
+    private Long id;
+    /**
+     * 活动标题
+     */
+    private String name;
+    /**
+     * 条件类型
+     *
+     * 枚举 {@link PromotionConditionTypeEnum}
+     */
+    private Integer conditionType;
+    /**
+     * 优惠规则的数组
+     */
+    private List<Rule> rules;
+
+    /**
+     * 商品 SPU 编号的数组
+     */
+    private List<Long> spuIds;
+
+    // TODO 芋艿：后面 RewardActivityRespDTO 有了之后，Rule 可以放过去
+    /**
+     * 优惠规则
+     */
+    @Data
+    public static class Rule {
+
+        /**
+         * 优惠门槛
+         *
+         * 1. 满 N 元，单位：分
+         * 2. 满 N 件
+         */
+        private Integer limit;
+        /**
+         * 优惠价格，单位：分
+         */
+        private Integer discountPrice;
+        /**
+         * 是否包邮
+         */
+        private Boolean freeDelivery;
+        /**
+         * 赠送的积分
+         */
+        private Integer point;
+        /**
+         * 赠送的优惠劵编号的数组
+         */
+        private List<Long> couponIds;
+        /**
+         * 赠送的优惠卷数量的数组
+         */
+        private List<Integer> couponCounts;
+
+    }
+
+}

yudao-module-mall/yudao-module-promotion-api/src/main/java/cn/iocoder/yudao/module/promotion/enums/common/PromotionLevelEnum.java

@@ -1,40 +0,0 @@
-package cn.iocoder.yudao.module.promotion.enums.common;
-
-import cn.iocoder.yudao.framework.common.core.IntArrayValuable;
-import lombok.AllArgsConstructor;
-import lombok.Getter;
-
-import java.util.Arrays;
-
-/**
- * 营销的级别枚举
- *
- * 参考有赞：<a href="https://img01.yzcdn.cn/upload_files/2021/11/02/FhDjUrNDq-G0wjNdYDtgUX09fdGj.png">营销级别</a>
- *
- * @author 芋道源码
- */
-@Getter
-@AllArgsConstructor
-public enum PromotionLevelEnum implements IntArrayValuable {
-
-    ORDER(1, "订单级"), // 多个商品，进行组合后优惠。例如说：满减送、打包一口价、第二件半价
-    SKU(2, "商品级"), // 单个商品，直接优惠。例如说：限时折扣、会员折扣
-    COUPON(3, "优惠劵"), // 多个商品，进行组合后优惠。例如说：优惠劵
-    ;
-
-    public static final int[] ARRAYS = Arrays.stream(values()).mapToInt(PromotionLevelEnum::getLevel).toArray();
-
-    /**
-     * 级别值
-     */
-    private final Integer level;
-    /**
-     * 类型名
-     */
-    private final String name;
-
-    @Override
-    public int[] array() {
-        return ARRAYS;
-    }
-}

yudao-module-mall/yudao-module-promotion-api/src/main/java/cn/iocoder/yudao/module/promotion/enums/common/PromotionTypeEnum.java

@@ -18,7 +18,7 @@ public enum PromotionTypeEnum implements IntArrayValuable {
     DISCOUNT_ACTIVITY(1, "限时折扣"),
     REWARD_ACTIVITY(2, "满减送"),
 
-    MEMBER(3, "会员折扣"),
+    MEMBER(3, "会员折扣"), // TODO 芋艿：待实现 StrUtil.format("会员折扣：省 {} 元", formatPrice(orderItem.getPayPrice() - memberPrice)
     COUPON(4, "优惠劵")
     ;
 
@@ -37,4 +37,5 @@ public enum PromotionTypeEnum implements IntArrayValuable {
     public int[] array() {
         return ARRAYS;
     }
+
 }