1. 手动合并存在重复被合并的文件，并统一包名

zt-module-infra/zt-module-infra-api/pom.xml

@@ -0,0 +1,47 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <parent>
+        <groupId>com.zt.plat</groupId>
+        <artifactId>zt-module-infra</artifactId>
+        <version>${revision}</version>
+    </parent>
+    <modelVersion>4.0.0</modelVersion>
+    <artifactId>zt-module-infra-api</artifactId>
+    <packaging>jar</packaging>
+
+    <name>${project.artifactId}</name>
+    <description>
+        infra 模块 API，暴露给其它模块调用
+    </description>
+
+    <dependencies>
+        <dependency>
+            <groupId>com.zt.plat</groupId>
+            <artifactId>zt-common</artifactId>
+        </dependency>
+
+        <!-- Web 相关 -->
+        <dependency>
+            <groupId>org.springdoc</groupId> <!-- 接口文档：使用最新版本的 Swagger 模型 -->
+            <artifactId>springdoc-openapi-starter-webmvc-api</artifactId>
+            <scope>provided</scope>
+        </dependency>
+
+        <!-- 参数校验 -->
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-validation</artifactId>
+            <optional>true</optional>
+        </dependency>
+
+        <!-- RPC 远程调用相关 -->
+        <dependency>
+            <groupId>org.springframework.cloud</groupId>
+            <artifactId>spring-cloud-starter-openfeign</artifactId>
+            <optional>true</optional>
+        </dependency>
+    </dependencies>
+
+</project>

zt-module-infra/zt-module-infra-api/src/main/java/com/zt/plat/module/infra/api/businessfile/BusinessFileApi.java

@@ -0,0 +1,70 @@
+package com.zt.plat.module.infra.api.businessfile;
+
+import com.zt.plat.framework.common.pojo.CommonResult;
+import com.zt.plat.framework.common.pojo.PageResult;
+import com.zt.plat.module.infra.api.businessfile.dto.BusinessFilePageReqDTO;
+import com.zt.plat.module.infra.api.businessfile.dto.BusinessFileRespDTO;
+import com.zt.plat.module.infra.api.businessfile.dto.BusinessFileSaveReqDTO;
+import com.zt.plat.module.infra.api.businessfile.dto.BusinessFileWithUrlRespDTO;
+import com.zt.plat.module.infra.enums.ApiConstants;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+/**
+ * @author chenbowen
+ */
+@FeignClient(name = ApiConstants.NAME)
+@Tag(name = "RPC 服务 - 业务附件关联")
+public interface BusinessFileApi {
+
+    String PREFIX = ApiConstants.PREFIX + "/business-file";
+
+    @PostMapping(PREFIX + "/create")
+    @Operation(summary = "创建业务附件关联")
+    CommonResult<Long> createBusinessFile(@Valid @RequestBody BusinessFileSaveReqDTO createReqDTO);
+
+    @PostMapping(PREFIX + "/batch-create")
+    @Operation(summary = "批量新增业务附件关联")
+    CommonResult<List<Long>> batchCreateBusinessFile(@RequestBody List<BusinessFileSaveReqDTO> createReqDTOList);
+
+    @PostMapping(PREFIX + "/update")
+    @Operation(summary = "更新业务附件关联")
+    CommonResult<Boolean> updateBusinessFile(@Valid @RequestBody BusinessFileSaveReqDTO updateReqDTO);
+
+    @DeleteMapping(PREFIX + "/delete")
+    @Operation(summary = "删除业务附件关联")
+    @Parameter(name = "id", description = "编号", required = true)
+    CommonResult<Boolean> deleteBusinessFile(@RequestParam("id") Long id);
+
+    @DeleteMapping(PREFIX + "/delete-list")
+    @Operation(summary = "批量删除业务附件关联")
+    @Parameter(name = "ids", description = "编号列表", required = true)
+    CommonResult<Boolean> deleteBusinessFileList(@RequestParam("ids") List<Long> ids);
+
+    @GetMapping(PREFIX + "/get")
+    @Operation(summary = "获得业务附件关联")
+    @Parameter(name = "id", description = "编号", required = true)
+    CommonResult<BusinessFileRespDTO> getBusinessFile(@RequestParam("id") Long id);
+
+    @PostMapping(PREFIX + "/page")
+    @Operation(summary = "获得业务附件关联分页")
+    CommonResult<PageResult<BusinessFileRespDTO>> getBusinessFilePage(@RequestBody BusinessFilePageReqDTO pageReqDTO);
+
+    @PostMapping(PREFIX + "/page-with-url")
+    @Operation(summary = "获得业务附件关联分页（带URL）")
+    CommonResult<PageResult<BusinessFileWithUrlRespDTO>> getBusinessFilePageWithUrl(@RequestBody BusinessFilePageReqDTO pageReqDTO);
+
+    @DeleteMapping(PREFIX + "/delete-by-business")
+    @Operation(summary = "根据业务Id和来源删除业务附件关联")
+    @Parameter(name = "businessId", description = "业务Id", required = true)
+    @Parameter(name = "source", description = "业务来源", required = true)
+    CommonResult<Boolean> deleteBusinessFileByBusinessIdAndSource(@RequestParam("businessId") Long businessId,
+                                                                  @RequestParam("source") String source);
+
+}

