会员等级、积分、签到

本小节，我们主要看看会员等级、积分、签到相关的表。

## [#](https://doc.iocoder.cn/member/level/#_1-%E4%BC%9A%E5%91%98%E7%AD%89%E7%BA%A7)1. 会员等级

会员等级，将会员分成不同的等级，给予相应的折扣。例如说：商城下单时，会员等级为 1 的用户，可以享受 9 折优惠。

它的后端由 `level` 包实现，表关系如下图所示：

![会员等级表](/media/202404/2024-04-26_1618580.8861717501306579.png)

### [#](https://doc.iocoder.cn/member/level/#_1-1-%E8%A1%A8%E7%BB%93%E6%9E%84)1.1 表结构

`member_level` 表，会员等级（配置）表，由 MemberLevelService 实现。表结构如下：

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

```sql
CREATE TABLE `member_level` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',
  `name` varchar(30) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '等级名称',
  `level` int NOT NULL DEFAULT '0' COMMENT '等级',
  `experience` int NOT NULL DEFAULT '0' COMMENT '升级经验',
  `discount_percent` tinyint NOT NULL DEFAULT '100' COMMENT '享受折扣',
  `icon` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '等级图标',
  `background_url` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '等级背景图',
  `status` tinyint NOT NULL DEFAULT '0' COMMENT '状态',
  PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=4 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='会员等级';
```

① `level` 字段：会员等级，从 1 开始，越大等级越高。

② `experience` 字段：升级经验，当用户的经验值达到此值时，会员等级自动升级。

③ `discount_percent` 字段：享受折扣，例如说：100 表示不打折，90 表示 9 折，80 表示 8 折。

---

`member_level_record` 表，会员等级记录变更表，由 MemberLevelRecordService 实现。表结构如下：

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

```sql
CREATE TABLE `member_level_record` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',
  `user_id` bigint NOT NULL DEFAULT '0' COMMENT '用户编号',
  `level_id` bigint NOT NULL DEFAULT '0' COMMENT '等级编号',
  `level` int NOT NULL DEFAULT '0' COMMENT '会员等级',
  `discount_percent` tinyint NOT NULL DEFAULT '100' COMMENT '享受折扣',
  `experience` int NOT NULL DEFAULT '0' COMMENT '升级经验',
  `remark` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '备注',
  `description` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '描述',
  
  `user_experience` int NOT NULL DEFAULT '0' COMMENT '会员此时的经验',
  PRIMARY KEY (`id`) USING BTREE,
  KEY `idx_user_id` (`user_id`) USING BTREE COMMENT '会员等级记录-用户编号'
) ENGINE=InnoDB AUTO_INCREMENT=33 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='会员等级记录';
```

每次会员等级变更时，都会记录到此表中。并且，会记录 `user_experience` 字段，表示会员此时的经验值。

---

`member_experience_record` 表，会员经验变更记录表，由 MemberExperienceRecordService 实现。表结构如下：

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

```sql
CREATE TABLE `member_experience_record` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',
  `user_id` bigint NOT NULL DEFAULT '0' COMMENT '用户编号',
  `biz_id` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '业务编号',
  `biz_type` tinyint NOT NULL DEFAULT '0' COMMENT '业务类型',
  `title` varchar(30) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '标题',
  `description` varchar(512) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '描述',
  `experience` int NOT NULL DEFAULT '0' COMMENT '经验',
  `total_experience` int NOT NULL DEFAULT '0' COMMENT '变更后的经验',
  PRIMARY KEY (`id`) USING BTREE,
  KEY `idx_user_id` (`user_id`) USING BTREE COMMENT '会员经验记录-用户编号',
  KEY `idx_user_biz_type` (`user_id`,`biz_type`) USING BTREE COMMENT '会员经验记录-用户业务类型'
) ENGINE=InnoDB AUTO_INCREMENT=63 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='会员经验记录';
```

