From 778cf4a0cb22b01d6ab77c5418e075464bdd210b Mon Sep 17 00:00:00 2001
From: ziin <hiziying@hotmail.com>
Date: Mon, 29 Dec 2025 13:59:02 +0800
Subject: [PATCH] =?UTF-8?q?fix(entity):=20=E8=A1=A5=E5=85=A8=E7=94=A8?=
 =?UTF-8?q?=E6=88=B7=E9=82=80=E8=AF=B7=E7=BB=91=E5=AE=9A=E5=8F=B0=E8=B4=A6?=
 =?UTF-8?q?=E5=AD=97=E6=AE=B5=E4=B8=8E=E6=B3=A8=E9=87=8A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

为 KeyboardUserInvites 实体新增 clickToken、inviteType、profitTenantId、profitEmployeeId、inviterTenantId、inviteCode 等字段，并统一 Schema 注解空格格式，满足邀请链接归因、代理结算及审计需求。
---
 .../model/entity/KeyboardUserInvites.java     | 63 +++++++++++++++----
 1 file changed, 52 insertions(+), 11 deletions(-)

diff --git a/src/main/java/com/yolo/keyborad/model/entity/KeyboardUserInvites.java b/src/main/java/com/yolo/keyborad/model/entity/KeyboardUserInvites.java
index 6e0eafb..1a41b77 100644
--- a/src/main/java/com/yolo/keyborad/model/entity/KeyboardUserInvites.java
+++ b/src/main/java/com/yolo/keyborad/model/entity/KeyboardUserInvites.java
@@ -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;
 }
\ No newline at end of file