如何设计一个可扩展的优惠券功能

本文主要分享了如何设计一个可扩展的优惠券功能。

一、功能特性介绍

1.每个条件的代码独立，相当于单独的实现类实现接口，就能通过配置添加到优惠券条件校验当中，支持多种条件灵活组合

2.新增一种使用条件可以不修改核心流程代码，不需要增加数据库表字段

3.可实现优惠券区分客户端展示，比如在APP可见可用，在小程序不可见不可用

4.可实现优惠券查询适用的商品列表

二、核心代码架构图

三、代码实现

1.数据库表结构设计

CREATE TABLE `mk_coupon_use_condition` (
  `id` int(11) unsigned NOT NULL AUTO_INCREMENT COMMENT 'ID',
  `bean_name` varchar(64) NOT NULL DEFAULT '' COMMENT 'bean名称(UseCondition的实现类)',
  `descrpition` varchar(255) DEFAULT NULL COMMENT '描述',
  `remark` varchar(255) DEFAULT NULL COMMENT '备注',
  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
  PRIMARY KEY (`id`) USING BTREE,
  UNIQUE KEY `uniq_beanname` (`bean_name`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='优惠券使用条件';

CREATE TABLE `mk_coupon_template` (
  `id` int(11) unsigned NOT NULL AUTO_INCREMENT COMMENT 'ID',
  `name` varchar(128) NOT NULL DEFAULT '' COMMENT '优惠券名称',
  `max_amount` decimal(12,2) NOT NULL DEFAULT '0.00' COMMENT '最大优惠金额(元)',
  `discount` decimal(12,2) NOT NULL DEFAULT '1.00' COMMENT '折扣',
  `condition_amount` decimal(12,2) NOT NULL DEFAULT '0.00' COMMENT '满X元可用',
  `begin_time` datetime NOT NULL COMMENT '发放开始时间',
  `end_time` datetime NOT NULL COMMENT '发放结束时间',
  `period_type` varchar(8) NOT NULL DEFAULT '' COMMENT '有效期计算方式(fix:领券起X小时内有效,ps:固定开始时间-结束时间)',
  `total_num` int(11) NOT NULL DEFAULT '0' COMMENT '发放量',
  `left_num` int(11) NOT NULL DEFAULT '0' COMMENT '剩余量',
  `limit_num` int(11) NOT NULL DEFAULT '1' COMMENT '每用户限领量',
  `use_description` text COMMENT '使用说明',
  `remark` varchar(255) DEFAULT NULL COMMENT '备注',
  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='优惠券模板';

CREATE TABLE `mk_coupon_template_condition` (
  `id` int(11) unsigned NOT NULL AUTO_INCREMENT COMMENT 'ID',
  `coupon_template_id` int(11) NOT NULL COMMENT 'mk_coupon_template.id',
  `use_condition` varchar(32) NOT NULL DEFAULT '' COMMENT '使用条件(bean名称,mk_coupon_use_condition.bean_name)',
  `use_condition_value` varchar(255) DEFAULT '' COMMENT '使用条件值',
  `remark` varchar(255) DEFAULT NULL COMMENT '备注',
  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
  PRIMARY KEY (`id`),
  KEY `idx_coupontemplateid` (`coupon_template_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='优惠券模板-使用条件';

CREATE TABLE `mk_user_coupon` (
  `id` int(11) unsigned NOT NULL AUTO_INCREMENT COMMENT 'ID',
  `user_id` int(11) NOT NULL COMMENT 'bu_user_info.id',
  `coupon_template_id` int(11) NOT NULL COMMENT 'mk_coupon_template.id',
  `name` varchar(128) NOT NULL DEFAULT '' COMMENT '优惠券名称',
  `max_amount` decimal(12,2) NOT NULL DEFAULT '0.00' COMMENT '最大优惠金额',
  `discount` decimal(12,2) NOT NULL DEFAULT '1.00' COMMENT '折扣',
  `condition_amount` decimal(12,2) NOT NULL DEFAULT '0.00' COMMENT '满X金额可用',
  `begin_time` datetime NOT NULL COMMENT '有效期开始时间',
  `end_time` datetime NOT NULL COMMENT '有效期结束时间',
  `status` varchar(8) NOT NULL DEFAULT '' COMMENT '状态(nouse:未使用/已使用/已过期/未激活/已失效)',
  `max_num` int(11) NOT NULL COMMENT '最大叠加数',
  `remark` varchar(255) DEFAULT NULL COMMENT '备注',
  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
  PRIMARY KEY (`id`) USING BTREE,
  KEY `idx_userid` (`user_id`),
  KEY `idx_coupontemplateid` (`coupon_template_id`)
) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8mb4 COMMENT='用户优惠券';

表说明：

mk_coupon_use_condition：主要是记录有哪些使用条件，代码中配置优惠券模板时有用

mk_coupon_template：优惠券发给用户前得先有个模板做配置

mk_coupon_template_condition：某个优惠券模板的使用条件（1对多），条件组合配置就是利用该表

mk_user_coupon：实际给到用户的优惠券，有未使用/已使用等状态，冗余了一部分券模板的数据

数据样例说明：

优惠券模板

优惠券模板使用条件

1）优惠券1只有1个条件CouponBaseCondition，可以理解为全场通用券，只要满足了基本条件就可以使用

2）优惠券2除了条件CouponBaseCondition，还有PlatformCondition，说明除了满足基本条件，还需要满足平台是app才能使用

3）优惠券3除了条件CouponBaseCondition，还有ProductCodeCondition，说明除了满足基本条件，还需要满足指定的商品编码AB3301或AB3302才能使用

2.抽象使用条件，定义一个接口，核心是canUse方法，另外2个方法有其他用途

UseParam说明：

例：如下为‘自动为用户选择最优的优惠券’的代码调用，runtimeAttach设计为Map就是为了灵活接收各种参数：

特殊业务场景说明：

canSee方法：用于解决某张优惠券只有在APP能使用，但是在小程序不能使用的业务场景，利用canSee方法返回true/false决定是否展示该张优惠券，例

filterProduct方法：用于解决根据某张优惠券查询适用商品的功能，一些大型的电商平台就提供该功能，方便用户快速找到能够使用该优惠券的商品列表，如果业务中不需要用到该功能可以忽略该方法

3.核心代码（UseCouponService）中提供4个方法（此处代码过多，就不贴了，可以通过gitee查看源码）

1）用户优惠券列表（未使用、即将过期、已使用、已过期）

应用场景：用户查看自己的优惠券列表

2）用户最优的可用优惠券

应用场景：商品展示券后价、支付时自动为用户选择优惠券

3）用户可用优惠券列表

应用场景：支付时展示选择优惠券的列表

4）判断优惠券能否使用

应用场景：创建订单时校验优惠券

核心思想：遍历优惠券的多个使用条件，判断有1个条件不满足就返回优惠券无法使用

tips：此处利用CompletableFuture优化性能，实现了多线程并发判断每个使用条件，只要有1个条件不满足就立马返回。

4.如何新增1种使用条件？

1）实现接口UseCondition，重写canUse方法，以下为‘首单可用’使用条件的demo代码

把Bean名称配置到券模板使用条件表mk_coupon_template_condition即可使用该条件，无需新增其他代码。

怎么样？如果你觉得有用的话，还不快快收藏起来！！！

附：涉及的代码目录

github：GitHub - 897665787/springcloud-template: 一个基于springcloud netflix微服务框架，记录了关于微服务开发的一些最佳应用，欢迎大家学习指导。

gitee：springcloud-template: 一个基于springcloud netflix微服务框架，记录了关于微服务开发的一些最佳应用，欢迎大家学习指导。

springcloud-template
└── template-user
     └──controller
          └── CouponTestController -- 优惠券查询的测试代码演示
     └── coupon
          └── UseCouponService -- 优惠券查询的核心代码
          └── UseCondition -- 抽象定义使用条件
          └── UseParam -- 使用条件参数
          └── SeeParam -- 可见条件参数
          └── FilterParam -- 过滤商品参数
          └── impl -- 使用条件实现类（条件就新增到这下面）
               └── CouponBaseCondition -- 优惠券基础条件（必选）
               └── FirstOrderCondition -- 首单可用
               └── PinleiCondition -- 某商品品类可用
               └── PlatformCondition -- 仅指定平台可见可用
               └── ProductCodeCondition -- 指定商品可用
               └── TagCondition -- 某标签下的商品可用
               └── TimeRangeCondition -- 指定时间段可用