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
* @date: 2025/12/19 13:26
* @date: 2025/12/29 13:58
*/
/**
* 用户邀请关系绑定台账表,记录新用户最终归属的邀请人
*/
@Schema(description="用户邀请关系绑定台账表,记录新用户最终归属的邀请人")
@Schema(description = "用户邀请关系绑定台账表,记录新用户最终归属的邀请人")
@Data
@TableName(value = "keyboard_user_invites")
public class KeyboardUserInvites {
@@ -24,56 +24,97 @@ public class KeyboardUserInvites {
* 邀请绑定记录主键ID
*/
@TableId(value = "id", type = IdType.AUTO)
@Schema(description="邀请绑定记录主键ID")
@Schema(description = "邀请绑定记录主键ID")
private Long id;
/**
* 邀请人用户ID
*/
@TableField(value = "inviter_user_id")
@Schema(description="邀请人用户ID")
@Schema(description = "邀请人用户ID")
private Long inviterUserId;
/**
* 被邀请人用户ID新注册用户
*/
@TableField(value = "invitee_user_id")
@Schema(description="被邀请人用户ID新注册用户")
@Schema(description = "被邀请人用户ID新注册用户")
private Long inviteeUserId;
/**
* 使用的邀请码ID
*/
@TableField(value = "invite_code_id")
@Schema(description="使用的邀请码ID")
@Schema(description = "使用的邀请码ID")
private Long inviteCodeId;
/**
* 绑定时关联的点击Token通过邀请链接自动绑定时使用
*/
@TableField(value = "click_token")
@Schema(description = "绑定时关联的点击Token通过邀请链接自动绑定时使用")
private String clickToken;
/**
* 绑定方式1=手动填写邀请码2=邀请链接自动绑定3=其他方式
*/
@TableField(value = "bind_type")
@Schema(description="绑定方式1=手动填写邀请码2=邀请链接自动绑定3=其他方式")
@Schema(description = "绑定方式1=手动填写邀请码2=邀请链接自动绑定3=其他方式")
private Short bindType;
/**
* 邀请关系绑定完成时间
*/
@TableField(value = "bound_at")
@Schema(description="邀请关系绑定完成时间")
@Schema(description = "邀请关系绑定完成时间")
private Date boundAt;
/**
* 绑定 iP
*/
@TableField(value = "bind_ip")
@Schema(description="绑定 iP")
@Schema(description = "绑定 iP")
private String bindIp;
/**
* userAgent
*/
@TableField(value = "bind_user_agent")
@Schema(description="userAgent")
@Schema(description = "userAgent")
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;
}