【营销】优惠劵

优惠劵功能，主要由 dtpc-module-promotion-biz 后端模块的 coupon 实现，包括两部分：优惠劵模版、优惠劵。如下图所示：

![](/media/202408/2024-08-28_165313_081461.png)

## 1. 优惠劵模版
优惠劵模版，由卖家在管理后台配置，提供给买家领取成优惠劵，由 CouponTemplateService 类实现。

### 1.1 表结构
> <span style="font-family:楷体">CREATE TABLE `promotion_coupon_template` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '模板编号，自增唯一。',
  `name` varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL COMMENT '优惠劵名',
  `status` tinyint NOT NULL COMMENT '状态',
  `take_type` tinyint NOT NULL COMMENT '领取方式',  
  `total_count` int NOT NULL COMMENT '发放数量, -1 - 则表示不限制',
  `take_limit_count` tinyint NOT NULL COMMENT '每人限领个数, -1 - 则表示不限制',
  `take_count` int NOT NULL DEFAULT '0' COMMENT '领取优惠券的数量',
  `use_count` int NOT NULL DEFAULT '0' COMMENT '使用优惠券的次数',
  `use_price` int NOT NULL COMMENT '是否设置满多少金额可用，单位：分',
  `product_scope` tinyint NOT NULL COMMENT '商品范围',
  `product_scope_values` varchar(500) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci DEFAULT NULL COMMENT '商品范围编号的数组',
  `validity_type` tinyint NOT NULL COMMENT '生效日期类型',
  `valid_start_time` datetime DEFAULT NULL COMMENT '固定日期-生效开始时间',
  `valid_end_time` datetime DEFAULT NULL COMMENT '固定日期-生效结束时间',
  `fixed_start_term` int DEFAULT NULL COMMENT '领取日期-开始天数',
  `fixed_end_term` int DEFAULT NULL COMMENT '领取日期-结束天数',
  `discount_type` int NOT NULL COMMENT '优惠类型：1-代金卷；2-折扣卷\n',
  `discount_percent` tinyint DEFAULT NULL COMMENT '折扣百分比',
  `discount_price` int DEFAULT NULL COMMENT '优惠金额，单位：分',
  `discount_limit_price` int DEFAULT NULL COMMENT '折扣上限，仅在 discount_type 等于 2 时生效',
  PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=17 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='优惠劵模板';
</span>

① status 字段：优惠劵模版状态，由 CommonStatusEnum 枚举，只有开启、禁用两个状态。禁用时，无法领取。
② 【领取限制】take_type 字段：领取方式，由 CouponTemplateTakeTypeEnum 枚举，分成 3 种情况：

1、直接领取：展示在 uni-app 的 [首页]、[领劵中心]、[商品详情]，由用户主动领取。如下图所示：

![](/media/202408/2024-08-28_165406_192565.png)

2、指定发放：管理员在管理后台，指定用户发放。如下图所示：

![](/media/202408/2024-08-28_165434_558275.png)

3、新人券：买家在注册时，自动发放，由 CouponTakeByRegisterConsumer 消息消费者实现

③ 【使用条件】product_scope 字段：商品范围，由 PromotionProductScopeEnum 枚举，分成 3 种情况：
1- 、通用券：全部商品
- 2、商品券：指定商品，由 product_scope_values 字段指定商品编号的数组
- 3、品类券：指定品类，由 product_scope_values 字段指定品类编号的数组

④ 【有效期】validity_type 字段：生效日期类型，由 CouponTemplateValidityTypeEnum 枚举，分成 2 种情况：

- 1、固定日期：由 valid_start_time、valid_end_time 字段指定生效时间范围
- 2、领取日期：由 fixed_start_term、fixed_end_term 字段指定领取后多少天生效

