LotteryRecord（抽奖记录）

概述

LotteryRecord 表示用户每次抽奖结果的记录，用于保存抽奖行为、奖品结果、积分消耗、领取状态以及幂等控制等信息。

业务含义

用户每次抽奖结果记录。

字段定义

字段名	类型	必填	默认值	字段说明	状态值枚举
recordId	string	是	-	抽奖记录 ID	-
userId	string	是	-	用户 ID	-
prizeId	string	是	-	奖品 ID	-
costPoints	int	是	0	消耗积分	-
resultStatus	enum	是	won	抽奖结果	won, not_won
claimStatus	enum	是	issued	领取状态	issued, contacted, claimed, closed
idempotencyKey	string	是	-	幂等键	-
createdAt	datetime	是	当前时间	抽奖时间	-

枚举说明

resultStatus

• won：中奖
• not_won：未中奖

claimStatus

• issued：已发放/初始领取状态
• contacted：已联系用户
• claimed：已领取
• closed：已关闭

设计要点

• recordId 用于唯一标识一次抽奖记录。
• idempotencyKey 用于保证抽奖请求幂等，避免重复创建记录。
• costPoints 记录本次抽奖消耗的积分值。
• createdAt 记录抽奖发生时间，默认取当前时间。