feat(REQ-3300): 添加变更签证分页查询接口定义

visa/visa-api/src/main/java/cn/axzo/visa/api/changerecord/ChangeRecordApi.java

@@ -3,7 +3,9 @@ package cn.axzo.visa.api.changerecord;
 import cn.axzo.framework.domain.web.result.ApiResult;
 import cn.axzo.visa.api.req.VisaChangeApproveCreateReq;
 import cn.axzo.visa.api.req.VisaChangeDiscussCreateReq;
+import cn.axzo.visa.api.req.VisaChangePageSearchReq;
 import cn.axzo.visa.api.req.VisaChangeTempCreateReq;
+import cn.axzo.visa.api.response.VisaChangePageSearchResp;
 import org.springframework.cloud.openfeign.FeignClient;
 import org.springframework.validation.annotation.Validated;
 import org.springframework.web.bind.annotation.PostMapping;
@@ -44,4 +46,13 @@ public interface ChangeRecordApi {
     @PostMapping("/api/visa/change/approveCreate")
     ApiResult<Long> approveCreateVisaChangeRecord(@RequestBody @Validated VisaChangeApproveCreateReq req);
 
+    /**
+     * 分页搜索
+     *
+     * @param req {@link VisaChangePageSearchReq} 筛查条件
+     * @return 分页记录
+     */
+    @PostMapping("/api/visa/change/pageSearch")
+    ApiResult<VisaChangePageSearchResp> pageSearchVisaChangeRecord(@RequestBody @Validated VisaChangePageSearchReq req);
+
 }

visa/visa-api/src/main/java/cn/axzo/visa/api/req/VisaChangePageSearchReq.java

@@ -0,0 +1,75 @@
+package cn.axzo.visa.api.req;
+
+import cn.axzo.visa.api.enums.VisaStatusEnum;
+import cn.axzo.visa.api.enums.VisaTypeEnum;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.math.BigDecimal;
+import java.util.Date;
+import java.util.List;
+
+/**
+ * @author chenwenjian
+ * @version 1.0
+ * @date 2025/1/16 15:46
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class VisaChangePageSearchReq {
+
+    /**
+     * 单据类型
+     */
+    private VisaTypeEnum type;
+
+    /**
+     * 单号或主题
+     * <p>
+     * 单号精确搜索，主题模糊搜索
+     * </p>
+     */
+    private String keyword;
+
+    /**
+     * 所属工程
+     */
+    private Long projectId;
+
+    /**
+     * 发起人
+     */
+    private List<Long> initiators;
+
+    /**
+     * 状态
+     */
+    private List<VisaStatusEnum> statuses;
+
+    /**
+     * 变更金额区间
+     * 0：最小值 1：最大值
+     */
+    private List<BigDecimal> amountChange;
+
+    /**
+     * 提交时间区间
+     * 0：起始时间 1：结束时间
+     */
+    private List<Date> submitDate;
+
+    /**
+     * 审批完成时间区间
+     * 0：起始时间 1：结束时间
+     */
+    private List<Date> approveCompletedDate;
+
+    private Long page;
+
+    private Long pageSize;
+
+}

visa/visa-api/src/main/java/cn/axzo/visa/api/req/VisaChangeTempCreateReq.java

@@ -1,5 +1,6 @@
 package cn.axzo.visa.api.req;
 
+import cn.axzo.visa.api.enums.VisaRelationFieldEnum;
 import cn.axzo.visa.api.enums.VisaTypeEnum;
 import com.alibaba.fastjson.JSONObject;
 import lombok.AllArgsConstructor;
@@ -61,7 +62,7 @@ public class VisaChangeTempCreateReq {
     private JSONObject relationArea;
 
     /**
-     * 提交日期
+     * 提出日期
      */
     @NotNull(message = "请选择提交日期")
     private Date submitDate;
@@ -102,9 +103,11 @@ public class VisaChangeTempCreateReq {
     /**
      * 关联的单据，key: 单据类型，value: 单据id集合
      * <p>
-     * TASK ：任务单 RECTIFY ：整改单 CHANGE：变更单
+     * TASK_ORDER ：任务单 RECTIFICATION_ORDER ：整改单 VISA_ORDER：变更单
      * 只有变更签证类型即{@code type}为“技术核定”或“工程签证”时才可能会有关联变更单
      * </p>
+     *
+     * @see VisaRelationFieldEnum
      */
     private Map<String, List<Long>> relationOrderMap;
 
@@ -114,6 +117,11 @@ public class VisaChangeTempCreateReq {
     @Size(max = 30, message = "最多支持上传30个附件，已超出请重新选择")
     private List<String> attach;
 
+    /**
+     * 操作人peronId
+     */
+    private Long operator;
+
     @Data
     @Builder
     @NoArgsConstructor

visa/visa-api/src/main/java/cn/axzo/visa/api/response/VisaChangePageSearchResp.java

@@ -0,0 +1,18 @@
+package cn.axzo.visa.api.response;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * @author chenwenjian
+ * @version 1.0
+ * @date 2025/1/16 16:29
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class VisaChangePageSearchResp {
+}