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

云

2026-04-23 c247f5bf64c98595cc7e4efc9e1ae7ff1df79c11

 src/main/java/com/ruoyi/warehouse/pojo/Documentation.java

@@ -6,9 +6,9 @@
import java.time.LocalDateTime;
import java.util.Date;

import com.fasterxml.jackson.annotation.JsonFormat;
import com.ruoyi.framework.aspectj.lang.annotation.Excel;
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;

/**
@@ -17,125 +17,127 @@
 */
@TableName(value ="documentation")
@Data
@ApiModel(value = "文档信息表")
@Schema(name = "文档信息表")
public class Documentation implements Serializable {
    /**
     * 
     */
    @TableId(type = IdType.AUTO)
    @ApiModelProperty(value = "文档ID")
    @Schema(description = "文档ID")
    private Long id;

    /**
     * 类别名称
     * 类别名称id
     */
    @Excel(name = "类别名称")
    @ApiModelProperty(value = "类别名称")
    private String categoryName;
    @Excel(name = "类别名称id")
    @Schema(description = "类别名称id")
    private Long documentClassificationId;

    /**
     * 文档名称
     */
    @Excel(name = "文档名称")
    @ApiModelProperty(value = "文档名称")
    @Schema(description = "文档名称")
    private String docName;

    /**
     * 文档编号
     */
    @Excel(name = "文档编号")
    @ApiModelProperty(value = "文档编号")
    private Long docNumber;
    @Schema(description = "文档编号")
    private String docNumber;

    /**
     * 年份
     */
    @Excel(name = "年份")
    @ApiModelProperty(value = "年份")
    @Schema(description = "年份")
    private Long year;

    /**
     * 责任人
     */
    @Excel(name = "责任人")
    @ApiModelProperty(value = "责任人")
    @Schema(description = "责任人")
    private String responsiblePerson;

    /**
     * 文档放置位置
     */
    @Excel(name = "文档放置位置")
    @ApiModelProperty(value = "文档放置位置")
    @Schema(description = "文档放置位置")
    private Long warehouseGoodsShelvesRowcolId;

    /**
     * 文档日期
     */
    @Excel(name = "文档日期")
    @ApiModelProperty(value = "文档日期")

    @Excel(name = "文档日期", dateFormat = "yyyy-MM-dd", width = 30)
    @Schema(description = "文档日期")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
    private LocalDateTime docDate;

    /**
     * 保管期限
     */
    @Excel(name = "保管期限")
    @ApiModelProperty(value = "保管期限")
    @Schema(description = "保管期限")
    private Long retentionPeriod;

    /**
     * 保密级别
     */
    @Excel(name = "保密级别")
    @ApiModelProperty(value = "保密级别")
    @Schema(description = "保密级别")
    private String securityLevel;

    /**
     * 份数
     */
    @Excel(name = "份数")
    @ApiModelProperty(value = "份数")
    @Schema(description = "份数")
    private Long copyCount;

    /**
     * 页数
     */
    @Excel(name = "页数")
    @ApiModelProperty(value = "页数")
    @Schema(description = "页数")
    private Long pageCount;

    /**
     * 文档类别
     */
    @Excel(name = "文档类别")
    @ApiModelProperty(value = "文档类别")
    @Schema(description = "文档类别")
    private String docCategory;

    /**
     * 文档种类
     */
    @Excel(name = "文档种类")
    @ApiModelProperty(value = "文档种类")
    @Schema(description = "文档种类")
    private String docType;

    /**
     * 紧急程度
     */
    @Excel(name = "紧急程度")
    @ApiModelProperty(value = "紧急程度")
    @Schema(description = "紧急程度")
    private String urgencyLevel;

    /**
     * 文档状态
     */
    @Excel(name = "文档状态")
    @ApiModelProperty(value = "文档状态")
    @Schema(description = "文档状态")
    private String docStatus;

    /**
     * 备注
     */
    @Excel(name = "备注")
    @ApiModelProperty(value = "备注")
    @Schema(description = "备注")
    private String remark;

    /**
@@ -148,19 +150,19 @@
     * 创建用户
     */
    @TableField(fill = FieldFill.INSERT)
    private Long createUser;
    private Integer createUser;

    /**
     * 修改时间
     */
    @TableField(fill = FieldFill.UPDATE)
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private LocalDateTime updateTime;

    /**
     * 修改用户
     */
    @TableField(fill = FieldFill.UPDATE)
    private Long updateUser;
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private Integer updateUser;

    /**
     * 租户ID
@@ -169,4 +171,7 @@
    private Long tenantId;

    private static final long serialVersionUID = 1L;

    @TableField(fill = FieldFill.INSERT)
    private Long deptId;
}