feat: knife4j springdoc

This commit is contained in:
xingyu
2022-12-22 00:25:22 +08:00
parent 69420c0a9c
commit cacefb4eea
385 changed files with 1939 additions and 1941 deletions

View File

@@ -11,22 +11,22 @@ import javax.validation.constraints.NotNull;
@Data
public class ProductBrandBaseVO {
@Schema(title = "品牌名称", required = true, example = "芋道")
@Schema(description = "品牌名称", required = true, example = "芋道")
@NotNull(message = "品牌名称不能为空")
private String name;
@Schema(title = "品牌图片", required = true)
@Schema(description = "品牌图片", required = true)
@NotNull(message = "品牌图片不能为空")
private String picUrl;
@Schema(title = "品牌排序", required = true, example = "1")
@Schema(description = "品牌排序", required = true, example = "1")
@NotNull(message = "品牌排序不能为空")
private Integer sort;
@Schema(title = "品牌描述", example = "描述")
@Schema(description = "品牌描述", example = "描述")
private String description;
@Schema(title = "状态", required = true, example = "0")
@Schema(description = "状态", required = true, example = "0")
@NotNull(message = "状态不能为空")
private Integer status;

View File

@@ -2,7 +2,7 @@ package cn.iocoder.yudao.module.product.controller.admin.brand.vo;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.*;
@Schema(title = "管理后台 - 商品品牌创建 Request VO")
@Schema(description = "管理后台 - 商品品牌创建 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)

View File

@@ -3,11 +3,11 @@ package cn.iocoder.yudao.module.product.controller.admin.brand.vo;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
@Schema(title = "管理后台 - 商品品牌分页 Request VO")
@Schema(description = "管理后台 - 商品品牌分页 Request VO")
@Data
public class ProductBrandListReqVO {
@Schema(title = "品牌名称", example = "芋道")
@Schema(description = "品牌名称", example = "芋道")
private String name;
}

View File

@@ -11,20 +11,20 @@ import java.time.LocalDateTime;
import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
@Schema(title = "管理后台 - 商品品牌分页 Request VO")
@Schema(description = "管理后台 - 商品品牌分页 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class ProductBrandPageReqVO extends PageParam {
@Schema(title = "品牌名称", example = "芋道")
@Schema(description = "品牌名称", example = "芋道")
private String name;
@Schema(title = "状态", example = "0", description = "参考 CommonStatusEnum 枚举")
@Schema(description = "状态-参考 CommonStatusEnum 枚举", example = "0")
private Integer status;
@DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
@Schema(title = "创建时间")
@Schema(description = "创建时间")
private LocalDateTime[] createTime;
}

View File

@@ -7,16 +7,16 @@ import lombok.ToString;
import java.time.LocalDateTime;
@Schema(title = "管理后台 - 品牌 Response VO")
@Schema(description = "管理后台 - 品牌 Response VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class ProductBrandRespVO extends ProductBrandBaseVO {
@Schema(title = "品牌编号", required = true, example = "1")
@Schema(description = "品牌编号", required = true, example = "1")
private Long id;
@Schema(title = "创建时间", required = true)
@Schema(description = "创建时间", required = true)
private LocalDateTime createTime;
}

View File

@@ -3,13 +3,13 @@ import io.swagger.v3.oas.annotations.media.Schema;
import lombok.*;
import javax.validation.constraints.*;
@Schema(title = "管理后台 - 商品品牌更新 Request VO")
@Schema(description = "管理后台 - 商品品牌更新 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class ProductBrandUpdateReqVO extends ProductBrandBaseVO {
@Schema(title = "品牌编号", required = true, example = "1")
@Schema(description = "品牌编号", required = true, example = "1")
@NotNull(message = "品牌编号不能为空")
private Long id;

View File

@@ -12,25 +12,25 @@ import javax.validation.constraints.NotNull;
@Data
public class ProductCategoryBaseVO {
@Schema(title = "父分类编号", required = true, example = "1")
@Schema(description = "父分类编号", required = true, example = "1")
@NotNull(message = "父分类编号不能为空")
private Long parentId;
@Schema(title = "分类名称", required = true, example = "办公文具")
@Schema(description = "分类名称", required = true, example = "办公文具")
@NotBlank(message = "分类名称不能为空")
private String name;
@Schema(title = "分类图片", required = true)
@Schema(description = "分类图片", required = true)
@NotBlank(message = "分类图片不能为空")
private String picUrl;
@Schema(title = "分类排序", required = true, example = "1")
@Schema(description = "分类排序", required = true, example = "1")
private Integer sort;
@Schema(title = "分类描述", required = true, example = "描述")
@Schema(description = "分类描述", required = true, example = "描述")
private String description;
@Schema(title = "开启状态", required = true, example = "0")
@Schema(description = "开启状态", required = true, example = "0")
@NotNull(message = "开启状态不能为空")
private Integer status;

View File

@@ -2,7 +2,7 @@ package cn.iocoder.yudao.module.product.controller.admin.category.vo;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.*;
@Schema(title = "管理后台 - 商品分类创建 Request VO")
@Schema(description = "管理后台 - 商品分类创建 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)

View File

@@ -3,11 +3,11 @@ package cn.iocoder.yudao.module.product.controller.admin.category.vo;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
@Schema(title = "管理后台 - 商品分类列表查询 Request VO")
@Schema(description = "管理后台 - 商品分类列表查询 Request VO")
@Data
public class ProductCategoryListReqVO {
@Schema(title = "分类名称", example = "办公文具")
@Schema(description = "分类名称", example = "办公文具")
private String name;
}

View File

@@ -4,16 +4,16 @@ import lombok.*;
import java.time.LocalDateTime;
@Schema(title = "管理后台 - 商品分类 Response VO")
@Schema(description = "管理后台 - 商品分类 Response VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class ProductCategoryRespVO extends ProductCategoryBaseVO {
@Schema(title = "分类编号", required = true, example = "2")
@Schema(description = "分类编号", required = true, example = "2")
private Long id;
@Schema(title = "创建时间", required = true)
@Schema(description = "创建时间", required = true)
private LocalDateTime createTime;
}

View File

@@ -3,13 +3,13 @@ import io.swagger.v3.oas.annotations.media.Schema;
import lombok.*;
import javax.validation.constraints.*;
@Schema(title = "管理后台 - 商品分类更新 Request VO")
@Schema(description = "管理后台 - 商品分类更新 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class ProductCategoryUpdateReqVO extends ProductCategoryBaseVO {
@Schema(title = "分类编号", required = true, example = "2")
@Schema(description = "分类编号", required = true, example = "2")
@NotNull(message = "分类编号不能为空")
private Long id;

View File

@@ -12,22 +12,22 @@ import java.util.List;
* @CreateDate: 2022/7/5 21:29
* @Version: 1.0.0
*/
@Schema(title = "管理后台 - 规格名称详情展示 Request VO")
@Schema(description = "管理后台 - 规格名称详情展示 Request VO")
@Data
@ToString(callSuper = true)
public class ProductPropertyViewRespVO {
@Schema(title = "规格名称id", example = "1")
@Schema(description = "规格名称id", example = "1")
public Long propertyId;
@Schema(title = "规格名称", example = "内存")
@Schema(description = "规格名称", example = "内存")
public String name;
@Schema(title = "规格属性值集合", example = "[{\"v1\":11,\"v2\":\"64G\"},{\"v1\":10,\"v2\":\"32G\"}]")
@Schema(description = "规格属性值集合", example = "[{\"v1\":11,\"v2\":\"64G\"},{\"v1\":10,\"v2\":\"32G\"}]")
public List<Tuple2> propertyValues;
@Data
@Schema(title = "规格属性值元组")
@Schema(description = "规格属性值元组")
public static class Tuple2 {
private final long id;
private final String name;

View File

@@ -9,16 +9,16 @@ import lombok.ToString;
import java.time.LocalDateTime;
import java.util.List;
@Schema(title = "管理后台 - 规格 + 规格值 Response VO")
@Schema(description = "管理后台 - 规格 + 规格值 Response VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class ProductPropertyAndValueRespVO extends ProductPropertyBaseVO {
@Schema(title = "规格的编号", required = true, example = "1024")
@Schema(description = "规格的编号", required = true, example = "1024")
private Long id;
@Schema(title = "创建时间", required = true)
@Schema(description = "创建时间", required = true)
private LocalDateTime createTime;
/**

View File

@@ -12,14 +12,14 @@ import javax.validation.constraints.NotNull;
@Data
public class ProductPropertyBaseVO {
@Schema(title = "规格名称", required = true, example = "颜色")
@Schema(description = "规格名称", required = true, example = "颜色")
@NotBlank(message = "规格名称不能为空")
private String name;
@Schema(title = "备注", example = "颜色")
@Schema(description = "备注", example = "颜色")
private String remark;
@Schema(title = "状态", required = true, example = "1", description = "参见 CommonStatusEnum 枚举")
@Schema(description = "状态-参见 CommonStatusEnum 枚举", required = true, example = "1")
@NotNull(message = "状态不能为空")
private Integer status;

View File

@@ -4,7 +4,7 @@ import lombok.Data;
import lombok.EqualsAndHashCode;
import lombok.ToString;
@Schema(title = "管理后台 - 规格名称创建 Request VO")
@Schema(description = "管理后台 - 规格名称创建 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)

View File

@@ -4,15 +4,15 @@ import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
import lombok.ToString;
@Schema(title = "管理后台 - 规格名称 List Request VO")
@Schema(description = "管理后台 - 规格名称 List Request VO")
@Data
@ToString(callSuper = true)
public class ProductPropertyListReqVO {
@Schema(title = "规格名称", example = "颜色")
@Schema(description = "规格名称", example = "颜色")
private String name;
@Schema(title = "状态", required = true, example = "1", description = "参见 CommonStatusEnum 枚举")
@Schema(description = "状态,参见 CommonStatusEnum 枚举", required = true, example = "1")
private Integer status;
}

View File

@@ -11,20 +11,20 @@ import java.time.LocalDateTime;
import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
@Schema(title = "管理后台 - 规格名称分页 Request VO")
@Schema(description = "管理后台 - 规格名称分页 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class ProductPropertyPageReqVO extends PageParam {
@Schema(title = "规格名称", example = "颜色")
@Schema(description = "规格名称", example = "颜色")
private String name;
@Schema(title = "状态", required = true, example = "1", description = "参见 CommonStatusEnum 枚举")
@Schema(description = "状态,参见 CommonStatusEnum 枚举", required = true, example = "1")
private Integer status;
@DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
@Schema(title = "创建时间")
@Schema(description = "创建时间")
private LocalDateTime[] createTime;
}

View File

@@ -7,16 +7,16 @@ import lombok.ToString;
import java.time.LocalDateTime;
@Schema(title = "管理后台 - 规格 + 规格值 Response VO")
@Schema(description = "管理后台 - 规格 + 规格值 Response VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class ProductPropertyRespVO extends ProductPropertyBaseVO {
@Schema(title = "规格的编号", required = true, example = "1024")
@Schema(description = "规格的编号", required = true, example = "1024")
private Long id;
@Schema(title = "创建时间", required = true)
@Schema(description = "创建时间", required = true)
private LocalDateTime createTime;
}

View File

@@ -3,13 +3,13 @@ import io.swagger.v3.oas.annotations.media.Schema;
import lombok.*;
import javax.validation.constraints.*;
@Schema(title = "管理后台 - 规格名称更新 Request VO")
@Schema(description = "管理后台 - 规格名称更新 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class ProductPropertyUpdateReqVO extends ProductPropertyBaseVO {
@Schema(title = "主键", required = true, example = "1")
@Schema(description = "主键", required = true, example = "1")
@NotNull(message = "主键不能为空")
private Long id;

View File

@@ -12,19 +12,19 @@ import javax.validation.constraints.NotNull;
@Data
public class ProductPropertyValueBaseVO {
@Schema(title = "规格编号", required = true, example = "1024")
@Schema(description = "规格编号", required = true, example = "1024")
@NotNull(message = "规格编号不能为空")
private Long propertyId;
@Schema(title = "规格值名字", required = true, example = "红色")
@Schema(description = "规格值名字", required = true, example = "红色")
@NotEmpty(message = "规格值名字不能为空")
private String name;
@Schema(title = "状态", required = true, example = "1", description = "参见 CommonStatusEnum 枚举")
@Schema(description = "状态,参见 CommonStatusEnum 枚举", required = true, example = "1")
@NotNull(message = "状态不能为空")
private Integer status;
@Schema(title = "备注", example = "颜色")
@Schema(description = "备注", example = "颜色")
private String remark;
}

View File

@@ -2,7 +2,7 @@ package cn.iocoder.yudao.module.product.controller.admin.property.vo.value;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.*;
@Schema(title = "管理后台 - 规格值创建 Request VO")
@Schema(description = "管理后台 - 规格值创建 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)

View File

@@ -12,19 +12,19 @@ import java.util.Date;
import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
@Schema(title = "管理后台 - 规格名称值分页 Request VO")
@Schema(description = "管理后台 - 规格名称值分页 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class ProductPropertyValuePageReqVO extends PageParam {
@Schema(title = "规格id", example = "1024")
@Schema(description = "规格id", example = "1024")
private String propertyId;
@Schema(title = "规格值", example = "红色")
@Schema(description = "规格值", example = "红色")
private String name;
@Schema(title = "状态", required = true, example = "1", description = "参见 CommonStatusEnum 枚举")
@Schema(description = "状态,参见 CommonStatusEnum 枚举", required = true, example = "1")
private Integer status;
}

View File

@@ -7,16 +7,16 @@ import lombok.ToString;
import java.time.LocalDateTime;
@Schema(title = "管理后台 - 规格值 Response VO")
@Schema(description = "管理后台 - 规格值 Response VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class ProductPropertyValueRespVO extends ProductPropertyValueBaseVO {
@Schema(title = "主键", required = true, example = "10")
@Schema(description = "主键", required = true, example = "10")
private Long id;
@Schema(title = "创建时间")
@Schema(description = "创建时间")
private LocalDateTime createTime;
}

View File

@@ -3,13 +3,13 @@ import io.swagger.v3.oas.annotations.media.Schema;
import lombok.*;
import javax.validation.constraints.*;
@Schema(title = "管理后台 - 规格值更新 Request VO")
@Schema(description = "管理后台 - 规格值更新 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class ProductPropertyValueUpdateReqVO extends ProductPropertyValueBaseVO {
@Schema(title = "主键", required = true, example = "1024")
@Schema(description = "主键", required = true, example = "1024")
@NotNull(message = "主键不能为空")
private Long id;

View File

@@ -15,54 +15,54 @@ import javax.validation.constraints.NotNull;
@Data
public class ProductSkuBaseVO {
@Schema(title = "商品 SKU 名字", required = true, example = "芋道")
@Schema(description = "商品 SKU 名字", required = true, example = "芋道")
@NotEmpty(message = "商品 SKU 名字不能为空")
private String name;
@Schema(title = "销售价格,单位:分", required = true, example = "1024", description = "单位:分")
@Schema(description = "销售价格,单位:分", required = true, example = "1024")
@NotNull(message = "销售价格,单位:分不能为空")
private Integer price;
@Schema(title = "市场价", example = "1024", description = "单位:分")
@Schema(description = "市场价,单位:分", example = "1024")
private Integer marketPrice;
@Schema(title = "成本价", example = "1024", description = "单位:分")
@Schema(description = "成本价,单位:分", example = "1024")
private Integer costPrice;
@Schema(title = "条形码", example = "haha")
@Schema(description = "条形码", example = "haha")
private String barCode;
@Schema(title = "图片地址", required = true, example = "https://www.iocoder.cn/xx.png")
@Schema(description = "图片地址", required = true, example = "https://www.iocoder.cn/xx.png")
@NotNull(message = "图片地址不能为空")
private String picUrl;
@Schema(title = "SKU 状态", required = true, example = "1", description = "参见 CommonStatusEnum 枚举")
@Schema(description = "SKU 状态,参见 CommonStatusEnum 枚举", required = true, example = "1")
@NotNull(message = "SKU 状态不能为空")
@InEnum(CommonStatusEnum.class)
private Integer status;
@Schema(title = "库存", required = true, example = "1")
@Schema(description = "库存", required = true, example = "1")
@NotNull(message = "库存不能为空")
private Integer stock;
@Schema(title = "预警预存", example = "1")
@Schema(description = "预警预存", example = "1")
private Integer warnStock;
@Schema(title = "商品重量", example = "1", description = "单位kg 千克")
@Schema(description = "商品重量,单位kg 千克", example = "1")
private Double weight;
@Schema(title = "商品体积", example = "1024", description = "单位m^3 平米")
@Schema(description = "商品体积,单位m^3 平米", example = "1024")
private Double volume;
@Schema(title = "规格值")
@Schema(description = "规格值")
@Data
public static class Property {
@Schema(title = "属性编号", required = true, example = "1")
@Schema(description = "属性编号", required = true, example = "1")
@NotNull(message = "属性编号不能为空")
private Long propertyId;
@Schema(title = "属性值编号", required = true, example = "1024")
@Schema(description = "属性值编号", required = true, example = "1024")
@NotNull(message = "属性值编号不能为空")
private Long valueId;

View File

@@ -7,13 +7,13 @@ import lombok.ToString;
import java.util.List;
@Schema(title = "管理后台 - 商品 SKU 创建/更新 Request VO")
@Schema(description = "管理后台 - 商品 SKU 创建/更新 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class ProductSkuCreateOrUpdateReqVO extends ProductSkuBaseVO {
@Schema(title = "商品 SKU 编号", example = "1")
@Schema(description = "商品 SKU 编号", example = "1")
private Long id;
/**

View File

@@ -3,28 +3,28 @@ package cn.iocoder.yudao.module.product.controller.admin.sku.vo;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
@Schema(title = "管理后台 - 商品 SKU 选项 Response VO", description = "用于前端 SELECT 选项")
@Schema(description = "管理后台 - 商品 SKU 选项 Response VO,用于前端 SELECT 选项")
@Data
public class ProductSkuOptionRespVO {
@Schema(title = "主键", required = true, example = "1024")
@Schema(description = "主键", required = true, example = "1024")
private Long id;
@Schema(title = "商品 SKU 名字", example = "红色")
@Schema(description = "商品 SKU 名字", example = "红色")
private String name;
@Schema(title = "销售价格", required = true, example = "100", description = "单位:分")
@Schema(description = "销售价格,单位:分", required = true, example = "100")
private String price;
@Schema(title = "库存", required = true, example = "100")
@Schema(description = "库存", required = true, example = "100")
private Integer stock;
// ========== 商品 SPU 信息 ==========
@Schema(title = "商品 SPU 编号", required = true, example = "1")
@Schema(description = "商品 SPU 编号", required = true, example = "1")
private Long spuId;
@Schema(title = "商品 SPU 名字", required = true, example = "iPhone 11")
@Schema(description = "商品 SPU 名字", required = true, example = "iPhone 11")
private String spuName;
}

View File

@@ -8,16 +8,16 @@ import lombok.ToString;
import java.time.LocalDateTime;
import java.util.List;
@Schema(title = "管理后台 - 商品 SKU Response VO")
@Schema(description = "管理后台 - 商品 SKU Response VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class ProductSkuRespVO extends ProductSkuBaseVO {
@Schema(title = "主键", required = true, example = "1024")
@Schema(description = "主键", required = true, example = "1024")
private Long id;
@Schema(title = "创建时间")
@Schema(description = "创建时间")
private LocalDateTime createTime;
/**

View File

@@ -17,75 +17,75 @@ import java.util.List;
@Data
public class ProductSpuBaseVO {
@Schema(title = "商品名称", required = true, example = "芋道")
@Schema(description = "商品名称", required = true, example = "芋道")
@NotEmpty(message = "商品名称不能为空")
private String name;
@Schema(title = "商品编码", example = "yudaoyuanma")
@Schema(description = "商品编码", example = "yudaoyuanma")
private String code;
@Schema(title = "促销语", example = "好吃!")
@Schema(description = "促销语", example = "好吃!")
private String sellPoint;
@Schema(title = "商品详情", required = true, example = "我是商品描述")
@Schema(description = "商品详情", required = true, example = "我是商品描述")
@NotNull(message = "商品详情不能为空")
private String description;
@Schema(title = "商品分类编号", required = true, example = "1")
@Schema(description = "商品分类编号", required = true, example = "1")
@NotNull(message = "商品分类编号不能为空")
private Long categoryId;
@Schema(title = "商品品牌编号", example = "1")
@Schema(description = "商品品牌编号", example = "1")
private Long brandId;
@Schema(title = "商品图片的数组", required = true)
@Schema(description = "商品图片的数组", required = true)
@NotNull(message = "商品图片的数组不能为空")
private List<String> picUrls;
@Schema(title = "商品视频", required = true)
@Schema(description = "商品视频", required = true)
private String videoUrl;
@Schema(title = "排序字段", required = true, example = "1")
@Schema(description = "排序字段", required = true, example = "1")
private Integer sort;
@Schema(title = "商品状态", required = true, example = "1", description = "参见 ProductSpuStatusEnum 枚举类")
@Schema(description = "商品状态,参见 ProductSpuStatusEnum 枚举类", required = true, example = "1")
@NotNull(message = "商品状态不能为空")
@InEnum(ProductSpuStatusEnum.class)
private Integer status;
// ========== SKU 相关字段 =========
@Schema(title = "规格类型", required = true, example = "1", description = "参见 ProductSpuSpecTypeEnum 枚举类")
@Schema(description = "规格类型,参见 ProductSpuSpecTypeEnum 枚举类", required = true, example = "1")
@NotNull(message = "规格类型不能为空")
@InEnum(ProductSpuSpecTypeEnum.class)
private Integer specType;
@Schema(title = "是否展示库存", required = true, example = "true")
@Schema(description = "是否展示库存", required = true, example = "true")
@NotNull(message = "是否展示库存不能为空")
private Boolean showStock;
@Schema(title = "库存", required = true, example = "true")
@Schema(description = "库存", required = true, example = "true")
private Integer totalStock;
@Schema(title = "市场价", example = "1024")
@Schema(description = "市场价", example = "1024")
private Integer marketPrice;
@Schema(title = " 最小价格,单位使用:分", required = true, example = "1024")
@Schema(description = " 最小价格,单位使用:分", required = true, example = "1024")
private Integer minPrice;
@Schema(title = "最大价格,单位使用:分", required = true, example = "1024")
@Schema(description = "最大价格,单位使用:分", required = true, example = "1024")
private Integer maxPrice;
// ========== 统计相关字段 =========
@Schema(title = "商品销量", example = "1024")
@Schema(description = "商品销量", example = "1024")
private Integer salesCount;
@Schema(title = "虚拟销量", required = true, example = "1024")
@Schema(description = "虚拟销量", required = true, example = "1024")
@NotNull(message = "虚拟销量不能为空")
private Integer virtualSalesCount;
@Schema(title = "点击量", example = "1024")
@Schema(description = "点击量", example = "1024")
private Integer clickCount;
}

View File

@@ -9,7 +9,7 @@ import lombok.ToString;
import javax.validation.Valid;
import java.util.List;
@Schema(title = "管理后台 - 商品 SPU 创建 Request VO")
@Schema(description = "管理后台 - 商品 SPU 创建 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)

View File

@@ -10,16 +10,16 @@ import lombok.ToString;
import java.time.LocalDateTime;
import java.util.List;
@Schema(title = "管理后台 - 商品 SPU 详细 Response VO", description = "包括关联的 SKU 等信息")
@Schema(description = "管理后台 - 商品 SPU 详细 Response VO,包括关联的 SKU 等信息")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class ProductSpuDetailRespVO extends ProductSpuBaseVO {
@Schema(title = "主键", required = true, example = "1")
@Schema(description = "主键", required = true, example = "1")
private Long id;
@Schema(title = "创建时间")
@Schema(description = "创建时间")
private LocalDateTime createTime;
/**
@@ -27,7 +27,7 @@ public class ProductSpuDetailRespVO extends ProductSpuBaseVO {
*/
private List<Sku> skus;
@Schema(title = "管理后台 - 商品 SKU 详细 Response VO")
@Schema(description = "管理后台 - 商品 SKU 详细 Response VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
@@ -40,25 +40,25 @@ public class ProductSpuDetailRespVO extends ProductSpuBaseVO {
}
@Schema(title = "管理后台 - 商品规格的详细 Response VO")
@Schema(description = "管理后台 - 商品规格的详细 Response VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public static class Property extends ProductSkuBaseVO.Property {
@Schema(title = "规格的名字", required = true, example = "颜色")
@Schema(description = "规格的名字", required = true, example = "颜色")
private String propertyName;
@Schema(title = "规格值的名字", required = true, example = "蓝色")
@Schema(description = "规格值的名字", required = true, example = "蓝色")
private String valueName;
}
@Schema(title = "分类 id 数组,一直递归到一级父节点", example = "4")
@Schema(description = "分类 id 数组,一直递归到一级父节点", example = "4")
private Long categoryId;
// TODO @芋艿:在瞅瞅~
@Schema(title = "规格属性修改和详情展示组合", example = "[{\"propertyId\":2,\"name\":\"内存\",\"propertyValues\":[{\"v1\":11,\"v2\":\"64G\"},{\"v1\":10,\"v2\":\"32G\"}]},{\"propertyId\":3,\"name\":\"尺寸\",\"propertyValues\":[{\"v1\":16,\"v2\":\"6.1\"},{\"v1\":15,\"v2\":\"5.7\"}]}]")
@Schema(description = "规格属性修改和详情展示组合", example = "[{\"propertyId\":2,\"name\":\"内存\",\"propertyValues\":[{\"v1\":11,\"v2\":\"64G\"},{\"v1\":10,\"v2\":\"32G\"}]},{\"propertyId\":3,\"name\":\"尺寸\",\"propertyValues\":[{\"v1\":16,\"v2\":\"6.1\"},{\"v1\":15,\"v2\":\"5.7\"}]}]")
private List<ProductPropertyViewRespVO> productPropertyViews;
}

View File

@@ -6,40 +6,40 @@ import lombok.Data;
import lombok.EqualsAndHashCode;
import lombok.ToString;
@Schema(title = "管理后台 - 商品 SPU 分页 Request VO")
@Schema(description = "管理后台 - 商品 SPU 分页 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class ProductSpuPageReqVO extends PageParam {
@Schema(title = "商品名称", example = "yutou")
@Schema(description = "商品名称", example = "yutou")
private String name;
@Schema(title = "商品编码", example = "yudaoyuanma")
@Schema(description = "商品编码", example = "yudaoyuanma")
private String code;
@Schema(title = "分类id", example = "1")
@Schema(description = "分类id", example = "1")
private Long categoryId;
@Schema(title = "商品品牌编号", example = "1")
@Schema(description = "商品品牌编号", example = "1")
private Long brandId;
@Schema(title = "上下架状态", example = "1", description = "参见 ProductSpuStatusEnum 枚举值")
@Schema(description = "上下架状态,参见 ProductSpuStatusEnum 枚举值", example = "1")
private Integer status;
@Schema(title = "销量最小值", example = "1")
@Schema(description = "销量最小值", example = "1")
private Integer salesCountMin;
@Schema(title = "销量最大值", example = "1024")
@Schema(description = "销量最大值", example = "1024")
private Integer salesCountMax;
@Schema(title = "市场价最小值", example = "1")
@Schema(description = "市场价最小值", example = "1")
private Integer marketPriceMin;
@Schema(title = "市场价最大值", example = "1024")
@Schema(description = "市场价最大值", example = "1024")
private Integer marketPriceMax;
@Schema(title = "是否库存告警", example = "true")
@Schema(description = "是否库存告警", example = "true")
private Boolean alarmStock;
}

View File

@@ -8,16 +8,16 @@ import lombok.ToString;
import java.time.LocalDateTime;
import java.util.List;
@Schema(title = "管理后台 - 商品 SPU Response VO")
@Schema(description = "管理后台 - 商品 SPU Response VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class ProductSpuRespVO extends ProductSpuBaseVO {
@Schema(title = "主键", required = true, example = "1")
@Schema(description = "主键", required = true, example = "1")
private Long id;
@Schema(title = "创建时间")
@Schema(description = "创建时间")
private LocalDateTime createTime;
}

View File

@@ -5,22 +5,22 @@ import lombok.Data;
import lombok.EqualsAndHashCode;
import lombok.ToString;
@Schema(title = "管理后台 - 商品 SPU 精简 Response VO")
@Schema(description = "管理后台 - 商品 SPU 精简 Response VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class ProductSpuSimpleRespVO extends ProductSpuBaseVO {
@Schema(title = "主键", required = true, example = "1")
@Schema(description = "主键", required = true, example = "1")
private Long id;
@Schema(title = "商品名称", required = true, example = "芋道")
@Schema(description = "商品名称", required = true, example = "芋道")
private String name;
@Schema(title = " 最小价格,单位使用:分", required = true, example = "1024")
@Schema(description = " 最小价格,单位使用:分", required = true, example = "1024")
private Integer minPrice;
@Schema(title = "最大价格,单位使用:分", required = true, example = "1024")
@Schema(description = "最大价格,单位使用:分", required = true, example = "1024")
private Integer maxPrice;
}

View File

@@ -10,13 +10,13 @@ import javax.validation.Valid;
import javax.validation.constraints.NotNull;
import java.util.List;
@Schema(title = "管理后台 - 商品 SPU 更新 Request VO")
@Schema(description = "管理后台 - 商品 SPU 更新 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class ProductSpuUpdateReqVO extends ProductSpuBaseVO {
@Schema(title = "商品编号", required = true, example = "1")
@Schema(description = "商品编号", required = true, example = "1")
@NotNull(message = "商品编号不能为空")
private Long id;

View File

@@ -7,21 +7,21 @@ import javax.validation.constraints.NotBlank;
import javax.validation.constraints.NotNull;
@Data
@Schema(title = "用户 APP - 商品分类 Response VO")
@Schema(description = "用户 APP - 商品分类 Response VO")
public class AppCategoryRespVO {
@Schema(title = "分类编号", required = true, example = "2")
@Schema(description = "分类编号", required = true, example = "2")
private Long id;
@Schema(title = "父分类编号", required = true, example = "1")
@Schema(description = "父分类编号", required = true, example = "1")
@NotNull(message = "父分类编号不能为空")
private Long parentId;
@Schema(title = "分类名称", required = true, example = "办公文具")
@Schema(description = "分类名称", required = true, example = "办公文具")
@NotBlank(message = "分类名称不能为空")
private String name;
@Schema(title = "分类图片", required = true)
@Schema(description = "分类图片", required = true)
@NotBlank(message = "分类图片不能为空")
private String picUrl;

View File

@@ -6,12 +6,12 @@ import lombok.Data;
import lombok.EqualsAndHashCode;
import lombok.ToString;
@Schema(title = "App - 商品spu分页 Request VO")
@Schema(description = "App - 商品spu分页 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class AppSpuPageReqVO extends PageParam {
@Schema(title = "分类id")
@Schema(description = "分类id")
private Long categoryId;
}

View File

@@ -6,46 +6,46 @@ import lombok.Data;
import javax.validation.constraints.NotNull;
import java.util.List;
@Schema(title = "App - 商品spu分页 Request VO")
@Schema(description = "App - 商品spu分页 Request VO")
@Data
public class AppSpuPageRespVO {
@Schema(title = "主键", required = true, example = "1")
@Schema(description = "主键", required = true, example = "1")
private Long id;
@Schema(title = "商品名称")
@Schema(description = "商品名称")
private String name;
@Schema(title = "卖点", required = true)
@Schema(description = "卖点", required = true)
@NotNull(message = "卖点不能为空")
private String sellPoint;
@Schema(title = "描述", required = true)
@Schema(description = "描述", required = true)
@NotNull(message = "描述不能为空")
private String description;
@Schema(title = "分类id", required = true)
@Schema(description = "分类id", required = true)
@NotNull(message = "分类id不能为空")
private Long categoryId;
@Schema(title = "商品主图地址,* 数组,以逗号分隔,最多上传15张", required = true)
@Schema(description = "商品主图地址,* 数组,以逗号分隔,最多上传15张", required = true)
@NotNull(message = "商品主图地址,* 数组,以逗号分隔,最多上传15张不能为空")
private List<String> picUrls;
@Schema(title = "排序字段", required = true)
@Schema(description = "排序字段", required = true)
@NotNull(message = "排序字段不能为空")
private Integer sort;
@Schema(title = "点赞初始人数")
@Schema(description = "点赞初始人数")
private Integer likeCount;
@Schema(title = "价格 单位使用:分")
@Schema(description = "价格 单位使用:分")
private Integer price;
@Schema(title = "库存数量")
@Schema(description = "库存数量")
private Integer quantity;
@Schema(title = "上下架状态: 0 上架(开启) 1 下架(禁用)")
@Schema(description = "上下架状态: 0 上架(开启) 1 下架(禁用)")
private Integer status;
}

View File

@@ -12,7 +12,7 @@ import lombok.EqualsAndHashCode;
*
* @author LuoWenFeng
*/
@Schema(title = "App - 商品spu Response VO")
@Schema(description = "App - 商品spu Response VO")
@Data
@EqualsAndHashCode(callSuper = true)
public class AppSpuRespVO extends ProductSpuRespVO {

View File

@@ -15,28 +15,28 @@ import javax.validation.constraints.NotNull;
@Data
public class BannerBaseVO {
@Schema(title = "标题", required = true)
@Schema(description = "标题", required = true)
@NotNull(message = "标题不能为空")
private String title;
@Schema(title = "跳转链接", required = true)
@Schema(description = "跳转链接", required = true)
@NotNull(message = "跳转链接不能为空")
private String url;
@Schema(title = "图片地址", required = true)
@Schema(description = "图片地址", required = true)
@NotNull(message = "图片地址不能为空")
private String picUrl;
@Schema(title = "排序", required = true)
@Schema(description = "排序", required = true)
@NotNull(message = "排序不能为空")
private Integer sort;
@Schema(title = "状态", required = true)
@Schema(description = "状态", required = true)
@NotNull(message = "状态不能为空")
@InEnum(CommonStatusEnum.class)
private Integer status;
@Schema(title = "备注")
@Schema(description = "备注")
private String memo;
}

View File

@@ -7,7 +7,7 @@ import lombok.ToString;
/**
* @author xia
*/
@Schema(title = "管理后台 - Banner 创建 Request VO")
@Schema(description = "管理后台 - Banner 创建 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)

View File

@@ -16,22 +16,22 @@ import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_
/**
* @author xia
*/
@Schema(title = "管理后台 - Banner 分页 Request VO")
@Schema(description = "管理后台 - Banner 分页 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class BannerPageReqVO extends PageParam {
@Schema(title = "标题")
@Schema(description = "标题")
private String title;
@Schema(title = "状态")
@Schema(description = "状态")
@InEnum(CommonStatusEnum.class)
private Integer status;
@DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
@Schema(title = "创建时间")
@Schema(description = "创建时间")
private LocalDateTime[] createTime;
}

View File

@@ -10,16 +10,16 @@ import java.time.LocalDateTime;
/**
* @author xia
*/
@Schema(title = "管理后台 - Banner Response VO")
@Schema(description = "管理后台 - Banner Response VO")
@Data
@ToString(callSuper = true)
public class BannerRespVO extends BannerBaseVO {
@Schema(title = "banner编号", required = true)
@Schema(description = "banner编号", required = true)
@NotNull(message = "banner编号不能为空")
private Long id;
@Schema(title = "创建时间", required = true)
@Schema(description = "创建时间", required = true)
private LocalDateTime createTime;
}

View File

@@ -10,13 +10,13 @@ import javax.validation.constraints.NotNull;
/**
* @author xia
*/
@Schema(title = "管理后台 - Banner更新 Request VO")
@Schema(description = "管理后台 - Banner更新 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class BannerUpdateReqVO extends BannerBaseVO {
@Schema(title = "banner 编号", required = true)
@Schema(description = "banner 编号", required = true)
@NotNull(message = "banner 编号不能为空")
private Long id;

View File

@@ -24,76 +24,76 @@ import static cn.iocoder.yudao.framework.common.util.date.DateUtils.TIME_ZONE_DE
public class CouponBaseVO {
// ========== 基本信息 BEGIN ==========
@Schema(title = "优惠劵模板编号", required = true, example = "1024")
@Schema(description = "优惠劵模板编号", required = true, example = "1024")
@NotNull(message = "优惠劵模板编号不能为空")
private Integer templateId;
@Schema(title = "优惠劵名", required = true, example = "春节送送送")
@Schema(description = "优惠劵名", required = true, example = "春节送送送")
@NotNull(message = "优惠劵名不能为空")
private String name;
@Schema(title = "优惠码状态", required = true, example = "1", description = "参见 CouponStatusEnum 枚举")
@Schema(description = "优惠码状态,参见 CouponStatusEnum 枚举", required = true, example = "1")
private Integer status;
// ========== 基本信息 END ==========
// ========== 领取情况 BEGIN ==========
@Schema(title = "用户编号", required = true, example = "1")
@Schema(description = "用户编号", required = true, example = "1")
@NotNull(message = "用户编号不能为空")
private Long userId;
@Schema(title = "领取方式", required = true, example = "1", description = "参见 CouponTakeTypeEnum 枚举类")
@Schema(description = "领取方式,参见 CouponTakeTypeEnum 枚举类", required = true, example = "1")
@NotNull(message = "领取方式不能为空")
private Integer takeType;
// ========== 领取情况 END ==========
// ========== 使用规则 BEGIN ==========
@Schema(title = "是否设置满多少金额可用", required = true, example = "100", description = "单位0 - 不限制")
@Schema(description = "是否设置满多少金额可用,单位0 - 不限制", required = true, example = "100")
@NotNull(message = "是否设置满多少金额可用不能为空")
private Integer usePrice;
@Schema(title = "固定日期 - 生效开始时间")
@Schema(description = "固定日期 - 生效开始时间")
@DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
@JsonFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND, timezone = TIME_ZONE_DEFAULT)
private LocalDateTime validStartTime;
@Schema(title = "固定日期 - 生效结束时间")
@Schema(description = "固定日期 - 生效结束时间")
@DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
@JsonFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND, timezone = TIME_ZONE_DEFAULT)
private LocalDateTime validEndTime;
@Schema(title = "商品范围", required = true, example = "1", description = "参见 PromotionProductScopeEnum 枚举类")
@Schema(description = "商品范围,参见 PromotionProductScopeEnum 枚举类", required = true, example = "1")
@NotNull(message = "商品范围不能为空")
@InEnum(PromotionProductScopeEnum.class)
private Integer productScope;
@Schema(title = "商品 SPU 编号的数组", example = "1,3")
@Schema(description = "商品 SPU 编号的数组", example = "1,3")
private List<Long> productSpuIds;
// ========== 使用规则 END ==========
// ========== 使用效果 BEGIN ==========
@Schema(title = "优惠类型", required = true, example = "1", description = "参见 PromotionDiscountTypeEnum 枚举")
@Schema(description = "优惠类型,参见 PromotionDiscountTypeEnum 枚举", required = true, example = "1")
@NotNull(message = "优惠类型不能为空")
@InEnum(PromotionDiscountTypeEnum.class)
private Integer discountType;
@Schema(title = "折扣百分比", example = "80", description = "例如说80% 为 80")
@Schema(description = "折扣百分比,例如说80% 为 80", example = "80")
private Integer discountPercent;
@Schema(title = "优惠金额", example = "10", description = "单位:分")
@Schema(description = "优惠金额,单位:分", example = "10")
@Min(value = 0, message = "优惠金额需要大于等于 0")
private Integer discountPrice;
@Schema(title = "折扣上限", example = "100", description = "单位:分,仅在 discountType 为 PERCENT 使用")
@Schema(description = "折扣上限,单位:分,仅在 discountType 为 PERCENT 使用", example = "100")
private Integer discountLimitPrice;
// ========== 使用效果 END ==========
// ========== 使用情况 BEGIN ==========
@Schema(title = "使用订单号", example = "4096")
@Schema(description = "使用订单号", example = "4096")
private Long useOrderId;
@Schema(title = "使用时间")
@Schema(description = "使用时间")
@DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
@JsonFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND, timezone = TIME_ZONE_DEFAULT)
private LocalDateTime useTime;

View File

@@ -5,13 +5,13 @@ import lombok.Data;
import lombok.EqualsAndHashCode;
import lombok.ToString;
@Schema(title = "管理后台 - 优惠劵分页的每一项 Response VO")
@Schema(description = "管理后台 - 优惠劵分页的每一项 Response VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class CouponPageItemRespVO extends CouponRespVO {
@Schema(title = "用户昵称", example = "老芋艿")
@Schema(description = "用户昵称", example = "老芋艿")
private String nickname;
}

View File

@@ -11,23 +11,23 @@ import java.time.LocalDateTime;
import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
@Schema(title = "管理后台 - 优惠劵分页 Request VO")
@Schema(description = "管理后台 - 优惠劵分页 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class CouponPageReqVO extends PageParam {
@Schema(title = "优惠劵模板编号", example = "2048")
@Schema(description = "优惠劵模板编号", example = "2048")
private Long templateId;
@Schema(title = "优惠码状态", example = "1", description = "参见 CouponStatusEnum 枚举")
@Schema(description = "优惠码状态,参见 CouponStatusEnum 枚举", example = "1")
private Integer status;
@Schema(title = "创建时间")
@Schema(description = "创建时间")
@DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
private LocalDateTime[] createTime;
@Schema(title = "用户昵称", example = "芋艿", description = "模糊匹配")
@Schema(description = "用户昵称,模糊匹配", example = "芋艿")
private String nickname;
}

View File

@@ -7,16 +7,16 @@ import lombok.ToString;
import java.time.LocalDateTime;
@Schema(title = "管理后台 - 优惠劵 Response VO")
@Schema(description = "管理后台 - 优惠劵 Response VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class CouponRespVO extends CouponBaseVO {
@Schema(title = "优惠劵编号", required = true, example = "1024")
@Schema(description = "优惠劵编号", required = true, example = "1024")
private Long id;
@Schema(title = "创建时间", required = true)
@Schema(description = "创建时间", required = true)
private LocalDateTime createTime;
}

View File

@@ -29,70 +29,70 @@ import static cn.iocoder.yudao.framework.common.util.date.DateUtils.TIME_ZONE_DE
@Data
public class CouponTemplateBaseVO {
@Schema(title = "优惠劵名", required = true, example = "春节送送送")
@Schema(description = "优惠劵名", required = true, example = "春节送送送")
@NotNull(message = "优惠劵名不能为空")
private String name;
@Schema(title = "发行总量", required = true, example = "1024", description = "-1 - 则表示不限制发放数量")
@Schema(description = "发行总量,-1 - 则表示不限制发放数量", required = true, example = "1024")
@NotNull(message = "发行总量不能为空")
private Integer totalCount;
@Schema(title = "每人限领个数", required = true, example = "66", description = "-1 - 则表示不限制")
@Schema(description = "每人限领个数,-1 - 则表示不限制", required = true, example = "66")
@NotNull(message = "每人限领个数不能为空")
private Integer takeLimitCount;
@Schema(title = "领取方式", required = true, example = "1", description = "参见 CouponTakeTypeEnum 枚举类")
@Schema(description = "领取方式,参见 CouponTakeTypeEnum 枚举类", required = true, example = "1")
@NotNull(message = "领取方式不能为空")
private Integer takeType;
@Schema(title = "是否设置满多少金额可用", required = true, example = "100", description = "单位0 - 不限制")
@Schema(description = "是否设置满多少金额可用,单位0 - 不限制", required = true, example = "100")
@NotNull(message = "是否设置满多少金额可用不能为空")
private Integer usePrice;
@Schema(title = "商品范围", required = true, example = "1", description = "参见 PromotionProductScopeEnum 枚举类")
@Schema(description = "商品范围,参见 PromotionProductScopeEnum 枚举类", required = true, example = "1")
@NotNull(message = "商品范围不能为空")
@InEnum(PromotionProductScopeEnum.class)
private Integer productScope;
@Schema(title = "商品 SPU 编号的数组", example = "1,3")
@Schema(description = "商品 SPU 编号的数组", example = "1,3")
private List<Long> productSpuIds;
@Schema(title = "生效日期类型", required = true, example = "1")
@Schema(description = "生效日期类型", required = true, example = "1")
@NotNull(message = "生效日期类型不能为空")
@InEnum(CouponTemplateValidityTypeEnum.class)
private Integer validityType;
@Schema(title = "固定日期 - 生效开始时间")
@Schema(description = "固定日期 - 生效开始时间")
@DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
@JsonFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND, timezone = TIME_ZONE_DEFAULT)
private LocalDateTime validStartTime;
@Schema(title = "固定日期 - 生效结束时间")
@Schema(description = "固定日期 - 生效结束时间")
@DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
@JsonFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND, timezone = TIME_ZONE_DEFAULT)
private LocalDateTime validEndTime;
@Schema(title = "领取日期 - 开始天数")
@Schema(description = "领取日期 - 开始天数")
@Min(value = 0L, message = "开始天数必须大于 0")
private Integer fixedStartTerm;
@Schema(title = "领取日期 - 结束天数")
@Schema(description = "领取日期 - 结束天数")
@Min(value = 1L, message = "开始天数必须大于 1")
private Integer fixedEndTerm;
@Schema(title = "优惠类型", required = true, example = "1", description = "参见 PromotionDiscountTypeEnum 枚举")
@Schema(description = "优惠类型,参见 PromotionDiscountTypeEnum 枚举", required = true, example = "1")
@NotNull(message = "优惠类型不能为空")
@InEnum(PromotionDiscountTypeEnum.class)
private Integer discountType;
@Schema(title = "折扣百分比", example = "80", description = "例如说80% 为 80")
@Schema(description = "折扣百分比,例如说80% 为 80", example = "80")
private Integer discountPercent;
@Schema(title = "优惠金额", example = "10", description = "单位:分")
@Schema(description = "优惠金额,单位:分", example = "10")
@Min(value = 0, message = "优惠金额需要大于等于 0")
private Integer discountPrice;
@Schema(title = "折扣上限", example = "100", description = "单位:分,仅在 discountType 为 PERCENT 使用")
@Schema(description = "折扣上限,单位:分,仅在 discountType 为 PERCENT 使用", example = "100")
private Integer discountLimitPrice;
@AssertTrue(message = "商品 SPU 编号的数组不能为空")

View File

@@ -4,7 +4,7 @@ import lombok.Data;
import lombok.EqualsAndHashCode;
import lombok.ToString;
@Schema(title = "管理后台 - 优惠劵模板创建 Request VO")
@Schema(description = "管理后台 - 优惠劵模板创建 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)

View File

@@ -11,22 +11,22 @@ import java.time.LocalDateTime;
import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
@Schema(title = "管理后台 - 优惠劵模板分页 Request VO")
@Schema(description = "管理后台 - 优惠劵模板分页 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class CouponTemplatePageReqVO extends PageParam {
@Schema(title = "优惠劵名", example = "你好")
@Schema(description = "优惠劵名", example = "你好")
private String name;
@Schema(title = "状态", example = "1", description = "参见 CommonStatusEnum 枚举类")
@Schema(description = "状态,参见 CommonStatusEnum 枚举类", example = "1")
private Integer status;
@Schema(title = "优惠类型", example = "1", description = "参见 PromotionDiscountTypeEnum 枚举")
@Schema(description = "优惠类型,参见 PromotionDiscountTypeEnum 枚举", example = "1")
private Integer discountType;
@Schema(title = "创建时间")
@Schema(description = "创建时间")
@DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
private LocalDateTime[] createTime;

View File

@@ -9,26 +9,26 @@ import lombok.ToString;
import java.time.LocalDateTime;
@Schema(title = "管理后台 - 优惠劵模板 Response VO")
@Schema(description = "管理后台 - 优惠劵模板 Response VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class CouponTemplateRespVO extends CouponTemplateBaseVO {
@Schema(title = "模板编号", required = true, example = "1024")
@Schema(description = "模板编号", required = true, example = "1024")
private Long id;
@Schema(title = "状态", required = true, example = "1")
@Schema(description = "状态", required = true, example = "1")
@InEnum(CommonStatusEnum.class)
private Integer status;
@Schema(title = "领取优惠券的数量", required = true, example = "1024")
@Schema(description = "领取优惠券的数量", required = true, example = "1024")
private Integer takeCount;
@Schema(title = "使用优惠券的次数", required = true, example = "2048")
@Schema(description = "使用优惠券的次数", required = true, example = "2048")
private Integer useCount;
@Schema(title = "创建时间", required = true)
@Schema(description = "创建时间", required = true)
private LocalDateTime createTime;
}

View File

@@ -7,13 +7,13 @@ import lombok.ToString;
import javax.validation.constraints.NotNull;
@Schema(title = "管理后台 - 优惠劵模板更新 Request VO")
@Schema(description = "管理后台 - 优惠劵模板更新 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class CouponTemplateUpdateReqVO extends CouponTemplateBaseVO {
@Schema(title = "模板编号", required = true, example = "1024")
@Schema(description = "模板编号", required = true, example = "1024")
@NotNull(message = "模板编号不能为空")
private Long id;

View File

@@ -7,15 +7,15 @@ import lombok.Data;
import javax.validation.constraints.NotNull;
@Schema(title = "管理后台 - 优惠劵模板更新状态 Request VO")
@Schema(description = "管理后台 - 优惠劵模板更新状态 Request VO")
@Data
public class CouponTemplateUpdateStatusReqVO {
@Schema(title = "优惠劵模板编号", required = true, example = "1024")
@Schema(description = "优惠劵模板编号", required = true, example = "1024")
@NotNull(message = "优惠劵模板编号不能为空")
private Long id;
@Schema(title = "状态", required = true, example = "1", description = "见 CommonStatusEnum 枚举")
@Schema(description = "状态,见 CommonStatusEnum 枚举", required = true, example = "1")
@NotNull(message = "状态不能为空")
@InEnum(value = CommonStatusEnum.class, message = "修改状态必须是 {value}")
private Integer status;

View File

@@ -22,44 +22,44 @@ import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_
@Data
public class DiscountActivityBaseVO {
@Schema(title = "活动标题", required = true, example = "一个标题")
@Schema(description = "活动标题", required = true, example = "一个标题")
@NotNull(message = "活动标题不能为空")
private String name;
@Schema(title = "开始时间", required = true)
@Schema(description = "开始时间", required = true)
@NotNull(message = "开始时间不能为空")
@DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
private LocalDateTime startTime;
@Schema(title = "结束时间", required = true)
@Schema(description = "结束时间", required = true)
@NotNull(message = "结束时间不能为空")
@DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
private LocalDateTime endTime;
@Schema(title = "备注", example = "我是备注")
@Schema(description = "备注", example = "我是备注")
private String remark;
@Schema(title = "商品")
@Schema(description = "商品")
@Data
public static class Product {
@Schema(title = "商品 SPU 编号", required = true, example = "1")
@Schema(description = "商品 SPU 编号", required = true, example = "1")
@NotNull(message = "商品 SPU 编号不能为空")
private Long spuId;
@Schema(title = "商品 SKU 编号", required = true, example = "1")
@Schema(description = "商品 SKU 编号", required = true, example = "1")
@NotNull(message = "商品 SKU 编号不能为空")
private Long skuId;
@Schema(title = "优惠类型", required = true, example = "1", description = "参见 PromotionDiscountTypeEnum 枚举")
@Schema(description = "优惠类型,参见 PromotionDiscountTypeEnum 枚举", required = true, example = "1")
@NotNull(message = "优惠类型不能为空")
@InEnum(PromotionDiscountTypeEnum.class)
private Integer discountType;
@Schema(title = "折扣百分比", example = "80", description = "例如说80% 为 80")
@Schema(description = "折扣百分比,例如说80% 为 80", example = "80")
private Integer discountPercent;
@Schema(title = "优惠金额", example = "10", description = "单位:分")
@Schema(description = "优惠金额,单位:分", example = "10")
@Min(value = 0, message = "优惠金额需要大于等于 0")
private Integer discountPrice;

View File

@@ -8,7 +8,7 @@ import javax.validation.Valid;
import javax.validation.constraints.NotEmpty;
import java.util.List;
@Schema(title = "管理后台 - 限时折扣活动创建 Request VO")
@Schema(description = "管理后台 - 限时折扣活动创建 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)

View File

@@ -6,7 +6,7 @@ import lombok.ToString;
import java.util.List;
@Schema(title = "管理后台 - 限时折扣活动的详细 Response VO")
@Schema(description = "管理后台 - 限时折扣活动的详细 Response VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)

View File

@@ -11,19 +11,19 @@ import java.time.LocalDateTime;
import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
@Schema(title = "管理后台 - 限时折扣活动分页 Request VO")
@Schema(description = "管理后台 - 限时折扣活动分页 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class DiscountActivityPageReqVO extends PageParam {
@Schema(title = "活动标题", example = "一个标题")
@Schema(description = "活动标题", example = "一个标题")
private String name;
@Schema(title = "活动状态", example = "1")
@Schema(description = "活动状态", example = "1")
private Integer status;
@Schema(title = "创建时间")
@Schema(description = "创建时间")
@DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
private LocalDateTime[] createTime;

View File

@@ -8,20 +8,20 @@ import lombok.ToString;
import javax.validation.constraints.NotNull;
import java.time.LocalDateTime;
@Schema(title = "管理后台 - 限时折扣活动 Response VO")
@Schema(description = "管理后台 - 限时折扣活动 Response VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class DiscountActivityRespVO extends DiscountActivityBaseVO {
@Schema(title = "活动编号", required = true, example = "1024")
@Schema(description = "活动编号", required = true, example = "1024")
private Long id;
@Schema(title = "活动状态", required = true, example = "1")
@Schema(description = "活动状态", required = true, example = "1")
@NotNull(message = "活动状态不能为空")
private Integer status;
@Schema(title = "创建时间", required = true)
@Schema(description = "创建时间", required = true)
private LocalDateTime createTime;
}

View File

@@ -10,13 +10,13 @@ import javax.validation.constraints.NotEmpty;
import javax.validation.constraints.NotNull;
import java.util.List;
@Schema(title = "管理后台 - 限时折扣活动更新 Request VO")
@Schema(description = "管理后台 - 限时折扣活动更新 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class DiscountActivityUpdateReqVO extends DiscountActivityBaseVO {
@Schema(title = "活动编号", required = true, example = "1024")
@Schema(description = "活动编号", required = true, example = "1024")
@NotNull(message = "活动编号不能为空")
private Long id;

View File

@@ -25,35 +25,35 @@ import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_
@Data
public class RewardActivityBaseVO {
@Schema(title = "活动标题", required = true, example = "满啦满啦")
@Schema(description = "活动标题", required = true, example = "满啦满啦")
@NotNull(message = "活动标题不能为空")
private String name;
@Schema(title = "开始时间", required = true)
@Schema(description = "开始时间", required = true)
@NotNull(message = "开始时间不能为空")
@DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
private LocalDateTime startTime;
@Schema(title = "结束时间", required = true)
@Schema(description = "结束时间", required = true)
@NotNull(message = "结束时间不能为空")
@DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
@Future(message = "结束时间必须大于当前时间")
private LocalDateTime endTime;
@Schema(title = "备注", example = "biubiubiu")
@Schema(description = "备注", example = "biubiubiu")
private String remark;
@Schema(title = "条件类型", required = true, example = "1")
@Schema(description = "条件类型", required = true, example = "1")
@NotNull(message = "条件类型不能为空")
@InEnum(value = PromotionConditionTypeEnum.class, message = "条件类型必须是 {value}")
private Integer conditionType;
@Schema(title = "商品范围", required = true, example = "1")
@Schema(description = "商品范围", required = true, example = "1")
@NotNull(message = "商品范围不能为空")
@InEnum(value = PromotionConditionTypeEnum.class, message = "商品范围必须是 {value}")
private Integer productScope;
@Schema(title = "商品 SPU 编号的数组", example = "1,2,3")
@Schema(description = "商品 SPU 编号的数组", example = "1,2,3")
private List<Long> productSpuIds;
/**
@@ -62,29 +62,29 @@ public class RewardActivityBaseVO {
@Valid // 校验下子对象
private List<Rule> rules;
@Schema(title = "优惠规则")
@Schema(description = "优惠规则")
@Data
public static class Rule {
@Schema(title = "优惠门槛", required = true, example = "100", description = "1. 满 N 元,单位:分; 2. 满 N 件")
@Schema(description = "优惠门槛,1. 满 N 元,单位:分; 2. 满 N 件", required = true, example = "100")
@Min(value = 1L, message = "优惠门槛必须大于等于 1")
private Integer limit;
@Schema(title = "优惠价格", required = true, example = "100", description = "单位:分")
@Schema(description = "优惠价格,单位:分", required = true, example = "100")
@Min(value = 1L, message = "优惠价格必须大于等于 1")
private Integer discountPrice;
@Schema(title = "是否包邮", required = true, example = "true")
@Schema(description = "是否包邮", required = true, example = "true")
private Boolean freeDelivery;
@Schema(title = "赠送的积分", required = true, example = "100")
@Schema(description = "赠送的积分", required = true, example = "100")
@Min(value = 1L, message = "赠送的积分必须大于等于 1")
private Integer point;
@Schema(title = "赠送的优惠劵编号的数组", example = "1,2,3")
@Schema(description = "赠送的优惠劵编号的数组", example = "1,2,3")
private List<Long> couponIds;
@Schema(title = "赠送的优惠卷数量的数组", example = "1,2,3")
@Schema(description = "赠送的优惠卷数量的数组", example = "1,2,3")
private List<Integer> couponCounts;
@AssertTrue(message = "优惠劵和数量必须一一对应")

View File

@@ -2,7 +2,7 @@ package cn.iocoder.yudao.module.promotion.controller.admin.reward.vo;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.*;
@Schema(title = "管理后台 - 满减送活动创建 Request VO")
@Schema(description = "管理后台 - 满减送活动创建 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)

View File

@@ -3,16 +3,16 @@ import io.swagger.v3.oas.annotations.media.Schema;
import lombok.*;
import cn.iocoder.yudao.framework.common.pojo.PageParam;
@Schema(title = "管理后台 - 满减送活动分页 Request VO")
@Schema(description = "管理后台 - 满减送活动分页 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class RewardActivityPageReqVO extends PageParam {
@Schema(title = "活动标题", example = "满啦满啦")
@Schema(description = "活动标题", example = "满啦满啦")
private String name;
@Schema(title = "活动状态", example = "1")
@Schema(description = "活动状态", example = "1")
private Integer status;
}

View File

@@ -7,19 +7,19 @@ import lombok.ToString;
import java.time.LocalDateTime;
@Schema(title = "管理后台 - 满减送活动 Response VO")
@Schema(description = "管理后台 - 满减送活动 Response VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class RewardActivityRespVO extends RewardActivityBaseVO {
@Schema(title = "活动编号", required = true, example = "1024")
@Schema(description = "活动编号", required = true, example = "1024")
private Integer id;
@Schema(title = "活动状态", required = true, example = "1")
@Schema(description = "活动状态", required = true, example = "1")
private Integer status;
@Schema(title = "创建时间", required = true)
@Schema(description = "创建时间", required = true)
private LocalDateTime createTime;
}

View File

@@ -3,13 +3,13 @@ import io.swagger.v3.oas.annotations.media.Schema;
import lombok.*;
import javax.validation.constraints.*;
@Schema(title = "管理后台 - 满减送活动更新 Request VO")
@Schema(description = "管理后台 - 满减送活动更新 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class RewardActivityUpdateReqVO extends RewardActivityBaseVO {
@Schema(title = "活动编号", required = true, example = "1024")
@Schema(description = "活动编号", required = true, example = "1024")
@NotNull(message = "活动编号不能为空")
private Long id;

View File

@@ -3,20 +3,20 @@ package cn.iocoder.yudao.module.trade.controller.app.base.property;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
@Schema(title = "用户 App - 规格 + 规格值 Response VO")
@Schema(description = "用户 App - 规格 + 规格值 Response VO")
@Data
public class AppProductPropertyValueDetailRespVO {
@Schema(title = "属性的编号", required = true, example = "1")
@Schema(description = "属性的编号", required = true, example = "1")
private Long propertyId;
@Schema(title = "属性的名称", required = true, example = "颜色")
@Schema(description = "属性的名称", required = true, example = "颜色")
private String propertyName;
@Schema(title = "属性值的编号", required = true, example = "1024")
@Schema(description = "属性值的编号", required = true, example = "1024")
private Long valueId;
@Schema(title = "属性值的名称", required = true, example = "红色")
@Schema(description = "属性值的名称", required = true, example = "红色")
private String valueName;
}

View File

@@ -14,16 +14,16 @@ import java.util.List;
@Data
public class AppProductSkuBaseRespVO {
@Schema(title = "主键", required = true, example = "1024")
@Schema(description = "主键", required = true, example = "1024")
private Long id;
@Schema(title = "商品 SKU 名字", required = true, example = "芋道")
@Schema(description = "商品 SKU 名字", required = true, example = "芋道")
private String name;
@Schema(title = "图片地址", example = "https://www.iocoder.cn/xx.png")
@Schema(description = "图片地址", example = "https://www.iocoder.cn/xx.png")
private String picUrl;
@Schema(title = "库存", required = true, example = "1")
@Schema(description = "库存", required = true, example = "1")
private Integer stock;
/**

View File

@@ -12,13 +12,13 @@ import java.util.List;
@Data
public class AppProductSpuBaseRespVO {
@Schema(title = "主键", required = true, example = "1024")
@Schema(description = "主键", required = true, example = "1024")
private Long id;
@Schema(title = "商品 SPU 名字", required = true, example = "芋道")
@Schema(description = "商品 SPU 名字", required = true, example = "芋道")
private String name;
@Schema(title = "商品主图地址", example = "https://www.iocoder.cn/xx.png")
@Schema(description = "商品主图地址", example = "https://www.iocoder.cn/xx.png")
private List<String> picUrls;
}

View File

@@ -6,7 +6,7 @@ import lombok.Data;
import java.util.List;
@Schema(title = "用户 App - 用户的购物车明细 Response VO")
@Schema(description = "用户 App - 用户的购物车明细 Response VO")
@Data
public class AppTradeCartDetailRespVO {
@@ -20,7 +20,7 @@ public class AppTradeCartDetailRespVO {
*/
private Order order;
@Schema(title = "商品分组", description = "多个商品,参加同一个活动,从而形成分组")
@Schema(description = "商品分组,多个商品,参加同一个活动,从而形成分组")
@Data
public static class ItemGroup {
@@ -35,7 +35,7 @@ public class AppTradeCartDetailRespVO {
}
@Schema(title = "商品 SKU")
@Schema(description = "商品 SKU")
@Data
public static class Sku extends AppProductSkuBaseRespVO {
@@ -46,26 +46,26 @@ public class AppTradeCartDetailRespVO {
// ========== 购物车相关的字段 ==========
@Schema(title = "商品数量", required = true, example = "1")
@Schema(description = "商品数量", required = true, example = "1")
private Integer count;
@Schema(title = "是否选中", required = true, example = "true")
@Schema(description = "是否选中", required = true, example = "true")
private Boolean selected;
// ========== 价格相关的字段,对应 PriceCalculateRespDTO.OrderItem 的属性 ==========
// TODO 芋艿:后续可以去除一些无用的字段
@Schema(title = "商品原价(单)", required = true, example = "100")
@Schema(description = "商品原价(单)", required = true, example = "100")
private Integer originalPrice;
@Schema(title = "商品原价(总)", required = true, example = "200")
@Schema(description = "商品原价(总)", required = true, example = "200")
private Integer totalOriginalPrice;
@Schema(title = "商品级优惠(总)", required = true, example = "300")
@Schema(description = "商品级优惠(总)", required = true, example = "300")
private Integer totalPromotionPrice;
@Schema(title = "最终购买金额(总)", required = true, example = "400")
@Schema(description = "最终购买金额(总)", required = true, example = "400")
private Integer totalPresentPrice;
@Schema(title = "最终购买金额(单)", required = true, example = "500")
@Schema(description = "最终购买金额(单)", required = true, example = "500")
private Integer presentPrice;
@Schema(title = "应付金额(总)", required = true, example = "600")
@Schema(description = "应付金额(总)", required = true, example = "600")
private Integer totalPayPrice;
// ========== 营销相关的字段 ==========
@@ -76,40 +76,40 @@ public class AppTradeCartDetailRespVO {
}
@Schema(title = "订单", description = "对应 PriceCalculateRespDTO.Order 类,用于费用(合计)")
@Schema(description = "订单,对应 PriceCalculateRespDTO.Order 类,用于费用(合计)")
@Data
public static class Order {
// TODO 芋艿:后续可以去除一些无用的字段
@Schema(title = "商品原价(总)", required = true, example = "100")
@Schema(description = "商品原价(总)", required = true, example = "100")
private Integer skuOriginalPrice;
@Schema(title = "商品优惠(总)", required = true, example = "200")
@Schema(description = "商品优惠(总)", required = true, example = "200")
private Integer skuPromotionPrice;
@Schema(title = "订单优惠(总)", required = true, example = "300")
@Schema(description = "订单优惠(总)", required = true, example = "300")
private Integer orderPromotionPrice;
@Schema(title = "运费金额", required = true, example = "400")
@Schema(description = "运费金额", required = true, example = "400")
private Integer deliveryPrice;
@Schema(title = "应付金额(总)", required = true, example = "500")
@Schema(description = "应付金额(总)", required = true, example = "500")
private Integer payPrice;
}
@Schema(title = "营销活动", description = "对应 PriceCalculateRespDTO.Promotion 类的属性")
@Schema(description = "营销活动,对应 PriceCalculateRespDTO.Promotion 类的属性")
@Data
public static class Promotion {
@Schema(title = "营销编号", required = true, example = "1024", description = "营销活动的编号、优惠劵的编号")
@Schema(description = "营销编号,营销活动的编号、优惠劵的编号", required = true, example = "1024")
private Long id;
@Schema(title = "营销名字", required = true, example = "xx 活动")
@Schema(description = "营销名字", required = true, example = "xx 活动")
private String name;
@Schema(title = "营销类型", required = true, example = "1", description = "参见 PromotionTypeEnum 枚举类")
@Schema(description = "营销类型,参见 PromotionTypeEnum 枚举类", required = true, example = "1")
private Integer type;
// ========== 匹配情况 ==========
@Schema(title = "是否满足优惠条件", required = true, example = "true")
@Schema(description = "是否满足优惠条件", required = true, example = "true")
private Boolean meet;
@Schema(title = "满足条件的提示", required = true, example = "圣诞价:省 150.00 元")
@Schema(description = "满足条件的提示", required = true, example = "圣诞价:省 150.00 元")
private String meetTip;
}

View File

@@ -6,15 +6,15 @@ import lombok.Data;
import javax.validation.constraints.Min;
import javax.validation.constraints.NotNull;
@Schema(title = "用户 App - 购物车添加购物项 Request VO")
@Schema(description = "用户 App - 购物车添加购物项 Request VO")
@Data
public class AppTradeCartItemAddCountReqVO {
@Schema(title = "商品 SKU 编号", required = true,example = "1024")
@Schema(description = "商品 SKU 编号", required = true,example = "1024")
@NotNull(message = "商品 SKU 编号不能为空")
private Long skuId;
@Schema(title = "商品数量", required = true, example = "1", description = "注意,这是新增数量")
@Schema(description = "商品数量,注意,这是新增数量", required = true, example = "1")
@NotNull(message = "数量不能为空")
@Min(message = "数量必须大于 0", value = 1L)
private Integer count;

View File

@@ -6,15 +6,15 @@ import lombok.Data;
import javax.validation.constraints.Min;
import javax.validation.constraints.NotNull;
@Schema(title = "用户 App - 购物车更新数量 Request VO")
@Schema(description = "用户 App - 购物车更新数量 Request VO")
@Data
public class AppTradeCartItemUpdateCountReqVO {
@Schema(title = "商品 SKU 编号", required = true, example = "1024")
@Schema(description = "商品 SKU 编号", required = true, example = "1024")
@NotNull(message = "商品 SKU 编号不能为空")
private Long skuId;
@Schema(title = "商品数量", required = true, example = "1")
@Schema(description = "商品数量", required = true, example = "1")
@NotNull(message = "数量不能为空")
@Min(message = "数量必须大于 0", value = 1L)
private Integer count;

View File

@@ -6,15 +6,15 @@ import lombok.Data;
import javax.validation.constraints.NotNull;
import java.util.Collection;
@Schema(title = "用户 App - 购物车更新是否选中 Request VO")
@Schema(description = "用户 App - 购物车更新是否选中 Request VO")
@Data
public class AppTradeCartItemUpdateSelectedReqVO {
@Schema(title = "商品 SKU 编号列表", required = true, example = "1024,2048")
@Schema(description = "商品 SKU 编号列表", required = true, example = "1024,2048")
@NotNull(message = "商品 SKU 编号列表不能为空")
private Collection<Long> skuIds;
@Schema(title = "是否选中", required = true, example = "true")
@Schema(description = "是否选中", required = true, example = "true")
@NotNull(message = "是否选中不能为空")
private Boolean selected;

View File

@@ -8,21 +8,21 @@ import javax.validation.constraints.NotEmpty;
import javax.validation.constraints.NotNull;
import java.util.List;
@Schema(title = "用户 App - 交易订单创建 Request VO")
@Schema(description = "用户 App - 交易订单创建 Request VO")
@Data
public class AppTradeOrderCreateReqVO {
@Schema(name = "收件地址编号", required = true, example = "1")
@Schema(description = "收件地址编号", required = true, example = "1")
@NotNull(message = "收件地址不能为空")
private Long addressId;
@Schema(name = "优惠劵编号", example = "1024")
@Schema(description = "优惠劵编号", example = "1024")
private Long couponId;
@Schema(name = "备注", example = "这个是我的订单哟")
@Schema(description = "备注", example = "这个是我的订单哟")
private String remark;
@Schema(name = "是否来自购物车", required = true, example = "true", description = "true - 来自购物车false - 立即购买")
@Schema(description = "是否来自购物车,true - 来自购物车false - 立即购买", required = true, example = "true")
@NotNull(message = "是否来自购物车不能为空")
private Boolean fromCart;
@@ -32,15 +32,15 @@ public class AppTradeOrderCreateReqVO {
@NotEmpty(message = "必须选择购买的商品")
private List<Item> items;
@Schema(title = "订单商品项")
@Schema(description = "订单商品项")
@Data
public static class Item {
@Schema(name = "商品 SKU 编号", required = true, example = "111")
@Schema(description = "商品 SKU 编号", required = true, example = "111")
@NotNull(message = "商品 SKU 编号不能为空")
private Long skuId;
@Schema(name = "商品 SKU 购买数量", required = true, example = "1024")
@Schema(description = "商品 SKU 购买数量", required = true, example = "1024")
@NotNull(message = "商品 SKU 购买数量不能为空")
@Min(value = 1, message = "商品 SKU 购买数量必须大于 0")
private Integer count;

View File

@@ -6,7 +6,7 @@ import lombok.Data;
import java.util.List;
@Schema(title = "用户 App - 订单获得创建信息 Response VO")
@Schema(description = "用户 App - 订单获得创建信息 Response VO")
@Data
public class AppTradeOrderGetCreateInfoRespVO {
@@ -24,7 +24,7 @@ public class AppTradeOrderGetCreateInfoRespVO {
// */
// private List<CouponCardAvailableRespDTO> coupons;
@Schema(title = "商品分组", description = "多个商品,参加同一个活动,从而形成分组")
@Schema(description = "商品分组,多个商品,参加同一个活动,从而形成分组")
@Data
public static class ItemGroup {
@@ -39,12 +39,12 @@ public class AppTradeOrderGetCreateInfoRespVO {
}
@Schema(title = "商品 SKU")
@Schema(description = "商品 SKU")
@Data
public static class Sku {
// SKU 自带信息
@Schema(title = "SKU 编号", required = true, example = "1024")
@Schema(description = "SKU 编号", required = true, example = "1024")
private Integer id;
/**
* SPU 信息
@@ -139,12 +139,12 @@ public class AppTradeOrderGetCreateInfoRespVO {
}
@Schema(title = "费用(合计)")
@Schema(description = "费用(合计)")
@Data
@AllArgsConstructor
public static class Fee {
@Schema(title = "购买总价", required = true, example = "1024")
@Schema(description = "购买总价", required = true, example = "1024")
private Integer buyPrice;
/**
* 优惠总价

View File

@@ -5,47 +5,47 @@ import lombok.Data;
import java.time.LocalDateTime;
@Schema(title = "交易订单项 Response VO")
@Schema(description = "交易订单项 Response VO")
@Data
public class TradeOrderItemRespVO {
@Schema(title = "id自增长", required = true)
@Schema(description = "id自增长", required = true)
private Integer id;
@Schema(title = "订单编号", required = true)
@Schema(description = "订单编号", required = true)
private Integer orderId;
@Schema(title = "订单项状态", required = true)
@Schema(description = "订单项状态", required = true)
private Integer status;
@Schema(title = "商品 SKU 编号", required = true)
@Schema(description = "商品 SKU 编号", required = true)
private Integer skuId;
@Schema(title = "商品 SPU 编号", required = true)
@Schema(description = "商品 SPU 编号", required = true)
private Integer spuId;
@Schema(title = "商品名字", required = true)
@Schema(description = "商品名字", required = true)
private String skuName;
@Schema(title = "图片名字", required = true)
@Schema(description = "图片名字", required = true)
private String skuImage;
@Schema(title = "商品数量", required = true)
@Schema(description = "商品数量", required = true)
private Integer quantity;
@Schema(title = "原始单价,单位:分", required = true)
@Schema(description = "原始单价,单位:分", required = true)
private Integer originPrice;
@Schema(title = "购买单价,单位:分", required = true)
@Schema(description = "购买单价,单位:分", required = true)
private Integer buyPrice;
@Schema(title = "最终价格,单位:分", required = true)
@Schema(description = "最终价格,单位:分", required = true)
private Integer presentPrice;
@Schema(title = "购买总金额,单位:分", required = true)
@Schema(description = "购买总金额,单位:分", required = true)
private Integer buyTotal;
@Schema(title = "优惠总金额,单位:分", required = true)
@Schema(description = "优惠总金额,单位:分", required = true)
private Integer discountTotal;
@Schema(title = "最终总金额,单位:分", required = true)
@Schema(description = "最终总金额,单位:分", required = true)
private Integer presentTotal;
@Schema(title = "退款总金额,单位:分", required = true)
@Schema(description = "退款总金额,单位:分", required = true)
private Integer refundTotal;
@Schema(title = "物流id")
@Schema(description = "物流id")
private Integer logisticsId;
@Schema(title = "售后状态", required = true)
@Schema(description = "售后状态", required = true)
private Integer afterSaleStatus;
@Schema(title = "售后订单编号")
@Schema(description = "售后订单编号")
private Integer afterSaleOrderId;
@Schema(title = "创建时间", required = true)
@Schema(description = "创建时间", required = true)
private LocalDateTime createTime;

View File

@@ -5,12 +5,12 @@ import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
import lombok.EqualsAndHashCode;
@Schema(title = "交易订单分页 Request VO")
@Schema(description = "交易订单分页 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
public class TradeOrderPageReqVO extends PageParam {
@Schema(title = "订单状态", example = "1", description = "参见 TradeOrderStatusEnum 枚举")
@Schema(description = "订单状态-参见 TradeOrderStatusEnum 枚举", example = "1")
private Integer orderStatus;
}

View File

@@ -5,59 +5,59 @@ import lombok.*;
import java.time.LocalDateTime;
import java.util.*;
@Schema(title = "订单交易 Response VO")
@Schema(description = "订单交易 Response VO")
@Data
public class TradeOrderRespVO {
@Schema(title = "订单编号", required = true)
@Schema(description = "订单编号", required = true)
private Integer id;
@Schema(title = "用户编号", required = true)
@Schema(description = "用户编号", required = true)
private Integer userId;
@Schema(title = "订单单号", required = true)
@Schema(description = "订单单号", required = true)
private String orderNo;
@Schema(title = "订单状态", required = true)
@Schema(description = "订单状态", required = true)
private Integer orderStatus;
@Schema(title = "备注")
@Schema(description = "备注")
private String remark;
@Schema(title = "订单结束时间")
@Schema(description = "订单结束时间")
private LocalDateTime endTime;
@Schema(title = "订单金额(总金额),单位:分", required = true)
@Schema(description = "订单金额(总金额),单位:分", required = true)
private Integer buyPrice;
@Schema(title = "优惠总金额,单位:分", required = true)
@Schema(description = "优惠总金额,单位:分", required = true)
private Integer discountPrice;
@Schema(title = "物流金额,单位:分", required = true)
@Schema(description = "物流金额,单位:分", required = true)
private Integer logisticsPrice;
@Schema(title = "最终金额,单位:分", required = true)
@Schema(description = "最终金额,单位:分", required = true)
private Integer presentPrice;
@Schema(title = "支付金额,单位:分", required = true)
@Schema(description = "支付金额,单位:分", required = true)
private Integer payPrice;
@Schema(title = "退款金额,单位:分", required = true)
@Schema(description = "退款金额,单位:分", required = true)
private Integer refundPrice;
@Schema(title = "付款时间")
@Schema(description = "付款时间")
private LocalDateTime payTime;
@Schema(title = "支付订单编号")
@Schema(description = "支付订单编号")
private Integer payTransactionId;
@Schema(title = "支付渠道")
@Schema(description = "支付渠道")
private Integer payChannel;
@Schema(title = "配送类型", required = true)
@Schema(description = "配送类型", required = true)
private Integer deliveryType;
@Schema(title = "发货时间")
@Schema(description = "发货时间")
private LocalDateTime deliveryTime;
@Schema(title = "收货时间")
@Schema(description = "收货时间")
private LocalDateTime receiveTime;
@Schema(title = "收件人名称", required = true)
@Schema(description = "收件人名称", required = true)
private String receiverName;
@Schema(title = "手机号", required = true)
@Schema(description = "手机号", required = true)
private String receiverMobile;
@Schema(title = "地区编码", required = true)
@Schema(description = "地区编码", required = true)
private Integer receiverAreaCode;
@Schema(title = "收件详细地址", required = true)
@Schema(description = "收件详细地址", required = true)
private String receiverDetailAddress;
@Schema(title = "售后状态", required = true)
@Schema(description = "售后状态", required = true)
private Integer afterSaleStatus;
@Schema(title = "优惠劵编号")
@Schema(description = "优惠劵编号")
private Integer couponCardId;
@Schema(title = "创建时间", required = true)
@Schema(description = "创建时间", required = true)
private LocalDateTime createTime;
/**