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

云

2026-04-23 c247f5bf64c98595cc7e4efc9e1ae7ff1df79c11

 src/main/java/com/ruoyi/staff/pojo/StaffSalaryMain.java

@@ -11,8 +11,7 @@
import java.util.List;

import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Getter;
import lombok.Setter;

@@ -27,7 +26,7 @@
@Getter
@Setter
@TableName("staff_salary_main")
@ApiModel(value = "StaffSalaryMain对象", description = "员工工资主表")
@Schema(name = "StaffSalaryMain对象", description = "员工工资主表")
public class StaffSalaryMain implements Serializable {

    private static final long serialVersionUID = 1L;
@@ -35,59 +34,59 @@
    @TableField(exist = false)
    private List<StaffSalaryDetail> staffSalaryDetailList;

    @ApiModelProperty("主键ID")
    @Schema(description = "主键ID")
    @TableId(value = "id", type = IdType.AUTO)
    private Long id;

    @ApiModelProperty("审核人Id")
    @Schema(description = "审核人Id")
    private Long auditUserId;

    @ApiModelProperty("审核人名称")
    @Schema(description = "审核人名称")
    private String auditUserName;

    @ApiModelProperty("工资主题")
    @Schema(description = "工资主题")
    private String salaryTitle;

    @ApiModelProperty("关联部门ID，多个用逗号分隔")
    @Schema(description = "关联部门ID，多个用逗号分隔")
    private String deptIds;

    @ApiModelProperty("工资月份，格式：yyyy-MM")
    @Schema(description = "工资月份，格式：yyyy-MM")
    private String salaryMonth;

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

    @ApiModelProperty("状态：1-草稿 2-审核未通过 3-待审核 4-待发放 5-已发放")
    @Schema(description = "状态：1-草稿 2-审核未通过 3-待审核 4-待发放 5-已发放")
    private Integer status;

    @ApiModelProperty("工资总额")
    @Schema(description = "工资总额")
    private BigDecimal totalSalary;

    @ApiModelProperty("支付银行")
    @Schema(description = "支付银行")
    private String payBank;

    @TableField(exist = false)
    @ApiModelProperty("创建人")
    @Schema(description = "创建人")
    private String createUserName;

    @ApiModelProperty("发放时间")
    @Schema(description = "发放时间")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8",shape = JsonFormat.Shape.STRING)
    private LocalDateTime payTime;

    @ApiModelProperty("创建时间")
    @Schema(description = "创建时间")
    @TableField(fill = FieldFill.INSERT)
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8",shape = JsonFormat.Shape.STRING)
    private LocalDateTime createTime;

    @ApiModelProperty("创建用户")
    @Schema(description = "创建用户")
    @TableField(fill = FieldFill.INSERT)
    private Long createUser;

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

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