本文主要分享了如何设计一个可扩展的优惠券功能。
一、功能特性介绍
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 -- 指定时间段可用