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

云

2026-04-23 c247f5bf64c98595cc7e4efc9e1ae7ff1df79c11

 src/main/java/com/ruoyi/officesupplies/pojo/OfficeSupplies.java

@@ -4,8 +4,7 @@
import com.fasterxml.jackson.annotation.JsonFormat;
import com.ruoyi.framework.aspectj.lang.annotation.Excel;
import com.ruoyi.sales.pojo.CommonFile;
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
import org.springframework.format.annotation.DateTimeFormat;

@@ -18,7 +17,7 @@
 * @date : 2025/9/4 14:02
 */
@Data
@ApiModel
@Schema
@TableName("office_supplies")
public class OfficeSupplies {

@@ -27,49 +26,49 @@
    @TableId(value = "id", type = IdType.AUTO)
    private Long id;

    @ApiModelProperty("编号")
    @Schema(description = "编号")
    @Excel(name = "编号")
    private String code;

    @ApiModelProperty("物品名称")
    @Schema(description = "物品名称")
    private String itemName;

    @ApiModelProperty("申请人")
    @Schema(description = "申请人")
    @Excel(name = "申请人")
    private String applicant;

    /**
     * 部门
     */
    @ApiModelProperty("部门")
    @Schema(description = "部门")
    @Excel(name = "部门")
    private String dept;

    /**
     * 物资类型（1-其他 2-清洁用品 3-电子用品 4-电子设备）
     */
    @ApiModelProperty("物资类型（1-其他 2-清洁用品 3-电子用品 4-电子设备）")
    @Schema(description = "物资类型（1-其他 2-清洁用品 3-电子用品 4-电子设备）")
    @Excel(name = "物资类型", readConverterExp = "1=其他,2=清洁用品,3=电子用品,4=电子设备")
    private Integer materialType;

    /**
     * 申请数量
     */
    @ApiModelProperty("申请数量")
    @Schema(description = "申请数量")
    @Excel(name = "申请数量")
    private Integer applyNum;

    /**
     * 审批意见
     */
    @ApiModelProperty("审批意见")
    @Schema(description = "审批意见")
//    @Excel(name = "审批意见")
    private String approvalOpinions;

    /**
     * 申请原因
     */
    @ApiModelProperty("申请原因")
    @Schema(description = "申请原因")
    @Excel(name = "申请原因")
    private String reason;

@@ -77,21 +76,21 @@
    /**
     * 紧急程度（1-普通 2-紧急 3-非常紧急）
     */
    @ApiModelProperty("紧急程度（1-普通 2-紧急 3-非常紧急）")
    @Schema(description = "紧急程度（1-普通 2-紧急 3-非常紧急）")
//    @Excel(name = "紧急程度", readConverterExp = "1=普通,2=紧急,3=非常紧急")
    private Integer urgency;

    /**
     * 状态（1-待审批 2-已拒绝 3-已通过 4-已发放）
     */
    @ApiModelProperty("状态（1-待审批 2-已拒绝 3-已通过 4-已发放）")
    @Schema(description = "状态（1-待审批 2-已拒绝 3-已通过 4-已发放）")
    @Excel(name = "状态", readConverterExp = "1=待审批,2=已拒绝,3=已通过,4=已发放")
    private Integer status;

    /**
     * 申请时间
     */
    @ApiModelProperty("申请时间")
    @Schema(description = "申请时间")
    @Excel(name = "申请时间" , width = 30, dateFormat = "yyyy-MM-dd HH:mm:ss")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
@@ -101,14 +100,14 @@
    /**
     * 审批人
     */
    @ApiModelProperty("审批人")
    @Schema(description = "审批人")
    @Excel(name = "审批人")
    private String approval;

    /**
     * 审批时间
     */
    @ApiModelProperty("审批时间")
    @Schema(description = "审批时间")
    @Excel(name = "审批时间", width = 30, dateFormat = "yyyy-MM-dd HH:mm:ss")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
@@ -117,13 +116,13 @@
    /**
     * 发放时间
     */
    @ApiModelProperty("发放时间")
    @Schema(description = "发放时间")
    @Excel(name = "发放时间", width = 30, dateFormat = "yyyy-MM-dd HH:mm:ss")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private Date issueTime;

    @ApiModelProperty("发放人")
    @Schema(description = "发放人")
//    @Excel(name = "发放人")
    private String issueUser;