zt-module-infra/zt-module-infra-api/src/main/java/com/zt/plat/module/infra/api/businessfile/dto/BusinessFilePageReqDTO.java

@@ -0,0 +1,46 @@
+package com.zt.plat.module.infra.api.businessfile.dto;
+
+import com.zt.plat.framework.common.pojo.PageParam;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+import java.io.Serializable;
+import java.time.LocalDateTime;
+
+/**
+ * 业务附件关联分页查询 DTO
+ *
+ * @author 后台管理
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class BusinessFilePageReqDTO extends PageParam implements Serializable {
+
+    /**
+     * 业务Id
+     */
+    private Long businessId;
+
+    /**
+     * 业务编码
+     */
+    private String businessCode;
+
+    /**
+     * 文件名
+     */
+    private String fileName;
+
+    /**
+     * 业务来源
+     */
+    private String source;
+
+    /**
+     * 创建时间
+     */
+    private LocalDateTime[] createTime;
+
+}

zt-module-infra/zt-module-infra-api/src/main/java/com/zt/plat/module/infra/api/businessfile/dto/BusinessFileRespDTO.java

@@ -0,0 +1,62 @@
+package com.zt.plat.module.infra.api.businessfile.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.io.Serializable;
+import java.time.LocalDateTime;
+
+/**
+ * 业务附件关联响应 DTO
+ *
+ * @author 后台管理
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class BusinessFileRespDTO implements Serializable {
+
+    /**
+     * 编号
+     */
+    private Long id;
+
+    /**
+     * 业务Id
+     */
+    private Long businessId;
+
+    /**
+     * 业务编码
+     */
+    private String businessCode;
+
+    /**
+     * 文件名
+     */
+    private String fileName;
+
+    /**
+     * 文件Id
+     */
+    private Long fileId;
+
+    /**
+     * 业务来源
+     */
+    private String source;
+
+    /**
+     * 创建时间
+     */
+    private LocalDateTime createTime;
+
+    /**
+     * 更新时间
+     */
+    private LocalDateTime updateTime;
+
+}

zt-module-infra/zt-module-infra-api/src/main/java/com/zt/plat/module/infra/api/businessfile/dto/BusinessFileSaveReqDTO.java

@@ -0,0 +1,29 @@
+package com.zt.plat.module.infra.api.businessfile.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.io.Serializable;
+
+/**
+ * 业务附件关联保存请求 DTO
+ * @author chenbowen
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class BusinessFileSaveReqDTO implements Serializable {
+    /** 业务Id */
+    private Long businessId;
+    /** 业务编码 */
+    private String businessCode;
+    /** 文件名 */
+    private String fileName;
+    private Long fileId;
+    /** 业务来源 */
+    private String source;
+}
+

zt-module-infra/zt-module-infra-api/src/main/java/com/zt/plat/module/infra/api/businessfile/dto/BusinessFileWithUrlRespDTO.java

@@ -0,0 +1,49 @@
+package com.zt.plat.module.infra.api.businessfile.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * 业务附件关联带URL响应 DTO
+ *
+ * @author 后台管理
+ */
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class BusinessFileWithUrlRespDTO extends BusinessFileRespDTO {
+
+    /**
+     * 文件路径
+     */
+    private String filePath;
+
+    /**
+     * 文件 URL
+     */
+    private String fileUrl;
+
+    /**
+     * 附件预览地址
+     */
+    private String previewUrl;
+
+    /**
+     * 是否加密
+     */
+    private Boolean isEncrypted;
+
+    /**
+     * 文件MIME类型
+     */
+    private String fileType;
+
+    /**
+     * 文件大小
+     */
+    private Integer fileSize;
+
+}

