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

云

2026-04-23 c247f5bf64c98595cc7e4efc9e1ae7ff1df79c11

 src/main/java/com/ruoyi/aftersalesservice/pojo/AfterSalesService.java

@@ -1,13 +1,16 @@
package com.ruoyi.aftersalesservice.pojo;

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

import java.math.BigDecimal;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.util.Date;

/**
 * @author :yys
@@ -15,7 +18,7 @@
 */
@Data
@TableName("after_sales_service")
@ApiModel
@Schema
public class AfterSalesService {

    private static final long serialVersionUID = 1L;
@@ -26,62 +29,81 @@
    /**
     * 状态 1-待处理 2-已处理
     */
    @ApiModelProperty("状态 1-待处理 2-已处理")
    @Schema(description = "状态 1-待处理 2-已处理")
    private Integer status;

    @Schema(description = "售后单号")
    private String afterSalesServiceNo;


    @Excel(name = "状态", readConverterExp = "1=待处理,2=已处理")
    @TableField(exist = false)
    private String statusName;

    /**
     * 登记人
     */
    @ApiModelProperty("登记人")
    @Schema(description = "登记人")
    private Long checkUserId;

    /**
     * 登记人名称
     */
    @ApiModelProperty("登记人名称")
    @Schema(description = "登记人名称")
    @Excel(name = "登记人名称")
    private String checkNickName;

    /**
     * 处理人
     */
    @ApiModelProperty("处理人")
    @Schema(description = "处理人")
    private Long disposeUserId;

    /**
     * 处理人名称
     */
    @ApiModelProperty("处理人名称")
    @Schema(description = "处理人名称")
    @Excel(name = "处理人名称")
    private String disposeNickName;

    /**
     * 客户名称
     */
    @ApiModelProperty("客户名称")
    @Schema(description = "客户名称")
    @Excel(name = "客户名称")
    private String customerName;

    /**
     * 问题描述
     */
    @ApiModelProperty("问题描述")
    @Schema(description = "问题描述")
    @Excel(name = "问题描述")
    private String proDesc;

    /**
     * 处理结果
     */
    @ApiModelProperty("处理结果")
    @Schema(description = "处理结果")
    @Excel(name = "处理结果")
    private String disRes;

    /**
     * 反馈日期
     */
    @ApiModelProperty("反馈日期")
    private LocalDate feedbackDate;
    @Schema(description = "反馈日期")
    @JsonFormat(pattern = "yyyy-MM-dd")
    @DateTimeFormat(pattern = "yyyy-MM-dd")
    @Excel(name = "反馈日期", width = 30, dateFormat = "yyyy-MM-dd")
    private Date feedbackDate;

    /**
     * 处理日期
     */
    @ApiModelProperty("处理日期")
    private LocalDate disDate;
    @Schema(description = "处理日期")
    @JsonFormat(pattern = "yyyy-MM-dd")
    @DateTimeFormat(pattern = "yyyy-MM-dd")
    @Excel(name = "处理日期", width = 30, dateFormat = "yyyy-MM-dd")
    private Date disDate;


    /**
@@ -115,9 +137,29 @@
    private Long tenantId;

    @TableField(exist = false)
    @ApiModelProperty("部门名称")
    @Schema(description = "部门名称")
    private String deptName;


    @Schema(description = "售后类型")
    private String serviceType;

    @Schema(description = "紧急程度")
    private String urgency;

    @Schema(description = "销售台账ID")
    private Long salesLedgerId;

    @Schema(description = "分配人ID")
    private Long distributionUserId;


    @Schema(description = "产品型号IDs")
    private String productModelIds;




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