♻️ refactor: 对 BaseEntity 接口和 CriteriaUtils 类进行了重构，增强了代码的可读性和可维护性。

- 为 BaseEntity 接口添加了一个默认方法 setCode(String code)。
- 改进了 CriteriaUtils 类中硬编码字符串的使用，现在使用变量代替，提高了代码的灵活性。

boot/platform/src/main/java/com/platform/boot/commons/base/BaseEntity.java

@@ -15,20 +15,46 @@
  */
 public interface BaseEntity<T> extends Serializable, Persistable<T> {
 
+    /**
+     * 设置代码值。
+     * <p>
+     * 此方法提供了一个接口来为相关对象设置一个代码值。具体的实现可能会根据实际需求来决定如何处理这个代码值。
+     * 由于这是一个默认方法，它为接口的实现提供了一种灵活的方式来处理代码值，而不需要强制实现这个方法。
+     *
+     * @param code 要设置的代码值。这个参数允许调用者指定一个代码值，该值可以是任何字符串，具体的含义和使用方式取决于实现。
+     */
     default void setCode(String code) {
+        //todo 方法体为空，具体的实现可能需要根据实际需求来决定如何处理code参数。
     }
 
+    /**
+     * 判断当前对象是否为新对象，即是否具有ID。
+     * 如果对象尚未分配ID，则将其视为新对象，并生成一个新的ID。
+     * 此方法用于标识对象是否已存在于持久化存储中，如果没有ID，则认为是新对象需要进行持久化操作。
+     *
+     * @return 如果对象是新对象（没有ID），则返回true；否则返回false。
+     */
     @Override
     @JsonIgnore
     default boolean isNew() {
+        // 判断对象是否为新对象，通过检查ID是否为空来确定
         boolean isNew = ObjectUtils.isEmpty(getId());
         if (isNew) {
+            // 如果是新对象，则生成并设置一个新的ID
             setCode(ContextUtils.nextId());
         }
         return isNew;
     }
 
+    /**
+     * 创建一个Criteria对象，用于构建查询条件。
+     * 此方法允许指定一组应被忽略的属性键，这些键不会被包含在查询条件中。
+     *
+     * @param skipKeys 一个字符串集合，包含应被忽略的属性键。
+     * @return 返回一个Criteria对象，用于进一步构建查询条件。
+     */
     default Criteria criteria(Collection<String> skipKeys) {
+        // 调用CriteriaUtils的静态方法build来创建Criteria对象，并传入当前对象和要忽略的属性键集合。
         return CriteriaUtils.build(this, skipKeys);
     }
 }

boot/platform/src/main/java/com/platform/boot/commons/utils/query/CriteriaUtils.java

@@ -58,19 +58,19 @@ public static ParamSql buildParamSql(Object object, Collection<String> skipKeys,
         ParamSql jsonParamSql = QueryJson.queryJson((Map<String, Object>) objectMap.get("query"), prefix);
         Map<String, Object> params = jsonParamSql.params();
         StringJoiner sql = jsonParamSql.sql();
-
-        if (!skipKeys.contains("securityCode") && !ObjectUtils.isEmpty(objectMap.get("securityCode"))) {
+        String securityCodeKey = "securityCode";
+        if (!skipKeys.contains(securityCodeKey) && !ObjectUtils.isEmpty(objectMap.get(securityCodeKey))) {
             String key = "tenant_code";
             if (StringUtils.hasLength(prefix)) {
                 key = prefix + "." + key;
             }
             sql.add(key + " like :securityCode");
-            params.put("securityCode", objectMap.get("securityCode"));
+            params.put(securityCodeKey, objectMap.get(securityCodeKey));
         }
 
         Set<String> removeKeys = new HashSet<>(SKIP_CRITERIA_KEYS);
         removeKeys.add("query");
-        removeKeys.add("securityCode");
+        removeKeys.add(securityCodeKey);
         if (!ObjectUtils.isEmpty(skipKeys)) {
             removeKeys.addAll(skipKeys);
         }