每次会员经验变更时，都会记录到此表中。并且，会记录 `total_experience` 字段，表示变更后的经验值。

另外，`biz_type` 字段，表示业务类型，对应 MemberExperienceBizTypeEnum 枚举，目前有管理员调整、签到奖励、下单奖励等等。

### [#](https://doc.iocoder.cn/member/level/#_1-2-%E7%AE%A1%E7%90%86%E5%90%8E%E5%8F%B0)1.2 管理后台

① 会员等级，对应 [会员系统 -> 会员中心 -> 会员等级] 菜单，对应 `yudao-ui-admin-vue3` 项目的 `views/member/level/index.vue` 目录。如下图所示：

![管理后台](/media/202404/2024-04-26_1618590.8064201759793895.png)

② 会员详情的 [成长值] 标签，可以查看 `member_experience_record` 表的记录，对应 `views/member/user/detail/UserExperienceRecordList.vue` 组件。如下图所示：

![会员详情 - 成长值](/media/202404/2024-04-26_1618590.5317350569668956.png)

### [#](https://doc.iocoder.cn/member/level/#_1-3-%E7%A7%BB%E5%8A%A8%E7%AB%AF)1.3 移动端

① 会员等级、经验信息，在 `yudao-mall-uniapp` 暂时没有展示。

② 商城下单时，会员等级的折扣计算，通过 TradeMemberLevelPriceCalculator 实现。

## [#](https://doc.iocoder.cn/member/level/#_2-%E4%BC%9A%E5%91%98%E7%A7%AF%E5%88%86)2. 会员积分

会员积分，一般用于积分抵扣金额。例如说：商城下单时，会员积分为 100 的用户，可以抵扣 1 元。

它的后端由 `point` 包的 MemberPointRecordService 实现。

### [#](https://doc.iocoder.cn/member/level/#_2-1-%E8%A1%A8%E7%BB%93%E6%9E%84)2.1 表结构

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

```sql
CREATE TABLE `member_point_record` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '自增主键',
  
  `user_id` bigint NOT NULL COMMENT '用户编号',
  
  `biz_id` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '业务编码',
  `biz_type` tinyint NOT NULL COMMENT '业务类型',
  `title` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '积分标题',
  `description` varchar(5000) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '积分描述',
  
  `point` int NOT NULL COMMENT '积分',
  `total_point` int NOT NULL COMMENT '变动后的积分',
  PRIMARY KEY (`id`) USING BTREE,
  KEY `index_userId` (`user_id`) USING BTREE,
  KEY `index_title` (`title`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=89 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='用户积分记录';
```

① `user_id` 字段：用户编号，属于哪个会员用户。

② `biz_type` 字段：业务类型，对应 MemberPointBizTypeEnum 枚举，目前有管理员调整、签到奖励、下单奖励等等。

③ `point`、`total_point` 字段：积分、变动后的积分。所以会员积分变更时，都会记录到此表中。

### [#](https://doc.iocoder.cn/member/level/#_2-2-%E7%AE%A1%E7%90%86%E5%90%8E%E5%8F%B0)2.2 管理后台

① 对应 [会员系统 -> 会员中心 -> 会员积分] 菜单，对应 `yudao-ui-admin-vue3` 项目的 `views/member/point/record` 目录。如下图所示：

![管理后台](/media/202404/2024-04-26_1618590.9587605938908048.png)

② 会员详情的 [积分] 标签，可以查看 `member_point_record` 表的记录，对应 `views/member/user/detail/UserPointList.vue` 组件。如下图所示：

![会员详情 - 积分](/media/202404/2024-04-26_1618590.494567711129702.png)

### [#](https://doc.iocoder.cn/member/level/#_2-3-%E7%A7%BB%E5%8A%A8%E7%AB%AF)2.3 移动端

