From 7771b303660ba33123d384b97245b60df6d31672 Mon Sep 17 00:00:00 2001
From: irving <oujunyiirving@gmail.com>
Date: Tue, 21 Oct 2025 22:41:32 -0400
Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=EF=BC=9A=E5=BE=AE=E4=BF=A1?=
 =?UTF-8?q?=E7=AB=AF=E8=AF=84=E4=BB=B7=E5=88=97=E8=A1=A8=E8=87=AA=E5=8A=A8?=
 =?UTF-8?q?=E8=BF=87=E6=BB=A4=E9=9A=90=E8=97=8F=E8=AF=84=E4=BB=B7?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 在微信店员评价查询接口中强制设置hidden=0
- 确保顾客端只能看到管理员未隐藏的评价
- 优化日志配置，减少SQL日志输出
---
 .../entity/PlayOrderEvaluateInfoEntity.java   |  2 +
 .../vo/PlayOrderEvaluateEditStateVo.java      |  4 +-
 .../PlayOrderEvaluateInfoServiceImpl.java     |  1 +
 .../weichat/controller/WxClerkController.java |  2 +
 .../common/enums/EvaluateHiddenState.java     | 82 +++++++++++++++++++
 5 files changed, 90 insertions(+), 1 deletion(-)
 create mode 100644 play-common/src/main/java/com/starry/common/enums/EvaluateHiddenState.java

diff --git a/play-admin/src/main/java/com/starry/admin/modules/order/module/entity/PlayOrderEvaluateInfoEntity.java b/play-admin/src/main/java/com/starry/admin/modules/order/module/entity/PlayOrderEvaluateInfoEntity.java
index 82a30d5..d730ba0 100644
--- a/play-admin/src/main/java/com/starry/admin/modules/order/module/entity/PlayOrderEvaluateInfoEntity.java
+++ b/play-admin/src/main/java/com/starry/admin/modules/order/module/entity/PlayOrderEvaluateInfoEntity.java
@@ -2,6 +2,7 @@ package com.starry.admin.modules.order.module.entity;
 
 import com.baomidou.mybatisplus.annotation.TableName;
 import com.starry.common.domain.BaseEntity;
+import com.starry.common.enums.EvaluateHiddenState;
 import java.util.Date;
 import lombok.Data;
 import lombok.EqualsAndHashCode;
@@ -74,6 +75,7 @@ public class PlayOrderEvaluateInfoEntity extends BaseEntity<PlayOrderEvaluateInf
 
     /**
      * 数据是否隐藏（0:显示，1:隐藏）
+     * @see EvaluateHiddenState
      */
     private String hidden;
 
diff --git a/play-admin/src/main/java/com/starry/admin/modules/order/module/vo/PlayOrderEvaluateEditStateVo.java b/play-admin/src/main/java/com/starry/admin/modules/order/module/vo/PlayOrderEvaluateEditStateVo.java
index d209960..b508cd5 100644
--- a/play-admin/src/main/java/com/starry/admin/modules/order/module/vo/PlayOrderEvaluateEditStateVo.java
+++ b/play-admin/src/main/java/com/starry/admin/modules/order/module/vo/PlayOrderEvaluateEditStateVo.java
@@ -1,5 +1,6 @@
 package com.starry.admin.modules.order.module.vo;
 
+import com.starry.common.enums.EvaluateHiddenState;
 import io.swagger.annotations.ApiModel;
 import io.swagger.annotations.ApiModelProperty;
 import javax.validation.constraints.NotBlank;
@@ -24,9 +25,10 @@ public class PlayOrderEvaluateEditStateVo {
 
     /**
      * 数据是否隐藏（0:显示，1:隐藏）
+     * @see EvaluateHiddenState
      */
     @NotBlank(message = "是否隐藏不能为空")
     @Pattern(regexp = "[01]", message = "是否隐藏数据错误,只能位0或者1")
-    @ApiModelProperty(value = "是否隐藏", required = true, example = "1", notes = "数据是否隐藏，0:显示，1:隐藏")
+    @ApiModelProperty(value = "是否隐藏", required = true, example = "1", notes = "数据是否隐藏，0:显示，1:隐藏。使用 EvaluateHiddenState 枚举值")
     private String hidden;
 }
