refactor(swagger): 迁移Swagger注解到OpenAPI 3.0

云

2026-04-23 c247f5bf64c98595cc7e4efc9e1ae7ff1df79c11

 src/main/java/com/ruoyi/sales/pojo/ShipmentApproval.java

@@ -3,7 +3,7 @@
import com.baomidou.mybatisplus.annotation.*;
import com.fasterxml.jackson.annotation.JsonFormat;
import com.ruoyi.framework.aspectj.lang.annotation.Excel;
import io.swagger.annotations.ApiModelProperty;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
import org.springframework.format.annotation.DateTimeFormat;

@@ -18,49 +18,49 @@
public class ShipmentApproval {
    @TableId(type = IdType.AUTO)
    private Long id;
    @ApiModelProperty(value = "发货信息id")
    @Schema(description = "发货信息id")
    private Long shippingInfoId;
    @ApiModelProperty(value = "销售台账id")
    @Schema(description = "销售台账id")
    private Long salesLedgerId;
    @ApiModelProperty(value = "销售报价产品表id")
    @Schema(description = "销售报价产品表id")
    private Long salesLedgerProductId;
     @ApiModelProperty(value = "申请部门id")
     @Schema(description = "申请部门id")
    private Long approveDeptId;

    @ApiModelProperty(value = "申请部门名称")
    @Schema(description = "申请部门名称")
    @Excel(name = "申请部门")
    private String approveDeptName;
     @ApiModelProperty(value = "审批用户id")
     @Schema(description = "审批用户id")
    private Integer approveUserId;
    @ApiModelProperty(value = "审批用户名称")
    @Schema(description = "审批用户名称")
    @Excel(name = "审批用户")
    private String approveUserNames;

    /**
     * 审批状态
     */
    @ApiModelProperty(value = "审批状态：0未出库,1已出库,2待审核,3审核完成,4审核失败")
    @Schema(description = "审批状态：0未出库,1已出库,2待审核,3审核完成,4审核失败")
    @Excel(name = "审批状态", readConverterExp = "0=未出库,1=已出库,2=待审核,3=审核完成,4=审核失败")
    private Integer approveStatus;

    @ApiModelProperty(value = "创建时间")
    @Schema(description = "创建时间")
    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createTime;

    @ApiModelProperty(value = "修改时间")
    @Schema(description = "修改时间")
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private LocalDateTime updateTime;

    @ApiModelProperty(value = "创建用户")
    @Schema(description = "创建用户")
    @TableField(fill = FieldFill.INSERT)
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private Integer createUser;

    @ApiModelProperty(value = "修改用户")
    @Schema(description = "修改用户")
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private Integer updateUser;

    @ApiModelProperty(value = "租户ID")
    @Schema(description = "租户ID")
    @TableField(fill = FieldFill.INSERT)
    private Long tenantId;

@@ -176,28 +176,28 @@
    @TableField(exist = false)
    private BigDecimal futureTicketsAmount;

    @ApiModelProperty(value = "开票数")
    @Schema(description = "开票数")
    @TableField(exist = false)
    private BigDecimal invoiceNum;

    @ApiModelProperty(value = "未开票数")
    @Schema(description = "未开票数")
    @TableField(exist = false)
    private BigDecimal noInvoiceNum;

    @ApiModelProperty(value = "开票金额")
    @Schema(description = "开票金额")
    @TableField(exist = false)
    private BigDecimal invoiceAmount;

    @ApiModelProperty(value = "未开票金额")
    @Schema(description = "未开票金额")
    @TableField(exist = false)
    private BigDecimal noInvoiceAmount;

    @ApiModelProperty(value = "本次开票数")
    @Schema(description = "本次开票数")
    @TableField(exist = false)
    private BigDecimal currentInvoiceNum;

    @TableField(exist = false)
    @ApiModelProperty(value = "本次开票金额")
    @Schema(description = "本次开票金额")
    private BigDecimal currentInvoiceAmount;

    /**
@@ -212,31 +212,31 @@
    @TableField(exist = false)
    private Long productModelId;

    @ApiModelProperty(value = "初始未开票数")
    @Schema(description = "初始未开票数")
    @TableField(exist = false)
    private BigDecimal originalNoInvoiceNum;

    @ApiModelProperty(value = "临时未开票数")
    @Schema(description = "临时未开票数")
    @TableField(exist = false)
    private BigDecimal tempNoInvoiceNum;

    @ApiModelProperty(value = "临时未开票金额")
    @Schema(description = "临时未开票金额")
    @TableField(exist = false)
    private BigDecimal tempnoInvoiceAmount;

    @ApiModelProperty(value = "临时未来票数")
    @Schema(description = "临时未来票数")
    @TableField(exist = false)
    private BigDecimal tempFutureTickets;

    @ApiModelProperty(value = "临时未来票金额")
    @Schema(description = "临时未来票金额")
    @TableField(exist = false)
    private BigDecimal tempFutureTicketsAmount;

    @ApiModelProperty("登记人")
    @Schema(description = "登记人")
    @TableField(exist = false)
    private String register;

    @ApiModelProperty("登记日期")
    @Schema(description = "登记日期")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    @Excel(name = "登记日期", width = 30, dateFormat = "yyyy-MM-dd HH:mm:ss")
    @TableField(exist = false)
@@ -295,7 +295,7 @@
    private String entryPerson;

    @TableField(exist = false)
    @ApiModelProperty(value = "录入人")
    @Schema(description = "录入人")
    @Excel(name = "录入人")
    private String entryPersonName;

@@ -321,33 +321,33 @@
    private BigDecimal contractAmount;

    @TableField(exist = false)
    @ApiModelProperty(value = "未开票金额(元)")
    @Schema(description = "未开票金额(元)")
    @Excel(name = "未开票金额")
    private BigDecimal noInvoiceAmountTotal = BigDecimal.ZERO;

    @ApiModelProperty(value = "签订日期")
    @Schema(description = "签订日期")
    @TableField(exist = false)
    private LocalDate executionDate;

    @TableField(exist = false)
    @ApiModelProperty(value = "已开票金额(元)")
    @Schema(description = "已开票金额(元)")
    @Excel(name = "已开票金额")
    private BigDecimal invoiceTotal = BigDecimal.ZERO;

    @TableField(exist = false)
    @ApiModelProperty(value = "回款金额")
    @Schema(description = "回款金额")
    private BigDecimal receiptPaymentAmountTotal = BigDecimal.ZERO;

    @TableField(exist = false)
    @ApiModelProperty(value = "待回款金额")
    @Schema(description = "待回款金额")
    private BigDecimal noReceiptAmount = BigDecimal.ZERO;

    @ApiModelProperty(value = "付款方式")
    @Schema(description = "付款方式")
    @TableField(exist = false)
    private String paymentMethod;

    @TableField(exist = false)
    @ApiModelProperty(value = "生产状态")
    @Schema(description = "生产状态")
    private String productionStatus = "未开始";

    @TableField(fill = FieldFill.INSERT)