【营销】砍价活动

砍价功能，主要 后端模块的 bargain 实现，包括三部分：砍价活动、砍价助力。如下图所示：

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

## 1. 砍价活动
砍价活动，由卖家在管理后台配置，提供给买家参与砍价，由 BargainActivityService 类实现。
### 1.1 表结构
不同于砍价、砍价活动，一个砍价活动，只对应一个商品 SKU。
> CREATE TABLE `promotion_bargain_activity` (
 `id` bigint NOT NULL AUTO_INCREMENT COMMENT '砍价活动编号',
 `name` varchar(200) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL DEFAULT '' COMMENT '砍价活动名称',
 `spu_id` bigint NOT NULL DEFAULT '0' COMMENT '商品 SPU 编号',
 `sku_id` bigint NOT NULL COMMENT '商品 SKU 编号',
 `status` int NOT NULL DEFAULT '0' COMMENT '活动状态',
 `total_limit_count` int NOT NULL DEFAULT '0' COMMENT '总限购数量',
 `start_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '活动开始时间',
 `end_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '活动结束时间',
 `bargain_first_price` int NOT NULL DEFAULT '0' COMMENT '砍价起始价格，单位分',
 `bargain_min_price` int NOT NULL DEFAULT '0' COMMENT '砍价底价，单位：分',
 `help_max_count` int NOT NULL DEFAULT '0' COMMENT '砍价人数',
 `bargain_count` int NOT NULL DEFAULT '0' COMMENT '最大帮砍次数',
 `random_min_price` int NOT NULL DEFAULT '0' COMMENT '用户每次砍价的最小金额，单位：分',
 `random_max_price` int NOT NULL DEFAULT '0' COMMENT '用户每次砍价的最大金额，单位：分',
 `stock` int NOT NULL DEFAULT '0' COMMENT '砍价库存',
 `total_stock` int NOT NULL DEFAULT '0' COMMENT '砍价总库存',
 PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=26 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='砍价活动';

① spu_id、sku_id 字段：对应的商品 SPU 编号、商品 SKU 编号。
注意：一个砍价活动，只能对应一个商品 SKU，不能对应多个商品 SPU 或者 SKU！！！
② status 字段：活动状态，由 CommonStatusEnum 枚举，只有开启、禁用两个状态。禁用时，无法参与砍价。
③ stock、total_stock 字段：砍价库存，自定义参与砍价的数量。
④ bargain_first_price、bargain_min_price 字段：砍价起始价格、砍价最低价格。比如商品原价 100 元，砍价起始价格 80 元，砍价底价 50 元，那么用户发起砍价时的价格为 80 元，最多邀请好友砍价到 50 元。
help_max_count 字段：砍价人数，需要多少人，砍价才能成功。如果不砍价成功，则该砍价记录不允许下单支付。
help_max_count 字段：单个活动，用户可以帮砍的次数。例如说：帮砍次数为 1 时，A 和 B 同时将该活动链接发给 C，C 只能帮其中一个人砍价。
random_min_price、random_max_price 字段：用户每次砍价的最小金额、最大金额。比如用户每次砍价的金额为 1 元到 10 元之间的随机数。

### 1.2 管理后台
对应 [商城系统 -> 营销中心 -> 砍价活动 -> 砍价商品] 菜单，如下图所示：

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

### 1.3 移动端
TODO 界面迁移后，补充

## 2. 砍价记录
砍价记录，由买家发起砍价时生成，后续可邀请好友助力（砍价），由 BargainRecordService 类实现。

### 2.1 表结构
> CREATE TABLE `promotion_bargain_record` (
 `id` bigint NOT NULL AUTO_INCREMENT COMMENT '砍价记录编号',
 `activity_id` bigint NOT NULL COMMENT '砍价活动名称', 
 `spu_id` bigint NOT NULL DEFAULT '0' COMMENT '商品 SPU 编号',
 `sku_id` bigint NOT NULL COMMENT '商品 SKU 编号',
 `user_id` bigint NOT NULL COMMENT '用户编号',
 `status` int NOT NULL DEFAULT '0' COMMENT '砍价状态',
 `bargain_first_price` int NOT NULL DEFAULT '0' COMMENT '砍价起始价格，单位：分',
 `bargain_price` int NOT NULL DEFAULT '0' COMMENT '当前砍价，单位：分',
 `end_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '结束时间',
 `order_id` bigint DEFAULT NULL COMMENT '订单编号',
 PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=33 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='砍价记录表';

① 【活动信息】activity_id 字段：砍价活动编号，对应 promotion_bargain_activity 表的 id 字段。其它 spu_id、sku_id 字段，都是冗余字段，方便查询。
② 【用户信息】user_id 字段：用户编号，就是砍价发起的买家。
③ 【砍价信息】status 字段：砍价状态，由 BargainRecordStatusEnum 枚举，分成 3 种情况：砍价中、砍价成功、砍价失败。
bargain_first_price、bargain_price 字段：砍价起始价格、当前砍价。
④ 【订单信息】order_id 字段：订单编号，对应订单表的 id 字段。砍价记录的 status 为砍价成功时，才可以创建并支付订单。

### 2.2 管理后台
对应 [商城系统 -> 营销中心 -> 砍价活动 -> 砍价记录] 菜单，如下图所示：

### 2.3 移动端
TODO 界面迁移后，补充

### 3. 砍价助力
砍价助力，给好友的砍价记录助力（砍价）时生成，由 BargainHelpService 类实现。

### 3.1 表结构
> CREATE TABLE `promotion_bargain_help` (
 `id` bigint NOT NULL AUTO_INCREMENT COMMENT '砍价助力编号',
 `user_id` bigint NOT NULL COMMENT '用户编号',
 `activity_id` bigint NOT NULL COMMENT '砍价活动名称',
 `record_id` bigint NOT NULL DEFAULT '0' COMMENT '砍价记录编号',
 `reduce_price` int NOT NULL DEFAULT '0' COMMENT '减少砍价，单位：分',
 PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=37 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='砍价助力表';

## 3.2 管理后台
点击某个砍价记录后面的「助力」按钮，可以查看它的助力列表。如下图所示：

![](/media/202408/2024-08-28_172416_997578.png)
3.3 移动端
TODO 界面迁移后，补充