⑤ 【优惠金额】discount_type 字段：优惠类型，由 PromotionDiscountTypeEnum 枚举，分成 2 种情况：
- 1、代金卷：由 discount_price 字段指定优惠金额
- 2、折扣卷：由 discount_percent 字段指定折扣百分比，由 discount_limit_price 字段指定折扣上限

### 1.2 管理后台
对应 [商城系统 -> 营销中心 -> 优惠劵 -> 优惠劵] 菜单，如下图所示：

![](/media/202408/2024-08-28_165600_176249.png)

### 1.3 移动端
① 在 uni-app 的 [我的] 有 [领劵中心]，可以领取优惠劵。如下图所示：

![](/media/202408/2024-08-28_165617_393866.png)

② 点击 [领劵中心] 的优惠劵，可以查看该优惠劵的详情，如下图所示：

![](/media/202408/2024-08-28_165632_473532.png)

## 2. 优惠劵
优惠劵，会员领取优惠劵模版来“生成”，由 CouponService 类实现。

### 2.1 表结构
> <span style="font-family:楷体">CREATE TABLE `promotion_coupon` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '优惠劵编号',
  `template_id` bigint NOT NULL COMMENT '优惠劵模板编号',
  `name` varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL COMMENT '优惠劵名',
  `use_price` int NOT NULL COMMENT '是否设置满多少金额可用，单位：分',
  `take_type` tinyint NOT NULL COMMENT '领取方式',
  `valid_start_time` datetime NOT NULL COMMENT '生效开始时间',
  `valid_end_time` datetime NOT NULL COMMENT '生效结束时间',
  `product_scope` tinyint NOT NULL COMMENT '商品范围',
  `product_scope_values` varchar(500) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci DEFAULT NULL COMMENT '商品范围编号的数组',
  `discount_type` tinyint NOT NULL COMMENT '折扣类型',
  `discount_percent` tinyint DEFAULT NULL COMMENT '折扣百分比',
  `discount_price` int DEFAULT NULL COMMENT '优惠金额，单位：分',
  `discount_limit_price` int DEFAULT NULL COMMENT '折扣上限',
  `user_id` bigint NOT NULL COMMENT '用户编号',
  `status` tinyint NOT NULL COMMENT '优惠码状态；1-未使用；2-已使用；3-已失效',
  `use_order_id` bigint DEFAULT NULL COMMENT '使用订单号',
  `use_time` datetime DEFAULT NULL COMMENT '使用时间',
  PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=18 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='优惠劵';
</span>

字段虽然也蛮多，但是都是从 promotion_coupon_template 中复制过来的，所以更多讲讲差异的地方。

① 【优惠劵模版】从 template_id 开始到 discount_limit_price 结束，都是从 promotion_coupon_template 中复制过来的，用于记录优惠劵模版的信息。
要注意，如果 promotion_coupon_template 中的信息发生变化，promotion_coupon 中的信息不会变化，因为买家已经领取了，不能随意变更。
② 【用户】user_id 字段：用户编号，就是领取的买家。
③ 【状态】status 字段：优惠码状态，由 CouponStatusEnum 枚举，分成

3 种情况：未使用、已使用、已失效。

如果已使用，会记录 use_order_id、use_time 字段，表示使用的订单编号、使用时间。
优惠劵的过期，由 CouponExpireJob 定时任务实现。

### 2.2 管理后台
对应 [商城系统 -> 营销中心 -> 优惠劵 -> 领取记录] 菜单，如下图所示：

![](/media/202408/2024-08-28_165815_575870.png)

### 2.3 移动端
① 在 uni-app 的 [我的] 有 [已领取]、[已使用]、[已失效]，如下图所示：

![](/media/202408/2024-08-28_165833_589227.png)
② 点击某个优惠劵，可以查看该优惠劵的详情，如下图所示：

![](/media/202408/2024-08-28_165942_273707.png)

③ 在 uni-app 下单时，可以选择优惠劵，如下图所示：

![](/media/202408/2024-08-28_170001_454107.png)