fix(entity): 补全用户邀请绑定台账字段与注释

为 KeyboardUserInvites 实体新增 clickToken、inviteType、profitTenantId、profitEmployeeId、inviterTenantId、inviteCode 等字段,并统一 Schema 注解空格格式,满足邀请链接归因、代理结算及审计需求。
This commit is contained in:
2025-12-29 13:59:02 +08:00
parent fb0c0c34a9
commit 778cf4a0cb

View File

@@ -10,13 +10,13 @@ import lombok.Data;
/* /*
* @author: ziin * @author: ziin
* @date: 2025/12/19 13:26 * @date: 2025/12/29 13:58
*/ */
/** /**
* 用户邀请关系绑定台账表,记录新用户最终归属的邀请人 * 用户邀请关系绑定台账表,记录新用户最终归属的邀请人
*/ */
@Schema(description="用户邀请关系绑定台账表,记录新用户最终归属的邀请人") @Schema(description = "用户邀请关系绑定台账表,记录新用户最终归属的邀请人")
@Data @Data
@TableName(value = "keyboard_user_invites") @TableName(value = "keyboard_user_invites")
public class KeyboardUserInvites { public class KeyboardUserInvites {
@@ -24,56 +24,97 @@ public class KeyboardUserInvites {
* 邀请绑定记录主键ID * 邀请绑定记录主键ID
*/ */
@TableId(value = "id", type = IdType.AUTO) @TableId(value = "id", type = IdType.AUTO)
@Schema(description="邀请绑定记录主键ID") @Schema(description = "邀请绑定记录主键ID")
private Long id; private Long id;
/** /**
* 邀请人用户ID * 邀请人用户ID
*/ */
@TableField(value = "inviter_user_id") @TableField(value = "inviter_user_id")
@Schema(description="邀请人用户ID") @Schema(description = "邀请人用户ID")
private Long inviterUserId; private Long inviterUserId;
/** /**
* 被邀请人用户ID新注册用户 * 被邀请人用户ID新注册用户
*/ */
@TableField(value = "invitee_user_id") @TableField(value = "invitee_user_id")
@Schema(description="被邀请人用户ID新注册用户") @Schema(description = "被邀请人用户ID新注册用户")
private Long inviteeUserId; private Long inviteeUserId;
/** /**
* 使用的邀请码ID * 使用的邀请码ID
*/ */
@TableField(value = "invite_code_id") @TableField(value = "invite_code_id")
@Schema(description="使用的邀请码ID") @Schema(description = "使用的邀请码ID")
private Long inviteCodeId; private Long inviteCodeId;
/**
* 绑定时关联的点击Token通过邀请链接自动绑定时使用
*/
@TableField(value = "click_token")
@Schema(description = "绑定时关联的点击Token通过邀请链接自动绑定时使用")
private String clickToken;
/** /**
* 绑定方式1=手动填写邀请码2=邀请链接自动绑定3=其他方式 * 绑定方式1=手动填写邀请码2=邀请链接自动绑定3=其他方式
*/ */
@TableField(value = "bind_type") @TableField(value = "bind_type")
@Schema(description="绑定方式1=手动填写邀请码2=邀请链接自动绑定3=其他方式") @Schema(description = "绑定方式1=手动填写邀请码2=邀请链接自动绑定3=其他方式")
private Short bindType; private Short bindType;
/** /**
* 邀请关系绑定完成时间 * 邀请关系绑定完成时间
*/ */
@TableField(value = "bound_at") @TableField(value = "bound_at")
@Schema(description="邀请关系绑定完成时间") @Schema(description = "邀请关系绑定完成时间")
private Date boundAt; private Date boundAt;
/** /**
* 绑定 iP * 绑定 iP
*/ */
@TableField(value = "bind_ip") @TableField(value = "bind_ip")
@Schema(description="绑定 iP") @Schema(description = "绑定 iP")
private String bindIp; private String bindIp;
/** /**
* userAgent * userAgent
*/ */
@TableField(value = "bind_user_agent") @TableField(value = "bind_user_agent")
@Schema(description="userAgent") @Schema(description = "userAgent")
private String bindUserAgent; private String bindUserAgent;
/**
* 邀请码类型快照USER=普通用户邀请AGENT=代理邀请
*/
@TableField(value = "invite_type")
@Schema(description = "邀请码类型快照USER=普通用户邀请AGENT=代理邀请")
private String inviteType;
/**
* 收益结算归属租户ID代理结算用绑定时固化
*/
@TableField(value = "profit_tenant_id")
@Schema(description = "收益结算归属租户ID代理结算用绑定时固化")
private Long profitTenantId;
/**
* 收益归因员工ID用于区分租户员工/渠道,绑定时固化)
*/
@TableField(value = "profit_employee_id")
@Schema(description = "收益归因员工ID用于区分租户员工/渠道,绑定时固化)")
private Long profitEmployeeId;
/**
* 邀请人所属租户ID快照便于审计/对账,可选)
*/
@TableField(value = "inviter_tenant_id")
@Schema(description = "邀请人所属租户ID快照便于审计/对账,可选)")
private Long inviterTenantId;
/**
* 邀请码字符串快照(便于排查,可选)
*/
@TableField(value = "invite_code")
@Schema(description = "邀请码字符串快照(便于排查,可选)")
private String inviteCode;
} }