zt-module-infra/zt-module-infra-api/src/main/java/com/zt/plat/module/infra/api/config/ConfigApi.java

@@ -0,0 +1,21 @@
+package com.zt.plat.module.infra.api.config;
+
+import com.zt.plat.framework.common.pojo.CommonResult;
+import com.zt.plat.module.infra.enums.ApiConstants;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+
+@FeignClient(name = ApiConstants.NAME) // TODO 芋艿：fallbackFactory =
+@Tag(name = "RPC 服务 - 参数配置")
+public interface ConfigApi {
+
+    String PREFIX = ApiConstants.PREFIX + "/config";
+
+    @GetMapping(PREFIX + "/get-value-by-key")
+    @Operation(summary = "根据参数键查询参数值")
+    CommonResult<String> getConfigValueByKey(@RequestParam("key") String key);
+
+}

zt-module-infra/zt-module-infra-api/src/main/java/com/zt/plat/module/infra/api/file/FileApi.java

@@ -0,0 +1,59 @@
+package com.zt.plat.module.infra.api.file;
+
+import com.zt.plat.framework.common.pojo.CommonResult;
+import com.zt.plat.module.infra.api.file.dto.FileCreateReqDTO;
+import com.zt.plat.module.infra.enums.ApiConstants;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotEmpty;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+
+@FeignClient(name = ApiConstants.NAME) // TODO 芋艿：fallbackFactory =
+@Tag(name = "RPC 服务 - 文件")
+public interface FileApi {
+
+    String PREFIX = ApiConstants.PREFIX + "/file";
+
+    /**
+     * 保存文件，并返回文件的访问路径
+     *
+     * @param content 文件内容
+     * @return 文件路径
+     */
+    default String createFile(byte[] content) {
+        return createFile(content, null, null, null);
+    }
+
+    /**
+     * 保存文件，并返回文件的访问路径
+     *
+     * @param content 文件内容
+     * @param name 文件名称，允许空
+     * @return 文件路径
+     */
+    default String createFile(byte[] content, String name) {
+        return createFile(content, name, null, null);
+    }
+
+    /**
+     * 保存文件，并返回文件的访问路径
+     *
+     * @param content 文件内容
+     * @param name 文件名称，允许空
+     * @param directory 目录，允许空
+     * @param type 文件的 MIME 类型，允许空
+     * @return 文件路径
+     */
+    default String createFile(@NotEmpty(message = "文件内容不能为空") byte[] content,
+                              String name, String directory, String type) {
+        return createFile(new FileCreateReqDTO().setName(name).setDirectory(directory).setType(type).setContent(content)).getCheckedData();
+    }
+
+    @PostMapping(PREFIX + "/create")
+    @Operation(summary = "保存文件，并返回文件的访问路径")
+    CommonResult<String> createFile(@Valid @RequestBody FileCreateReqDTO createReqDTO);
+
+}

zt-module-infra/zt-module-infra-api/src/main/java/com/zt/plat/module/infra/api/file/dto/FileCreateReqDTO.java

@@ -0,0 +1,24 @@
+package com.zt.plat.module.infra.api.file.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import lombok.Data;
+
+@Schema(description = "RPC 服务 - 文件创建 Request DTO")
+@Data
+public class FileCreateReqDTO {
+
+    @Schema(description = "原文件名称", example = "xxx.png")
+    private String name;
+
+    @Schema(description = "文件目录", example = "xxx")
+    private String directory;
+
+    @Schema(description = "文件的 MIME 类型", example = "image/png")
+    private String type;
+
+    @Schema(description = "文件内容", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "文件内容不能为空")
+    private byte[] content;
+
+}

zt-module-infra/zt-module-infra-api/src/main/java/com/zt/plat/module/infra/api/package-info.java

@@ -0,0 +1,4 @@
+/**
+ * infra API 包，定义暴露给其它模块的 API
+ */
+package com.zt.plat.module.infra.api;