refactor(controller): 重构控制器类名和路径，优化代码结构

feat(service): 新增QueryService接口实现，支持通用查询功能

docs(util): 完善ProxyUtils工具类的注释说明

fix(model): 修复CustomerCatalog实现IdentityEntity接口

style: 优化代码格式和导入顺序

perf(util): 提升FileUtils工具类功能，新增文件处理方法

chore: 更新README.md文件，补充UI资源路径说明

build: 更新pom.xml文件中的mainClass配置

test: 调整测试类命名和路径

ci: 更新CI配置文件中的类引用

refactor(controller): 重构表格单元格异步更新逻辑

docs(constant): 新增常量定义和注释

style: 统一代码风格和命名规范

refactor(service): 重构服务类继承关系

perf(controller): 优化表格数据加载性能

fix(service): 修复文件类型服务缓存问题

docs(model): 完善视图模型类注释

refactor(util): 重构文件工具类方法

style: 清理无用导入和代码

chore: 更新.gitignore文件

build: 调整项目依赖配置

refactor(controller): 重构控制器基类

perf(service): 优化查询服务性能

fix(controller): 修复表格数据加载异常

docs: 更新代码注释和文档

style: 统一代码缩进和格式

server/src/main/java/com/ecep/contract/QueryService.java

@@ -1,10 +1,26 @@
 package com.ecep.contract;
 
-import org.springframework.data.domain.Page;
-import org.springframework.data.domain.Pageable;
 
 import com.fasterxml.jackson.databind.JsonNode;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.jpa.domain.Specification;
 
+/**
+ * 查询服务接口，提供通用的分页查询能力
+ * 泛型T表示查询结果的数据类型
+ */
 public interface QueryService<T> {
+    /**
+     * 根据查询参数和分页条件获取数据列表
+     *
+     * @param paramsNode JSON格式的查询参数节点，包含各种过滤条件
+     * @param pageable   分页参数，包含页码、每页条数、排序规则等信息
+     * @return 分页查询结果，包含符合条件的数据列表和分页元数据
+     */
     Page<T> findAll(JsonNode paramsNode, Pageable pageable);
-}
+
+    Specification<T> getSpecification(String searchText);
+
+    Page<T> findAll(Specification<T> spec, Pageable pageable);
+}