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

云

2026-04-23 c247f5bf64c98595cc7e4efc9e1ae7ff1df79c11

 src/main/java/com/ruoyi/purchase/pojo/PurchaseReturnOrders.java

@@ -11,9 +11,7 @@
import java.time.LocalDateTime;

import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import io.swagger.models.auth.In;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Getter;
import lombok.Setter;
import org.springframework.format.annotation.DateTimeFormat;
@@ -29,7 +27,7 @@
@Getter
@Setter
@TableName("purchase_return_orders")
@ApiModel(value = "PurchaseReturnOrders对象", description = "采购退货单")
@Schema(name = "PurchaseReturnOrders对象", description = "采购退货单")
public class PurchaseReturnOrders implements Serializable {

    private static final long serialVersionUID = 1L;
@@ -37,65 +35,65 @@
    @TableId(value = "id", type = IdType.AUTO)
    private Long id;

    @ApiModelProperty("退货单编号")
    @Schema(description = "退货单编号")
    private String no;

    @ApiModelProperty("退货方式 0退货退款 1拒收")
    @Schema(description = "退货方式 0退货退款 1拒收")
    private Integer returnType;

    @ApiModelProperty("供应商id")
    @Schema(description = "供应商id")
    private Long supplierId;

    @ApiModelProperty("项目id")
    @Schema(description = "项目id")
    private Long projectId;

    @ApiModelProperty("项目阶段")
    @Schema(description = "项目阶段")
    private Integer projectPhase;

    @ApiModelProperty("制单日期")
    @Schema(description = "制单日期")
    @JsonFormat(pattern = "yyyy-MM-dd")
    private LocalDate preparedAt;

    @ApiModelProperty("制单人id")
    @Schema(description = "制单人id")
    private Long preparedUserId;

    @ApiModelProperty("制单人名称")
    @Schema(description = "制单人名称")
    private String preparedUserName;

    @ApiModelProperty("退料人id")
    @Schema(description = "退料人id")
    private Long returnUserId;

    @ApiModelProperty("退料人名称")
    @Schema(description = "退料人名称")
    private String returnUserName;

    @ApiModelProperty("采购订单id")
    @Schema(description = "采购订单id")
    private Long purchaseLedgerId;

    @ApiModelProperty("备注")
    @Schema(description = "备注")
    private String remark;

    @ApiModelProperty("'整单折扣额'")
    @Schema(description = "'整单折扣额'")
    private BigDecimal totalDiscountAmount;

    @ApiModelProperty("'整单折扣率'")
    @Schema(description = "'整单折扣率'")
    private BigDecimal totalDiscountRate;

    @ApiModelProperty("'成交金额'")
    @Schema(description = "'成交金额'")
    private BigDecimal totalAmount;

    @ApiModelProperty("录入时间")
    @Schema(description = "录入时间")
    @TableField(fill = FieldFill.INSERT)
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private LocalDateTime createTime;

    @ApiModelProperty("更新时间")
    @Schema(description = "更新时间")
    @TableField(fill = FieldFill.INSERT_UPDATE)
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private LocalDateTime updateTime;

    @ApiModelProperty("收入类型")
    @Schema(description = "收入类型")
    @TableField(value = "income_type")
    private Integer incomeType;