1. 统一包名修改

zt-framework/zt-common/src/main/java/com/fhs/trans/service/AutoTransable.java

@@ -0,0 +1,59 @@
+package com.fhs.trans.service;
+
+import com.fhs.core.trans.vo.VO;
+
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * 只有实现了这个接口的才能自动翻译
+ *
+ * 为什么要赋值粘贴到 cloud-common 包下？
+ * 因为 AutoTransable 属于 easy-trans-service 下，无法方便的在 cloud-module-xxx-api 模块下使用
+ *
+ * @author jackwang
+ * @since  2020-05-19 10:26:15
+ */
+public interface AutoTransable<V extends VO> {
+
+    /**
+     * 根据 ids 查询数据列表
+     *
+     * 改方法已过期啦，请使用 selectByIds
+     *
+     * @param ids 编号数组
+     * @return 数据列表
+     */
+    @Deprecated
+    default List<V> findByIds(List<? extends Object> ids){
+        return new ArrayList<>();
+    }
+
+    /**
+     * 根据 ids 查询
+     *
+     * @param ids 编号数组
+     * @return 数据列表
+     */
+    default List<V> selectByIds(List<? extends Object> ids){
+        return this.findByIds(ids);
+    }
+
+    /**
+     * 获取 db 中所有的数据
+     *
+     * @return db 中所有的数据
+     */
+    default List<V> select(){
+        return new ArrayList<>();
+    }
+
+    /**
+     * 根据 id 获取 vo
+     *
+     * @param primaryValue id
+     * @return vo
+     */
+    V selectById(Object primaryValue);
+
+}

zt-framework/zt-common/src/main/java/com/zt/plat/framework/common/biz/infra/logger/ApiAccessLogCommonApi.java

@@ -0,0 +1,34 @@
+package com.zt.plat.framework.common.biz.infra.logger;
+
+import com.zt.plat.framework.common.biz.infra.logger.dto.ApiAccessLogCreateReqDTO;
+import com.zt.plat.framework.common.enums.RpcConstants;
+import com.zt.plat.framework.common.pojo.CommonResult;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.scheduling.annotation.Async;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+
+@FeignClient(name = RpcConstants.INFRA_NAME) // TODO 芋艿：fallbackFactory =
+@Tag(name = "RPC 服务 - API 访问日志")
+public interface ApiAccessLogCommonApi {
+
+    String PREFIX = RpcConstants.INFRA_PREFIX + "/api-access-log";
+
+    @PostMapping(PREFIX + "/create")
+    @Operation(summary = "创建 API 访问日志")
+    CommonResult<Boolean> createApiAccessLog(@Valid @RequestBody ApiAccessLogCreateReqDTO createDTO);
+
+    /**
+     * 【异步】创建 API 访问日志
+     *
+     * @param createDTO 访问日志 DTO
+     */
+    @Async
+    default void createApiAccessLogAsync(ApiAccessLogCreateReqDTO createDTO) {
+        createApiAccessLog(createDTO).checkError();
+    }
+
+}

zt-framework/zt-common/src/main/java/com/zt/plat/framework/common/biz/infra/logger/ApiErrorLogCommonApi.java

@@ -0,0 +1,34 @@
+package com.zt.plat.framework.common.biz.infra.logger;
+
+import com.zt.plat.framework.common.biz.infra.logger.dto.ApiErrorLogCreateReqDTO;
+import com.zt.plat.framework.common.enums.RpcConstants;
+import com.zt.plat.framework.common.pojo.CommonResult;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.scheduling.annotation.Async;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+
+@FeignClient(name = RpcConstants.INFRA_NAME) // TODO 芋艿：fallbackFactory =
+@Tag(name = "RPC 服务 - API 异常日志")
+public interface ApiErrorLogCommonApi {
+
+    String PREFIX = RpcConstants.INFRA_PREFIX + "/api-error-log";
+
+    @PostMapping(PREFIX + "/create")
+    @Operation(summary = "创建 API 异常日志")
+    CommonResult<Boolean> createApiErrorLog(@Valid @RequestBody ApiErrorLogCreateReqDTO createDTO);
+
+    /**
+     * 【异步】创建 API 异常日志
+     *
+     * @param createDTO 异常日志 DTO
+     */
+    @Async
+    default void createApiErrorLogAsync(ApiErrorLogCreateReqDTO createDTO) {
+        createApiErrorLog(createDTO).checkError();
+    }
+
+}

zt-framework/zt-common/src/main/java/com/zt/plat/framework/common/biz/infra/logger/dto/ApiErrorLogCreateReqDTO.java

