From b55cd9aad0835a96a790e61f9f89edc2fae1be9f Mon Sep 17 00:00:00 2001
From: 刘帅 <rr.iii@qq.com>
Date: 星期二, 29 九月 2026 01:26:37 +0800
Subject: [PATCH] 注释优化、格式优化

---
 cloud-server-other/src/main/java/com/dsh/other/entity/QrLink.java |   60 ++++++++++++++++++++++++++++++++++++++++++++++++++----------
 1 files changed, 50 insertions(+), 10 deletions(-)

diff --git a/cloud-server-other/src/main/java/com/dsh/other/entity/QrLink.java b/cloud-server-other/src/main/java/com/dsh/other/entity/QrLink.java
index be3bba8..f0da645 100644
--- a/cloud-server-other/src/main/java/com/dsh/other/entity/QrLink.java
+++ b/cloud-server-other/src/main/java/com/dsh/other/entity/QrLink.java
@@ -1,35 +1,75 @@
 package com.dsh.other.entity;
 
 import com.baomidou.mybatisplus.annotation.IdType;
-import com.baomidou.mybatisplus.annotation.TableId;
-import com.baomidou.mybatisplus.annotation.TableName;
 import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
 import com.baomidou.mybatisplus.annotation.TableLogic;
+import com.baomidou.mybatisplus.annotation.TableName;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Getter;
 import lombok.Setter;
+
 import java.util.Date;
 
 /** 二维码短链接实体,对应表 t_qr_link。 */
 @Getter
 @Setter
 @TableName("t_qr_link")
+@ApiModel(description = "二维码短链接")
 public class QrLink {
     @TableId(type = IdType.ID_WORKER)
+    @ApiModelProperty("主键 ID")
     private Long id;
-    @TableField("shortCode") private String shortCode;
+
+    @TableField("shortCode")
+    @ApiModelProperty("二维码短码")
+    private String shortCode;
+
+    @ApiModelProperty("二维码类型")
     private String type;
-    @TableField("storeId") private Integer storeId;
-    @TableField("siteId") private Integer siteId;
-    @TableField("bookingId") private Integer bookingId;
+
+    @TableField("storeId")
+    @ApiModelProperty("关联门店 ID")
+    private Integer storeId;
+
+    @TableField("siteId")
+    @ApiModelProperty("关联场地 ID")
+    private Integer siteId;
+
+    @TableField("bookingId")
+    @ApiModelProperty("关联预约订单 ID")
+    private Integer bookingId;
+
+    @ApiModelProperty("二维码名称")
     private String name;
+
+    @ApiModelProperty("投放渠道")
     private String channel;
-    @TableField("pageName") private String pageName;
-    @TableField("expiresAt") private Date expiresAt;
+
+    @TableField("pageName")
+    @ApiModelProperty("跳转页面名称")
+    private String pageName;
+
+    @TableField("expiresAt")
+    @ApiModelProperty("失效时间")
+    private Date expiresAt;
+
+    @ApiModelProperty("启用状态:0-停用,1-启用")
     private Integer enabled;
+
     /** 逻辑删除标识:0-正常,1-删除。 */
     @TableLogic
     @TableField("isDeleted")
+    @ApiModelProperty("逻辑删除标识:0-正常,1-删除")
     private Integer isDeleted;
-    /** 创建时间。 */ @TableField("createTime") private Date createTime;
-    @TableField("updateTime") private Date updateTime;
+
+    /** 创建时间。 */
+    @TableField("createTime")
+    @ApiModelProperty("创建时间")
+    private Date createTime;
+
+    @TableField("updateTime")
+    @ApiModelProperty("更新时间")
+    private Date updateTime;
 }

--
Gitblit v1.7.1