后端：优惠劵领取相关接口

promotion/promotion-service-api/src/main/java/cn/iocoder/mall/promotion/api/CouponService.java

@@ -12,6 +12,8 @@ public interface CouponService {
 
     // ========== 优惠劵（码）模板 ==========
 
+    CommonResult<CouponTemplateBO> getCouponTemplate(Integer couponTemplateId);
+
     CommonResult<CouponTemplatePageBO> getCouponTemplatePage(CouponTemplatePageDTO couponTemplatePageDTO);
 
     /**

promotion/promotion-service-api/src/main/java/cn/iocoder/mall/promotion/api/bo/CouponCardBO.java

@@ -3,10 +3,113 @@ package cn.iocoder.mall.promotion.api.bo;
 import lombok.Data;
 import lombok.experimental.Accessors;
 
+import java.util.Date;
+
 /**
  * 优惠劵 BO
  */
 @Data
 @Accessors(chain = true)
 public class CouponCardBO {
+
+    // ========== 基本信息 BEGIN ==========
+    /**
+     * 优惠劵编号
+     */
+    private Integer id;
+    /**
+     * 优惠劵（码）分组编号
+     */
+    private Integer templateId;
+//    /**
+//     * 核销码
+//     */
+//    private String verifyCode;
+    /**
+     * 优惠码状态
+     *
+     * 1-未使用
+     * 2-已使用
+     * 3-已失效
+     */
+    private Integer status;
+
+    // ========== 基本信息 END ==========
+
+    // ========== 领取情况 BEGIN ==========
+    /**
+     * 用户编号
+     */
+    private Integer userId;
+    /**
+     * 领取类型
+     *
+     * 1 - 用户主动领取
+     * 2 - 后台自动发放
+     */
+    private Integer takeType;
+    // ========== 领取情况 END ==========
+
+    // ========== 使用规则 BEGIN ==========
+    /**
+     * 生效开始时间
+     */
+    private Date validStartTime;
+    /**
+     * 生效结束时间
+     */
+    private Date validEndTime;
+    // ========== 使用规则 END ==========
+
+    // ========== 使用效果 BEGIN ==========
+    /**
+     * 优惠类型
+     *
+     * 1-代金卷
+     * 2-折扣卷
+     */
+    private Integer preferentialType;
+    /**
+     * 折扣
+     */
+    private Integer percentOff;
+    /**
+     * 优惠金额，单位：分。
+     */
+    private Integer priceOff;
+    /**
+     * 折扣上限，仅在 {@link #preferentialType} 等于 2 时生效。
+     *
+     * 例如，折扣上限为 20 元，当使用 8 折优惠券，订单金额为 1000 元时，最高只可折扣 20 元，而非 80  元。
+     */
+    private Integer discountPriceLimit;
+    // ========== 使用效果 END ==========
+
+    // ========== 使用情况 BEGIN ==========
+    /**
+     * 是否使用
+     */
+    private Boolean used;
+    /**
+     * 使用订单号
+     */
+    private Integer usedOrderId;
+    /**
+     * 订单中优惠面值，单位：分
+     */
+    private Integer usedPrice;
+    /**
+     * 使用时间
+     */
+    private Date usedTime;
+
+    // TODO 芋艿，后续要加优惠劵的使用日志，因为下单后，可能会取消。
+
+    // ========== 使用情况 END ==========
+
+    /**
+     * 创建时间
+     */
+    private Date createTime;
+
 }

promotion/promotion-service-api/src/main/java/cn/iocoder/mall/promotion/api/constant/CouponCardStatusEnum.java

@@ -0,0 +1,45 @@
+package cn.iocoder.mall.promotion.api.constant;
+
+import cn.iocoder.common.framework.core.IntArrayValuable;
+
+import java.util.Arrays;
+
+/**
+ * 优惠劵状态枚举
+ */
+public enum CouponCardStatusEnum implements IntArrayValuable {
+
+    UNUSED(1, "未使用"),
+    USED(2, "已使用"),
+    EXPIRE(3, "已过期"),
+    ;
+
+    public static final int[] ARRAYS = Arrays.stream(values()).mapToInt(CouponCardStatusEnum::getValue).toArray();
+
+    /**
+     * 值
+     */
+    private final Integer value;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    CouponCardStatusEnum(Integer value, String name) {
+        this.value = value;
+        this.name = name;
+    }
+
+    public Integer getValue() {
+        return value;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    @Override
+    public int[] array() {
+        return ARRAYS;
+    }
+}

promotion/promotion-service-api/src/main/java/cn/iocoder/mall/promotion/api/constant/CouponCardTakeTypeEnum.java

@@ -0,0 +1,44 @@
+package cn.iocoder.mall.promotion.api.constant;
+
+import cn.iocoder.common.framework.core.IntArrayValuable;
+
+import java.util.Arrays;
+
+/**
+ * 优惠劵领取方式
+ */
+public enum CouponCardTakeTypeEnum implements IntArrayValuable {
+
+    BY_USER(1, "用户主动领取"),
+    BY_ADMIN(2, "已使用"),
+    ;
+
+    public static final int[] ARRAYS = Arrays.stream(values()).mapToInt(CouponCardTakeTypeEnum::getValue).toArray();
+
+    /**
+     * 值
+     */
+    private final Integer value;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    CouponCardTakeTypeEnum(Integer value, String name) {
+        this.value = value;
+        this.name = name;
+    }
+
+    public Integer getValue() {
+        return value;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    @Override
+    public int[] array() {
+        return ARRAYS;
+    }
+}

promotion/promotion-service-api/src/main/java/cn/iocoder/mall/promotion/api/constant/PromotionErrorCodeEnum.java

@@ -21,6 +21,7 @@ public enum PromotionErrorCodeEnum {
     PRODUCT_TEMPLATE_NOT_CARD(1006002001, "不是优惠劵模板"),
     PRODUCT_TEMPLATE_NOT_CODE(1006002002, "不是优惠码模板"),
     PRODUCT_TEMPLATE_TOTAL_CAN_NOT_REDUCE(1006002003, "优惠劵（码）模板的发放数量不能减小"),
+    PRODUCT_TEMPLATE_STATUS_NOT_ENABLE(1006002004, "优惠劵模板（码）未开启"),
 
     ;