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

云

2026-04-23 c247f5bf64c98595cc7e4efc9e1ae7ff1df79c11

 src/main/java/com/ruoyi/home/dto/ProductCategoryDistributionDto.java

@@ -1,8 +1,7 @@
package com.ruoyi.home.dto;

import com.ruoyi.dto.MapDto;
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;

import java.util.List;
@@ -11,39 +10,39 @@
 * 产品大类分布统计DTO
 */
@Data
@ApiModel("产品大类分布统计")
@Schema(name = "产品大类分布统计")
public class ProductCategoryDistributionDto {

    @ApiModelProperty("大类分布列表")
    @Schema(description = "大类分布列表")
    private List<MajorCategoryDto> items;

    @Data
    public static class MajorCategoryDto {
        @ApiModelProperty("大类名称")
        @Schema(description = "大类名称")
        private String name;

        @ApiModelProperty("库存总数")
        @Schema(description = "库存总数")
        private String value;

        @ApiModelProperty("占比")
        @Schema(description = "占比")
        private String rate;

        @ApiModelProperty("小类分布详情")
        @Schema(description = "小类分布详情")
        private List<MinorCategoryDto> children;
    }

    @Data
    public static class MinorCategoryDto {
        @ApiModelProperty("小类名称")
        @Schema(description = "小类名称")
        private String name;

        @ApiModelProperty("库存数量")
        @Schema(description = "库存数量")
        private String value;

        @ApiModelProperty("占比")
        @Schema(description = "占比")
        private String rate;

        @ApiModelProperty("型号分布详情")
        @Schema(description = "型号分布详情")
        private List<MapDto> children;
    }
}