Merge #88 into master from cc_20260401_private_sphere_qr

fix:私域二维码

* cc_20260401_private_sphere_qr: (3 commits squashed)

  - fix:新增防抖

  - Merge branch 'refs/heads/cc_20260302_debounce' into cc_20260401_private_sphere_qr

  - fix:私域二维码

Signed-off-by: 王非凡 <accounts_67eba0c5fee9c49c80c8e2b4@mail.teambition.com>
Merged-by: 正新 <accounts_6964c7bcd2a2c377c5bbd01b@mail.teambition.com>

CR-link: https://codeup.aliyun.com/692ea314dec569489f6f167c/hangzhou/java/custom_zxjp/change/88

coolstore-partner-model/src/main/java/com/cool/store/request/privatesphere/PrivateSphereBindRequest.java

@@ -0,0 +1,25 @@
+package com.cool.store.request.privatesphere;
+
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+import javax.validation.constraints.NotBlank;
+
+/**
+ * <p>
+ * 门店设备sn绑定
+ * </p>
+ *
+ * @author wangff
+ * @since 2026/4/2
+ */
+@Data
+public class PrivateSphereBindRequest {
+    @ApiModelProperty("门店id")
+    @NotBlank(message = "门店id不能为空")
+    private String storeId;
+    
+    @ApiModelProperty("设备sn")
+    @NotBlank(message = "设备sn不能为空")
+    private String sn;
+}

coolstore-partner-model/src/main/java/com/cool/store/request/privatesphere/PrivateSphereSnRequest.java

@@ -0,0 +1,24 @@
+package com.cool.store.request.privatesphere;
+
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+import javax.validation.constraints.NotBlank;
+
+/**
+ * <p>
+ * 设备sn
+ * </p>
+ *
+ * @author wangff
+ * @since 2026/4/2
+ */
+@Data
+public class PrivateSphereSnRequest {
+    @ApiModelProperty("设备sn")
+    @NotBlank(message = "设备sn不能为空")
+    private String sn;
+
+    @ApiModelProperty(value = "客户端IP", hidden = true)
+    private String clientIp;
+}

coolstore-partner-model/src/main/java/com/cool/store/vo/privatesphere/PrivateSphereVO.java

@@ -0,0 +1,40 @@
+package com.cool.store.vo.privatesphere;
+
+import io.swagger.annotations.ApiModelProperty;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+
+/**
+ * <p>
+ * 私域二维码VO
+ * </p>
+ *
+ * @author wangff
+ * @since 2026/4/2
+ */
+@Data
+@AllArgsConstructor
+public class PrivateSphereVO {
+    @ApiModelProperty("状态，0正常，1未绑定sn，2门店未维护私域二维码，3IP限制")
+    private Integer status;
+
+    @ApiModelProperty("二维码地址")
+    private String qrCodeUrl;
+
+    public PrivateSphereVO(String url) {
+        this.qrCodeUrl = url;
+        this.status = 0;
+    }
+
+    public static PrivateSphereVO unbind() {
+        return new PrivateSphereVO(1,  null);
+    }
+
+    public static PrivateSphereVO noMaintain() {
+        return new PrivateSphereVO(2,  null);
+    }
+
+    public static PrivateSphereVO ipLimit() {
+        return new PrivateSphereVO(3,  null);
+    }
+}