点击 uni-app 底部的 [我的] 导航，点击 [积分] 菜单，进入积分信息界面，对应 `yudao-mall-uniapp` 项目的 `pages/user/wallet/score.vue` 页面。如下图所示：

![移动端](/media/202404/2024-04-26_1618590.2799683083618859.png)

## [#](https://doc.iocoder.cn/member/level/#_3-%E4%BC%9A%E5%91%98%E7%AD%BE%E5%88%B0)3. 会员签到

会员签到，通过每日签到，获得积分、经验等奖励。

它的后端由 `signin` 包实现，表关系如下图所示：

![表关系](/media/202404/2024-04-26_1618590.4930033909066033.png)

### [#](https://doc.iocoder.cn/member/level/#_3-1-%E8%A1%A8%E7%BB%93%E6%9E%84)3.1 表结构

`member_sign_in_config` 表，会员签到配置表，由 MemberSignInConfigService 实现。表结构如下：

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

```sql
CREATE TABLE `member_sign_in_config` (
  `id` int NOT NULL AUTO_INCREMENT COMMENT '编号',
  `day` int NOT NULL COMMENT '第几天',
  `point` int NOT NULL COMMENT '奖励积分',
  `experience` int NOT NULL DEFAULT '0' COMMENT '奖励经验',
  `status` tinyint NOT NULL COMMENT '状态',
  PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=13 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='签到规则';
```

① `day` 字段：第几天，例如说：第 1 天、第 2 天、第 3 天等等。

② `point`、`experience` 字段：奖励积分、奖励经验。

---

`member_sign_in_record` 表，会员签到记录表，由 MemberSignInRecordService 实现。表结构如下：

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

```sql
CREATE TABLE `member_sign_in_record` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '签到自增id',
  
  `user_id` int DEFAULT NULL COMMENT '签到用户',
  
  `day` int DEFAULT NULL COMMENT '第几天签到',
  
  `point` int NOT NULL DEFAULT '0' COMMENT '签到的分数',
  `experience` int NOT NULL DEFAULT '0' COMMENT '奖励经验',
  PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=12 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='签到记录';
```

① `user_id` 字段：用户编号，属于哪个会员用户。

② `day` 字段：第几天签到，例如说：第 1 天、第 2 天、第 3 天等等。

③ `point`、`experience` 字段：签到的分数、奖励经验。冗余的原因，是 `member_sign_in_config` 表的 `point`、`experience` 字段，可能会变更。

### [#](https://doc.iocoder.cn/member/level/#_3-2-%E7%AE%A1%E7%90%86%E5%90%8E%E5%8F%B0)3.2 管理后台

① 对应 [会员系统 -> 会员中心 -> 会员签到 -> 签到配置] 菜单，对应 `yudao-ui-admin-vue3` 项目的 `views/member/signin/config` 目录。如下图所示：

![管理后台 - 签到配置](/media/202404/2024-04-26_1618590.16769056923750725.png)

② 对应 [会员系统 -> 会员中心 -> 会员签到 -> 签到记录] 菜单，对应 `yudao-ui-admin-vue3` 项目的 `views/member/signin/record` 目录。如下图所示：

![管理后台 - 签到记录](/media/202404/2024-04-26_1618590.1420414368659565.png)

③ 会员详情的 [签到] 标签，可以查看 `member_sign_in_record` 表的记录，对应 `views/member/user/detail/UserSignList.vue` 组件。如下图所示：

![会员详情 - 签到](/media/202404/2024-04-26_1618590.09112184970717663.png)

### [#](https://doc.iocoder.cn/member/level/#_3-3-%E7%A7%BB%E5%8A%A8%E7%AB%AF)3.3 移动端

点击 uni-app 底部的 [我的] 导航，点击 [签到] 菜单，进入签到界面，对应 `yudao-mall-uniapp` 项目的 `pages/app/sign.vue` 页面。如下图所示：

![移动端](/media/202404/2024-04-26_1618590.029229103459801564.png)