用户徽章（UserBadge）

概述

UserBadge 表示用户徽章资产及其解锁记录，用于描述某个用户与某个徽章之间的状态关系，以及相关时间与奖励发放信息。

业务含义

用户徽章资产与解锁记录。

字段定义

字段名	类型	必填	默认值	说明	状态值枚举
userBadgeId	string	是	-	用户徽章记录 ID	-
userId	string	是	-	用户 ID	-
badgeId	string	是	-	徽章 ID	-
unlockStatus	enum	是	locked	当前用户状态	locked, unlockable, unlocked
unlockTime	datetime	否	null	解锁时间	-
bonusPointsGranted	bool	是	false	是否已发放额外积分	-
createdAt	datetime	是	当前时间	创建时间	-
updatedAt	datetime	是	当前时间	更新时间	-

状态说明

unlockStatus

• locked：未满足解锁条件，徽章处于锁定状态
• unlockable：已满足解锁条件，可解锁
• unlocked：已完成解锁

设计要点

• userBadgeId 用于唯一标识一条用户徽章记录。
• userId 与 badgeId 共同描述某用户对应的某一枚徽章。
• unlockTime 仅在徽章实际解锁后有值。
• bonusPointsGranted 用于标记该徽章对应的额外积分是否已发放，避免重复发放。
• createdAt 和 updatedAt 用于记录数据创建与变更时间。