permissionVisaIds;
+
+ /**
+ * 是否需要主单据（即是否被其他单据关联）信息
+ */
+ private Boolean needRelatedBill = false;
+ /**
+ * 变更签证Id
+ */
+ private Long visaId;
+
+ /**
+ * 调用场景
+ *
+ * PAGE: 分页列表页面调用
+ * SELECT: 选择器页面调用
+ *
+ */
+ private FromEnum from;
+
+ /**
+ * 主单据类型
+ *
+ * 仅当{@code from}为{@link FromEnum#SELECT}且{@code needRelatedBill}为{@code true}时，该字段才有效且不能为空
+ *
+ */
+ private VisaTypeEnum visaType;
+
+ public static enum FromEnum {
+ PAGE("分页列表页面调用"),
+ SELECT("选择器页面调用");
+
+ private final String desc;
+
+ FromEnum(String desc) {
+ this.desc = desc;
+ }
+
+ public String getDesc() {
+ return desc;
+ }
+ }
+
+}
diff --git a/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/request/VisaChangeTempCreateReq.java b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/request/VisaChangeTempCreateReq.java
new file mode 100644
index 00000000..090c2871
--- /dev/null
+++ b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/request/VisaChangeTempCreateReq.java
@@ -0,0 +1,258 @@
+package cn.axzo.nanopart.visa.api.request;
+
+import cn.axzo.maokai.common.enums.SaasCooperateShipCooperateTypeEnum;
+import cn.axzo.nanopart.visa.api.enums.VisaBillTypeEnum;
+import cn.axzo.nanopart.visa.api.enums.VisaTypeEnum;
+import cn.axzo.workflow.common.model.dto.UploadFieldDTO;
+import com.alibaba.fastjson.JSONArray;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import lombok.experimental.SuperBuilder;
+
+import javax.validation.constraints.Min;
+import javax.validation.constraints.NotBlank;
+import javax.validation.constraints.NotNull;
+import javax.validation.constraints.Size;
+import java.math.BigDecimal;
+import java.util.Date;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * @author chenwenjian
+ * @version 1.0
+ * @date 2025/1/16 11:53
+ */
+@Data
+@SuperBuilder
+@NoArgsConstructor
+@AllArgsConstructor
+public class VisaChangeTempCreateReq {
+
+
+ /**
+ * 变更单号Id
+ */
+ private Long id;
+
+ /**
+ * 单号
+ */
+ @NotBlank(message = "请输入单号")
+ @Size(max = 100, message = "单号长度不能超过100个字符")
+ private String no;
+
+ /**
+ * 主题
+ */
+ @NotBlank(message = "请输入主题")
+ @Size(max = 100, message = "主题长度不能超过100个字符")
+ private String topic;
+
+ /**
+ * 项目
+ */
+ @NotNull(message = "关联项目不能为空")
+ @Min(value = 1, message = "关联项目不能为空")
+ private Long relationWorkspaceId;
+
+ /**
+ * 工程
+ */
+ @NotNull(message = "请选择工程")
+ @Min(value = 1, message = "请选择工程")
+ private Long relationProject;
+ /**
+ * 工程名称
+ */
+ @NotBlank(message = "工程名称不能为空")
+ private String relationProjectName;
+
+ /**
+ * 区域集合
+ * 示例：
+ *
+ * [
+ * {"areaId": 249556},
+ * {"areaId": 249555}
+ * ]
+ *
+ */
+ private JSONArray relationArea;
+
+ /**
+ * 提出时间
+ */
+ @NotNull(message = "请选择提出时间")
+ private Date happenTime;
+
+ /**
+ * 专业集合
+ * 示例：
+ *
+ * [
+ * {"code":"code1"},
+ * {"code":"code2"},
+ * ]
+ *
+ */
+// @NotNull(message = "请选择专业")
+ private JSONArray relationProfessional;
+
+ /**
+ * 发生原因
+ */
+ @NotBlank(message = "请填写发生原因")
+ @Size(max = 500, message = "发生原因长度不能超过500个字符")
+ private String reason;
+
+ /**
+ * 单据类型
+ */
+ @NotNull(message = "请选择变更签证类型")
+ private VisaTypeEnum type;
+
+ /**
+ * 相关单位及人员
+ */
+ private List relationUnitAndPersonList;
+
+ /**
+ * 发生内容说明
+ */
+ private List changeContextAndDescriptionList;
+
+ /**
+ * 有符号的变更金额
+ */
+ private BigDecimal amountChange;
+
+ /**
+ * 关联的单据，key: 单据类型，value: 单据id集合
+ *
+ * TASK ：任务单 RECTIFY ：整改单 DESIGN_VISA：变更单
+ * 只有变更签证类型即{@code type}为“技术核定”或“工程签证”时才可能会有关联变更单
+ *
+ *
+ * @see VisaBillTypeEnum
+ */
+ private Map> relationOrderMap;
+
+ /**
+ * 附件，json列表
+ *
+ * {
+ * "fileUrl": "http://www.baidu.com/img1.jpeg",
+ * "fileKey": "jskjksjgnaqkjkgag",
+ * "fileName": "附件1.jpg"
+ * }
+ *
+ */
+ @Size(max = 30, message = "最多支持上传30个附件，已超出请重新选择")
+ private List attach;
+
+ private Long operatorOuId;
+
+ private Integer operatorOuType;
+
+ private Long operatorNodeId;
+
+ /**
+ * 操作人peronId
+ */
+ private Long operatorPersonId;
+
+ @Data
+ @Builder
+ @NoArgsConstructor
+ @AllArgsConstructor
+ public static class OrderSimpleModel {
+ /**
+ * 单据主键 ID
+ */
+ private Long id;
+
+ /**
+ * 单据编号
+ */
+ private String no;
+
+ /**
+ * 单据名称
+ */
+ private String name;
+ }
+
+ @Data
+ @Builder
+ @NoArgsConstructor
+ @AllArgsConstructor
+ public static class RelationUnitAndPerson {
+ /**
+ * 单位类型 1：施工单位 2：建设单位 3：监理单位 4：劳务分包 5：专业分包 9：项目内班组 13：设计单位
+ *
+ * @see cn.axzo.maokai.common.enums.SaasCooperateShipCooperateTypeEnum
+ */
+ private SaasCooperateShipCooperateTypeEnum type;
+
+ /**
+ * 单位 ID
+ */
+ private Long ouId;
+
+ /**
+ * 确认人所在部门节点id或项目内班组节点id
+ */
+ private Long nodeId;
+
+ /**
+ * 确认人personId
+ */
+ private Long personId;
+
+ }
+
+ @Data
+ @Builder
+ @NoArgsConstructor
+ @AllArgsConstructor
+ public static class ChangeContextAndDescription {
+ /**
+ * 内容类型，1：图片 2：图纸批注
+ */
+ private Integer type;
+
+ /**
+ * 图片或图纸url
+ */
+ private String fileUrl;
+
+ /**
+ * 图片或图纸key
+ */
+ private String fileKey;
+
+ /**
+ * 图片或图纸名称
+ */
+ private String fileName;
+
+ /**
+ * 图纸批注id，{@code type}为2时使用
+ */
+ private Long annotationId;
+
+ /**
+ * 图纸图框id，{@code type}为2时使用
+ */
+ private Long borderId;
+
+ /**
+ * 内容说明
+ */
+ private String text;
+
+ }
+}
diff --git a/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/request/VisaDetailByIdRequest.java b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/request/VisaDetailByIdRequest.java
new file mode 100644
index 00000000..169f0e0a
--- /dev/null
+++ b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/request/VisaDetailByIdRequest.java
@@ -0,0 +1,44 @@
+package cn.axzo.nanopart.visa.api.request;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import javax.validation.constraints.NotNull;
+
+/**
+ * @author xudawei
+ * @date 2025/01/16
+ * @desc 变签Id获取变签日志
+ */
+@Builder
+@AllArgsConstructor
+@NoArgsConstructor
+@Data
+public class VisaDetailByIdRequest {
+
+ /**
+ * 变签Id
+ */
+ @NotNull(message = "变签Id不能为空")
+ private Long visaId;
+
+ /**
+ * 人员Id
+ */
+ private Long personId;
+
+ private Long workspaceId;
+
+ private Long ouId;
+
+ private Long projectId;
+
+ /**
+ * 是否需要btnList
+ * true:需要, 则personId/ouId/workspaceId 必填，需要查询确认人信息
+ * false:不需要
+ */
+ private boolean needBtnList = true;
+}
diff --git a/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/request/VisaInitiatorListReq.java b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/request/VisaInitiatorListReq.java
new file mode 100644
index 00000000..4a8d1686
--- /dev/null
+++ b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/request/VisaInitiatorListReq.java
@@ -0,0 +1,36 @@
+package cn.axzo.nanopart.visa.api.request;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import javax.validation.constraints.NotNull;
+
+/**
+ * @author chenwenjian
+ * @version 1.0
+ * @date 2025/1/22 9:41
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class VisaInitiatorListReq {
+
+ @NotNull(message = "workspaceId不能为空")
+ private Long workspaceId;
+
+ /**
+ * 当前登录人的personId
+ */
+ private Long currentPersonId;
+ /**
+ * 当前登录人的项目Id
+ */
+ private Long currentWorkspaceId;
+ /**
+ * 当前登录人的单位Id
+ */
+ private Long currentOuId;
+}
diff --git a/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/request/VisaRelationReq.java b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/request/VisaRelationReq.java
new file mode 100644
index 00000000..ea9a5c45
--- /dev/null
+++ b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/request/VisaRelationReq.java
@@ -0,0 +1,36 @@
+package cn.axzo.nanopart.visa.api.request;
+
+import cn.axzo.nanopart.visa.api.enums.VisaRelationFieldEnum;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import lombok.experimental.Accessors;
+
+import javax.validation.constraints.NotNull;
+
+/**
+ * 变洽签关联数据查询入参模型
+ *
+ * @author wangli
+ * @since 2025-01-16 10:46
+ */
+@Data
+@Accessors(chain = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class VisaRelationReq {
+
+ /**
+ * 变洽签单据 ID
+ */
+ @NotNull(message = "变洽签单据 ID不能为空")
+ private Long visaId;
+
+ /**
+ * 关联表中指定类型
+ * 可为空，则查询所有关联的数据
+ */
+ private VisaRelationFieldEnum fieldEnum;
+}
diff --git a/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/request/VisaSearchReq.java b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/request/VisaSearchReq.java
new file mode 100644
index 00000000..715aad60
--- /dev/null
+++ b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/request/VisaSearchReq.java
@@ -0,0 +1,81 @@
+package cn.axzo.nanopart.visa.api.request;
+
+import cn.axzo.core.domain.PageRequest;
+import cn.axzo.framework.domain.ServiceException;
+import cn.axzo.nanopart.visa.api.enums.VisaBillTypeEnum;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import org.springframework.util.StringUtils;
+
+import java.util.Objects;
+
+/**
+ * @author xudawei
+ * @date 2025/01/16
+ * @desc 变签Id获取变签日志
+ */
+@Builder
+@AllArgsConstructor
+@NoArgsConstructor
+@Data
+public class VisaSearchReq extends PageRequest {
+
+
+ /**
+ * 变签Id
+ */
+ private Long visaId;
+ /**
+ * 项目Id
+ */
+ private Long workspaceId;
+
+ /**
+ * 变签编号
+ */
+ private String visaNo;
+
+ /**
+ * 单据类型,任务单:TASK;整改单:RECTIFY;变更单:VISA
+ */
+ private VisaBillTypeEnum billType;
+
+ /**
+ * 单据Id
+ */
+ private Long billId;
+
+ /**
+ * 单据编号
+ */
+ private String billNo;
+
+ /**
+ * 校验
+ */
+ public void check() {
+ if (Objects.isNull(this.getBillId())
+ && Objects.isNull(this.getBillNo())
+ && Objects.isNull(this.getBillType())
+ && Objects.isNull(this.getVisaId())
+ && !StringUtils.hasText(this.getVisaNo())) {
+ throw new ServiceException("参数不合法");
+ }
+ repairPage();
+ }
+
+ /**
+ * 修复page
+ */
+ public void repairPage() {
+ if (Objects.isNull(this.page)) {
+ this.setPage(1);
+ }
+ if (Objects.isNull(this.pageSize)) {
+ this.setPageSize(20);
+ }
+ }
+
+}
diff --git a/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/response/FetchVisaLogByVisaIdResponse.java b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/response/FetchVisaLogByVisaIdResponse.java
new file mode 100644
index 00000000..5bbcf828
--- /dev/null
+++ b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/response/FetchVisaLogByVisaIdResponse.java
@@ -0,0 +1,36 @@
+package cn.axzo.nanopart.visa.api.response;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.util.Date;
+
+/**
+ * @author xudawei
+ * @date 2025/01/16
+ * @desc 变签Id获取变签日志
+ */
+@Builder
+@AllArgsConstructor
+@NoArgsConstructor
+@Data
+public class FetchVisaLogByVisaIdResponse {
+
+ /**
+ * 操作标题
+ */
+ private String title;
+
+ /**
+ * 操作内容
+ */
+ private String content;
+
+ /**
+ * 创建时间
+ */
+ private Date createAt;
+
+}
diff --git a/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/response/ImGroupButton.java b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/response/ImGroupButton.java
new file mode 100644
index 00000000..dc13b2f8
--- /dev/null
+++ b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/response/ImGroupButton.java
@@ -0,0 +1,29 @@
+package cn.axzo.nanopart.visa.api.response;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * IM 群聊中的按钮
+ *
+ * @author wangli
+ * @since 2025-02-05 16:47
+ */
+@Builder
+@AllArgsConstructor
+@NoArgsConstructor
+@Data
+public class ImGroupButton {
+ /**
+ * 按钮文案
+ */
+ private String name;
+
+ /**
+ * 按钮类型
+ */
+ private String type;
+
+}
diff --git a/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/response/ImGroupTipsResp.java b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/response/ImGroupTipsResp.java
new file mode 100644
index 00000000..3dfb0181
--- /dev/null
+++ b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/response/ImGroupTipsResp.java
@@ -0,0 +1,36 @@
+package cn.axzo.nanopart.visa.api.response;
+
+import cn.axzo.nanopart.visa.api.enums.VisaStatusEnum;
+import cn.axzo.nanopart.visa.api.enums.VisaTypeEnum;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.util.List;
+
+/**
+ * IM 群聊上方横条
+ *
+ * @author wangli
+ * @since 2025-02-05 16:37
+ */
+@Builder
+@AllArgsConstructor
+@NoArgsConstructor
+@Data
+public class ImGroupTipsResp {
+
+ private VisaStatusEnum status;
+
+ private String statusText;
+
+ private String tipsText;
+
+ private List buttonList;
+
+ private VisaTypeEnum visaType;
+
+ private String visaTypeText;
+
+}
diff --git a/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/response/VisaChangeDiscussCreateResp.java b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/response/VisaChangeDiscussCreateResp.java
new file mode 100644
index 00000000..bb0f3633
--- /dev/null
+++ b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/response/VisaChangeDiscussCreateResp.java
@@ -0,0 +1,33 @@
+package cn.axzo.nanopart.visa.api.response;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * @author chenwenjian
+ * @version 1.0
+ * @date 2025/2/10 14:17
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class VisaChangeDiscussCreateResp {
+
+ /**
+ * 变洽签单据id
+ */
+ private Long visaId;
+
+ /**
+ * 群聊id
+ */
+ private Long imGroupId;
+
+ /**
+ * 群聊名称
+ */
+ private String imGroupName;
+}
diff --git a/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/response/VisaChangeInitiatorResp.java b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/response/VisaChangeInitiatorResp.java
new file mode 100644
index 00000000..eafeefc5
--- /dev/null
+++ b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/response/VisaChangeInitiatorResp.java
@@ -0,0 +1,64 @@
+package cn.axzo.nanopart.visa.api.response;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * @author chenwenjian
+ * @version 1.0
+ * @date 2025/1/16 18:43
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class VisaChangeInitiatorResp {
+
+ /**
+ * 发起人personId
+ */
+ private Long personId;
+
+ /**
+ * 发起人姓名
+ */
+ private String name;
+
+ /**
+ * 发起人头像
+ */
+ private String avatar;
+
+ /**
+ * 岗位id
+ */
+ private Long jobId;
+
+ /**
+ * 岗位名称
+ */
+ private String jobName;
+
+ /**
+ * 岗位编码
+ */
+ private String jobCode;
+
+ /**
+ * 单位id
+ */
+ private Long ouId;
+
+ /**
+ * 所属单位节点id或班组节点id
+ */
+ private Long nodeId;
+
+ /**
+ * 所属单位名称或班组名称
+ */
+ private String unitOrTeamName;
+
+}
diff --git a/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/response/VisaChangePageSearchResp.java b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/response/VisaChangePageSearchResp.java
new file mode 100644
index 00000000..1ea06939
--- /dev/null
+++ b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/response/VisaChangePageSearchResp.java
@@ -0,0 +1,155 @@
+package cn.axzo.nanopart.visa.api.response;
+
+import cn.axzo.nanopart.visa.api.enums.VisaButtonTypeEnum;
+import cn.axzo.nanopart.visa.api.enums.VisaStatusEnum;
+import cn.axzo.nanopart.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.Objects;
+import java.util.Set;
+
+/**
+ * @author chenwenjian
+ * @version 1.0
+ * @date 2025/1/16 16:29
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class VisaChangePageSearchResp {
+
+ private Long id;
+
+ /**
+ * 单号
+ */
+ private String no;
+
+ /**
+ * 主题
+ */
+ private String topic;
+
+ /**
+ * 项目
+ */
+ private Long relationWorkspaceId;
+
+ /**
+ * 工程
+ */
+ private Long relationProject;
+
+ /**
+ * 工程名称
+ */
+ private String relationProjectName;
+
+ /**
+ * 提出时间
+ */
+ private Date happenTime;
+
+
+ /**
+ * 最终审批时间
+ */
+ private Date approvalCompleteTime;
+
+ /**
+ * 单据类型
+ *
+ * DESIGN_CHANGE: 设计变更
+ * TECHNOLOGY_APPROVED: 技术核定
+ * PROJECT_VISA: 工程签证
+ *
+ *
+ * @see VisaTypeEnum
+ */
+ private VisaTypeEnum type;
+
+ /**
+ * 单据类型描述
+ */
+ private String typeDesc;
+
+ /**
+ * 状态
+ *
+ * TO_REPORT: 待提报
+ * DECIDING: 决策中
+ * EXECUTING: 执行中
+ * APPROVING: 审批中
+ * COMPLETED: 已完成
+ * FORBIDED: 已废除
+ *
+ *
+ * @see VisaStatusEnum
+ */
+ private VisaStatusEnum status;
+
+ /**
+ * 状态描述
+ */
+ private String statusDesc;
+
+ /**
+ * 有符号的变更金额
+ */
+ private BigDecimal amountChange;
+
+
+ /**
+ * 发起人
+ */
+ private VisaChangeInitiatorResp initiator;
+
+ /**
+ * 发生原因
+ */
+ private String reason;
+ /**
+ * 是否被其他变更签证单单据关联
+ */
+ private Boolean isRelated;
+
+ /**
+ * 操作按钮
+ *
+ * UPDATE: 编辑
+ * DETAIL: 详情
+ * UPLOAD_FILE: 上传附件
+ * APPROVE_RECORD: 查看审批记录
+ *
+ *
+ * @see VisaButtonTypeEnum
+ */
+ private Set operateBtnSet;
+
+ public String getTypeDesc() {
+ if (Objects.isNull(type)) {
+ return null;
+ }
+ return type.getDesc();
+ }
+
+ public String getStatusDesc() {
+ if (Objects.isNull(status)) {
+ return null;
+ }
+ if (VisaStatusEnum.REPORT_FROM_APPROVE.equals(status)) {
+ return VisaStatusEnum.TO_REPORT.getDesc();
+ }
+ if (VisaStatusEnum.DECIDING_FROM_APPROVE.equals(status)) {
+ return VisaStatusEnum.DECIDING.getDesc();
+ }
+ return status.getDesc();
+ }
+
+}
diff --git a/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/response/VisaDetailByIdResponse.java b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/response/VisaDetailByIdResponse.java
new file mode 100644
index 00000000..d05a1f43
--- /dev/null
+++ b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/response/VisaDetailByIdResponse.java
@@ -0,0 +1,613 @@
+package cn.axzo.nanopart.visa.api.response;
+
+import cn.axzo.maokai.common.enums.SaasCooperateShipCooperateTypeEnum;
+import cn.axzo.nanopart.visa.api.enums.VisaButtonTypeEnum;
+import cn.axzo.nanopart.visa.api.enums.VisaStatusEnum;
+import cn.axzo.nanopart.visa.api.enums.VisaTypeEnum;
+import cn.axzo.nanopart.visa.api.request.VisaChangeTempCreateReq;
+import com.alibaba.fastjson.JSONArray;
+import com.alibaba.fastjson.JSONObject;
+import com.google.common.collect.Lists;
+import com.google.common.collect.Sets;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import org.apache.commons.collections.CollectionUtils;
+import org.apache.commons.lang3.StringUtils;
+
+import java.util.Date;
+import java.util.List;
+import java.util.Objects;
+import java.util.Set;
+import java.util.stream.Collectors;
+
+/**
+ * @author xudawei
+ * @date 2025/01/16
+ * @desc 变签Id获取变签日志
+ */
+@Builder
+@AllArgsConstructor
+@NoArgsConstructor
+@Data
+public class VisaDetailByIdResponse {
+
+ /**
+ * 变签Id
+ */
+ private Long visaId;
+
+
+ /**
+ * 单号
+ */
+ private String no;
+
+ /**
+ * 单据类型
+ */
+ private VisaTypeEnum type;
+
+ /**
+ * 发生原因
+ */
+ private String reason;
+
+ /**
+ * 发起人姓名
+ */
+ private String createName;
+
+ /**
+ * 发起人头像
+ */
+ private String createAvatarUrl;
+
+ /**
+ * 发起人岗位名称
+ */
+ private String createJobName;
+
+ /**
+ * 发起人岗位code
+ */
+ private String createJobCode;
+
+ /**
+ * 发起人单位名称
+ */
+ private String createOuName;
+
+ /**
+ * 发起人单位Id
+ */
+ private Long createOuId;
+
+ /**
+ * 发起人Id
+ */
+ private Long createBy;
+
+ /**
+ * 所属工程
+ */
+ private Long relationProject;
+
+ /**
+ * 所属工程名称
+ */
+ private String relationProjectName;
+
+ /**
+ * 主题
+ */
+ private String topic;
+
+ /**
+ * 项目
+ */
+ private Long relationWorkspaceId;
+
+ /**
+ * 项目名称
+ */
+ private String relationWorkspaceName;
+
+ /**
+ * 区域集合
+ */
+ private List relationAreaList;
+
+ /**
+ * 区域集合名称
+ */
+ private String relationAreaName;
+
+ /**
+ * 提出时间
+ */
+ private String happenTime;
+
+
+ /**
+ * 最终审批时间
+ */
+ private String approvalCompleteTime;
+
+ /**
+ * 专业集合
+ */
+ private List relationProfessionalList;
+
+ /**
+ * 专业集合名称
+ */
+ private String relationProfessionalName;
+
+ /**
+ * 相关单位及人员
+ */
+ private List relationOuAndPersonList;
+
+ /**
+ * 发生内容说明
+ */
+ private List changeContextAndDescriptionList;
+
+ /**
+ * 有符号的变更金额
+ */
+ private String amountChange;
+
+ /**
+ * 附件
+ */
+ private List attach;
+
+ /**
+ * 按钮
+ */
+ private List btnList;
+
+
+ /**
+ * 任务单
+ */
+ private List relationTaskList;
+
+ /**
+ * 整改单
+ */
+ private List relationRectifyList;
+
+ /**
+ * 变更单
+ */
+ private List relationVisaList;
+
+ /**
+ * 关联无效的变更单
+ */
+ private List relationInvalidVisaList;
+
+ /**
+ * 状态
+ */
+ private VisaStatusEnum status;
+
+ /**
+ * 群组ID
+ */
+ private Long imGroupId;
+
+ /**
+ * 最终审批ID
+ */
+ private String approvalId;
+
+ /**
+ * 最终审批状态
+ */
+ private String approvalStatus;
+
+ /**
+ * 当前登录人的personId
+ */
+ private Long currentPersonId;
+
+ @Data
+ @Builder
+ @NoArgsConstructor
+ @AllArgsConstructor
+ public static class RelationOuAndPerson {
+ /**
+ * 相关单位
+ */
+ private RelationUnit relationOu;
+
+ /**
+ * 相关确认人
+ */
+ private List relationPersonList;
+ }
+
+ @Data
+ @Builder
+ @NoArgsConstructor
+ @AllArgsConstructor
+ public static class RelationUnit {
+ /**
+ * 类型
+ */
+ private String type;
+
+ /**
+ * 单位id
+ */
+ private Long ouId;
+
+ /**
+ * 单位名称
+ */
+ private String ouName;
+ /**
+ * 节点Id
+ */
+ private Long nodeId;
+ }
+
+ @Data
+ @Builder
+ @NoArgsConstructor
+ @AllArgsConstructor
+ public static class RelationPerson {
+ /**
+ * 类型
+ */
+ private SaasCooperateShipCooperateTypeEnum type;
+
+ /**
+ * 单位id
+ */
+ private Long ouId;
+
+ /**
+ * 确认人名称
+ */
+ private String realName;
+
+ /**
+ * 头像
+ */
+ private String avatarUrl;
+
+ /**
+ * 节点id
+ */
+ private Long nodeId;
+
+ /**
+ * 确认人personId
+ */
+ private Long personId;
+
+ /**
+ * 项目Id
+ */
+ private Long workspaceId;
+
+ /**
+ * 工程Id
+ */
+ private Long projectId;
+
+ /**
+ * 岗位Id
+ */
+ private Long jobId;
+ /**
+ * 岗位名称
+ */
+ private String jobName;
+ }
+
+
+ @Data
+ @Builder
+ @NoArgsConstructor
+ @AllArgsConstructor
+ public static class ChangeContextAndDescription {
+ /**
+ * 内容类型，1：图片 2：图纸批注
+ */
+ private Integer Type;
+
+ /**
+ * 图片或图纸
+ */
+ private String imgUrl;
+
+ /**
+ * 内容说明
+ */
+ private String text;
+
+ }
+
+ @Data
+ @Builder
+ @NoArgsConstructor
+ @AllArgsConstructor
+ public static class RelationProfessional {
+
+ /**
+ * code
+ */
+ private String code;
+ }
+
+
+
+ @Data
+ @Builder
+ @NoArgsConstructor
+ @AllArgsConstructor
+ public static class RelationProfessionalDetail {
+ /**
+ * code
+ */
+ private String code;
+
+ /**
+ * 构建专业集合-对象集合
+ */
+ public static List buildProfessionWithObject(JSONArray relationProfessional) {
+
+ if (CollectionUtils.isEmpty(relationProfessional)) {
+ return Lists.newArrayList();
+ }
+ List professionalList = relationProfessional.toJavaList(VisaDetailByIdResponse.RelationProfessionalDetail.class);
+
+ if (CollectionUtils.isEmpty(professionalList)) {
+ return Lists.newArrayList();
+ }
+
+ List filter = professionalList.stream().filter(item -> Objects.nonNull(item) && StringUtils.isNotBlank(item.getCode())).collect(Collectors.toList());
+ if (CollectionUtils.isEmpty(filter)) {
+ return Lists.newArrayList();
+ }
+ return filter;
+ }
+
+ /**
+ * 构建专业集合-code集合
+ */
+ public static Set buildProfessionWithCode(JSONArray relationProfessional) {
+ List relationProfessionalDetails = RelationProfessionalDetail.buildProfessionWithObject(relationProfessional);
+ if (CollectionUtils.isEmpty(relationProfessionalDetails)) {
+ return Sets.newHashSet();
+ }
+
+ return relationProfessionalDetails.stream()
+ .filter(item -> Objects.nonNull(item) && StringUtils.isNotBlank(item.getCode()))
+ .map(RelationProfessionalDetail::getCode).collect(Collectors.toSet());
+ }
+
+ }
+
+ @Data
+ @Builder
+ @NoArgsConstructor
+ @AllArgsConstructor
+ public static class RelationAreaDetail {
+ /**
+ * id
+ */
+ private Long areaId;
+
+
+ public static List buildAreaWithObject(JSONArray relationArea) {
+ if (CollectionUtils.isEmpty(relationArea)) {
+ return Lists.newArrayList();
+ }
+ List relationAreaList = relationArea.toJavaList(VisaDetailByIdResponse.RelationAreaDetail.class);
+ if (CollectionUtils.isEmpty(relationAreaList)) {
+ return Lists.newArrayList();
+ }
+ List filter = relationAreaList.stream().filter(item -> Objects.nonNull(item) && Objects.nonNull(item.getAreaId())).collect(Collectors.toList());
+ if (CollectionUtils.isEmpty(filter)) {
+ return Lists.newArrayList();
+ }
+ return filter;
+ }
+
+ public static List buildAreaWithId(JSONArray relationArea) {
+ List areaDetailList = RelationAreaDetail.buildAreaWithObject(relationArea);
+
+ if (CollectionUtils.isEmpty(areaDetailList)) {
+ return Lists.newArrayList();
+ }
+ return areaDetailList.stream().map(VisaDetailByIdResponse.RelationAreaDetail::getAreaId).collect(Collectors.toList());
+ }
+
+ }
+
+ @Data
+ @Builder
+ @NoArgsConstructor
+ @AllArgsConstructor
+ public static class RelationRectifyOrder {
+
+ /**
+ * 整改单id
+ */
+ private Long id;
+
+ /**
+ * 整改单号
+ */
+ private String rectifyNo;
+
+ /**
+ * 名称
+ */
+ private String name;
+
+ /**
+ * 开始时间
+ */
+ private String startTime;
+
+ /**
+ * 结束时间
+ */
+ private String endTime;
+
+ /**
+ * 共计天数
+ */
+ private String totalDays;
+
+ /**
+ * 发起人
+ */
+ private String createName;
+ /**
+ * 发起人Id
+ */
+ private Long createBy;
+ /**
+ * 发起人岗位名称
+ */
+ private String createJobName;
+ /**
+ * 发起人岗位Id
+ */
+ private Long createJobId;
+ /**
+ * 发起人单位名称
+ */
+ private String createOuName;
+ /**
+ * 发起人单位Id
+ */
+ private String createOuId;
+
+ /**
+ * 责任人
+ */
+ private String rectifierName;
+ /**
+ * 责任人Id
+ */
+ private Long rectifier;
+ /**
+ * 责任人岗位名称
+ */
+ private String rectifierJobName;
+ /**
+ * 责任人岗位Id
+ */
+ private Long rectifierJobId;
+ /**
+ * 责任人单位名称
+ */
+ private String rectifierOuName;
+ /**
+ * 责任人单位Id
+ */
+ private String rectifierOuId;
+
+ /**
+ * 销项人
+ */
+ private String verifierName;
+ /**
+ * 销项人Id
+ */
+ private Long verifier;
+ /**
+ * 销项人岗位名称
+ */
+ private String verifierJobName;
+ /**
+ * 销项人岗位Id
+ */
+ private Long verifierJobId;
+ /**
+ * 销项人单位名称
+ */
+ private String verifierOuName;
+ /**
+ * 销项人单位Id
+ */
+ private String verifierOuId;
+
+
+ }
+
+ @Data
+ @Builder
+ @NoArgsConstructor
+ @AllArgsConstructor
+ public static class RelationVisaDetail {
+ /**
+ * 主题
+ */
+ private String topic;
+
+ /**
+ * 单号
+ */
+ private String no;
+ /**
+ * 有符号的变更金额
+ */
+ private String amountChange;
+
+ /**
+ * 发起人
+ */
+ private String createName;
+
+ /**
+ * 提出时间
+ */
+ private Date happenTime;
+
+ }
+
+ @Data
+ @Builder
+ @AllArgsConstructor
+ @NoArgsConstructor
+ public static class VisaUploadFile {
+ /**
+ * 文件Url
+ */
+ private String fileUrl;
+ /**
+ * 文件key
+ */
+ private String fileKey;
+ /**
+ * 文件名称
+ */
+ private String fileName;
+
+ /**
+ * 创建集合
+ */
+ public static List createListByJson(List jsonObjectList) {
+ if (CollectionUtils.isEmpty(jsonObjectList)) {
+ return Lists.newArrayList();
+ }
+ List fileDtoList = Lists.newArrayList();
+ for(JSONObject json : jsonObjectList) {
+ fileDtoList.add(json.toJavaObject(VisaUploadFile.class));
+ }
+ return fileDtoList;
+ }
+ }
+}
diff --git a/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/response/VisaRelationResp.java b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/response/VisaRelationResp.java
new file mode 100644
index 00000000..4a03db07
--- /dev/null
+++ b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/response/VisaRelationResp.java
@@ -0,0 +1,58 @@
+package cn.axzo.nanopart.visa.api.response;
+
+import cn.axzo.nanopart.visa.api.enums.VisaRelationFieldEnum;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import lombok.experimental.Accessors;
+
+import java.util.Date;
+
+/**
+ * 变洽签关联的行数据相应模型
+ *
+ * @author wangli
+ * @since 2025-01-16 09:50
+ */
+@Data
+@Accessors(chain = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class VisaRelationResp {
+
+ private Long id;
+ /**
+ * 变洽签主单据编号
+ */
+ private String visaId;
+ /**
+ * 变洽签单据关联的行数据类型
+ * {@link VisaRelationFieldEnum}
+ */
+ private String varName;
+
+ /**
+ * 数据类型的扩展内容
+ */
+ private String varExt;
+ /**
+ * 数据值的 java 类型
+ */
+ private String varType;
+ /**
+ * 数据值
+ */
+ private String content;
+ /**
+ * 数据值的一些额外描述
+ */
+ private String contentExt;
+
+ /**
+ * 创建时间
+ */
+ private Date createAt;
+
+}
diff --git a/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/response/VisaSearchResp.java b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/response/VisaSearchResp.java
new file mode 100644
index 00000000..f4bada46
--- /dev/null
+++ b/visa/visa-api/src/main/java/cn/axzo/nanopart/visa/api/response/VisaSearchResp.java
@@ -0,0 +1,144 @@
+package cn.axzo.nanopart.visa.api.response;
+
+import cn.axzo.nanopart.visa.api.enums.VisaStatusEnum;
+import cn.axzo.nanopart.visa.api.enums.VisaTypeEnum;
+import com.alibaba.fastjson.JSONObject;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.util.Date;
+import java.util.List;
+
+/**
+ * @author xudawei@axzo.cn
+ * @date 2025/2/18
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class VisaSearchResp {
+
+ /**
+ * 变更单据Id
+ */
+ private Long visaId;
+
+ /**
+ * 单据号
+ */
+ private String no;
+
+ /**
+ * 主题
+ */
+ private String topic;
+
+ /**
+ * 项目
+ */
+ private Long relationWorkspaceId;
+
+ /**
+ * 工程
+ */
+ private Long relationProject;
+
+ /**
+ * 区域集合
+ * 示例：
+ *
+ * [
+ * {"areaId": 249556},
+ * {"areaId": 249555}
+ * ]
+ *
+ */
+ private List relationArea;
+
+ /**
+ * 专业集合
+ * 示例：
+ *
+ * [
+ * {"code":"code1"},
+ * {"code":"code2"},
+ * ]
+ *
+ */
+ private List relationProfessional;
+
+ /**
+ * 提出时间
+ */
+ private Date happenTime;
+
+ /**
+ * 有符号的变更金额
+ */
+ private String amountChange;
+
+ /**
+ * 发生原因
+ */
+ private String reason;
+
+ /**
+ * 单据类型
+ */
+ private VisaTypeEnum type;
+
+ /**
+ * 状态
+ */
+ private VisaStatusEnum status;
+
+ /**
+ * 最终审批ID
+ */
+ private String approvalId;
+
+ /**
+ * 最终审批状态
+ */
+ private String approvalStatus;
+
+ /**
+ * 最终审批时间
+ */
+ private Date approvalCompleteTime;
+
+ /**
+ * IM群组ID
+ */
+ private Long imGroupId;
+
+ /**
+ * 额外信息
+ */
+ private JSONObject extra;
+
+ /**
+ * 创建人id
+ */
+ private Long createBy;
+
+ /**
+ * 修改人id
+ */
+ private Long updateBy;
+
+ /**
+ * 创建时间
+ */
+ protected Date createAt;
+
+ /**
+ * 修改时间
+ */
+ protected Date updateAt;
+
+
+}
diff --git a/visa/visa-api/src/main/resources/META-INF/spring.factories b/visa/visa-api/src/main/resources/META-INF/spring.factories
new file mode 100644
index 00000000..c3000f13
--- /dev/null
+++ b/visa/visa-api/src/main/resources/META-INF/spring.factories
@@ -0,0 +1,2 @@
+org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
+cn.axzo.nanopart.visa.api.config.VisaApiAutoConfiguration
\ No newline at end of file
diff --git a/visa/visa-server/pom.xml b/visa/visa-server/pom.xml
new file mode 100644
index 00000000..b27ba208
--- /dev/null
+++ b/visa/visa-server/pom.xml
@@ -0,0 +1,132 @@
+
+
+
+ cn.axzo.nanopart
+ visa
+ ${revision}
+ ../pom.xml
+
+ 4.0.0
+
+ visa-server
+ jar
+
+ visa-server
+
+
+
+ cn.axzo.framework
+ axzo-web-spring-boot-starter
+
+
+ cn.axzo.framework
+ axzo-spring-cloud-starter
+
+
+ cn.axzo.framework
+ axzo-consumer-spring-cloud-starter
+
+
+ cn.axzo.framework
+ axzo-processor-spring-boot-starter
+
+
+
+ cn.axzo.framework
+ axzo-mybatisplus-spring-boot-starter
+
+
+
+ cn.axzo.framework
+ axzo-swagger-yapi-spring-boot-starter
+
+
+ mysql
+ mysql-connector-java
+
+
+ cn.hutool
+ hutool-all
+
+
+ cn.axzo.framework
+ axzo-logger-spring-boot-starter
+
+
+ cn.axzo.framework.rocketmq
+ axzo-common-rocketmq
+
+
+ cn.axzo.pokonyan
+ pokonyan
+
+
+ cn.axzo.workflow
+ workflow-engine-spring-boot-starter
+
+
+ cn.axzo.maokai
+ maokai-api
+
+
+ cn.axzo.nanopart
+ visa-api
+ ${project.version}
+
+
+ cn.axzo.basics
+ basics-profiles-api
+
+
+ cn.axzo.maokai
+ maokai-common
+ ${project.version}
+
+
+ cn.axzo
+ thor-api
+ 1.0.0-SNAPSHOT
+
+
+ cn.axzo.apollo
+ apollo-api
+ 2.0.0-SNAPSHOT
+
+
+ cn.axzo.basics
+ basics-domainless-api
+ 2.0.0-SNAPSHOT
+
+
+ cn.axzo.org
+ org-api
+ 1.0.0-SNAPSHOT
+
+
+ org.apache.commons
+ commons-lang3
+ 3.12.0
+
+
+
+ cn.axzo.karma
+ karma-api
+ 2.0.0-SNAPSHOT
+
+
+
+ cn.axzo.platform
+ axzo-log-api
+ 1.0.0-SNAPSHOT
+
+
+
+ cn.axzo.digital
+ digital-api
+ 1.0.0-SNAPSHOT
+
+
+
+
+
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/config/RefreshableConfiguration.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/config/RefreshableConfiguration.java
new file mode 100644
index 00000000..e4bf9023
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/config/RefreshableConfiguration.java
@@ -0,0 +1,53 @@
+package cn.axzo.nanopart.visa.server.config;
+
+import lombok.Data;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.cloud.context.config.annotation.RefreshScope;
+import org.springframework.stereotype.Component;
+
+/**
+ * 可 nacos 动态更新的对象
+ *
+ * @author wangli
+ * @since 2025-02-07 16:03
+ */
+@Data
+@Component
+@RefreshScope
+public class RefreshableConfiguration {
+
+ /**
+ * IM 群创建成功后发送卡片模板
+ */
+ @Value("${visa.im.card:261c7fa3db344fb69f3553f695a5a19c}")
+ private String imGroupCardTemplateCode;
+ /**
+ * 变更签证洽商通知
+ * IM 群添加成员，给新成员发送的通知
+ */
+ @Value("${visa.im.notice.addMember:2a4fe042020f4dd783b73fdbb6e6ac98}")
+ private String imGroupAddMemberNoticeTemplateCode;
+ /**
+ * 配合上面的通知发送使用
+ */
+ @Value("${visa.im.event.addMember:visaNegotiation}")
+ private String imGroupAddMemberNoticeEventCode;
+
+ /**
+ * 相关单位确认人人数限制
+ */
+ @Value("${visa.verifyPersonLimit: 8}")
+ private Integer verifyPersonLimit;
+
+ /**
+ * 关联变更单个数限制
+ */
+ @Value("${visa.verifyVisaLimit: 5}")
+ private Integer verifyVisaLimit;
+
+ /**
+ * 发生内容及说明数量限制
+ */
+ @Value("${visa.verifyChangeContextLimit: 50}")
+ private Integer verifyChangeContextLimit;
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/controller/ChangeRecordController.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/controller/ChangeRecordController.java
new file mode 100644
index 00000000..a071f049
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/controller/ChangeRecordController.java
@@ -0,0 +1,184 @@
+package cn.axzo.nanopart.visa.server.controller;
+
+import cn.axzo.framework.domain.web.result.ApiPageResult;
+import cn.axzo.framework.domain.web.result.ApiResult;
+import cn.axzo.framework.domain.web.result.PageData;
+import cn.axzo.nanopart.visa.api.changerecord.ChangeRecordApi;
+import cn.axzo.nanopart.visa.api.enums.VisaStatusEnum;
+import cn.axzo.nanopart.visa.api.request.ChangeRecordButtonOperationReq;
+import cn.axzo.nanopart.visa.api.request.ChangeStatusRequest;
+import cn.axzo.nanopart.visa.api.request.CheckVisaWithVisaIdReq;
+import cn.axzo.nanopart.visa.api.request.FetchVisaAllConfirmReq;
+import cn.axzo.nanopart.visa.api.request.GetBillIfRelatedReq;
+import cn.axzo.nanopart.visa.api.request.VisaChangeApproveCreateReq;
+import cn.axzo.nanopart.visa.api.request.VisaChangeApproveOnlyReq;
+import cn.axzo.nanopart.visa.api.request.VisaChangeDiscussCreateReq;
+import cn.axzo.nanopart.visa.api.request.VisaChangeExportReq;
+import cn.axzo.nanopart.visa.api.request.VisaChangePageSearchReq;
+import cn.axzo.nanopart.visa.api.request.VisaChangeTempCreateReq;
+import cn.axzo.nanopart.visa.api.request.VisaDetailByIdRequest;
+import cn.axzo.nanopart.visa.api.request.VisaInitiatorListReq;
+import cn.axzo.nanopart.visa.api.request.VisaSearchReq;
+import cn.axzo.nanopart.visa.api.response.VisaChangeDiscussCreateResp;
+import cn.axzo.nanopart.visa.api.response.VisaChangeInitiatorResp;
+import cn.axzo.nanopart.visa.api.response.VisaChangePageSearchResp;
+import cn.axzo.nanopart.visa.api.response.VisaDetailByIdResponse;
+import cn.axzo.nanopart.visa.api.response.VisaSearchResp;
+import cn.axzo.nanopart.visa.server.service.ChangeRecordBillService;
+import cn.axzo.nanopart.visa.server.service.ChangeRecordConfirmService;
+import cn.axzo.nanopart.visa.server.service.ChangeRecordService;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.apache.commons.collections.CollectionUtils;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RestController;
+
+import javax.validation.Valid;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+
+/**
+ * @author xudawei
+ * @date 2025/01/15
+ * @desc 变更签证记录
+ */
+@Slf4j
+@RestController
+@RequiredArgsConstructor
+public class ChangeRecordController implements ChangeRecordApi {
+
+ @Autowired
+ private ChangeRecordService changeRecordService;
+
+ @Autowired
+ private ChangeRecordConfirmService changeRecordConfirmService;
+
+ @Autowired
+ private ChangeRecordBillService changeRecordBillService;
+
+ @Override
+ public ApiResult tempCreateVisaChangeRecord(VisaChangeTempCreateReq req) {
+ return ApiResult.ok(changeRecordService.tempCreateVisaChangeRecord(req));
+ }
+
+ @Override
+ public ApiResult checkVisaWithVisaId(CheckVisaWithVisaIdReq req) {
+ changeRecordService.checkVisaWithVisaId(req);
+ return ApiResult.ok();
+ }
+
+ @Override
+ public ApiResult discussCreateVisaChangeRecord(VisaChangeDiscussCreateReq req) {
+ return ApiResult.ok(changeRecordService.discussCreateVisaChangeRecord(req));
+ }
+
+ @Override
+ public ApiResult approveCreateVisaChangeRecord(VisaChangeApproveCreateReq req) {
+ return ApiResult.ok(changeRecordService.approveCreateVisaChangeRecord(req));
+ }
+
+ /**
+ * 变签状态变更
+ */
+ @Override
+ public ApiResult changeStatus(@RequestBody @Valid ChangeStatusRequest request) {
+ return ApiResult.ok(changeRecordService.changeStatus(request));
+ }
+
+
+ /**
+ * 变签详情
+ */
+ @Override
+ public ApiResult visaDetailById(@RequestBody @Valid VisaDetailByIdRequest req) {
+ VisaDetailByIdResponse resp = changeRecordService.detailById(req.getVisaId());
+
+ if (req.isNeedBtnList()) {
+// resp.setBtnList(VisaButtonTypeEnum.sort(VisaButtonTypeEnum.all()));
+ resp.setBtnList(changeRecordConfirmService.fetchBtnsByCondition(req.getVisaId(), req.getPersonId(), req.getOuId(), req.getWorkspaceId(), resp.getStatus(), resp.getApprovalId()));
+ }
+ return ApiResult.ok(resp);
+ }
+
+ @Override
+ public ApiPageResult pageSearchVisaChangeRecord(VisaChangePageSearchReq req) {
+ //重新赋值属性,待提报:TO_REPORT/REPORT_FROM_APPROVE,决策中:DECIDING/DECIDING_FROM_APPROVE
+ this.rechangeAttr(req);
+ PageData pageData = changeRecordService.page(req);
+ return ApiPageResult.ok(pageData.getList(), pageData.getTotalCount(), pageData.getPage(), pageData.getPageSize());
+ }
+
+ @Override
+ public ApiPageResult list(VisaSearchReq req) {
+ PageData page = changeRecordService.list(req);
+ return ApiPageResult.ok(page.getList(), page.getTotalCount(), page.getPage(), page.getPageSize());
+ }
+
+ /**
+ * 重新赋值属性
+ * 待提报:TO_REPORT/REPORT_FROM_APPROVE
+ * 决策中:DECIDING/DECIDING_FROM_APPROVE
+ */
+ private void rechangeAttr(VisaChangePageSearchReq req) {
+ if (Objects.nonNull(req) && CollectionUtils.isNotEmpty(req.getStatuses()) && req.getStatuses().contains(VisaStatusEnum.TO_REPORT)) {
+ req.getStatuses().add(VisaStatusEnum.REPORT_FROM_APPROVE);
+ }
+
+ if (Objects.nonNull(req) && CollectionUtils.isNotEmpty(req.getStatuses()) && req.getStatuses().contains(VisaStatusEnum.DECIDING)) {
+ req.getStatuses().add(VisaStatusEnum.DECIDING_FROM_APPROVE);
+ }
+ }
+
+ @Override
+ public ApiResult exportVisaChangeRecord(VisaChangeExportReq req) {
+ changeRecordService.export(req);
+ return ApiResult.ok();
+ }
+
+ @Override
+ public ApiResult> listInitiator(VisaInitiatorListReq req) {
+ return ApiResult.ok(changeRecordService.listInitiator(req));
+ }
+
+ @Override
+ public ApiResult> getVisaAllConfirm(FetchVisaAllConfirmReq req) {
+ return ApiResult.ok(changeRecordConfirmService.listAllConfirmByVisaId(req.getVisaId()));
+ }
+
+ @Override
+ public ApiResult approveCreateOnlyVisaChangeRecord(VisaChangeApproveOnlyReq req) {
+ return ApiResult.ok(changeRecordService.approveCreateOnlyVisaChangeRecord(req));
+ }
+
+ @Override
+ public ApiResult forbidChangeRecord(ChangeRecordButtonOperationReq req) {
+ changeRecordService.forbid(req);
+ return ApiResult.ok();
+ }
+
+ @Override
+ public ApiResult reDecisionChangeRecord(ChangeRecordButtonOperationReq req) {
+ changeRecordService.reDecision(req);
+ return ApiResult.ok();
+ }
+
+ @Override
+ public ApiResult executeChangeRecord(ChangeRecordButtonOperationReq req) {
+ changeRecordService.doExecute(req);
+ return ApiResult.ok();
+ }
+
+ @Override
+ public ApiResult deleteChangeRecord(ChangeRecordButtonOperationReq req) {
+ changeRecordService.delete(req);
+ return ApiResult.ok();
+ }
+
+ @Override
+ public ApiResult> getBillIfRelated(GetBillIfRelatedReq req) {
+ return ApiResult.ok(changeRecordBillService.getBillIfRelated(req));
+ }
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/controller/ChangeRecordLogController.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/controller/ChangeRecordLogController.java
new file mode 100644
index 00000000..ce209c63
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/controller/ChangeRecordLogController.java
@@ -0,0 +1,39 @@
+package cn.axzo.nanopart.visa.server.controller;
+
+import cn.axzo.framework.domain.web.result.ApiListResult;
+import cn.axzo.nanopart.visa.api.changerecord.ChangeRecordLogApi;
+import cn.axzo.nanopart.visa.api.request.FetchVisaLogByVisaIdRequest;
+import cn.axzo.nanopart.visa.api.response.FetchVisaLogByVisaIdResponse;
+import cn.axzo.nanopart.visa.server.service.ChangeRecordLogService;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestMethod;
+import org.springframework.web.bind.annotation.RestController;
+
+import javax.validation.Valid;
+import java.util.List;
+
+/**
+ * @author xudawei
+ * @date 2025/01/15
+ * @desc 变更签证记录操作日志
+ */
+@Slf4j
+@RestController
+public class ChangeRecordLogController implements ChangeRecordLogApi {
+
+ @Autowired
+ private ChangeRecordLogService changeRecordLogService;
+
+ /**
+ * 根据变签Id,获取变签日志
+ */
+ @Override
+ public ApiListResult fetchVisaLogByVisaId(@RequestBody @Valid FetchVisaLogByVisaIdRequest req) {
+ List responseList = changeRecordLogService.fetchVisaLogByVisaId(req.getVisaId());
+ return ApiListResult.ok(responseList);
+ }
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/controller/ChangeRecordRelationController.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/controller/ChangeRecordRelationController.java
new file mode 100644
index 00000000..36ae9695
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/controller/ChangeRecordRelationController.java
@@ -0,0 +1,69 @@
+package cn.axzo.nanopart.visa.server.controller;
+
+import cn.axzo.framework.domain.web.result.ApiResult;
+import cn.axzo.nanopart.visa.api.changerecord.ChangeRecordRelationApi;
+import cn.axzo.nanopart.visa.api.request.ChangeRecordAppendAttachReq;
+import cn.axzo.nanopart.visa.api.request.ImGroupOperationReq;
+import cn.axzo.nanopart.visa.api.request.ImGroupTipsQueryReq;
+import cn.axzo.nanopart.visa.api.request.VisaRelationReq;
+import cn.axzo.nanopart.visa.api.response.ImGroupTipsResp;
+import cn.axzo.nanopart.visa.api.response.VisaRelationResp;
+import cn.axzo.nanopart.visa.server.domain.ChangeRecordRelation;
+import cn.axzo.nanopart.visa.server.dto.VisaRelationDto;
+import cn.axzo.nanopart.visa.server.service.ChangeRecordRelationService;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.Comparator;
+import java.util.List;
+import java.util.Objects;
+import java.util.stream.Collectors;
+
+/**
+ * @author xudawei
+ * @date 2025/01/15
+ * @desc 变更签证记录内容关系表ø
+ */
+@Slf4j
+@RestController
+@RequiredArgsConstructor
+public class ChangeRecordRelationController implements ChangeRecordRelationApi {
+
+ private final ChangeRecordRelationService changeRecordRelationService;
+
+ @Override
+ public ApiResult> listByVisaId(VisaRelationReq req) {
+ return ApiResult.ok(changeRecordRelationService.findByCondition(VisaRelationDto.builder()
+ .visaId(req.getVisaId())
+ .varName(Objects.nonNull(req.getFieldEnum()) ? req.getFieldEnum().name() : null)
+ .build())
+ .stream().sorted(Comparator.comparing(ChangeRecordRelation::getCreateAt))
+ .map(i -> VisaRelationResp.builder()
+ .id(i.getId())
+ .visaId(String.valueOf(i.getVisaId()))
+ .varName(i.getVarName())
+ .varExt(i.getVarExt())
+ .varType(i.getVarType())
+ .content(i.getContent())
+ .contentExt(i.getContentExt())
+ .createAt(i.getCreateAt())
+ .build()).collect(Collectors.toList()));
+ }
+
+ @Override
+ public ApiResult saveImOperationParticipate(ImGroupOperationReq req) {
+ return ApiResult.ok(changeRecordRelationService.saveImOperationParticipate(req));
+ }
+
+ @Override
+ public ApiResult queryImGroupTips(ImGroupTipsQueryReq req) {
+ return ApiResult.ok(changeRecordRelationService.queryImGroupTips(req));
+ }
+
+ @Override
+ public ApiResult appendAttachment(ChangeRecordAppendAttachReq req) {
+ changeRecordRelationService.appendAttachment(req);
+ return ApiResult.ok();
+ }
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/domain/ChangeRecord.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/domain/ChangeRecord.java
new file mode 100644
index 00000000..61ae9886
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/domain/ChangeRecord.java
@@ -0,0 +1,158 @@
+package cn.axzo.nanopart.visa.server.domain;
+
+import cn.axzo.pokonyan.config.mybatisplus.BaseEntity;
+import cn.axzo.nanopart.visa.api.enums.VisaStatusEnum;
+import cn.axzo.nanopart.visa.api.enums.VisaTypeEnum;
+import com.alibaba.fastjson.JSONArray;
+import com.alibaba.fastjson.JSONObject;
+import com.baomidou.mybatisplus.annotation.FieldStrategy;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.FastjsonTypeHandler;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.experimental.Accessors;
+
+import java.math.BigDecimal;
+import java.util.Date;
+
+/**
+ * @author xudawei
+ * @date 2025/01/15
+ * @desc 变更签证记录
+ */
+@EqualsAndHashCode(callSuper = true)
+@Data
+@Accessors(chain = true)
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@TableName(value = "visa_change_record", autoResultMap = true)
+public class ChangeRecord extends BaseEntity {
+
+ /**
+ * 单据号
+ */
+ @TableField(value = "no")
+ private String no;
+
+ /**
+ * 主题
+ */
+ @TableField(value = "topic")
+ private String topic;
+
+ /**
+ * 项目
+ */
+ @TableField(value = "relation_workspaceId")
+ private Long relationWorkspaceId;
+
+ /**
+ * 工程
+ */
+ @TableField(value = "relation_project")
+ private Long relationProject;
+
+ /**
+ * 区域集合
+ * 示例：
+ *
+ * [
+ * {"areaId": 249556},
+ * {"areaId": 249555}
+ * ]
+ *
+ */
+ @TableField(value = "relation_area", typeHandler = FastjsonTypeHandler.class)
+ private JSONArray relationArea;
+
+ /**
+ * 专业集合
+ * 示例：
+ *
+ * [
+ * {"code":"code1"},
+ * {"code":"code2"},
+ * ]
+ *
+ */
+ @TableField(value = "relation_professional", typeHandler = FastjsonTypeHandler.class)
+ private JSONArray relationProfessional;
+
+ /**
+ * 提出时间
+ */
+ @TableField(value = "happen_time")
+ private Date happenTime;
+
+ /**
+ * 有符号的变更金额
+ */
+ @TableField(value = "amount_change")
+ private BigDecimal amountChange;
+
+ /**
+ * 发生原因
+ */
+ @TableField(value = "reason")
+ private String reason;
+
+ /**
+ * 单据类型
+ */
+ @TableField(value = "type")
+ private VisaTypeEnum type;
+
+ /**
+ * 状态
+ */
+ @TableField(value = "status")
+ private VisaStatusEnum status;
+
+ /**
+ * 最终审批ID
+ */
+ @TableField(value = "approval_id")
+ private String approvalId;
+
+ /**
+ * 最终审批状态
+ */
+ @TableField(value = "approval_status")
+ private String approvalStatus;
+
+ /**
+ * 最终审批时间
+ */
+ @TableField(value = "approval_complete_time", updateStrategy = FieldStrategy.IGNORED)
+ private Date approvalCompleteTime;
+
+ /**
+ * IM群组ID
+ */
+ @TableField(value = "im_group_id")
+ private Long imGroupId;
+
+ /**
+ * 额外信息
+ */
+ @TableField(value = "extra", typeHandler = FastjsonTypeHandler.class)
+ private JSONObject extra;
+
+ /**
+ * 创建人id
+ */
+ @TableField(value = "create_by")
+ private Long createBy;
+
+ /**
+ * 修改人id
+ */
+ @TableField(value = "update_by")
+ private Long updateBy;
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/domain/ChangeRecordBill.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/domain/ChangeRecordBill.java
new file mode 100644
index 00000000..9d6f4b67
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/domain/ChangeRecordBill.java
@@ -0,0 +1,87 @@
+package cn.axzo.nanopart.visa.server.domain;
+
+import cn.axzo.nanopart.visa.api.enums.VisaBillTypeEnum;
+import cn.axzo.nanopart.visa.api.enums.VisaTypeEnum;
+import cn.axzo.pokonyan.config.mybatisplus.BaseEntity;
+import com.alibaba.fastjson.JSONObject;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.FastjsonTypeHandler;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.experimental.Accessors;
+
+/**
+ * @author xudawei
+ * @date 2025/01/20
+ * @desc 变更签证记录单据关系表
+ */
+@EqualsAndHashCode(callSuper = true)
+@Data
+@Accessors(chain = true)
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@TableName(value = "visa_change_record_bill", autoResultMap = true)
+public class ChangeRecordBill extends BaseEntity {
+
+ /**
+ * 变更签证记录id
+ */
+ @TableField(value = "visa_id")
+ private Long visaId;
+
+ /**
+ * 变更签证单据类型
+ */
+ @TableField(value = "visa_type")
+ private VisaTypeEnum visaType;
+
+ /**
+ * 单据id
+ */
+ @TableField(value = "bill_id")
+ private Long billId;
+
+ /**
+ * 单据编号
+ */
+ @TableField(value = "bill_no")
+ private String billNo;
+
+ /**
+ * 单据类型
+ */
+ @TableField(value = "bill_type")
+ private VisaBillTypeEnum billType;
+
+ /**
+ * 单据被关联状态
+ * true 1 被关联
+ * false 0 未关联
+ */
+ @TableField(value = "relation_status")
+ private Boolean relationStatus;
+
+ /**
+ * 额外信息
+ */
+ @TableField(value = "extra", typeHandler = FastjsonTypeHandler.class)
+ private JSONObject extra;
+
+ /**
+ * 创建人id
+ */
+ @TableField(value = "create_by")
+ private Long createBy;
+
+ /**
+ * 修改人id
+ */
+ @TableField(value = "update_by")
+ private Long updateBy;
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/domain/ChangeRecordConfirm.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/domain/ChangeRecordConfirm.java
new file mode 100644
index 00000000..7de9642b
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/domain/ChangeRecordConfirm.java
@@ -0,0 +1,105 @@
+package cn.axzo.nanopart.visa.server.domain;
+
+import cn.axzo.maokai.common.enums.SaasCooperateShipCooperateTypeEnum;
+import cn.axzo.nanopart.visa.api.enums.VisaTypeEnum;
+import cn.axzo.pokonyan.config.mybatisplus.BaseEntity;
+import cn.axzo.nanopart.visa.api.enums.VisaConfirmBizTypeEnum;
+import com.alibaba.fastjson.JSONObject;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.FastjsonTypeHandler;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.experimental.Accessors;
+
+/**
+ * @author xudawei
+ * @date 2025/01/15
+ * @desc 变更签证记录确认
+ */
+@EqualsAndHashCode(callSuper = true)
+@Data
+@Accessors(chain = true)
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@TableName(value = "visa_change_record_confirm", autoResultMap = true)
+public class ChangeRecordConfirm extends BaseEntity {
+
+ /**
+ * 变更签id
+ */
+ @TableField(value = "visa_id")
+ private Long visaId;
+
+ /**
+ * 类型
+ */
+ @TableField(value = "type")
+ private SaasCooperateShipCooperateTypeEnum type;
+
+ /**
+ * 业务类型,CONFIRM:确认;CREATE:创建
+ */
+ @TableField(value = "biz_type")
+ private VisaConfirmBizTypeEnum bizType;
+
+
+ /**
+ * 业务类型,CONFIRM:确认;CREATE:创建
+ */
+ @TableField(value = "visa_type")
+ private VisaTypeEnum visaType;
+
+ /**
+ * 确认人
+ */
+ @TableField(value = "person_id")
+ private Long personId;
+
+ /**
+ * 确认单位
+ */
+ @TableField(value = "ou_id")
+ private Long ouId;
+
+ /**
+ * 确认项目
+ */
+ @TableField(value = "workspace_id")
+ private Long workspaceId;
+
+ /**
+ * 确认工程
+ */
+ @TableField(value = "project_id")
+ private Long projectId;
+
+ /**
+ * 确认节点
+ */
+ @TableField(value = "node_id")
+ private Long nodeId;
+
+ /**
+ * 额外信息
+ */
+ @TableField(value = "extra",typeHandler = FastjsonTypeHandler.class)
+ private JSONObject extra;
+
+ /**
+ * 创建人id
+ */
+ @TableField(value = "create_by")
+ private Long createBy;
+
+ /**
+ * 修改人id
+ */
+ @TableField(value = "update_by")
+ private Long updateBy;
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/domain/ChangeRecordLog.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/domain/ChangeRecordLog.java
new file mode 100644
index 00000000..aece4fc2
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/domain/ChangeRecordLog.java
@@ -0,0 +1,66 @@
+package cn.axzo.nanopart.visa.server.domain;
+
+import cn.axzo.pokonyan.config.mybatisplus.BaseEntity;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.experimental.Accessors;
+
+import java.util.Date;
+
+/**
+ * @author xudawei
+ * @date 2025/01/15
+ * @desc 变更签证记录操作日志
+ */
+@EqualsAndHashCode(callSuper = true)
+@Data
+@Accessors(chain = true)
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@TableName(value = "visa_change_record_log", autoResultMap = true)
+public class ChangeRecordLog extends BaseEntity {
+
+ /**
+ * 变更签证记录id
+ */
+ @TableField(value = "visa_id")
+ private Long visaId;
+
+ /**
+ * 操作动作
+ */
+ @TableField(value = "action")
+ private String action;
+
+ /**
+ * 操作标题
+ */
+ @TableField(value = "title")
+ private String title;
+
+ /**
+ * 操作内容
+ */
+ @TableField(value = "content")
+ private String content;
+
+ /**
+ * 排序
+ */
+ @TableField(value = "order_by")
+ private Integer orderBy;
+
+ /**
+ * 创建人id
+ */
+ @TableField(value = "create_by")
+ private Long createBy;
+
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/domain/ChangeRecordRelation.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/domain/ChangeRecordRelation.java
new file mode 100644
index 00000000..079a9eaf
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/domain/ChangeRecordRelation.java
@@ -0,0 +1,74 @@
+package cn.axzo.nanopart.visa.server.domain;
+
+import cn.axzo.pokonyan.config.mybatisplus.BaseEntity;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.experimental.Accessors;
+
+/**
+ * @author xudawei
+ * @date 2025/01/15
+ * @desc 变更签证记录内容关系表
+ */
+@EqualsAndHashCode(callSuper = true)
+@Data
+@Accessors(chain = true)
+@NoArgsConstructor
+@AllArgsConstructor
+@TableName(value = "visa_change_record_relation", autoResultMap = true)
+public class ChangeRecordRelation extends BaseEntity {
+
+ /**
+ * 变更签证记录id
+ */
+ @TableField(value = "visa_id")
+ private Long visaId;
+
+ /**
+ * 关联的内容名称（发生内容及说明、相关单位及人员，单据，附件，审批记录）
+ */
+ @TableField(value = "var_name")
+ private String varName;
+
+ /**
+ * 扩展内容名称
+ */
+ @TableField(value = "var_ext")
+ private String varExt;
+
+ /**
+ * 值类型
+ */
+
+ @TableField(value = "var_type")
+ private String varType;
+
+ /**
+ * 内容值
+ */
+ @TableField(value = "content")
+ private String content;
+
+ /**
+ * 内容描述
+ */
+ @TableField(value = "content_ext")
+ private String contentExt;
+
+ /**
+ * 创建人id
+ */
+ @TableField(value = "create_by")
+ private Long createBy;
+
+ /**
+ * 修改人id
+ */
+ @TableField(value = "update_by")
+ private Long updateBy;
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/dto/VisaAddLogContext.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/dto/VisaAddLogContext.java
new file mode 100644
index 00000000..9c1ac9a9
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/dto/VisaAddLogContext.java
@@ -0,0 +1,55 @@
+package cn.axzo.nanopart.visa.server.dto;
+
+import cn.axzo.nanopart.visa.api.enums.VisaRelationFieldEnum;
+import cn.axzo.nanopart.visa.api.enums.VisaStatusEnum;
+import cn.axzo.nanopart.visa.server.domain.ChangeRecord;
+import cn.axzo.nanopart.visa.server.domain.ChangeRecordRelation;
+import com.alibaba.fastjson.JSONObject;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import org.apache.commons.collections.CollectionUtils;
+import org.apache.commons.compress.utils.Lists;
+
+import java.util.List;
+import java.util.stream.Collectors;
+
+@Builder
+@Data
+@AllArgsConstructor
+@NoArgsConstructor
+public class VisaAddLogContext {
+
+ /**
+ * 人员Id
+ */
+ private Long personId;
+ /**
+ * 项目Id
+ */
+ private Long workspaceId;
+ /**
+ * 单位id
+ */
+ private Long ouId;
+
+ private VisaStatusEnum status;
+
+ private ChangeRecord changeRecord;
+
+ private List relationList;
+
+ /**
+ * 获取附件集合
+ */
+ public List getAttachList() {
+ if (CollectionUtils.isEmpty(relationList)) {
+ return Lists.newArrayList();
+ }
+ return relationList.stream()
+ .filter(item -> VisaRelationFieldEnum.isAttach(item.getVarName()))
+ .map(item -> JSONObject.parseObject(item.getContent())).collect(Collectors.toList());
+ }
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/dto/VisaBillDto.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/dto/VisaBillDto.java
new file mode 100644
index 00000000..7b6d619b
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/dto/VisaBillDto.java
@@ -0,0 +1,70 @@
+package cn.axzo.nanopart.visa.server.dto;
+
+import cn.axzo.nanopart.visa.api.enums.VisaBillTypeEnum;
+import cn.axzo.nanopart.visa.api.enums.VisaTypeEnum;
+import com.alibaba.fastjson.JSONObject;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import lombok.experimental.Accessors;
+
+/**
+ * @author xudawei
+ * @date 2025/01/17
+ * @desc 变更签证记录确认
+ */
+@Data
+@Accessors(chain = true)
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class VisaBillDto {
+
+ /**
+ * 变更签证记录id
+ */
+ private Long visaId;
+
+ /**
+ * 变更签证单据类型
+ */
+ private VisaTypeEnum visaType;
+
+ /**
+ * 单据id
+ */
+ private Long billId;
+
+ /**
+ * 单据编号
+ */
+ private String billNo;
+
+ /**
+ * 单据类型
+ */
+ private VisaBillTypeEnum billType;
+ /**
+ * 额外信息
+ */
+ private JSONObject extra;
+
+ /**
+ * 创建人id
+ */
+ private Long createBy;
+
+ /**
+ * 修改人id
+ */
+ private Long updateBy;
+
+ /**
+ * 单据被关联状态
+ * true 1 被关联
+ * false 0 未关联
+ */
+ private Boolean relationStatus;
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/dto/VisaConfirmDto.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/dto/VisaConfirmDto.java
new file mode 100644
index 00000000..23edf2f1
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/dto/VisaConfirmDto.java
@@ -0,0 +1,156 @@
+package cn.axzo.nanopart.visa.server.dto;
+
+import cn.axzo.karma.client.feign.tyr.response.MergeMatchDataResp;
+import cn.axzo.maokai.common.enums.SaasCooperateShipCooperateTypeEnum;
+import cn.axzo.nanopart.visa.api.enums.VisaConfirmBizTypeEnum;
+import cn.axzo.nanopart.visa.api.enums.VisaTypeEnum;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import lombok.experimental.Accessors;
+import org.apache.commons.collections.CollectionUtils;
+
+import java.util.Collection;
+import java.util.List;
+import java.util.Objects;
+import java.util.Set;
+import java.util.stream.Collectors;
+
+/**
+ * @author xudawei
+ * @date 2025/01/17
+ * @desc 变更签证记录确认
+ */
+@Data
+@Accessors(chain = true)
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class VisaConfirmDto {
+
+ /**
+ * 变更签id
+ */
+ private Long visaId;
+
+ private Collection visaIds;
+
+ /**
+ * 类型
+ */
+ private SaasCooperateShipCooperateTypeEnum type;
+
+ /**
+ * 业务类型,CONFIRM:确认;CREATE:创建
+ */
+ private VisaConfirmBizTypeEnum bizType;
+
+ /**
+ * 确认人
+ */
+ private Long personId;
+ /**
+ * 确认人集合
+ */
+ private Collection personIds;
+
+ /**
+ * 确认单位
+ */
+ private Long ouId;
+
+ /**
+ * 确认单位集合
+ */
+ private Collection ouIds;
+
+ /**
+ * 确认项目
+ */
+ private Long workspaceId;
+
+ /**
+ * 确认项目集合
+ */
+ private Collection workspaceIds;
+
+ /**
+ * 确认工程
+ */
+ private Long projectId;
+
+ /**
+ * 确认工程集合
+ */
+ private Collection projectIds;
+
+ /**
+ * 确认节点
+ */
+ private Long nodeId;
+ /**
+ * 确认节点集合
+ */
+ private Collection nodeIds;
+
+ private Long operator;
+
+ /**
+ * 变更签证类型集合
+ */
+ private Set visaTypes;
+
+
+ /**
+ * 变更签证类型
+ */
+ private VisaTypeEnum visaType;
+ /**
+ * 根据DataItem创建Dto
+ */
+ public static VisaConfirmDto create(List dataItems, Set visaTypes) {
+
+ VisaConfirmDto dto = new VisaConfirmDto();
+
+ if (CollectionUtils.isNotEmpty(dataItems)) {
+ Collection personIds = dataItems.stream()
+ .filter(item -> CollectionUtils.isNotEmpty(item.getPersonIds()))
+ .flatMap(item -> item.getPersonIds().stream()).collect(Collectors.toSet());
+ if (CollectionUtils.isNotEmpty(personIds)) {
+ dto.setPersonIds(personIds);
+ }
+
+ Collection ouIds = dataItems.stream()
+ .filter(item -> Objects.nonNull(item.getOuId()))
+ .map(item -> item.getOuId()).collect(Collectors.toSet());
+ if (CollectionUtils.isNotEmpty(ouIds)) {
+ dto.setOuIds(ouIds);
+ }
+
+ Collection workspaceIds = dataItems.stream()
+ .filter(item -> Objects.nonNull(item.getWorkspaceId()))
+ .map(item -> item.getWorkspaceId()).collect(Collectors.toSet());
+ if (CollectionUtils.isNotEmpty(workspaceIds)) {
+ dto.setWorkspaceIds(workspaceIds);
+ }
+
+ Set nodeIds = dataItems.stream()
+ .filter(item -> Objects.nonNull(item.getNodeId()))
+ .map(item -> item.getNodeId()).collect(Collectors.toSet());
+ if (CollectionUtils.isNotEmpty(nodeIds)) {
+ dto.setNodeIds(nodeIds);
+ }
+
+ Collection projectIds = dataItems.stream()
+ .filter(item -> CollectionUtils.isNotEmpty(item.getProjectIds()))
+ .flatMap(item -> item.getProjectIds().stream()).collect(Collectors.toSet());
+ if (CollectionUtils.isNotEmpty(projectIds)) {
+ dto.setProjectIds(projectIds);
+ }
+ }
+ dto.setVisaTypes(visaTypes);
+ return dto;
+ }
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/dto/VisaExportDto.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/dto/VisaExportDto.java
new file mode 100644
index 00000000..69b1aeff
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/dto/VisaExportDto.java
@@ -0,0 +1,77 @@
+package cn.axzo.nanopart.visa.server.dto;
+
+import com.alibaba.excel.annotation.ExcelProperty;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.math.BigDecimal;
+import java.util.Date;
+
+/**
+ * @author chenwenjian
+ * @version 1.0
+ * @date 2025/1/23 10:19
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class VisaExportDto {
+
+
+ /**
+ * 单据号
+ */
+ @ExcelProperty("单号")
+ private String no;
+
+ /**
+ * 单据类型
+ */
+ @ExcelProperty("单据类型")
+ private String type;
+
+ /**
+ * 状态
+ */
+ @ExcelProperty("单据状态")
+ private String status;
+
+ /**
+ * 主题
+ */
+ @ExcelProperty("主题")
+ private String topic;
+
+ /**
+ * 有符号的变更金额
+ */
+ @ExcelProperty("金额变化")
+ private BigDecimal amountChange;
+
+ /**
+ * 发起人
+ */
+ @ExcelProperty("发起人")
+ private String initiator;
+
+ /**
+ * 提出时间
+ */
+ @ExcelProperty("提出时间")
+ private Date happenTime;
+
+ /**
+ * 最终审批时间
+ */
+ @ExcelProperty("审批通过时间")
+ private Date approvalCompleteTime;
+
+ /**
+ * 工程
+ */
+ @ExcelProperty("所属工程")
+ private String relationProject;
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/dto/VisaLogDto.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/dto/VisaLogDto.java
new file mode 100644
index 00000000..731ff412
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/dto/VisaLogDto.java
@@ -0,0 +1,31 @@
+package cn.axzo.nanopart.visa.server.dto;
+
+import cn.axzo.nanopart.visa.api.enums.VisaLogTypeEnum;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import lombok.experimental.Accessors;
+
+/**
+ * @author xudawei
+ * @date 2025/01/21
+ * @desc 变更签证记录日志确认
+ */
+@Data
+@Accessors(chain = true)
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class VisaLogDto {
+
+ /**
+ * 变更签证Id
+ */
+ private Long visaId;
+ /**
+ * 类型
+ */
+ private VisaLogTypeEnum logType;
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/dto/VisaLogParam.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/dto/VisaLogParam.java
new file mode 100644
index 00000000..8dd99778
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/dto/VisaLogParam.java
@@ -0,0 +1,163 @@
+package cn.axzo.nanopart.visa.server.dto;
+
+import cn.axzo.nanopart.visa.api.enums.VisaLogTypeEnum;
+import cn.axzo.nanopart.visa.api.enums.VisaStatusEnum;
+import cn.axzo.nanopart.visa.api.response.VisaDetailByIdResponse;
+import cn.hutool.core.collection.CollUtil;
+import com.alibaba.fastjson.JSONObject;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import lombok.experimental.Accessors;
+import org.apache.commons.collections.CollectionUtils;
+import org.apache.commons.compress.utils.Lists;
+
+import java.math.BigDecimal;
+import java.util.Collection;
+import java.util.List;
+import java.util.stream.Collectors;
+
+/**
+ * @author xudawei
+ * @date 2025/01/21
+ * @desc 变更签证记录日志确认
+ */
+@Data
+@Accessors(chain = true)
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class VisaLogParam {
+
+ /**
+ * 人员Id
+ */
+ private Long personId;
+ /**
+ * 单位Id
+ */
+ private Long ouId;
+ /**
+ * 项目Id
+ */
+ private Long workspaceId;
+
+ /**
+ * 原变更金额
+ */
+ private BigDecimal oldAmountChange;
+
+ /**
+ * 新变更金额
+ */
+ private BigDecimal newAmountChange;
+
+ /**
+ * 上传文件
+ */
+ private List uploadAttach;
+
+ /**
+ * 删除文件
+ */
+ private List deleteAttach;
+
+ /**
+ * 日志类型
+ */
+ private VisaLogTypeEnum logType;
+
+ /**
+ * 原因:审批流的驳回原因/转交原因
+ */
+ private String reason;
+
+ /**
+ * 审批流转交给的用户
+ */
+ private String transmitTo;
+ /**
+ * 新状态
+ */
+ private VisaStatusEnum newStatus;
+ /**
+ * 原状态
+ */
+ private VisaStatusEnum oldStatus;
+
+
+ /**
+ * 获取删除附件信息
+ */
+ public static List deleteAttach(List oldAttach, List newAttach) {
+ return fetchChangeAttach(oldAttach, newAttach);
+ }
+
+ /**
+ * 获取删除附件信息
+ */
+ public static List deleteAttachWithObject(List oldAttach, List newAttach) {
+ return fetchChangeAttachWithObject(oldAttach, newAttach);
+ }
+
+ /**
+ * 获取上传的附件信息
+ */
+ public static List uploadAttach(List newAttach, List oldAttach) {
+ return fetchChangeAttach(newAttach, oldAttach);
+ }
+
+ /**
+ * 获取上传的附件信息
+ */
+ public static List uploadAttachWithObject(List newAttach, List oldAttach) {
+ return fetchChangeAttachWithObject(newAttach, oldAttach);
+ }
+
+
+
+ /**
+ * 获取变动的附件信息
+ * 计算集合的单差集，即只返回【集合1】中有，但是【集合2】中没有的元素，例如：
+ * subtractToList([1,2,3,4],[2,3,4,5]) -》 [1]
+ */
+ private static List fetchChangeAttach(List compareFir, List compareSec) {
+ if (CollectionUtils.isEmpty(compareFir)) {
+ return Lists.newArrayList();
+ }
+ List oldFileDtoList = VisaDetailByIdResponse.VisaUploadFile.createListByJson(compareFir);
+
+ if (CollectionUtils.isEmpty(compareSec)) {
+ return oldFileDtoList.stream().map(VisaDetailByIdResponse.VisaUploadFile::getFileName).collect(Collectors.toList());
+ }
+ List newFileDtoList = VisaDetailByIdResponse.VisaUploadFile.createListByJson(compareSec);
+
+ return fetchChangeAttachWithObject(oldFileDtoList, newFileDtoList);
+ }
+
+
+
+ /**
+ * 获取变动的附件信息
+ * 计算集合的单差集，即只返回【集合1】中有，但是【集合2】中没有的元素，例如：
+ * subtractToList([1,2,3,4],[2,3,4,5]) -》 [1]
+ */
+ private static List fetchChangeAttachWithObject(List compareFir, List compareSec) {
+ if (CollectionUtils.isEmpty(compareFir)) {
+ return Lists.newArrayList();
+ }
+
+ if (CollectionUtils.isEmpty(compareSec)) {
+ return compareFir.stream().map(VisaDetailByIdResponse.VisaUploadFile::getFileName).collect(Collectors.toList());
+ }
+
+ Collection substractList = CollUtil.subtractToList(compareFir, compareSec);
+ if (CollectionUtils.isEmpty(substractList)) {
+ return Lists.newArrayList();
+ }
+ return substractList.stream().map(VisaDetailByIdResponse.VisaUploadFile::getFileName).collect(Collectors.toList());
+ }
+
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/dto/VisaRelationDto.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/dto/VisaRelationDto.java
new file mode 100644
index 00000000..69d40f88
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/dto/VisaRelationDto.java
@@ -0,0 +1,46 @@
+package cn.axzo.nanopart.visa.server.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import lombok.experimental.Accessors;
+
+/**
+ * @author xudawei
+ * @date 2025/01/21
+ * @desc 变更签证记录内容关系表
+ */
+@Data
+@Accessors(chain = true)
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class VisaRelationDto {
+
+ /**
+ * 变更签证记录id
+ */
+ private Long visaId;
+
+ /**
+ * 类型
+ */
+ private String varName;
+
+ /**
+ * 内容
+ */
+ private String content;
+
+ /**
+ * 内容扩展
+ */
+ private String contentExt;
+
+ /**
+ * 创建人
+ */
+ private Long createBy;
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mapper/ChangeRecordBillDao.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mapper/ChangeRecordBillDao.java
new file mode 100644
index 00000000..6bf5f9ad
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mapper/ChangeRecordBillDao.java
@@ -0,0 +1,15 @@
+package cn.axzo.nanopart.visa.server.mapper;
+
+import cn.axzo.nanopart.visa.server.domain.ChangeRecordBill;
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import org.apache.ibatis.annotations.Mapper;
+
+/**
+ * @author xudawei
+ * @date 2025/01/15
+ * @desc 变更签证记录单据关系表
+ */
+@Mapper
+public interface ChangeRecordBillDao extends BaseMapper {
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mapper/ChangeRecordConfirmDao.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mapper/ChangeRecordConfirmDao.java
new file mode 100644
index 00000000..770a3dc3
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mapper/ChangeRecordConfirmDao.java
@@ -0,0 +1,15 @@
+package cn.axzo.nanopart.visa.server.mapper;
+
+import cn.axzo.nanopart.visa.server.domain.ChangeRecordConfirm;
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import org.apache.ibatis.annotations.Mapper;
+
+/**
+ * @author xudawei
+ * @date 2025/01/15
+ * @desc 变更签证记录确认
+ */
+@Mapper
+public interface ChangeRecordConfirmDao extends BaseMapper {
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mapper/ChangeRecordDao.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mapper/ChangeRecordDao.java
new file mode 100644
index 00000000..54050363
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mapper/ChangeRecordDao.java
@@ -0,0 +1,15 @@
+package cn.axzo.nanopart.visa.server.mapper;
+
+import cn.axzo.nanopart.visa.server.domain.ChangeRecord;
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import org.apache.ibatis.annotations.Mapper;
+
+/**
+ * @author xudawei
+ * @date 2025/01/15
+ * @desc 变更签证记录
+ */
+@Mapper
+public interface ChangeRecordDao extends BaseMapper {
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mapper/ChangeRecordLogDao.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mapper/ChangeRecordLogDao.java
new file mode 100644
index 00000000..1ce735c9
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mapper/ChangeRecordLogDao.java
@@ -0,0 +1,15 @@
+package cn.axzo.nanopart.visa.server.mapper;
+
+import cn.axzo.nanopart.visa.server.domain.ChangeRecordLog;
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import org.apache.ibatis.annotations.Mapper;
+
+/**
+ * @author xudawei
+ * @date 2025/01/15
+ * @desc 变更签证记录操作日志
+ */
+@Mapper
+public interface ChangeRecordLogDao extends BaseMapper {
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mapper/ChangeRecordRelationDao.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mapper/ChangeRecordRelationDao.java
new file mode 100644
index 00000000..925dc2af
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mapper/ChangeRecordRelationDao.java
@@ -0,0 +1,15 @@
+package cn.axzo.nanopart.visa.server.mapper;
+
+import cn.axzo.nanopart.visa.server.domain.ChangeRecordRelation;
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import org.apache.ibatis.annotations.Mapper;
+
+/**
+ * @author xudawei
+ * @date 2025/01/15
+ * @desc 变更签证记录内容关系表
+ */
+@Mapper
+public interface ChangeRecordRelationDao extends BaseMapper {
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/listener/im/ImGroupAddMembersEventHandler.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/listener/im/ImGroupAddMembersEventHandler.java
new file mode 100644
index 00000000..5aaf3f4e
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/listener/im/ImGroupAddMembersEventHandler.java
@@ -0,0 +1,108 @@
+package cn.axzo.nanopart.visa.server.mq.listener.im;
+
+import cn.axzo.basics.common.util.AssertUtil;
+import cn.axzo.basics.profiles.dto.basic.PersonProfileDto;
+import cn.axzo.framework.rocketmq.Event;
+import cn.axzo.framework.rocketmq.EventConsumer;
+import cn.axzo.framework.rocketmq.EventHandler;
+import cn.axzo.im.center.api.vo.group.GroupInfo;
+import cn.axzo.im.center.api.vo.group.GroupMemberInfo;
+import cn.axzo.im.center.api.vo.mq.GroupMembersChangeMessage;
+import cn.axzo.msg.center.api.MessageAPIV3;
+import cn.axzo.msg.center.api.request.v3.MessageSendReqV3;
+import cn.axzo.msg.center.service.dto.PersonV3DTO;
+import cn.axzo.nanopart.visa.api.enums.VisaTypeEnum;
+import cn.axzo.nanopart.visa.server.config.RefreshableConfiguration;
+import cn.axzo.nanopart.visa.server.rpc.VisaProfileGateway;
+import com.alibaba.fastjson.JSON;
+import com.alibaba.fastjson.JSONObject;
+import com.google.common.collect.Lists;
+import lombok.extern.slf4j.Slf4j;
+import org.apache.commons.lang3.StringUtils;
+import org.apache.groovy.util.Maps;
+import org.springframework.beans.factory.InitializingBean;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Component;
+
+import javax.annotation.Resource;
+import java.util.Map;
+import java.util.Objects;
+
+import static cn.axzo.im.center.api.enums.MqEventType.GROUP_ADD_MEMBERS;
+import static cn.axzo.nanopart.visa.api.constant.VisaConstant.IM_GROUP_BIZ_INFO_INITIATOR_WORKSPACE_ID;
+import static cn.axzo.nanopart.visa.api.constant.VisaConstant.IM_GROUP_BIZ_INFO_VISA_ID;
+import static cn.axzo.nanopart.visa.api.constant.VisaConstant.IM_GROUP_BIZ_INFO_VISA_TYPE;
+
+/**
+ * 监听 IM 添加群成员的广播事件
+ *
+ * @author wangli
+ * @since 2025-02-07 13:53
+ */
+@Slf4j
+@Component
+public class ImGroupAddMembersEventHandler implements EventHandler, InitializingBean {
+ @Autowired
+ private EventConsumer eventConsumer;
+ @Resource
+ private RefreshableConfiguration refreshableConfiguration;
+ @Resource
+ private MessageAPIV3 noticeApi;
+ @Resource
+ private VisaProfileGateway visaProfileGateway;
+
+ @Override
+ public void onEvent(Event event, EventConsumer.Context context) {
+ if (Objects.isNull(event) || Objects.isNull(event.getEventCode())) {
+ log.warn("illegal event code: {}", JSON.toJSONString(event));
+ return;
+ }
+ log.info("receive add member event, push notice : {}", JSON.toJSONString(event));
+ GroupMembersChangeMessage groupMembersChangeMessage = event.normalizedData(GroupMembersChangeMessage.class);
+ GroupInfo group = groupMembersChangeMessage.getGroup();
+ AssertUtil.notNull(group, "im group is null");
+
+ GroupMemberInfo member = groupMembersChangeMessage.getMember();
+ AssertUtil.notNull(member, "im member is null");
+
+ Map profileMap = visaProfileGateway.getProfileMap(Lists.newArrayList(group.getOwnerPersonId(), member.getPersonId()));
+
+
+ Long visaId = Long.valueOf(group.getBizGroupInfo().getOrDefault(IM_GROUP_BIZ_INFO_VISA_ID, 0).toString());
+ String visaType = (String) group.getBizGroupInfo().getOrDefault(IM_GROUP_BIZ_INFO_VISA_TYPE, "");
+ Long workspaceId = Long.valueOf(group.getBizGroupInfo().getOrDefault(IM_GROUP_BIZ_INFO_INITIATOR_WORKSPACE_ID, 0).toString());
+
+ PersonProfileDto memberProfile = profileMap.getOrDefault(member.getPersonId(), null);
+ PersonProfileDto ownerProfile = profileMap.getOrDefault(group.getOwnerPersonId(), null);
+
+ if (Objects.nonNull(memberProfile) && Objects.nonNull(ownerProfile)) {
+ MessageSendReqV3 notice = new MessageSendReqV3();
+ notice.setSender(PersonV3DTO.builder().build());
+
+ notice.setReceivers(Lists.newArrayList(PersonV3DTO.builder()
+ .id(member.getPersonId())
+ .name(memberProfile.getRealName())
+ .imReceiveModel(new PersonV3DTO.ReceiveModel(member.getPersonOuId(), workspaceId))
+ .build()));
+ notice.setBizEventMappingCode(refreshableConfiguration.getImGroupAddMemberNoticeEventCode());
+ notice.setBizCode(String.valueOf(visaId));
+ notice.setBizExtParams(new JSONObject(Maps.of(
+ "visaId", visaId,
+ "initiatorName", ownerProfile.getRealName(),
+ "visaType", StringUtils.isNotBlank(visaType) ? VisaTypeEnum.valueOf(visaType).getDesc() : "",
+ "topic", group.getName())));
+ notice.setRouterParams(new JSONObject(Maps.of(
+ "visaId", visaId,
+ "ouId", member.getPersonOuId(),
+ "workspaceId", workspaceId
+ )));
+ noticeApi.send(notice);
+ }
+ log.info("receive add member event, push notice success!");
+ }
+
+ @Override
+ public void afterPropertiesSet() {
+ eventConsumer.registerHandler(GROUP_ADD_MEMBERS.getEventCode(), this);
+ }
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/listener/im/ImGroupDismissedEventHandler.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/listener/im/ImGroupDismissedEventHandler.java
new file mode 100644
index 00000000..9595df8c
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/listener/im/ImGroupDismissedEventHandler.java
@@ -0,0 +1,41 @@
+package cn.axzo.nanopart.visa.server.mq.listener.im;
+
+import cn.axzo.framework.rocketmq.Event;
+import cn.axzo.framework.rocketmq.EventConsumer;
+import cn.axzo.framework.rocketmq.EventHandler;
+import com.alibaba.fastjson.JSON;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.beans.factory.InitializingBean;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Component;
+
+import java.util.Objects;
+
+import static cn.axzo.im.center.api.enums.MqEventType.GROUP_DISMISSED;
+
+/**
+ * 监听 IM 群解散的广播事件
+ *
+ * @author wangli
+ * @since 2025-02-07 13:53
+ */
+@Slf4j
+@Component
+public class ImGroupDismissedEventHandler implements EventHandler, InitializingBean {
+ @Autowired
+ private EventConsumer eventConsumer;
+
+ @Override
+ public void onEvent(Event event, EventConsumer.Context context) {
+ if (Objects.isNull(event) || Objects.isNull(event.getEventCode())) {
+ log.warn("illegal event code: {}", JSON.toJSONString(event));
+ return;
+ }
+
+ }
+
+ @Override
+ public void afterPropertiesSet() {
+ eventConsumer.registerHandler(GROUP_DISMISSED.getEventCode(), this);
+ }
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/listener/im/ImGroupRemoveMembersEventHandler.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/listener/im/ImGroupRemoveMembersEventHandler.java
new file mode 100644
index 00000000..047969d9
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/listener/im/ImGroupRemoveMembersEventHandler.java
@@ -0,0 +1,73 @@
+package cn.axzo.nanopart.visa.server.mq.listener.im;
+
+import cn.axzo.basics.common.util.AssertUtil;
+import cn.axzo.framework.rocketmq.Event;
+import cn.axzo.framework.rocketmq.EventConsumer;
+import cn.axzo.framework.rocketmq.EventHandler;
+import cn.axzo.im.center.api.vo.group.GroupInfo;
+import cn.axzo.im.center.api.vo.group.GroupMemberInfo;
+import cn.axzo.im.center.api.vo.mq.GroupMembersChangeMessage;
+import cn.axzo.nanopart.visa.api.request.ImGroupOperationClearReq;
+import cn.axzo.nanopart.visa.server.service.ChangeRecordRelationService;
+import com.alibaba.fastjson.JSON;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.beans.factory.InitializingBean;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Component;
+
+import javax.annotation.Resource;
+import java.util.Objects;
+
+import static cn.axzo.im.center.api.enums.MqEventType.GROUP_REMOVE_MEMBERS;
+import static cn.axzo.nanopart.visa.api.constant.VisaConstant.IM_GROUP_BIZ_INFO_VISA_ID;
+
+/**
+ * 监听 IM 群成员被移除的广播事件
+ *
+ * @author wangli
+ * @since 2025-02-07 13:53
+ */
+@Slf4j
+@Component
+public class ImGroupRemoveMembersEventHandler implements EventHandler, InitializingBean {
+ @Autowired
+ private EventConsumer eventConsumer;
+ @Resource
+ private ChangeRecordRelationService changeRecordRelationService;
+
+ @Override
+ public void onEvent(Event event, EventConsumer.Context context) {
+ if (Objects.isNull(event) || Objects.isNull(event.getEventCode())) {
+ log.warn("illegal event code: {}", JSON.toJSONString(event));
+ return;
+ }
+ log.info("receive remove member event: {}", JSON.toJSONString(event));
+ GroupMembersChangeMessage groupMembersChangeMessage = event.normalizedData(GroupMembersChangeMessage.class);
+ GroupInfo group = groupMembersChangeMessage.getGroup();
+ AssertUtil.notNull(group, "im group is null");
+
+ GroupMemberInfo member = groupMembersChangeMessage.getMember();
+ AssertUtil.notNull(member, "im member is null");
+
+ // 移除该群成员的投票信息
+ removeMemberVote(group, member);
+ log.info("receive remove member event handle success!");
+ }
+
+ private void removeMemberVote(GroupInfo group, GroupMemberInfo member) {
+ Long visaId = Long.valueOf(group.getBizGroupInfo().getOrDefault(IM_GROUP_BIZ_INFO_VISA_ID, 0).toString());
+
+ changeRecordRelationService.clearImOperationParticipate(ImGroupOperationClearReq.builder()
+ .clearAll(false)
+ .imGroupId(group.getTid())
+ .visaId(visaId)
+ .operatorPersonId(member.getPersonId())
+ .operatorOuId(member.getPersonOuId())
+ .build());
+ }
+
+ @Override
+ public void afterPropertiesSet() {
+ eventConsumer.registerHandler(GROUP_REMOVE_MEMBERS.getEventCode(), this);
+ }
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/listener/im/ImGroupsCreatedEventHandler.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/listener/im/ImGroupsCreatedEventHandler.java
new file mode 100644
index 00000000..f49d53a5
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/listener/im/ImGroupsCreatedEventHandler.java
@@ -0,0 +1,161 @@
+package cn.axzo.nanopart.visa.server.mq.listener.im;
+
+import cn.axzo.basics.common.util.AssertUtil;
+import cn.axzo.basics.profiles.dto.basic.PersonProfileDto;
+import cn.axzo.framework.rocketmq.Event;
+import cn.axzo.framework.rocketmq.EventConsumer;
+import cn.axzo.framework.rocketmq.EventHandler;
+import cn.axzo.im.center.api.vo.PersonAccountAttribute;
+import cn.axzo.im.center.api.vo.group.GroupInfo;
+import cn.axzo.im.center.api.vo.group.GroupMemberInfo;
+import cn.axzo.im.center.api.vo.mq.GroupChangedMessage;
+import cn.axzo.im.center.api.vo.req.GroupGetOwnerRequest;
+import cn.axzo.im.center.api.vo.req.SendChatMessageRequest;
+import cn.axzo.im.center.api.vo.resp.GroupGetOwnerResponse;
+import cn.axzo.im.center.common.enums.AppTypeEnum;
+import cn.axzo.maokai.api.vo.response.OrganizationalUnitVO;
+import cn.axzo.msg.center.service.dto.PeerPerson;
+import cn.axzo.msg.center.service.pending.request.CardSendRequest;
+import cn.axzo.nanopart.visa.api.enums.VisaConfirmBizTypeEnum;
+import cn.axzo.nanopart.visa.api.enums.VisaTypeEnum;
+import cn.axzo.nanopart.visa.server.config.RefreshableConfiguration;
+import cn.axzo.nanopart.visa.server.domain.ChangeRecord;
+import cn.axzo.nanopart.visa.server.domain.ChangeRecordConfirm;
+import cn.axzo.nanopart.visa.server.dto.VisaConfirmDto;
+import cn.axzo.nanopart.visa.server.rpc.MsgCenterGateway;
+import cn.axzo.nanopart.visa.server.rpc.OrganizationalUnitGateway;
+import cn.axzo.nanopart.visa.server.rpc.VisaProfileGateway;
+import cn.axzo.nanopart.visa.server.service.ChangeRecordConfirmService;
+import cn.axzo.nanopart.visa.server.service.ChangeRecordService;
+import cn.axzo.nanopart.visa.server.service.VisaHelper;
+import com.alibaba.fastjson.JSON;
+import com.alibaba.fastjson.JSONObject;
+import com.google.common.collect.Sets;
+import lombok.extern.slf4j.Slf4j;
+import org.apache.commons.lang3.StringUtils;
+import org.apache.groovy.util.Maps;
+import org.springframework.beans.factory.InitializingBean;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Component;
+
+import javax.annotation.Resource;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+
+import static cn.axzo.im.center.api.enums.MqEventType.GROUP_CREATED;
+import static cn.axzo.nanopart.visa.api.constant.VisaConstant.IM_GROUP_BIZ_INFO_INITIATOR_WORKSPACE_ID;
+import static cn.axzo.nanopart.visa.api.constant.VisaConstant.IM_GROUP_BIZ_INFO_VISA_ID;
+import static cn.axzo.nanopart.visa.api.constant.VisaConstant.IM_GROUP_BIZ_INFO_VISA_TYPE;
+import static cn.axzo.nanopart.visa.api.constant.VisaConstant.MSG_CENTER_APP_CODE;
+
+/**
+ * 监听 IM 群创建的广播事件
+ *
+ * @author wangli
+ * @since 2025-02-07 13:53
+ */
+@Slf4j
+@Component
+public class ImGroupsCreatedEventHandler implements EventHandler, InitializingBean {
+ @Autowired
+ private EventConsumer eventConsumer;
+ @Resource
+ private MsgCenterGateway msgCenterGateway;
+ @Resource
+ private RefreshableConfiguration refreshableConfiguration;
+ @Resource
+ private OrganizationalUnitGateway organizationalUnitGateway;
+ @Resource
+ private ChangeRecordService changeRecordService;
+ @Resource
+ private ChangeRecordConfirmService changeRecordConfirmService;
+ @Resource
+ private VisaProfileGateway visaProfileGateway;
+
+ @Override
+ public void onEvent(Event event, EventConsumer.Context context) {
+ if (Objects.isNull(event) || Objects.isNull(event.getEventCode())) {
+ log.warn("illegal event code: {}", JSON.toJSONString(event));
+ return;
+ }
+ log.info("receive create im group event: {}", JSON.toJSONString(event));
+ GroupChangedMessage groupChangedMessage = event.normalizedData(GroupChangedMessage.class);
+ GroupInfo group = groupChangedMessage.getGroup();
+ AssertUtil.notNull(group, "group info is null");
+ try {
+ // 转移到创建群聊立即发送卡片
+ // sendCardAndMsgToImGroup(group);
+ } catch (Exception e) {
+ log.error("send msg to im group error: {}", e.getMessage(), e);
+ throw e;
+ }
+ log.info("receive create im group event, handle success: {}", JSON.toJSONString(event));
+ }
+
+ private void sendCardAndMsgToImGroup(GroupInfo group) {
+ Map bizGroupInfo = group.getBizGroupInfo();
+ HashSet imReceiveAccounts = Sets.newHashSet(String.valueOf(group.getTid()));
+ GroupGetOwnerRequest ownerRequest = new GroupGetOwnerRequest();
+ ownerRequest.setTid(group.getTid());
+ GroupGetOwnerResponse groupOwner = msgCenterGateway.getGroupOwner(ownerRequest);
+ AssertUtil.isTrue(Objects.nonNull(groupOwner) && Objects.nonNull(groupOwner.getOwner()), "im group owner is null");
+ GroupMemberInfo owner = groupOwner.getOwner();
+
+ Long visaId = Long.valueOf(bizGroupInfo.getOrDefault(IM_GROUP_BIZ_INFO_VISA_ID, 0).toString());
+ String visaType = (String) bizGroupInfo.getOrDefault(IM_GROUP_BIZ_INFO_VISA_TYPE, "");
+ Long ownerWorkspaceId = Long.valueOf(bizGroupInfo.getOrDefault(IM_GROUP_BIZ_INFO_INITIATOR_WORKSPACE_ID, 0).toString());
+
+ ChangeRecord visa = changeRecordService.getById(visaId);
+ AssertUtil.notNull(visa, "visa record is null");
+
+ List creators = changeRecordConfirmService.findByCondition(VisaConfirmDto.builder()
+ .visaId(visaId)
+ .bizType(VisaConfirmBizTypeEnum.CREATE)
+ .build());
+ AssertUtil.notEmpty(creators, "visa creator is null");
+
+
+ // 发送卡片
+ CardSendRequest cardRequest = new CardSendRequest();
+ cardRequest.setAppCode(MSG_CENTER_APP_CODE);
+ cardRequest.setTemplateCode(refreshableConfiguration.getImGroupCardTemplateCode());
+ cardRequest.setBizCode(IM_GROUP_BIZ_INFO_VISA_ID + ":" + visaId);
+ cardRequest.setSender(PeerPerson.create(owner.getPersonId(), owner.getPersonOuId(), ownerWorkspaceId));
+ cardRequest.setImSenderAccountAppType(AppTypeEnum.CMP);
+ cardRequest.setImReceiveAccounts(imReceiveAccounts);
+
+ ChangeRecordConfirm creator = creators.get(0);
+ OrganizationalUnitVO unitInfo = organizationalUnitGateway.getUnitInfo(creator.getOuId());
+ PersonProfileDto profile = visaProfileGateway.getProfile(creator.getPersonId());
+
+ cardRequest.setBizParam(new JSONObject(Maps.of(
+ "topic", group.getName(),
+ "reason", visa.getReason(),
+ "initiatorName", profile.getRealName(),
+ "initiatorUnitName", unitInfo.getName(),
+ "visaType", StringUtils.isNotBlank(visaType) ? VisaTypeEnum.valueOf(visaType).getDesc() : "",
+ "amountChange", VisaHelper.buildChangeAmount(visa.getAmountChange())
+ )));
+ msgCenterGateway.sendCardToCroup(cardRequest);
+
+ // 普通群消息
+ SendChatMessageRequest msgRequest = new SendChatMessageRequest();
+ msgRequest.setAsTextMessage(group.getName() + "，请各位审阅");
+ msgRequest.setImReceiveAccounts(imReceiveAccounts);
+ msgRequest.setSender(PersonAccountAttribute.builder()
+ .personId(String.valueOf(owner.getPersonId()))
+ .ouId(owner.getPersonOuId())
+ .workspaceId(ownerWorkspaceId)
+ .appType(AppTypeEnum.CMP)
+ .build());
+ msgRequest.setBizId(IM_GROUP_BIZ_INFO_VISA_ID + ":" + visaId);
+ msgCenterGateway.sendMsgToGroup(msgRequest);
+ }
+
+ @Override
+ public void afterPropertiesSet() {
+ eventConsumer.registerHandler(GROUP_CREATED.getEventCode(), this);
+ }
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/listener/visa/ChangeRecordLogEventHandle.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/listener/visa/ChangeRecordLogEventHandle.java
new file mode 100644
index 00000000..c2a90e2c
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/listener/visa/ChangeRecordLogEventHandle.java
@@ -0,0 +1,35 @@
+package cn.axzo.nanopart.visa.server.mq.listener.visa;
+
+import cn.axzo.framework.rocketmq.Event;
+import cn.axzo.framework.rocketmq.EventConsumer;
+import cn.axzo.framework.rocketmq.EventHandler;
+import cn.axzo.nanopart.visa.api.enums.MQEventEnum;
+import cn.axzo.nanopart.visa.server.mq.producer.VisaChangeLogPayload;
+import cn.axzo.nanopart.visa.server.service.ChangeRecordLogService;
+import lombok.AllArgsConstructor;
+import org.springframework.beans.factory.InitializingBean;
+import org.springframework.stereotype.Component;
+
+/**
+ * 添加处理变洽签日志的逻辑
+ *
+ * @author wangli
+ * @since 2025-02-08 11:18
+ */
+@Component
+@AllArgsConstructor
+public class ChangeRecordLogEventHandle implements EventHandler, InitializingBean {
+ private final EventConsumer eventConsumer;
+ private final ChangeRecordLogService changeRecordLogService;
+
+ @Override
+ public void onEvent(Event event, EventConsumer.Context context) {
+ VisaChangeLogPayload log = event.normalizedData(VisaChangeLogPayload.class);
+ changeRecordLogService.addLog(log.createRecordLogByPayload());
+ }
+
+ @Override
+ public void afterPropertiesSet() {
+ eventConsumer.registerHandler(MQEventEnum.VISA_CHANGE_LOG.getEventCode(), this);
+ }
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/listener/workflow/BasicLogSupport.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/listener/workflow/BasicLogSupport.java
new file mode 100644
index 00000000..16af4be1
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/listener/workflow/BasicLogSupport.java
@@ -0,0 +1,53 @@
+package cn.axzo.nanopart.visa.server.mq.listener.workflow;
+
+import cn.axzo.framework.rocketmq.EventProducer;
+import cn.axzo.maokai.api.vo.request.OrgNodeUserBriefInfoListReq;
+import cn.axzo.maokai.api.vo.response.OrgNodeUserBriefInfoResp;
+import cn.axzo.nanopart.visa.server.rpc.VisaOrganizationalNodeUserGateway;
+import cn.axzo.workflow.common.model.request.bpmn.task.BpmnTaskDelegateAssigner;
+import com.google.common.collect.Lists;
+import org.springframework.util.CollectionUtils;
+
+import java.util.List;
+import java.util.Objects;
+
+/**
+ * @author wangli
+ * @since 2025-01-20 10:18
+ */
+public abstract class BasicLogSupport {
+ protected final EventProducer eventProducer;
+ protected final VisaOrganizationalNodeUserGateway visaOrganizationalNodeUserGateway;
+
+ protected BasicLogSupport(EventProducer eventProducer, VisaOrganizationalNodeUserGateway visaOrganizationalNodeUserGateway) {
+ this.eventProducer = eventProducer;
+ this.visaOrganizationalNodeUserGateway = visaOrganizationalNodeUserGateway;
+ }
+
+ protected String buildLogUserInfo(BpmnTaskDelegateAssigner assigner) {
+ OrgNodeUserBriefInfoResp oneUserInfo = getOneUserInfo(assigner);
+ return buildLogUserInfo(oneUserInfo);
+ }
+ protected String buildLogUserInfo(OrgNodeUserBriefInfoResp user) {
+ String userInfo = "";
+ if (Objects.nonNull(user)) {
+ userInfo = user.getRealName() + "（" + user.getJob().getName() + "-" + user.getOrganizationalUnitName() + "）";
+ }
+ return userInfo;
+ }
+
+ protected OrgNodeUserBriefInfoResp getOneUserInfo(BpmnTaskDelegateAssigner assigner) {
+ if (Objects.isNull(assigner)) {
+ return null;
+ }
+ List users = visaOrganizationalNodeUserGateway.listOrgNodeUsers(OrgNodeUserBriefInfoListReq.builder()
+ .workspaceId(Long.valueOf(assigner.getTenantId()))
+ .ouId(Long.valueOf(assigner.getOuId()))
+ .personIds(Lists.newArrayList(Long.valueOf(assigner.getPersonId())))
+ .needUnit(true)
+ .needJob(true)
+ .build());
+ return CollectionUtils.isEmpty(users) ? null : users.get(0);
+ }
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/listener/workflow/process/ProcessInstanceAllEventHandler.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/listener/workflow/process/ProcessInstanceAllEventHandler.java
new file mode 100644
index 00000000..e0671c21
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/listener/workflow/process/ProcessInstanceAllEventHandler.java
@@ -0,0 +1,200 @@
+package cn.axzo.nanopart.visa.server.mq.listener.workflow.process;
+
+import cn.axzo.framework.rocketmq.Event;
+import cn.axzo.framework.rocketmq.EventConsumer;
+import cn.axzo.framework.rocketmq.EventProducer;
+import cn.axzo.nanopart.visa.api.enums.VisaStatusEnum;
+import cn.axzo.nanopart.visa.api.enums.VisaTypeEnum;
+import cn.axzo.nanopart.visa.api.request.ChangeStatusRequest;
+import cn.axzo.nanopart.visa.server.domain.ChangeRecord;
+import cn.axzo.nanopart.visa.server.domain.ChangeRecordLog;
+import cn.axzo.nanopart.visa.server.domain.ChangeRecordRelation;
+import cn.axzo.nanopart.visa.server.mq.listener.workflow.BasicLogSupport;
+import cn.axzo.nanopart.visa.server.mq.producer.VisaChangeLogPayload;
+import cn.axzo.nanopart.visa.server.rpc.VisaOrganizationalNodeUserGateway;
+import cn.axzo.nanopart.visa.server.service.ChangeRecordBillService;
+import cn.axzo.nanopart.visa.server.service.ChangeRecordRelationService;
+import cn.axzo.nanopart.visa.server.service.ChangeRecordService;
+import cn.axzo.workflow.common.enums.BpmnProcessInstanceResultEnum;
+import cn.axzo.workflow.common.model.request.bpmn.task.BpmnTaskDelegateAssigner;
+import cn.axzo.workflow.common.model.response.mq.ProcessInstanceDTO;
+import cn.axzo.workflow.starter.handler.ProcessInstanceEventHandler;
+import com.google.common.collect.Lists;
+import org.springframework.stereotype.Component;
+import org.springframework.util.StringUtils;
+
+import java.util.Date;
+import java.util.List;
+import java.util.Objects;
+
+import static cn.axzo.nanopart.visa.api.constant.VisaConstant.WORKFLOW_VAR_VISA_TYPE_KEY;
+import static cn.axzo.nanopart.visa.api.enums.VisaLogTypeEnum.REJECT_APPROVE;
+import static cn.axzo.nanopart.visa.api.enums.VisaLogTypeEnum.REVERT_APPROVE;
+import static cn.axzo.nanopart.visa.api.enums.VisaRelationFieldEnum.PROCESS_INSTANCE_OF_VISA;
+import static cn.axzo.nanopart.visa.api.enums.VisaTypeEnum.DESIGN_CHANGE;
+import static cn.axzo.nanopart.visa.api.enums.VisaTypeEnum.PROJECT_VISA;
+import static cn.axzo.nanopart.visa.api.enums.VisaTypeEnum.TECHNOLOGY_APPROVED;
+
+/**
+ * 工作流广播的实例维度的所有事件类型
+ *
+ * @author wangli
+ * @since 2025-01-17 11:35
+ */
+@Component
+public class ProcessInstanceAllEventHandler extends BasicLogSupport implements ProcessInstanceEventHandler {
+ protected final ChangeRecordService changeRecordService;
+ protected final ChangeRecordRelationService changeRecordRelationService;
+ protected final ChangeRecordBillService changeRecordBillService;
+ public static List SUPPORTED_DEFINITION_KEYS = Lists.newArrayList(
+ DESIGN_CHANGE.getProcessDefinitionKey(),
+ TECHNOLOGY_APPROVED.getProcessDefinitionKey(),
+ PROJECT_VISA.getProcessDefinitionKey()
+ );
+
+ public ProcessInstanceAllEventHandler(EventProducer eventProducer,
+ VisaOrganizationalNodeUserGateway visaOrganizationalNodeUserGateway,
+ ChangeRecordService changeRecordService,
+ ChangeRecordRelationService changeRecordRelationService,
+ ChangeRecordBillService changeRecordBillService) {
+ super(eventProducer, visaOrganizationalNodeUserGateway);
+ this.changeRecordService = changeRecordService;
+ this.changeRecordRelationService = changeRecordRelationService;
+ this.changeRecordBillService = changeRecordBillService;
+ }
+
+ @Override
+ public int getOrder() {
+ return Integer.MIN_VALUE;
+ }
+
+ @Override
+ public boolean accept(ProcessInstanceDTO dto, Event event, EventConsumer.Context context) {
+ return SUPPORTED_DEFINITION_KEYS.contains(dto.getProcessDefinitionKey());
+ }
+
+ @Override
+ public void onCreated(ProcessInstanceDTO dto) {
+ ProcessInstanceEventHandler.super.onCreated(dto);
+ }
+
+ private String parseVisaType(ProcessInstanceDTO dto) {
+ String visaType = (String) dto.getVariables().getOrDefault(WORKFLOW_VAR_VISA_TYPE_KEY, "");
+ return StringUtils.hasText(visaType) ? VisaTypeEnum.valueOf(visaType).getDesc() : "";
+ }
+
+ @Override
+ public void onCompleted(ProcessInstanceDTO dto) {
+ String visaTypeDesc = parseVisaType(dto);
+
+ updateChangeRecordApprovalStatus(dto, BpmnProcessInstanceResultEnum.APPROVED);
+ }
+
+ /**
+ * 流程撤回
+ *
+ * @param dto
+ */
+ @Override
+ public void onCancelled(ProcessInstanceDTO dto) {
+ BpmnTaskDelegateAssigner initiator = dto.getInitiator();
+ String visaTypeDesc = parseVisaType(dto);
+
+ ChangeRecordLog log = ChangeRecordLog.builder()
+ .visaId(Long.valueOf(dto.getBusinessKey()))
+ .action(dto.getType().getTag())
+ .title(String.format(REVERT_APPROVE.getTitle(), visaTypeDesc))
+ .content(String.format(REVERT_APPROVE.getContent(), buildLogUserInfo(initiator)))
+ .build();
+ eventProducer.send(VisaChangeLogPayload.form(log));
+
+ updateChangeRecordApprovalStatus(dto, BpmnProcessInstanceResultEnum.CANCELLED);
+ }
+
+ /**
+ * 流程驳回
+ *
+ * @param dto
+ */
+ @Override
+ public void onRejected(ProcessInstanceDTO dto) {
+ BpmnTaskDelegateAssigner lastOperationAssigner = dto.getLastOperationAssigner();
+ ChangeRecordLog log = ChangeRecordLog.builder()
+ .visaId(Long.valueOf(dto.getBusinessKey()))
+ .action(dto.getType().getTag())
+ .title(String.format(REJECT_APPROVE.getTitle(), lastOperationAssigner.getAssignerName()))
+ .content(String.format(REJECT_APPROVE.getContent(), buildLogUserInfo(lastOperationAssigner), dto.getReason()))
+ .build();
+ eventProducer.send(VisaChangeLogPayload.form(log));
+
+ updateChangeRecordApprovalStatus(dto, BpmnProcessInstanceResultEnum.REJECTED);
+ }
+
+ @Override
+ public void onAborted(ProcessInstanceDTO dto) {
+ ProcessInstanceEventHandler.super.onAborted(dto);
+
+ updateChangeRecordApprovalStatus(dto, BpmnProcessInstanceResultEnum.ABORTED);
+ }
+
+ private void updateChangeRecordApprovalStatus(ProcessInstanceDTO dto, BpmnProcessInstanceResultEnum resultEnum) {
+ // 更新主表审批状态信息
+ Long visaId = Long.valueOf(dto.getBusinessKey());
+ changeRecordService.lambdaQuery()
+ .eq(ChangeRecord::getId, visaId)
+ .eq(ChangeRecord::getApprovalId, dto.getProcessInstanceId())
+ .eq(ChangeRecord::getIsDelete, 0)
+ .oneOpt()
+ .ifPresent(changeRecord -> {
+ if (Objects.equals(resultEnum, BpmnProcessInstanceResultEnum.APPROVED)) {
+ changeRecord.setApprovalStatus(resultEnum.getStatus());
+ changeRecord.setApprovalCompleteTime(new Date());
+ } else {
+ changeRecord.setApprovalId("");
+ changeRecord.setApprovalStatus("");
+ changeRecord.setApprovalCompleteTime(null);
+ }
+ changeRecordService.updateById(changeRecord);
+ });
+
+ // 更新关联表审批信息
+ changeRecordRelationService.lambdaQuery()
+ .eq(ChangeRecordRelation::getVisaId, visaId)
+ .eq(ChangeRecordRelation::getVarName, PROCESS_INSTANCE_OF_VISA.name())
+ .eq(ChangeRecordRelation::getContent, dto.getProcessInstanceId())
+ .oneOpt()
+ .ifPresent(changeRecordRelation -> {
+ changeRecordRelation.setContentExt(resultEnum.getStatus());
+ changeRecordRelationService.updateById(changeRecordRelation);
+ });
+
+ ChangeRecord visa = changeRecordService.getById(visaId);
+ BpmnTaskDelegateAssigner lastOperationAssigner = dto.getLastOperationAssigner();
+ if (Objects.equals(resultEnum, BpmnProcessInstanceResultEnum.APPROVED)) {
+ changeRecordService.changeStatus(ChangeStatusRequest.builder()
+ .visaId(visaId)
+ .personId(Long.valueOf(lastOperationAssigner.getPersonId()))
+ .ouId(Long.valueOf(lastOperationAssigner.getOuId()))
+ .workspaceId(Long.valueOf(lastOperationAssigner.getTenantId()))
+ .updateStatus(VisaStatusEnum.COMPLETED)
+ .editFormFlag(false)
+ .build());
+ return;
+ }
+ // 回退到待提报或决策中
+ changeRecordService.changeStatus(ChangeStatusRequest.builder()
+ .visaId(visaId)
+ .personId(Long.valueOf(lastOperationAssigner.getPersonId()))
+ .ouId(Long.valueOf(lastOperationAssigner.getOuId()))
+ .workspaceId(Long.valueOf(lastOperationAssigner.getTenantId()))
+ .updateStatus(Objects.isNull(visa.getImGroupId()) ? VisaStatusEnum.REPORT_FROM_APPROVE : VisaStatusEnum.DECIDING_FROM_APPROVE)
+ .editFormFlag(false)
+ .build());
+
+ // 取消当前主单据关联的其他单据的关联状态
+ changeRecordBillService.billRelationStatus(visaId, false);
+ // 取消图纸绑定关系
+ changeRecordService.syncDrawAnnotationUnBindRelation(visaId);
+
+ }
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/listener/workflow/task/ProcessTaskAllEventHandler.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/listener/workflow/task/ProcessTaskAllEventHandler.java
new file mode 100644
index 00000000..821e7416
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/listener/workflow/task/ProcessTaskAllEventHandler.java
@@ -0,0 +1,94 @@
+package cn.axzo.nanopart.visa.server.mq.listener.workflow.task;
+
+import cn.axzo.framework.rocketmq.Event;
+import cn.axzo.framework.rocketmq.EventConsumer;
+import cn.axzo.framework.rocketmq.EventProducer;
+import cn.axzo.maokai.api.vo.response.OrgNodeUserBriefInfoResp;
+import cn.axzo.nanopart.visa.server.domain.ChangeRecordLog;
+import cn.axzo.nanopart.visa.server.mq.listener.workflow.BasicLogSupport;
+import cn.axzo.nanopart.visa.server.mq.producer.VisaChangeLogPayload;
+import cn.axzo.nanopart.visa.server.rpc.VisaOrganizationalNodeUserGateway;
+import cn.axzo.workflow.common.model.response.mq.ProcessTaskDTO;
+import cn.axzo.workflow.starter.handler.ProcessTaskEventHandler;
+import org.springframework.stereotype.Component;
+
+import java.util.Objects;
+
+import static cn.axzo.nanopart.visa.api.enums.VisaLogTypeEnum.APPROVED_AGRESS;
+import static cn.axzo.nanopart.visa.api.enums.VisaLogTypeEnum.TRANSMIT_APPROVE;
+import static cn.axzo.nanopart.visa.server.mq.listener.workflow.process.ProcessInstanceAllEventHandler.SUPPORTED_DEFINITION_KEYS;
+
+/**
+ * 工作流广播的任务维度的所有事件类型
+ *
+ * @author wangli
+ * @since 2025-01-17 11:34
+ */
+@Component
+public class ProcessTaskAllEventHandler extends BasicLogSupport implements ProcessTaskEventHandler {
+
+ public ProcessTaskAllEventHandler(EventProducer eventProducer, VisaOrganizationalNodeUserGateway visaOrganizationalNodeUserGateway) {
+ super(eventProducer, visaOrganizationalNodeUserGateway);
+ }
+
+ @Override
+ public int getOrder() {
+ return Integer.MAX_VALUE;
+ }
+
+ @Override
+ public boolean accept(ProcessTaskDTO dto, Event event, EventConsumer.Context context) {
+ return SUPPORTED_DEFINITION_KEYS.contains(dto.getProcessDefinitionKey());
+ }
+
+ @Override
+ public void onAssigned(ProcessTaskDTO dto) {
+ ProcessTaskEventHandler.super.onAssigned(dto);
+ }
+
+ @Override
+ public void onCreated(ProcessTaskDTO dto) {
+ ProcessTaskEventHandler.super.onCreated(dto);
+ }
+
+ /**
+ * 任务通过
+ *
+ * @param dto
+ */
+ @Override
+ public void onCompleted(ProcessTaskDTO dto) {
+ if (Objects.nonNull(dto.getApprover())
+ && Objects.equals(dto.getInitiator().getPersonId(), dto.getApprover().getPersonId())) {
+ return;
+ }
+ OrgNodeUserBriefInfoResp user = getOneUserInfo(dto.getApprover());
+
+ ChangeRecordLog log = ChangeRecordLog.builder()
+ .visaId(Long.valueOf(dto.getBusinessKey()))
+ .action(dto.getType().getTag())
+ .title(String.format(APPROVED_AGRESS.getTitle(), Objects.isNull(user) ? "" : user.getRealName()))
+ .content(String.format(APPROVED_AGRESS.getContent(), Objects.isNull(user) ? "系统自动通过" : buildLogUserInfo(user)))
+ .build();
+ eventProducer.send(VisaChangeLogPayload.form(log));
+ }
+
+ @Override
+ public void onDeleted(ProcessTaskDTO dto) {
+ ProcessTaskEventHandler.super.onDeleted(dto);
+ }
+
+ @Override
+ public void onTransfer(ProcessTaskDTO dto) {
+ ChangeRecordLog log = ChangeRecordLog.builder()
+ .visaId(Long.valueOf(dto.getBusinessKey()))
+ .action(dto.getType().getTag())
+ .title(String.format(TRANSMIT_APPROVE.getTitle()))
+ .content(String.format(TRANSMIT_APPROVE.getContent(),
+ buildLogUserInfo(dto.getApprover()),
+ buildLogUserInfo(dto.getTransferTargetApprover()),
+ dto.getAdvice()))
+ .build();
+ eventProducer.send(VisaChangeLogPayload.form(log));
+ }
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/producer/VisaChangeLogPayload.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/producer/VisaChangeLogPayload.java
new file mode 100644
index 00000000..275f7327
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/producer/VisaChangeLogPayload.java
@@ -0,0 +1,63 @@
+package cn.axzo.nanopart.visa.server.mq.producer;
+
+import cn.axzo.framework.rocketmq.Event;
+import cn.axzo.nanopart.visa.api.enums.MQEventEnum;
+import cn.axzo.nanopart.visa.server.domain.ChangeRecordLog;
+import cn.axzo.nanopart.visa.server.utils.Constants;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+
+import java.io.Serializable;
+import java.util.Date;
+
+/**
+ * 变洽签单据日志 MQ Payload
+ *
+ * @author wangli
+ * @since 2025-01-17 16:34
+ */
+@Slf4j
+@NoArgsConstructor
+@AllArgsConstructor
+@Data
+@Builder
+public class VisaChangeLogPayload implements Serializable {
+ private Long visaId;
+ private String action;
+ private String title;
+ private String content;
+ private Date operateTime;
+ private Long personId;
+ private Integer orderBy;
+
+ public static Event form(ChangeRecordLog log) {
+ VisaChangeLogPayload payload = VisaChangeLogPayload.builder()
+ .visaId(log.getVisaId())
+ .action(log.getAction())
+ .title(log.getTitle())
+ .content(log.getContent())
+ .personId(log.getCreateBy())
+ .orderBy(Constants.APPROVE_ORDER_BY)
+ .build();
+ return Event.builder()
+ .eventCode(MQEventEnum.VISA_CHANGE_LOG.getEventCode())
+ .shardingKey(String.valueOf(payload.getVisaId()))
+ .targetId(String.valueOf(payload.getVisaId()))
+ .targetType(log.getAction())
+ .data(payload)
+ .build();
+ }
+
+ public ChangeRecordLog createRecordLogByPayload() {
+ return ChangeRecordLog.builder()
+ .visaId(this.getVisaId())
+ .action(this.getAction())
+ .title(this.getTitle())
+ .content(this.getContent())
+ .orderBy(this.getOrderBy())
+ .build();
+ }
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/producer/VisaChangeLogProducer.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/producer/VisaChangeLogProducer.java
new file mode 100644
index 00000000..438f1961
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/mq/producer/VisaChangeLogProducer.java
@@ -0,0 +1,15 @@
+package cn.axzo.nanopart.visa.server.mq.producer;
+
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+
+/**
+ * 变洽签单据日志 MQ 生产者
+ *
+ * @author wangli
+ * @since 2025-01-17 16:33
+ */
+@Component
+@Slf4j
+public class VisaChangeLogProducer {
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/ApolloConstructionAreaGateway.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/ApolloConstructionAreaGateway.java
new file mode 100644
index 00000000..912dc186
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/ApolloConstructionAreaGateway.java
@@ -0,0 +1,74 @@
+package cn.axzo.nanopart.visa.server.rpc;
+
+import cn.axzo.apollo.api.ApolloConstructionAreaApi;
+import cn.axzo.apollo.api.res.ConstructionAreaInfo;
+import cn.axzo.apollo.core.web.Result;
+import com.alibaba.fastjson.JSON;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.apache.commons.collections.CollectionUtils;
+import org.apache.commons.compress.utils.Lists;
+import org.springframework.stereotype.Service;
+
+import java.util.List;
+
+/**
+ * @author xudawei@axzo.cn
+ * @date 2025/01/20
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class ApolloConstructionAreaGateway {
+
+ private final ApolloConstructionAreaApi apolloConstructionAreaApi;
+
+ public List getAllConstructionAreaByIds(List areaIds) {
+ try {
+ if (CollectionUtils.isEmpty(areaIds)) {
+ return Lists.newArrayList();
+ }
+ log.info("ApolloConstructionAreaGateway getAllConstructionAreaByIds,params:{}", JSON.toJSONString(areaIds));
+ Result> result = apolloConstructionAreaApi.getAllConstructionAreaByIds(areaIds);
+ log.info("ApolloConstructionAreaGateway getAllConstructionAreaByIds,result:{}", JSON.toJSONString(result));
+ return result.getData();
+ } catch (Exception e) {
+ log.warn("ApolloConstructionAreaGateway getAllConstructionAreaByIds exception", e);
+ throw e;
+ }
+
+ }
+
+ public List getConstructionAreaByIds(List areaIds) {
+ try {
+ if (CollectionUtils.isEmpty(areaIds)) {
+ return Lists.newArrayList();
+ }
+ log.info("ApolloConstructionAreaGateway getConstructionAreaByIds,params:{}", JSON.toJSONString(areaIds));
+ Result> result = apolloConstructionAreaApi.getConstructionAreaByIds(areaIds);
+ log.info("ApolloConstructionAreaGateway getAllConstructionAreaByIds,result:{}", JSON.toJSONString(result));
+ return result.getData();
+ } catch (Exception e) {
+ log.warn("ApolloConstructionAreaGateway getConstructionAreaByIds exception", e);
+ throw e;
+ }
+
+ }
+
+ public String generateAreaFullNameByAreaIds(List areaIds) {
+ try {
+ if (CollectionUtils.isEmpty(areaIds)) {
+ return "";
+ }
+ log.info("ApolloConstructionAreaGateway generateAreaFullNameByAreaIds,params:{}", JSON.toJSONString(areaIds));
+ Result result = apolloConstructionAreaApi.generateAreaFullNameByAreaIds(areaIds);
+ log.info("ApolloConstructionAreaGateway generateAreaFullNameByAreaIds,result:{}", JSON.toJSONString(result));
+ return result.getData();
+ } catch (Exception e) {
+ log.warn("ApolloConstructionAreaGateway generateAreaFullNameByAreaIds exception", e);
+ throw e;
+ }
+
+ }
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/ApolloTaskOrderApiGateway.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/ApolloTaskOrderApiGateway.java
new file mode 100644
index 00000000..29916873
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/ApolloTaskOrderApiGateway.java
@@ -0,0 +1,28 @@
+package cn.axzo.nanopart.visa.server.rpc;
+
+import cn.axzo.apollo.api.ApolloTaskOrderApi;
+import cn.axzo.apollo.api.req.QueryOrderToBasicReq;
+import cn.axzo.apollo.api.res.TaskOrderToBasicRes;
+import cn.axzo.apollo.core.domain.PageResult;
+import cn.axzo.nanopart.visa.server.utils.RpcUtil;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+/**
+ * @author chenwenjian
+ * @version 1.0
+ * @date 2025/2/12 11:18
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class ApolloTaskOrderApiGateway {
+
+ private final ApolloTaskOrderApi apolloTaskOrderApi;
+
+ public PageResult pageOrderByForBasic(QueryOrderToBasicReq req) {
+ return RpcUtil.rpcResultProcessor(() -> apolloTaskOrderApi.pageOrderByForBasic(req),
+ "Page query task orders", req);
+ }
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/DataObjectApiGateway.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/DataObjectApiGateway.java
new file mode 100644
index 00000000..a691f4ff
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/DataObjectApiGateway.java
@@ -0,0 +1,42 @@
+package cn.axzo.nanopart.visa.server.rpc;
+
+import cn.axzo.foundation.result.ApiResult;
+import cn.axzo.karma.client.feign.tyr.DataObjectApi;
+import cn.axzo.karma.client.feign.tyr.request.MatchDataObjectReq;
+import cn.axzo.karma.client.feign.tyr.response.MatchDataObjectResp;
+import cn.axzo.karma.client.feign.tyr.response.MergeMatchDataResp;
+import com.alibaba.fastjson.JSON;
+import com.google.common.collect.Lists;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+import java.util.Objects;
+
+/**
+ * @author xudawei@axzo.cn
+ * @date 2025/02/05
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class DataObjectApiGateway {
+
+ private final DataObjectApi dataObjectApi;
+
+ public MatchDataObjectResp match(MatchDataObjectReq req) {
+ if (Objects.isNull(req)) {
+ return MatchDataObjectResp.builder().build();
+ }
+ try {
+ log.info("DataObjectApiGateway match, params:{}", JSON.toJSONString(req));
+ ApiResult match = dataObjectApi.match(req);
+ log.info("DataObjectApiGateway match, result:{}", JSON.toJSONString(match));
+ return match.getData();
+ } catch (Exception e) {
+ log.warn("DataObjectApiGateway match exception", e);
+ throw e;
+ }
+ }
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/DrawingAnnotationApiGateway.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/DrawingAnnotationApiGateway.java
new file mode 100644
index 00000000..b7b5e19c
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/DrawingAnnotationApiGateway.java
@@ -0,0 +1,45 @@
+package cn.axzo.nanopart.visa.server.rpc;
+
+import cn.axzo.nanopart.visa.server.utils.RpcUtil;
+import cn.axzo.thor.client.enums.DrawingAnnotationBizEnum;
+import cn.axzo.thor.client.feign.DrawingAnnotationApi;
+import cn.axzo.thor.client.model.BindDrawingAnnotationDTO;
+import cn.axzo.thor.client.model.UnbindDrawingAnnotationDTO;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+import java.util.Set;
+
+/**
+ * @author chenwenjian
+ * @version 1.0
+ * @date 2025/2/19 20:09
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class DrawingAnnotationApiGateway {
+
+ private final DrawingAnnotationApi drawingAnnotationApi;
+
+ public void bindBusiness(Long visasId, Set annotationIds) {
+ BindDrawingAnnotationDTO bindDrawingAnnotationDTO = BindDrawingAnnotationDTO.builder()
+ .drawingAnnotationIds(annotationIds)
+ .businessType(DrawingAnnotationBizEnum.VISA_CHANGE)
+ .businessId(String.valueOf(visasId))
+ .build();
+ RpcUtil.rpcCommonProcessor(()->drawingAnnotationApi.bindBusiness(bindDrawingAnnotationDTO),
+ "sync visa and drawing annotation bind relation to thor", bindDrawingAnnotationDTO);
+ }
+
+ public void unbindBusiness(Long visasId, Set annotationIds) {
+ UnbindDrawingAnnotationDTO unbindDrawingAnnotationDTO = UnbindDrawingAnnotationDTO.builder()
+ .drawingAnnotationIds(annotationIds)
+ .businessType(DrawingAnnotationBizEnum.VISA_CHANGE)
+ .businessId(String.valueOf(visasId))
+ .build();
+ RpcUtil.rpcCommonProcessor(()->drawingAnnotationApi.unbindBusiness(unbindDrawingAnnotationDTO),
+ "sync visa and drawing annotation unbind relation to thor", unbindDrawingAnnotationDTO);
+ }
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/DrawingMajorGateway.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/DrawingMajorGateway.java
new file mode 100644
index 00000000..2bc46dc7
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/DrawingMajorGateway.java
@@ -0,0 +1,37 @@
+package cn.axzo.nanopart.visa.server.rpc;
+
+import cn.axzo.pokonyan.util.RpcUtil;
+import cn.axzo.thor.client.feign.DrawingMajorApi;
+import cn.axzo.thor.client.model.DrawingMajorResp;
+import cn.axzo.thor.client.model.ListDrawingMajorReq;
+import cn.azxo.framework.common.logger.MethodAroundLog;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+import java.util.List;
+import java.util.Set;
+
+/**
+ * @author xudawei@axzo.cn
+ * @date 2025/01/20
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class DrawingMajorGateway {
+
+ private final DrawingMajorApi drawingMajorApi;
+ /**
+ * 获取专业
+ */
+ @MethodAroundLog(target = "thor", source = "nanopart", value = "获取专业")
+ public List list(Long projectId, Set majorCodes, Boolean includeDrawingType) {
+ ListDrawingMajorReq req = new ListDrawingMajorReq();
+ req.setProjectId(projectId);
+ req.setMajorCodes(majorCodes);
+ req.setIncludeDrawingType(includeDrawingType);
+ return RpcUtil.rpcCommonProcessor(() -> drawingMajorApi.list(req), "drawingMajorApi#list", req);
+ }
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/LogApiGateway.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/LogApiGateway.java
new file mode 100644
index 00000000..3352f965
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/LogApiGateway.java
@@ -0,0 +1,50 @@
+package cn.axzo.nanopart.visa.server.rpc;
+
+/**
+ * @author xudawei@axzo.cn
+ * @date 2025/2/12
+ * @description 日志RPC
+ */
+
+import cn.axzo.log.platform.client.feign.LogApi;
+import cn.axzo.log.platform.client.model.req.LogAddReq;
+import cn.azxo.framework.common.model.CommonResponse;
+import cn.hutool.json.JSONUtil;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+import java.util.List;
+
+/**
+ * 日志RPC
+ * @author xudawei@axzo.cn
+ * @since 2025-02-05 15:08
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class LogApiGateway {
+
+ private final LogApi logApi;
+
+ public void addLog(LogAddReq req) {
+ try {
+ log.info("LogApiGateway-addLog, req: {}", JSONUtil.toJsonStr(req));
+ CommonResponse stringCommonResponse = logApi.addLog(req);
+ log.info("LogApiGateway-addLog, result: {}", JSONUtil.toJsonStr(stringCommonResponse));
+ } catch (Exception e) {
+ log.warn("LogApiGateway-addLog Exception", e);
+ }
+ }
+
+ public void addLog(String scene, String level, List tags, String msg) {
+ logApi.addLog(LogAddReq.builder()
+ .scene(scene)
+ .level(level)
+ .tags(tags)
+ .message(msg)
+ .build());
+ }
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/MsgCenterGateway.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/MsgCenterGateway.java
new file mode 100644
index 00000000..081af854
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/MsgCenterGateway.java
@@ -0,0 +1,101 @@
+package cn.axzo.nanopart.visa.server.rpc;
+
+import cn.axzo.basics.common.util.AssertUtil;
+import cn.axzo.framework.domain.web.result.ApiResult;
+import cn.axzo.im.center.api.feign.GroupApi;
+import cn.axzo.im.center.api.feign.MessageApi;
+import cn.axzo.im.center.api.vo.req.GroupCreateRequest;
+import cn.axzo.im.center.api.vo.req.GroupDismissRequest;
+import cn.axzo.im.center.api.vo.req.GroupGetMembersRequest;
+import cn.axzo.im.center.api.vo.req.GroupGetOwnerRequest;
+import cn.axzo.im.center.api.vo.req.SendChatMessageRequest;
+import cn.axzo.im.center.api.vo.resp.GroupCreateResponse;
+import cn.axzo.im.center.api.vo.resp.GroupGetMembersResponse;
+import cn.axzo.im.center.api.vo.resp.GroupGetOwnerResponse;
+import cn.axzo.msg.center.service.pending.card.CardClient;
+import cn.axzo.msg.center.service.pending.request.CardSendRequest;
+import cn.axzo.msg.center.service.pending.request.CardUpdateStateRequest;
+import cn.axzo.msg.center.service.pending.response.CardSendResponse;
+import cn.azxo.framework.common.logger.MethodAroundLog;
+import cn.azxo.framework.common.model.CommonResponse;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+import java.util.Objects;
+
+/**
+ * Message / IM 防腐层
+ *
+ * @author wangli
+ * @since 2025-02-05 15:08
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class MsgCenterGateway {
+
+ private final GroupApi groupApi;
+ private final MessageApi messageApi;
+ private final CardClient cardClient;
+
+ @MethodAroundLog(target = "imCenter", source = "nanopart", value = "创建 IM 群聊")
+ public GroupCreateResponse createImGroup(GroupCreateRequest request) {
+ ApiResult group = groupApi.createGroup(request);
+ if(group.isSuccess() && Objects.nonNull(group.getData())) {
+ return group.getData();
+ }
+ AssertUtil.isTrue(group.isSuccess(), group.getMsg());
+ return null;
+ }
+
+ @MethodAroundLog(target = "imCenter", source = "nanopart", value = "解散 IM 群聊")
+ public void dismissImGroup(GroupDismissRequest request) {
+ groupApi.dismissGroup(request);
+ }
+
+ @MethodAroundLog(target = "imCenter", source = "nanopart", value = "获取指定 IM 群成员信息")
+ public GroupGetMembersResponse getMembers(GroupGetMembersRequest request) {
+ ApiResult members = groupApi.getMembers(request);
+ if(members.isSuccess() && Objects.nonNull(members.getData())) {
+ return members.getData();
+ }
+ AssertUtil.isTrue(members.isSuccess(), members.getMsg());
+ return null;
+ }
+
+ @MethodAroundLog(target = "imCenter", source = "nanopart", value = "获取指定 IM 群群主信息")
+ public GroupGetOwnerResponse getGroupOwner(GroupGetOwnerRequest request) {
+ ApiResult owner = groupApi.getOwner(request);
+ if(owner.isSuccess() && Objects.nonNull(owner.getData())) {
+ return owner.getData();
+ }
+ AssertUtil.isTrue(owner.isSuccess(), owner.getMsg());
+ return null;
+ }
+
+ @MethodAroundLog(target = "imCenter", source = "nanopart", value = "发送普通消息到群消息")
+ public Long sendMsgToGroup(SendChatMessageRequest request) {
+ ApiResult mesageId = messageApi.sendChatMessage(request);
+ if(mesageId.isSuccess() && Objects.nonNull(mesageId.getData())) {
+ return mesageId.getData();
+ }
+ AssertUtil.isTrue(mesageId.isSuccess(), mesageId.getMsg());
+ return null;
+ }
+
+ @MethodAroundLog(target = "imCenter", source = "nanopart", value = "发送卡片消息到群消息")
+ public CardSendResponse sendCardToCroup(CardSendRequest request) {
+ CommonResponse sendCard = cardClient.send(request);
+ if (Objects.nonNull(sendCard) && sendCard.getCode() == 200) {
+ return sendCard.getData();
+ }
+ AssertUtil.isTrue(sendCard.getCode() == 200, sendCard.getMsg());
+ return null;
+ }
+
+ @MethodAroundLog(target = "imCenter", source = "nanopart", value = "更新 IM 群内卡片状态")
+ public void updateCardState(CardUpdateStateRequest request) {
+ cardClient.updateState(request);
+ }
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/OrganizationalUnitGateway.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/OrganizationalUnitGateway.java
new file mode 100644
index 00000000..46203d30
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/OrganizationalUnitGateway.java
@@ -0,0 +1,58 @@
+package cn.axzo.nanopart.visa.server.rpc;
+
+import cn.axzo.basics.common.util.AssertUtil;
+import cn.axzo.framework.domain.web.result.ApiResult;
+import cn.axzo.maokai.api.client.OrganizationalUnitApi;
+import cn.axzo.maokai.api.vo.request.OrganizationalUnitQuery;
+import cn.axzo.maokai.api.vo.response.OrganizationalUnitVO;
+import cn.azxo.framework.common.logger.MethodAroundLog;
+import com.alibaba.fastjson.JSON;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.apache.commons.compress.utils.Lists;
+import org.springframework.stereotype.Service;
+
+import java.util.List;
+import java.util.Objects;
+
+/**
+ * @author xudawei
+ * @date 2025/01/21
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class OrganizationalUnitGateway {
+
+ private final OrganizationalUnitApi organizationalUnitApi;
+
+ @MethodAroundLog(target = "maokai", source = "nanopart", value = "获取单位信息")
+ public OrganizationalUnitVO getUnitInfo(Long unitId) {
+ ApiResult unitResponse = organizationalUnitApi.getById(unitId);
+ if (unitResponse.isSuccess() && Objects.nonNull(unitResponse.getData())) {
+ return unitResponse.getData();
+ }
+ AssertUtil.isTrue(unitResponse.isSuccess(), unitResponse.getMsg());
+ return null;
+ }
+ /**
+ * 获取单位集合
+ */
+ @MethodAroundLog(target = "maokai", source = "nanopart", value = "获取单位集合")
+ public List list(OrganizationalUnitQuery query) {
+ if (Objects.isNull(query)) {
+ return Lists.newArrayList();
+ }
+ try {
+ log.info("OrganizationalUnitGateway list, params:{}", JSON.toJSONString(query));
+ ApiResult> list = organizationalUnitApi.list(query);
+ log.info("OrganizationalUnitGateway list, result:{}", JSON.toJSONString(list));
+ List data = list.getData();
+ return data;
+ } catch (Exception e) {
+ log.warn("OrganizationalUnitGateway list exception", e);
+ throw e;
+ }
+ }
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/RectifyApiGateway.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/RectifyApiGateway.java
new file mode 100644
index 00000000..e2753bb3
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/RectifyApiGateway.java
@@ -0,0 +1,29 @@
+package cn.axzo.nanopart.visa.server.rpc;
+
+import cn.axzo.digital.RectifyApi;
+import cn.axzo.digital.req.ListRectifyOrderReq;
+import cn.axzo.digital.resp.RectifyOrderResp;
+import cn.axzo.nanopart.visa.server.utils.RpcUtil;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+import java.util.List;
+
+/**
+ * @author chenwenjian
+ * @version 1.0
+ * @date 2025/2/12 11:37
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class RectifyApiGateway {
+
+ private final RectifyApi rectifyApi;
+
+ public List listRectifyOrders(ListRectifyOrderReq req) {
+ return RpcUtil.rpcApiResultProcessor(() -> rectifyApi.listRectifyOrders(req),
+ "Get rectify orders by ids", req);
+ }
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/VisaCooperateShipGateway.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/VisaCooperateShipGateway.java
new file mode 100644
index 00000000..b9dd0ed7
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/VisaCooperateShipGateway.java
@@ -0,0 +1,34 @@
+package cn.axzo.nanopart.visa.server.rpc;
+
+import cn.axzo.maokai.api.client.CooperateShipQueryApi;
+import cn.axzo.maokai.api.vo.request.CooperateShipQueryReq;
+import cn.axzo.maokai.api.vo.response.CooperateShipResp;
+import cn.axzo.nanopart.visa.server.utils.RpcUtil;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+import java.util.Collections;
+import java.util.List;
+import java.util.Objects;
+
+/**
+ * @author chenwenjian
+ * @version 1.0
+ * @date 2024/4/9 11:20
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class VisaCooperateShipGateway {
+
+ private final CooperateShipQueryApi cooperateShipQueryApi;
+
+ public List genericQuery(CooperateShipQueryReq req) {
+ if (Objects.isNull(req)) {
+ return Collections.emptyList();
+ }
+ return RpcUtil.rpcApiListResultProcessor(() -> cooperateShipQueryApi.genericQuery(req),
+ "协同关系树查询");
+ }
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/VisaOrganizationalNodeGateway.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/VisaOrganizationalNodeGateway.java
new file mode 100644
index 00000000..b59d48aa
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/VisaOrganizationalNodeGateway.java
@@ -0,0 +1,29 @@
+package cn.axzo.nanopart.visa.server.rpc;
+
+import cn.axzo.maokai.api.client.OrganizationalNodeApi;
+import cn.axzo.maokai.api.vo.response.OrganizationalNodeVO;
+import cn.axzo.pokonyan.util.RpcUtil;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+import javax.annotation.Resource;
+
+/**
+ * TODO
+ *
+ * @author wangli
+ * @since 2025-02-28 11:11
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class VisaOrganizationalNodeGateway {
+
+ @Resource
+ private OrganizationalNodeApi organizationalNodeApi;
+
+ public OrganizationalNodeVO getNode(Long nodeId) {
+ return RpcUtil.rpcApiResultProcessor(() -> organizationalNodeApi.getNode(nodeId), "", nodeId);
+ }
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/VisaOrganizationalNodeUserGateway.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/VisaOrganizationalNodeUserGateway.java
new file mode 100644
index 00000000..44e30ec3
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/VisaOrganizationalNodeUserGateway.java
@@ -0,0 +1,56 @@
+package cn.axzo.nanopart.visa.server.rpc;
+
+import cn.axzo.foundation.page.PageResp;
+import cn.axzo.foundation.result.ApiResult;
+import cn.axzo.maokai.api.client.OrganizationalNodeUserQueryApi;
+import cn.axzo.maokai.api.vo.request.OrgNodeUserBriefInfoListReq;
+import cn.axzo.maokai.api.vo.response.OrgNodeUserBriefInfoResp;
+import cn.axzo.orggateway.api.nodeuser.OrgNodeUserApi;
+import cn.axzo.orggateway.api.nodeuser.dto.OrgNodeUserDTO;
+import cn.axzo.orggateway.api.nodeuser.req.ListOrgNodeUserReq;
+import cn.axzo.pokonyan.util.RpcUtil;
+import cn.azxo.framework.common.logger.MethodAroundLog;
+import com.alibaba.fastjson.JSON;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+import java.util.List;
+import java.util.Objects;
+
+/**
+ * @author chenwenjian
+ * @version 1.0
+ * @date 2024/4/8 20:40
+ */
+@Service
+@Slf4j
+@RequiredArgsConstructor
+public class VisaOrganizationalNodeUserGateway {
+
+ private final OrganizationalNodeUserQueryApi organizationalNodeUserQueryApi;
+
+ private final OrgNodeUserApi orgNodeUserApi;
+
+ @MethodAroundLog(target = "maokai", source = "nanopart", value = "获取用户列表")
+ public List listOrgNodeUsers(OrgNodeUserBriefInfoListReq req) {
+ return RpcUtil.rpcApiResultProcessor(() -> organizationalNodeUserQueryApi.listOrgNodeUsers(req), "获取用户列表", req);
+ }
+
+ @MethodAroundLog(target = "org-gateway", source = "nanopart", value = "获取用户列表")
+ public PageResp list(ListOrgNodeUserReq req) {
+ if (Objects.isNull(req)) {
+ return new PageResp();
+ }
+ try {
+ log.info("VisaOrganizationalNodeUserGateway list, params:{}", req);
+ ApiResult> list = orgNodeUserApi.list(req);
+ log.info("VisaOrganizationalNodeUserGateway list, result:{}", JSON.toJSONString(list));
+ return list.getData();
+ } catch (Exception e) {
+ log.warn("VisaOrganizationalNodeUserGateway list exception", e);
+ throw e;
+ }
+ }
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/VisaProfileGateway.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/VisaProfileGateway.java
new file mode 100644
index 00000000..154634d4
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/VisaProfileGateway.java
@@ -0,0 +1,79 @@
+package cn.axzo.nanopart.visa.server.rpc;
+
+import cn.axzo.basics.common.util.AssertUtil;
+import cn.axzo.basics.profiles.api.UserProfileServiceApi;
+import cn.axzo.basics.profiles.dto.basic.PersonProfileDto;
+import cn.azxo.framework.common.logger.MethodAroundLog;
+import cn.azxo.framework.common.model.CommonResponse;
+import cn.hutool.core.collection.CollectionUtil;
+import com.google.common.collect.Maps;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.apache.commons.collections.CollectionUtils;
+import org.springframework.stereotype.Service;
+
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.function.Function;
+import java.util.stream.Collectors;
+
+/**
+ * @author chenwenjian
+ * @version 1.0
+ * @date 2024/4/17 19:39
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class VisaProfileGateway {
+
+ private final UserProfileServiceApi userProfileServiceApi;
+
+ /**
+ * 通过personId获取用户档案
+ *
+ * @param personId
+ * @return
+ */
+ @MethodAroundLog(target = "pudge", source = "nanopart", value = "获取用户档案")
+ public PersonProfileDto getProfile(Long personId) {
+ if (Objects.isNull(personId)) {
+ return null;
+ }
+ CommonResponse personProfile = userProfileServiceApi.getPersonProfile(personId);
+ if (Objects.nonNull(personProfile) && personProfile.getCode() == 200) {
+ return personProfile.getData();
+ }
+ AssertUtil.isTrue(personProfile.getCode() == 200, personProfile.getMsg());
+ return null;
+ }
+
+ /**
+ * 通过personId获取用户档案
+ *
+ * @param personIds
+ * @return
+ */
+ @MethodAroundLog(target = "pudge", source = "nanopart", value = "获取用户档案")
+ public List getProfiles(List personIds) {
+ if (CollectionUtil.isEmpty(personIds)) {
+ return Collections.emptyList();
+ }
+ CommonResponse> personProfiles = userProfileServiceApi.getPersonProfiles(personIds);
+ if (Objects.nonNull(personProfiles) && personProfiles.getCode() == 200) {
+ return personProfiles.getData();
+ }
+ return Collections.emptyList();
+ }
+
+ @MethodAroundLog(target = "pudge", source = "nanopart", value = "获取用户档案并转换Map")
+ public Map getProfileMap(List personIds) {
+ List profiles = getProfiles(personIds);
+ if (CollectionUtils.isEmpty(profiles)) {
+ return Maps.newHashMap();
+ }
+ return profiles.stream().collect(Collectors.toMap(PersonProfileDto::getId, Function.identity(), (x, y) -> x));
+ }
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/VisaProjectApiGateway.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/VisaProjectApiGateway.java
new file mode 100644
index 00000000..656a9248
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/VisaProjectApiGateway.java
@@ -0,0 +1,43 @@
+package cn.axzo.nanopart.visa.server.rpc;
+
+import cn.axzo.apollo.workspace.api.workspace.ProjectApi;
+import cn.axzo.apollo.workspace.api.workspace.res.ProjectBriefResp;
+import cn.axzo.apollo.workspace.api.workspace.res.ProjectDetailRes;
+import cn.axzo.basics.common.util.NumberUtil;
+import cn.axzo.nanopart.visa.server.utils.RpcUtil;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.apache.commons.collections.CollectionUtils;
+import org.springframework.stereotype.Service;
+
+import java.util.Collections;
+import java.util.List;
+
+/**
+ * @author chenwenjian
+ * @version 1.0
+ * @date 2025/1/20 10:36
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class VisaProjectApiGateway {
+
+ private final ProjectApi projectApi;
+
+ public ProjectDetailRes getProjectById(Long id) {
+ if (NumberUtil.isNotPositiveNumber(id)) {
+ return null;
+ }
+ return RpcUtil.rpcResultProcessor(() -> projectApi.getById(id), "通过id获取工程详情", id);
+ }
+
+ public List getProjectBriefByIds(List ids) {
+ if (CollectionUtils.isEmpty(ids)) {
+ return Collections.emptyList();
+ }
+ return RpcUtil.rpcResultProcessor(() -> projectApi.simpleList(ids), "通过ids获取工程简单信息", ids);
+ }
+
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/WorkflowGateway.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/WorkflowGateway.java
new file mode 100644
index 00000000..9f5145b6
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/WorkflowGateway.java
@@ -0,0 +1,64 @@
+package cn.axzo.nanopart.visa.server.rpc;
+
+import cn.axzo.workflow.common.model.request.bpmn.process.BpmnProcessInstanceAbortDTO;
+import cn.axzo.workflow.common.model.request.bpmn.process.BpmnProcessInstanceCheckApproverDTO;
+import cn.axzo.workflow.common.model.request.bpmn.process.BpmnProcessInstanceCreateDTO;
+import cn.axzo.workflow.common.model.request.form.instance.FormVariablesUpdateDTO;
+import cn.axzo.workflow.starter.api.WorkflowCoreService;
+import cn.axzo.workflow.starter.api.WorkflowManageService;
+import cn.azxo.framework.common.logger.MethodAroundLog;
+import com.alibaba.fastjson.JSON;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+import org.springframework.util.StringUtils;
+
+/**
+ * @author xudawei
+ * @date 2025/01/22
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class WorkflowGateway {
+
+ private final WorkflowCoreService workflowCoreService;
+ private final WorkflowManageService workflowManageService;
+
+ @MethodAroundLog(target = "workflow-engine", source = "nanopart", value = "创建流程实例")
+ public String processInstanceCreate(BpmnProcessInstanceCreateDTO dto) {
+ return workflowCoreService.createProcessInstance(dto);
+ }
+
+ @MethodAroundLog(target = "workflow-engine", source = "nanopart", value = "中止流程实例")
+ public Boolean processInstanceAbort(BpmnProcessInstanceAbortDTO dto) {
+ return workflowCoreService.abortProcessInstance(dto);
+ }
+
+ @MethodAroundLog(target = "workflow-engine", source = "nanopart", value = "查询某个人是否是指定流程的审批人")
+ public Boolean checkInstanceApprover(BpmnProcessInstanceCheckApproverDTO dto) {
+ try {
+ log.info("WorkflowManagerGateway checkInstanceApprover,param:{}", JSON.toJSONString(dto));
+ Boolean flag = workflowManageService.checkInstanceApprover(dto);
+ log.info("WorkflowManagerGateway checkInstanceApprover,result:{}", flag);
+ return flag;
+ } catch (Exception e) {
+ log.warn("WorkflowManagerGateway checkInstanceApprover exception", e);
+ throw e;
+ }
+
+ }
+
+ @MethodAroundLog(target = "workflow-engine", source = "nanopart", value = "更新指定流程表单最后一次编辑的内容")
+ public Boolean updateInstanceFormData(FormVariablesUpdateDTO dto) {
+ return workflowCoreService.updateInstanceFormVariables(dto);
+ }
+
+ @MethodAroundLog(target = "workflow-engine", source = "nanopart", value = "更新指定流程表单最后一次编辑的内容")
+ public Boolean hasPrintTemplate(String processInstanceId) {
+ if(!StringUtils.hasText(processInstanceId)) {
+ return false;
+ }
+ return workflowManageService.hasPrintTemplate(processInstanceId);
+ }
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/WorkspaceGateway.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/WorkspaceGateway.java
new file mode 100644
index 00000000..3996fa13
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/rpc/WorkspaceGateway.java
@@ -0,0 +1,44 @@
+package cn.axzo.nanopart.visa.server.rpc;
+
+import cn.axzo.apollo.core.web.Result;
+import cn.axzo.apollo.workspace.api.workspace.WorkspaceApi;
+import cn.axzo.apollo.workspace.api.workspace.res.GetDetailRes;
+import cn.azxo.framework.common.logger.MethodAroundLog;
+import com.alibaba.fastjson.JSON;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+import java.util.Objects;
+
+/**
+ * @author xudawei
+ * @date 2025/01/21
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class WorkspaceGateway {
+
+ private final WorkspaceApi workspaceApi;
+
+ /**
+ * 通过workspaceId获取对象
+ */
+ @MethodAroundLog(target = "workspace", source = "nanopart", value = "获取项目信息")
+ public GetDetailRes getById(Long workspaceId) {
+ if (Objects.isNull(workspaceId)) {
+ return GetDetailRes.builder().build();
+ }
+ try {
+ log.info("WorkspaceGateway getById, params:{}", workspaceId);
+ Result result = workspaceApi.getById(workspaceId);
+ log.info("WorkspaceGateway getById, result:{}", JSON.toJSONString(result));
+ return result.getData();
+ } catch (Exception e) {
+ log.warn("WorkspaceGateway getById exception", e);
+ throw e;
+ }
+ }
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/service/ChangeRecordBillService.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/service/ChangeRecordBillService.java
new file mode 100644
index 00000000..bd9c3b96
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/service/ChangeRecordBillService.java
@@ -0,0 +1,70 @@
+package cn.axzo.nanopart.visa.server.service;
+
+import cn.axzo.nanopart.visa.api.enums.VisaBillTypeEnum;
+import cn.axzo.nanopart.visa.api.request.GetBillIfRelatedReq;
+import cn.axzo.nanopart.visa.server.domain.ChangeRecordBill;
+import cn.axzo.nanopart.visa.server.dto.VisaBillDto;
+import com.baomidou.mybatisplus.extension.service.IService;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * @author xudawei
+ * @date 2025/01/15
+ * @desc 变更签证记录内容关系表
+ */
+public interface ChangeRecordBillService extends IService {
+
+
+ /**
+ * 新增
+ */
+ Boolean addBill(List dtoList);
+
+ /**
+ * 更新
+ */
+ Boolean updateBill(Long visaId, List dtoList);
+
+ /**
+ * 更新关联单据的被关联状态
+ *
+ * @param visaId
+ * @param related
+ * @return
+ */
+ Boolean billRelationStatus(Long visaId, Boolean related);
+
+ /**
+ * 删除
+ */
+ Boolean deleteByVisaId(Long visaId);
+
+ Boolean deleteByCondition(List billIds, VisaBillTypeEnum billType);
+
+ /**
+ * 查询记录
+ */
+ List findByCondition(VisaBillDto dto);
+
+ /**
+ * 通过Id,查询记录
+ */
+ List listById(Long visaId);
+
+ Map getBillIfRelated(GetBillIfRelatedReq req);
+
+ /**
+ * 获取指定类型单据的主单据
+ *
+ * 特别提醒：该接口返回的数据包含待提报等非审批态单据的关联单据信息
+ *
+ *
+ * @param billType 单据类型
+ * @param billIdNos 单据id或no
+ * @return 主单据信息
+ */
+ List getRelatedMainBill(VisaBillTypeEnum billType, List billIdNos);
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/service/ChangeRecordConfirmService.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/service/ChangeRecordConfirmService.java
new file mode 100644
index 00000000..a60f4a29
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/service/ChangeRecordConfirmService.java
@@ -0,0 +1,84 @@
+package cn.axzo.nanopart.visa.server.service;
+
+import cn.axzo.nanopart.visa.api.enums.VisaButtonTypeEnum;
+import cn.axzo.nanopart.visa.api.enums.VisaConfirmBizTypeEnum;
+import cn.axzo.nanopart.visa.api.enums.VisaStatusEnum;
+import cn.axzo.nanopart.visa.api.enums.VisaTypeEnum;
+import cn.axzo.nanopart.visa.api.request.VisaChangeApproveCreateReq;
+import cn.axzo.nanopart.visa.api.response.VisaDetailByIdResponse;
+import cn.axzo.nanopart.visa.server.domain.ChangeRecordConfirm;
+import cn.axzo.nanopart.visa.server.dto.VisaConfirmDto;
+
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+/**
+ * @author xudawei
+ * @date 2025/01/15
+ * @desc 变更签证记录确认
+ */
+public interface ChangeRecordConfirmService {
+
+ /**
+ * 新增变更签证确认信息
+ *
+ * @param dtoList 变更签证确认信息
+ * @return true:成功;false:失败
+ */
+ boolean addConfirm(List dtoList);
+
+ /**
+ * 更新变更签证确认信息
+ *
+ * @param visaId 变更签证Id
+ * @param dtoList 变更签证确认
+ * @return true:成功;false:失败
+ */
+ boolean updateConfirm(Long visaId, List dtoList);
+
+ /**
+ * 通过变更签证Id，删除变更签证确认信息
+ */
+ boolean deleteByVisaId(Long visaId, List bizTypes);
+
+ /**
+ * 变更签证Id获取map
+ */
+ List listRelationByVisaId(List list, Long workspaceId);
+
+ /**
+ * 根据条件查询
+ *
+ * @param dto 查询条件
+ * @return 人员列表
+ */
+ List findByCondition(VisaConfirmDto dto);
+ /**
+ * 获取按钮集合
+ * 确认人与发起人的不同的单据状态，按钮列表不相同
+ */
+ List fetchBtnsByCondition(Long visaId, Long personId, Long ouId, Long workspaceId, VisaStatusEnum status, String approvalId);
+
+ /**
+ * 权限过滤
+ * @param dataObjectCode OMS提供权限code
+ * @param currentPersonId 当前登录人personId
+ * @param currentWorkspaceId 当前登录人项目Id
+ * @param currentOuId 当前登录人的单位Id
+ * @return 变更签证visaId集合
+ */
+ Set permissionVisaData(String dataObjectCode, Long currentPersonId, Long currentWorkspaceId, Long currentOuId, Set visaTypes);
+
+ /**
+ * 获取指定的变洽签所有的确认人
+ * @param visaId
+ * @return
+ */
+ List listAllConfirmByVisaId(Long visaId);
+
+ /**
+ * 构建公司的Map，orgIdAndNameMap,key:ouId,value:ouName
+ */
+ Map buildOrgIdAndNameMap(Set ouIdSet);
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/service/ChangeRecordLogService.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/service/ChangeRecordLogService.java
new file mode 100644
index 00000000..00d96bfa
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/service/ChangeRecordLogService.java
@@ -0,0 +1,63 @@
+package cn.axzo.nanopart.visa.server.service;
+
+import cn.axzo.nanopart.visa.api.enums.VisaLogTypeEnum;
+import cn.axzo.nanopart.visa.api.response.FetchVisaLogByVisaIdResponse;
+import cn.axzo.nanopart.visa.server.domain.ChangeRecordLog;
+import cn.axzo.nanopart.visa.server.dto.VisaLogParam;
+
+import java.util.List;
+
+/**
+ * @author xudawei
+ * @date 2025/01/15
+ * @desc 变更签证记录操作日志
+ */
+public interface ChangeRecordLogService {
+
+ /**
+ * 增加操作日志
+ */
+ void addLog(ChangeRecordLog log);
+
+ /**
+ * 增加操作日志
+ */
+ void batchAddLog(List logList);
+
+ /**
+ * 增加操作日志
+ */
+ void batchAddLog(Long visaId, VisaLogTypeEnum type, VisaLogParam param);
+
+ /**
+ * 构建日志集合
+ */
+ List buildLogList(Long visaId, VisaLogTypeEnum type, VisaLogParam param);
+
+ /**
+ * 通过变签Id获取日志
+ * @param visaId 变签Id
+ */
+ List fetchVisaLogByVisaId(Long visaId);
+
+ /**
+ * 构建操作人信息
+ */
+ String buildUserName(Long personId, Long ouId, Long workspaceId);
+
+ /**
+ * 通过变签Id获取日志
+ * @param visaId 变签Id
+ * @param logType 类型
+ */
+ List listByVisaIdType(Long visaId, VisaLogTypeEnum logType);
+
+ /**
+ * 是否有日志类型
+ * @param visaId 变更签证Id
+ * @param logType 类型
+ * @return true:有;false:没有
+ */
+ boolean hasLogType(Long visaId, VisaLogTypeEnum logType);
+
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/service/ChangeRecordRelationService.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/service/ChangeRecordRelationService.java
new file mode 100644
index 00000000..b0cb25c9
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/service/ChangeRecordRelationService.java
@@ -0,0 +1,70 @@
+package cn.axzo.nanopart.visa.server.service;
+
+import cn.axzo.nanopart.visa.api.enums.VisaRelationFieldEnum;
+import cn.axzo.nanopart.visa.api.request.ChangeRecordAppendAttachReq;
+import cn.axzo.nanopart.visa.api.request.ImGroupOperationClearReq;
+import cn.axzo.nanopart.visa.api.request.ImGroupOperationReq;
+import cn.axzo.nanopart.visa.api.request.ImGroupTipsQueryReq;
+import cn.axzo.nanopart.visa.api.request.VisaChangeTempCreateReq;
+import cn.axzo.nanopart.visa.api.response.ImGroupTipsResp;
+import cn.axzo.nanopart.visa.server.domain.ChangeRecord;
+import cn.axzo.nanopart.visa.server.domain.ChangeRecordRelation;
+import cn.axzo.nanopart.visa.server.dto.VisaRelationDto;
+import com.baomidou.mybatisplus.extension.service.IService;
+
+import java.util.List;
+
+/**
+ * @author xudawei
+ * @date 2025/01/15
+ * @desc 变更签证记录内容关系表
+ */
+public interface ChangeRecordRelationService extends IService {
+
+ boolean save(VisaRelationFieldEnum type, VisaChangeTempCreateReq req, ChangeRecord changeRecord);
+
+ /**
+ * 获取集合
+ */
+ List findByCondition(VisaRelationDto dto);
+
+ /**
+ * 根据名称与变更签证Id,获取集合
+ */
+ List findByVisaAndVarName(Long visaId, String varName);
+
+ boolean deleteByVisaId(Long visaId, List relationTypes);
+
+ /**
+ * IM 群聊中，保存 IM 用户操作横条的人
+ *
+ * @param req
+ * @return
+ */
+ Boolean saveImOperationParticipate(ImGroupOperationReq req);
+
+ /**
+ * IM 群聊中，群主操作重新发起，清空所有人的操作信息
+ *
+ * @param req
+ * @return
+ */
+ Boolean clearImOperationParticipate(ImGroupOperationClearReq req);
+
+ /**
+ * IM 群聊界面，查询当前人的 tips 横条
+ *
+ * @param req
+ * @return
+ */
+ ImGroupTipsResp queryImGroupTips(ImGroupTipsQueryReq req);
+
+ /**
+ * 追加附件
+ *
+ * @param req
+ */
+ void appendAttachment(ChangeRecordAppendAttachReq req);
+
+ boolean deleteByIds(List ids);
+}
diff --git a/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/service/ChangeRecordService.java b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/service/ChangeRecordService.java
new file mode 100644
index 00000000..4012af6c
--- /dev/null
+++ b/visa/visa-server/src/main/java/cn/axzo/nanopart/visa/server/service/ChangeRecordService.java
@@ -0,0 +1,160 @@
+package cn.axzo.nanopart.visa.server.service;
+
+import cn.axzo.framework.domain.web.result.PageData;
+import cn.axzo.nanopart.visa.api.enums.VisaStatusEnum;
+import cn.axzo.nanopart.visa.api.request.ChangeRecordButtonOperationReq;
+import cn.axzo.nanopart.visa.api.request.ChangeStatusRequest;
+import cn.axzo.nanopart.visa.api.request.CheckVisaWithVisaIdReq;
+import cn.axzo.nanopart.visa.api.request.VisaChangeApproveCreateReq;
+import cn.axzo.nanopart.visa.api.request.VisaChangeApproveOnlyReq;
+import cn.axzo.nanopart.visa.api.request.VisaChangeDiscussCreateReq;
+import cn.axzo.nanopart.visa.api.request.VisaChangeExportReq;
+import cn.axzo.nanopart.visa.api.request.VisaChangePageSearchReq;
+import cn.axzo.nanopart.visa.api.request.VisaChangeTempCreateReq;
+import cn.axzo.nanopart.visa.api.request.VisaInitiatorListReq;
+import cn.axzo.nanopart.visa.api.request.VisaSearchReq;
+import cn.axzo.nanopart.visa.api.response.VisaChangeDiscussCreateResp;
+import cn.axzo.nanopart.visa.api.response.VisaChangeInitiatorResp;
+import cn.axzo.nanopart.visa.api.response.VisaChangePageSearchResp;
+import cn.axzo.nanopart.visa.api.response.VisaDetailByIdResponse;
+import cn.axzo.nanopart.visa.api.response.VisaSearchResp;
+import cn.axzo.nanopart.visa.server.domain.ChangeRecord;
+import cn.axzo.nanopart.visa.server.domain.ChangeRecordRelation;
+import com.baomidou.mybatisplus.extension.service.IService;
+
+import java.util.List;
+
+/**
+ * @author xudawei
+ * @date 2025/01/15
+ * @desc 变更签证记录
+ */
+public interface ChangeRecordService extends IService {
+
+ /**
+ * 状态变更
+ */
+ Boolean changeStatus(ChangeStatusRequest request);
+
+ /**
+ * 更新DB变签状态
+ */
+ boolean changeDbStatus(Long visaId, List statusList, VisaStatusEnum updateStatus);
+
+ /**
+ * 通过变更签证Id获取Entity
+ *
+ * @param visaId 变更签证Id
+ * @return 变更签证Entity
+ */
+ ChangeRecord getById(Long visaId);
+
+ /**
+ * 变更签证详情
+ *
+ * @param visaId 变更签证Id
+ * @return 变更签证详情
+ */
+ VisaDetailByIdResponse detailById(Long visaId);
+
+ /**
+ * 附件对象转换
+ */
+ List buildAttachUploadFileByRelation(List attachList);
+
+ /**
+ * 构建上传文件对象集合
+ */
+ List buildAttachUploadFile(Long visaId);
+
+ /**
+ * 创建变更签证
+ *
+ * @param req 表单数据
+ * @return 变更签证Id
+ */
+ Long tempCreateVisaChangeRecord(VisaChangeTempCreateReq req);
+
+ /**
+ * 创建群聊洽商变更签证
+ *
+ * @param req 表单数据
+ * @return 变更签证Id
+ */
+ VisaChangeDiscussCreateResp discussCreateVisaChangeRecord(VisaChangeDiscussCreateReq req);
+
+ /**
+ * 创建审批变更签证
+ *
+ * @param req 表单数据
+ * @return 变更签证Id
+ */
+ Long approveCreateVisaChangeRecord(VisaChangeApproveCreateReq req);
+
+ /**
+ * 分页查询
+ *
+ * @param req 筛查条件
+ * @return 分页数据
+ */
+ PageData page(VisaChangePageSearchReq req);
+
+ /**
+ * 查询发起人列表
+ *
+ * @param req 项目Id
+ * @return 发起人列表
+ */
+ List