@@ -0,0 +1,68 @@
+package com.zt.plat.framework.common.biz.infra.logger.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "RPC 服务 - API 错误日志创建 Request DTO")
+@Data
+public class ApiErrorLogCreateReqDTO {
+
+    @Schema(description = "链路追踪编号", example = "89aca178-a370-411c-ae02-3f0d672be4ab")
+    private String traceId;
+
+    @Schema(description = "用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long userId;
+    @Schema(description = "用户类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer userType;
+    @Schema(description = "应用名", requiredMode = Schema.RequiredMode.REQUIRED, example = "system-server")
+    @NotNull(message = "应用名不能为空")
+    private String applicationName;
+
+    @Schema(description = "请求方法名", requiredMode = Schema.RequiredMode.REQUIRED, example = "GET")
+    @NotNull(message = "http 请求方法不能为空")
+    private String requestMethod;
+    @Schema(description = "请求地址", requiredMode = Schema.RequiredMode.REQUIRED, example = "/xxx/yyy")
+    @NotNull(message = "访问地址不能为空")
+    private String requestUrl;
+    @Schema(description = "请求参数", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "请求参数不能为空")
+    private String requestParams;
+    @Schema(description = "用户 IP", requiredMode = Schema.RequiredMode.REQUIRED, example = "127.0.0.1")
+    @NotNull(message = "ip 不能为空")
+    private String userIp;
+    @Schema(description = "浏览器 UserAgent", requiredMode = Schema.RequiredMode.REQUIRED, example = "Mozilla/5.0")
+    @NotNull(message = "User-Agent 不能为空")
+    private String userAgent;
+
+    @Schema(description = "异常时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "异常时间不能为空")
+    private LocalDateTime exceptionTime;
+    @Schema(description = "异常名", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "异常名不能为空")
+    private String exceptionName;
+    @Schema(description = "异常发生的类全名", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "异常发生的类全名不能为空")
+    private String exceptionClassName;
+    @Schema(description = "异常发生的类文件", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "异常发生的类文件不能为空")
+    private String exceptionFileName;
+    @Schema(description = "异常发生的方法名", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "异常发生的方法名不能为空")
+    private String exceptionMethodName;
+    @Schema(description = "异常发生的方法所在行", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "异常发生的方法所在行不能为空")
+    private Integer exceptionLineNumber;
+    @Schema(description = "异常的栈轨迹异常的栈轨迹", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "异常的栈轨迹不能为空")
+    private String exceptionStackTrace;
+    @Schema(description = "异常导致的根消息", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "异常导致的根消息不能为空")
+    private String exceptionRootCauseMessage;
+    @Schema(description = "异常导致的消息", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "异常导致的消息不能为空")
+    private String exceptionMessage;
+
+}

zt-framework/zt-common/src/main/java/com/zt/plat/framework/common/biz/infra/package-info.java

@@ -0,0 +1,4 @@
+/**
+ * 针对 infra 模块的 api 包
+ */
+package com.zt.plat.framework.common.biz.infra;

zt-framework/zt-common/src/main/java/com/zt/plat/framework/common/biz/package-info.java

@@ -0,0 +1,4 @@
+/**
+ * 特殊：用于 framework 下，starter 需要调用 biz 业务模块的接口定义！
+ */
+package com.zt.plat.framework.common.biz;

zt-framework/zt-common/src/main/java/com/zt/plat/framework/common/biz/system/dict/DictDataCommonApi.java

@@ -0,0 +1,26 @@
+package com.zt.plat.framework.common.biz.system.dict;
+
+import com.zt.plat.framework.common.biz.system.dict.dto.DictDataRespDTO;
+import com.zt.plat.framework.common.enums.RpcConstants;
+import com.zt.plat.framework.common.pojo.CommonResult;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+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;
+
+import java.util.List;
+
+@FeignClient(name = RpcConstants.SYSTEM_NAME, primary = false) // TODO 芋艿：fallbackFactory =
+@Tag(name = "RPC 服务 - 字典数据")
+public interface DictDataCommonApi {
+
+    String PREFIX = RpcConstants.SYSTEM_PREFIX + "/dict-data";
+
+    @GetMapping(PREFIX + "/list")
+    @Operation(summary = "获得指定字典类型的字典数据列表")
+    @Parameter(name = "dictType", description = "字典类型", example = "SEX", required = true)
+    CommonResult<List<DictDataRespDTO>> getDictDataList(@RequestParam("dictType") String dictType);
+
+}

zt-framework/zt-common/src/main/java/com/zt/plat/framework/common/biz/system/dict/dto/DictDataRespDTO.java

@@ -0,0 +1,22 @@
+package com.zt.plat.framework.common.biz.system.dict.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+@Schema(description = "RPC 服务 - 字典数据 Response DTO")
+@Data
+public class DictDataRespDTO {
+
+    @Schema(description = "字典标签", requiredMode = Schema.RequiredMode.REQUIRED, example = "ZT")
+    private String label;
+
+    @Schema(description = "字典值", requiredMode = Schema.RequiredMode.REQUIRED, example = "iocoder")
+    private String value;
+
+    @Schema(description = "字典类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "sys_common_sex")
+    private String dictType;
+
+    @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer status; // 参见 CommonStatusEnum 枚举
+
+}