1. 新增统一的业务编码生成功能

(cherry picked from commit fe28760a49)
This commit is contained in:
chenbowen
2025-08-12 14:09:36 +08:00
committed by chenbowen
parent a3cc570b83
commit 3ff40f9af9
30 changed files with 1329 additions and 90 deletions

View File

@@ -1,13 +1,30 @@
package cn.iocoder.yudao.module.system.api.sequence;
import cn.iocoder.yudao.framework.common.biz.system.sequence.SequenceCommonApi;
import cn.iocoder.yudao.framework.common.pojo.CommonResult;
import cn.iocoder.yudao.module.system.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.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import java.util.List;
/**
* @author chenbowen
*/
@FeignClient(name = ApiConstants.NAME)
@Tag(name = "序列管理 Api")
public interface SequenceApi {
@FeignClient(name = ApiConstants.NAME, primary = false) // TODO 芋艿fallbackFactory =
@Tag(name = "RPC 服务 - 序列号")
public interface SequenceApi extends SequenceCommonApi {
String PREFIX = ApiConstants.PREFIX + "/sequence";
@PostMapping(PREFIX + "/next-sequence")
@Operation(summary = "获取下一个序列号")
@Override
CommonResult<String> getNextSequence(@RequestParam("sequenceCode") String sequenceCode,
@RequestParam(value = "circulationValue", required = false) String circulationValue,
@RequestParam(value = "inputStrs", required = false) List<String> inputStrs);
}

View File

@@ -0,0 +1,20 @@
package cn.iocoder.yudao.module.system.enums.sequence;
import lombok.AllArgsConstructor;
import lombok.Getter;
/**
* 序列号分段规则类型枚举
*/
@Getter
@AllArgsConstructor
public enum SequenceDetailRuleEnum {
// 示例规则类型
FIXED("FIXED", "固定值"),
DATE("DATE", "日期格式"),
NUMBER("NUMBER", "数字格式"),
CUSTOM("CUSTOM", "自定义格式");
private final String code;
private final String name;
}

View File

@@ -0,0 +1,39 @@
package cn.iocoder.yudao.module.system.enums.sequence;
import lombok.AllArgsConstructor;
import lombok.Getter;
/**
* 序列号分段类型枚举
*/
@Getter
@AllArgsConstructor
public enum SequenceDetailTypeEnum {
// 默认字符分段
SEQ_DETAIL_TYPE_STR("STR", "默认字符分段"),
// 给定字符分段
SEQ_DETAIL_TYPE_INPUT("INPUT", "给定字符分段"),
// 日期分段
SEQ_DETAIL_TYPE_DATE("DATE", "日期分段"),
// 流水号分段
SEQ_DETAIL_TYPE_SEQ("SEQ", "流水号分段");
/**
* 类型编码
*/
private final String code;
private final String name;
public static SequenceDetailTypeEnum getByCode(String code) {
if (code == null) {
return null;
}
for (SequenceDetailTypeEnum value : SequenceDetailTypeEnum.values()) {
if (value.getCode().equals(code)) {
return value;
}
}
return null;
}
}

View File

@@ -0,0 +1,26 @@
package cn.iocoder.yudao.module.system.api.sequence;
import cn.iocoder.yudao.framework.common.pojo.CommonResult;
import cn.iocoder.yudao.module.system.service.sequence.SequenceService;
import jakarta.annotation.Resource;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.RestController;
import java.util.List;
import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
@RestController // 提供 RESTful API 接口,给 Feign 调用
@Validated
public class SequenceApiImpl implements SequenceApi {
@Resource
private SequenceService sequenceService;
@Override
public CommonResult<String> getNextSequence(String sequenceCode, String circulationValue, List<String> inputStrs) {
String result = sequenceService.getNextSeq(sequenceCode, circulationValue, inputStrs);
return success(result);
}
}

View File

@@ -0,0 +1,23 @@
package cn.iocoder.yudao.module.system.controller.admin.sequence.vo;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.constraints.NotEmpty;
import lombok.Data;
import java.util.List;
@Schema(description = "管理后台 - 序列号生成 Request VO")
@Data
public class SequenceGenerateReqVO {
@Schema(description = "序列号编码", requiredMode = Schema.RequiredMode.REQUIRED)
@NotEmpty(message = "序列号编码不能为空")
private String sequenceCode;
@Schema(description = "循环值")
private String circulationValue;
@Schema(description = "输入参数数组")
private List<String> inputStrs;
}

View File

@@ -0,0 +1,29 @@
package cn.iocoder.yudao.module.system.controller.admin.sequence.vo;
import lombok.*;
import java.util.*;
import io.swagger.v3.oas.annotations.media.Schema;
import cn.iocoder.yudao.framework.common.pojo.PageParam;
import org.springframework.format.annotation.DateTimeFormat;
import java.time.LocalDateTime;
import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
@Schema(description = "管理后台 - 系统序列号分页 Request VO")
@Data
public class SequencePageReqVO extends PageParam {
@Schema(description = "序列号编码")
private String sequenceCode;
@Schema(description = "序列号名称", example = "张三")
private String sequenceName;
@Schema(description = "循环类型(yyyy-年/yyyy-MM-dd-日/XXX-自定义)", example = "1")
private String cycleType;
@Schema(description = "创建时间")
@DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
private LocalDateTime[] createTime;
}

View File

@@ -0,0 +1,35 @@
package cn.iocoder.yudao.module.system.controller.admin.sequence.vo;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.*;
import java.util.*;
import org.springframework.format.annotation.DateTimeFormat;
import java.time.LocalDateTime;
import com.alibaba.excel.annotation.*;
@Schema(description = "管理后台 - 系统序列号 Response VO")
@Data
@ExcelIgnoreUnannotated
public class SequenceRespVO {
@Schema(description = "主键ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "23537")
@ExcelProperty("主键ID")
private Long id;
@Schema(description = "序列号编码", requiredMode = Schema.RequiredMode.REQUIRED)
@ExcelProperty("序列号编码")
private String sequenceCode;
@Schema(description = "序列号名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "张三")
@ExcelProperty("序列号名称")
private String sequenceName;
@Schema(description = "循环类型(yyyy-年/yyyy-MM-dd-日/XXX-自定义)", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
@ExcelProperty("循环类型(yyyy-年/yyyy-MM-dd-日/XXX-自定义)")
private String cycleType;
@Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
@ExcelProperty("创建时间")
private LocalDateTime createTime;
}

View File

@@ -0,0 +1,35 @@
package cn.iocoder.yudao.module.system.controller.admin.sequence.vo;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.*;
import java.util.*;
import jakarta.validation.constraints.*;
import cn.iocoder.yudao.module.system.dal.dataobject.sequence.SequenceDetailDO;
import cn.iocoder.yudao.module.system.dal.dataobject.sequence.SequenceRecordDO;
@Schema(description = "管理后台 - 系统序列号新增/修改 Request VO")
@Data
public class SequenceSaveReqVO {
@Schema(description = "主键ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "23537")
private Long id;
@Schema(description = "序列号编码", requiredMode = Schema.RequiredMode.REQUIRED)
@NotEmpty(message = "序列号编码不能为空")
private String sequenceCode;
@Schema(description = "序列号名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "张三")
@NotEmpty(message = "序列号名称不能为空")
private String sequenceName;
@Schema(description = "循环类型(yyyy-年/yyyy-MM-dd-日/XXX-自定义)", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
@NotEmpty(message = "循环类型(yyyy-年/yyyy-MM-dd-日/XXX-自定义)不能为空")
private String cycleType;
@Schema(description = "系统序列号分段明细列表")
private List<SequenceDetailDO> sequenceDetails;
@Schema(description = "系统序列号记录列表")
private List<SequenceRecordDO> sequenceRecords;
}

View File

@@ -0,0 +1,50 @@
package cn.iocoder.yudao.module.system.dal.dataobject.sequence;
import lombok.*;
import java.util.*;
import java.time.LocalDateTime;
import java.time.LocalDateTime;
import com.baomidou.mybatisplus.annotation.*;
import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
/**
* 系统序列号 DO
*
* @author 后台管理
*/
@TableName("system_seq")
@KeySequence("system_seq_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库,可不写。
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
@Builder
@NoArgsConstructor
@AllArgsConstructor
/**
* 支持业务基类继承isBusiness=true 时继承 BusinessBaseDO否则继承 BaseDO
*/
public class SequenceDO extends BaseDO {
/**
* 主键ID
*/
@TableId(type = IdType.ASSIGN_ID)
private Long id;
/**
* 序列号编码
*/
@TableField("seq_cd")
private String sequenceCode;
/**
* 序列号名称
*/
@TableField("seq_name")
private String sequenceName;
/**
* 循环类型(yyyy-年/yyyy-MM-dd-日/XXX-自定义)
*/
@TableField("cycl_tp")
private String cycleType;
}

Some files were not shown because too many files have changed in this diff Show More