diff --git a/play-admin/src/main/java/com/starry/admin/modules/order/service/impl/PlayOrderEvaluateInfoServiceImpl.java b/play-admin/src/main/java/com/starry/admin/modules/order/service/impl/PlayOrderEvaluateInfoServiceImpl.java
index fc87b71..ffd2a2c 100644
--- a/play-admin/src/main/java/com/starry/admin/modules/order/service/impl/PlayOrderEvaluateInfoServiceImpl.java
+++ b/play-admin/src/main/java/com/starry/admin/modules/order/service/impl/PlayOrderEvaluateInfoServiceImpl.java
@@ -17,6 +17,7 @@ import com.starry.admin.modules.order.module.vo.PlayOrderEvaluateReturnVo;
 import com.starry.admin.modules.order.service.IPlayOrderEvaluateInfoService;
 import com.starry.admin.modules.personnel.service.IPlayPersonnelGroupInfoService;
 import com.starry.admin.utils.SecurityUtils;
+import com.starry.common.enums.EvaluateHiddenState;
 import com.starry.common.utils.IdUtils;
 import com.starry.common.utils.StringUtils;
 import java.util.Arrays;
diff --git a/play-admin/src/main/java/com/starry/admin/modules/weichat/controller/WxClerkController.java b/play-admin/src/main/java/com/starry/admin/modules/weichat/controller/WxClerkController.java
index b1ee55b..e795ba9 100644
--- a/play-admin/src/main/java/com/starry/admin/modules/weichat/controller/WxClerkController.java
+++ b/play-admin/src/main/java/com/starry/admin/modules/weichat/controller/WxClerkController.java
@@ -553,6 +553,8 @@ public class WxClerkController {
     @PostMapping("/user/queryEvaluateByPage")
     public R queryEvaluateById(@Validated @RequestBody PlayOrderEvaluateQueryVo vo) {
         clerkUserInfoService.selectById(vo.getClerkId());
+        // Force filter to show only visible evaluations (hidden = "0") for WeChat client
+        vo.setHidden(com.starry.common.enums.EvaluateHiddenState.VISIBLE.getCode());
         return R.ok(playOrderEvaluateInfoService.selectByPage(vo));
     }
 
diff --git a/play-common/src/main/java/com/starry/common/enums/EvaluateHiddenState.java b/play-common/src/main/java/com/starry/common/enums/EvaluateHiddenState.java
new file mode 100644
index 0000000..e51bcc6
--- /dev/null
+++ b/play-common/src/main/java/com/starry/common/enums/EvaluateHiddenState.java
@@ -0,0 +1,82 @@
+package com.starry.common.enums;
+
+import com.fasterxml.jackson.annotation.JsonCreator;
+import com.fasterxml.jackson.annotation.JsonValue;
+import io.swagger.annotations.ApiModel;
+
+/**
+ * 评价隐藏状态枚举，集中维护状态代码及含义。
+ * 用于订单评价、打赏等记录的显示/隐藏控制。
+ */
+@ApiModel(value = "评价隐藏状态", description = "评价隐藏状态枚举，避免魔法值")
+public enum EvaluateHiddenState {
+
+    VISIBLE("0", "显示"),
+    HIDDEN("1", "隐藏");
+
+    private final String code;
+    private final String description;
+
+    EvaluateHiddenState(String code, String description) {
+        this.code = code;
+        this.description = description;
+    }
+
+    @JsonValue
+    public String getCode() {
+        return code;
+    }
+
+    public String getDescription() {
+        return description;
+    }
+
+    /**
+     * 从代码获取枚举实例
+     *
+     * @param code 状态代码
+     * @return 对应的枚举实例
+     */
+    @JsonCreator
+    public static EvaluateHiddenState fromCode(String code) {
+        if (code == null) {
+            return null;
+        }
+        for (EvaluateHiddenState state : EvaluateHiddenState.values()) {
+            if (state.code.equals(code)) {
+                return state;
+            }
+        }
+        throw new IllegalArgumentException("Unknown EvaluateHiddenState code: " + code);
+    }
+
+    /**
+     * 判断是否为显示状态
+     *
+     * @param code 状态代码
+     * @return true: 显示, false: 隐藏或未知
+     */
+    public static boolean isVisible(String code) {
+        return VISIBLE.code.equals(code);
+    }
+
+    /**
+     * 判断是否为隐藏状态
+     *
+     * @param code 状态代码
+     * @return true: 隐藏, false: 显示或未知
+     */
+    public static boolean isHidden(String code) {
+        return HIDDEN.code.equals(code);
+    }
+
+    /**
+     * 切换显示/隐藏状态
+     *
+     * @param currentCode 当前状态代码
+     * @return 切换后的状态代码
+     */
+    public static String toggle(String currentCode) {
+        return isHidden(currentCode) ? VISIBLE.code : HIDDEN.code;
+    }
+}