开发指南
商城手册

【营销】积分商城

积分商城，主要由 yudao-module-promotion-biz 后端模块的 point 实现，支持纯积分兑换商品、或者积分 + 金额兑换商品。

表关系

# 1. 表结构

一个积分活动，对应一条 promotion_point_activity 表记录，对应一个商品 SPU。而每个商品 SKU 在该活动下可以单独配置兑换价格，所以会有多条 promotion_point_product 子表记录。

省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段

CREATE TABLE `promotion_point_activity` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '积分商城活动编号',
  `remark` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
  `sort` int NOT NULL COMMENT '排序',
  
  `spu_id` bigint NOT NULL COMMENT '商品 SPU ID',
  
  `status` int NOT NULL COMMENT '活动状态',
  
  `stock` int NOT NULL COMMENT '积分商城活动库存(剩余库存积分兑换时扣减)',
  `total_stock` int NOT NULL COMMENT '积分商城活动总库存',
  PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci ROW_FORMAT=DYNAMIC COMMENT='积分商城活动';

① spu_id 字段：商品 SPU ID，对应商品 SPU 表的 id 字段。

注意：一个积分活动，只能对应一个商品 SPU，不能对应多个商品 SPU！！！

② status 字段：活动状态，由 CommonStatusEnum 枚举，只有开启、禁用两个状态。禁用时，无法参与积分兑换。

③ stock、total_stock 字段：积分商城活动库存，自定义参与积分兑换的数量。目前它是 promotion_point_product 表的 stock 字段的总和。

CREATE TABLE `promotion_point_product` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '积分商城商品编号',

  `activity_id` bigint NOT NULL COMMENT '积分商城活动 id',  
  `activity_status` int NOT NULL COMMENT '积分商城商品状态',
  
  `spu_id` bigint NOT NULL COMMENT '商品 SPU 编号',
  `sku_id` bigint NOT NULL COMMENT '商品 SKU 编号',
  
  `count` int NOT NULL COMMENT '可兑换次数',
  `stock` int NOT NULL COMMENT '积分商城商品库存',

  `point` int NOT NULL COMMENT '所需兑换积分',
  `price` int NOT NULL COMMENT '所需兑换金额，单位：分',
  PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=4 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci ROW_FORMAT=DYNAMIC COMMENT='积分商城商品';