diff --git a/sky/sky-pojo/src/main/java/com/sky/dto/CategoryDTO.java b/sky/sky-pojo/src/main/java/com/sky/dto/CategoryDTO.java new file mode 100644 index 0000000..d17b389 --- /dev/null +++ b/sky/sky-pojo/src/main/java/com/sky/dto/CategoryDTO.java @@ -0,0 +1,42 @@ +package com.sky.dto; + +import lombok.Data; +import java.io.Serializable; + +/** + * 分类数据传输对象 + *
+ * 此类用于封装分类信息的数据传输对象(DTO),包括分类的基本信息。 + */ +@Data // 使用lombok提供的注解来自动生成getter和setter方法,以及toString等方法 +public class CategoryDTO implements Serializable { + + /** + * 分类的数据库主键ID + *
+ * 唯一标识一个分类实体。 + */ + private Long id; + + /** + * 分类的类型 + *
+ * 类型用于区分不同的分类,例如:1代表菜品分类,2代表套餐分类。 + */ + private Integer type; + + /** + * 分类的名称 + *
+ * 表示分类的名称,如“川菜”、“粤菜”等。 + */ + private String name; + + /** + * 分类的排序号 + *
+ * 用于在展示分类时确定分类的顺序。 + */ + private Integer sort; + +} \ No newline at end of file diff --git a/sky/sky-pojo/src/main/java/com/sky/dto/DishPageQueryDTO.java b/sky/sky-pojo/src/main/java/com/sky/dto/DishPageQueryDTO.java new file mode 100644 index 0000000..5376487 --- /dev/null +++ b/sky/sky-pojo/src/main/java/com/sky/dto/DishPageQueryDTO.java @@ -0,0 +1,49 @@ +package com.sky.dto; + +import lombok.Data; +import java.io.Serializable; + +/** + * 菜品分页查询数据传输对象 + *
+ * 此类用于封装菜品分页查询的参数。 + */ +@Data // 使用lombok提供的注解来自动生成getter和setter方法,以及toString等方法 +public class DishPageQueryDTO implements Serializable { + + /** + * 当前页码 + *
+ * 表示查询的当前页码,从1开始。 + */ + private int page; + + /** + * 每页显示的记录数 + *
+ * 表示每页想要显示的记录数。 + */ + private int pageSize; + + /** + * 菜品名称 + *
+ * 根据菜品名称进行搜索查询。 + */ + private String name; + + /** + * 分类ID + *
+ * 根据分类ID进行筛选查询。 + */ + private Integer categoryId; + + /** + * 状态 + *
+ * 0表示禁用,1表示启用,用于筛选菜品的状态。 + */ + private Integer status; + +} \ No newline at end of file diff --git a/sky/sky-pojo/src/main/java/com/sky/dto/GoodsSalesDTO.java b/sky/sky-pojo/src/main/java/com/sky/dto/GoodsSalesDTO.java new file mode 100644 index 0000000..868fd7c --- /dev/null +++ b/sky/sky-pojo/src/main/java/com/sky/dto/GoodsSalesDTO.java @@ -0,0 +1,35 @@ +package com.sky.dto; + +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; + +import java.io.Serializable; + +/** + * 商品销售数据传输对象 + *
+ * 此类用于封装商品销售相关的数据,包括商品名称和销量。 + */ +@Data // 使用lombok提供的注解来自动生成getter和setter方法,以及toString等方法 +@AllArgsConstructor // 使用lombok提供的注解来自动生成包含所有参数的构造函数 +@NoArgsConstructor // 使用lombok提供的注解来自动生成无参数的构造函数 +@Builder // 使用lombok提供的注解来自动生成builder模式的构建器 +public class GoodsSalesDTO implements Serializable { + + /** + * 商品名称 + *
+ * 表示商品的名称。 + */ + private String name; + + /** + * 销量 + *
+ * 表示商品的销售数量。 + */ + private Integer number; + +} \ No newline at end of file diff --git a/sky/sky-pojo/src/main/java/com/sky/dto/OrdersPageQueryDTO.java b/sky/sky-pojo/src/main/java/com/sky/dto/OrdersPageQueryDTO.java new file mode 100644 index 0000000..008011a --- /dev/null +++ b/sky/sky-pojo/src/main/java/com/sky/dto/OrdersPageQueryDTO.java @@ -0,0 +1,74 @@ +package com.sky.dto; + +import lombok.Data; +import org.springframework.format.annotation.DateTimeFormat; +import java.io.Serializable; +import java.time.LocalDateTime; + +/** + * 订单分页查询数据传输对象 + *
+ * 此类用于封装订单分页查询的参数,包括分页信息、订单编号、联系电话、订单状态以及时间范围。 + */ +@Data // 使用lombok提供的注解来自动生成getter和setter方法,以及toString等方法 +public class OrdersPageQueryDTO implements Serializable { + + /** + * 当前页码 + *
+ * 表示查询的当前页码,从1开始。 + */ + private int page; + + /** + * 每页显示的记录数 + *
+ * 表示每页想要显示的记录数。 + */ + private int pageSize; + + /** + * 订单编号 + *
+ * 用于根据订单编号进行搜索。 + */ + private String number; + + /** + * 联系电话 + *
+ * 用于根据联系电话进行搜索。 + */ + private String phone; + + /** + * 订单状态 + *
+ * 用于筛选特定状态的订单。 + */ + private Integer status; + + /** + * 开始时间 + *
+ * 查询订单的时间范围开始时间,格式为yyyy-MM-dd HH:mm:ss。 + */ + @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") + private LocalDateTime beginTime; + + /** + * 结束时间 + *
+ * 查询订单的时间范围结束时间,格式为yyyy-MM-dd HH:mm:ss。 + */ + @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") + private LocalDateTime endTime; + + /** + * 用户ID + *
+ * 用于筛选属于特定用户的订单。 + */ + private Long userId; + +} \ No newline at end of file diff --git a/sky/sky-pojo/src/main/java/com/sky/dto/PasswordEditDTO.java b/sky/sky-pojo/src/main/java/com/sky/dto/PasswordEditDTO.java new file mode 100644 index 0000000..8add980 --- /dev/null +++ b/sky/sky-pojo/src/main/java/com/sky/dto/PasswordEditDTO.java @@ -0,0 +1,35 @@ +package com.sky.dto; + +import lombok.Data; +import java.io.Serializable; + +/** + * 密码编辑数据传输对象 + *
+ * 此类用于封装员工密码修改时所需的数据。 + */ +@Data // 使用lombok提供的注解来自动生成getter和setter方法,以及toString等方法 +public class PasswordEditDTO implements Serializable { + + /** + * 员工ID + *
+ * 唯一标识一个员工的ID。 + */ + private Long empId; + + /** + * 旧密码 + *
+ * 员工当前使用的密码,用于验证身份。 + */ + private String oldPassword; + + /** + * 新密码 + *
+ * 员工想要设置的新密码。 + */ + private String newPassword; + +} \ No newline at end of file diff --git a/sky/sky-pojo/src/main/java/com/sky/dto/UserLoginDTO.java b/sky/sky-pojo/src/main/java/com/sky/dto/UserLoginDTO.java new file mode 100644 index 0000000..41ba827 --- /dev/null +++ b/sky/sky-pojo/src/main/java/com/sky/dto/UserLoginDTO.java @@ -0,0 +1,21 @@ +package com.sky.dto; + +import lombok.Data; +import java.io.Serializable; + +/** + * C端用户登录数据传输对象 + *
+ * 此类用于封装C端用户登录时所需的数据。 + */ +@Data // 使用lombok提供的注解来自动生成getter和setter方法,以及toString等方法 +public class UserLoginDTO implements Serializable { + + /** + * 登录授权码 + *
+ * 表示用户在登录过程中获取的授权码,通常通过第三方平台(如微信、支付宝等)授权登录后获得。 + */ + private String code; + +} \ No newline at end of file diff --git a/sky/sky-pojo/src/main/java/com/sky/entity/DishFlavor.java b/sky/sky-pojo/src/main/java/com/sky/entity/DishFlavor.java new file mode 100644 index 0000000..ea2dcad --- /dev/null +++ b/sky/sky-pojo/src/main/java/com/sky/entity/DishFlavor.java @@ -0,0 +1,51 @@ +package com.sky.entity; + +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; + +import java.io.Serializable; + +/** + * 菜品口味实体类 + *
+ * 此类用于表示菜品的不同口味,包含口味的基本信息。 + */ +@Data // 使用lombok提供的注解来自动生成getter和setter方法,以及toString等方法 +@Builder // 提供builder模式的构建器 +@NoArgsConstructor // 提供无参数的构造函数 +@AllArgsConstructor // 提供包含所有属性的构造函数 +public class DishFlavor implements Serializable { + + private static final long serialVersionUID = 1L; // 序列化ID,用于序列化和反序列化 + + /** + * 菜品口味ID + *
+ * 唯一标识一个菜品口味实体。 + */ + private Long id; + + /** + * 菜品ID + *
+ * 标识属于哪个菜品的口味。 + */ + private Long dishId; + + /** + * 口味名称 + *
+ * 表示口味的名称,例如“麻辣”、“酸甜”等。 + */ + private String name; + + /** + * 口味数据列表 + *
+ * 存储口味的具体数据,可能是一个以逗号分隔的字符串列表。 + */ + private String value; + +} \ No newline at end of file diff --git a/sky/sky-pojo/src/main/java/com/sky/entity/Setmeal.java b/sky/sky-pojo/src/main/java/com/sky/entity/Setmeal.java new file mode 100644 index 0000000..fd443c6 --- /dev/null +++ b/sky/sky-pojo/src/main/java/com/sky/entity/Setmeal.java @@ -0,0 +1,101 @@ +package com.sky.entity; + +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; + +import java.io.Serializable; +import java.math.BigDecimal; +import java.time.LocalDateTime; + +/** + * 套餐实体类 + *
+ * 此类用于表示套餐的详细信息,包括套餐的基础信息和状态等。 + */ +@Data // 使用lombok提供的注解来自动生成getter和setter方法,以及toString等方法 +@Builder // 提供builder模式的构建器 +@NoArgsConstructor // 提供无参数的构造函数 +@AllArgsConstructor // 提供包含所有属性的构造函数 +public class Setmeal implements Serializable { + + private static final long serialVersionUID = 1L; // 序列化ID,用于序列化和反序列化 + + /** + * 套餐ID + *
+ * 唯一标识一个套餐实体。 + */ + private Long id; + + /** + * 分类ID + *
+ * 标识套餐所属的分类。 + */ + private Long categoryId; + + /** + * 套餐名称 + *
+ * 表示套餐的名称。 + */ + private String name; + + /** + * 套餐价格 + *
+ * 表示套餐的价格。 + */ + private BigDecimal price; + + /** + * 状态 + *
+ * 0表示停用,1表示启用。 + */ + private Integer status; + + /** + * 描述信息 + *
+ * 对套餐的详细描述。 + */ + private String description; + + /** + * 图片 + *
+ * 套餐的图片链接或路径。 + */ + private String image; + + /** + * 创建时间 + *
+ * 记录套餐创建的时间。 + */ + private LocalDateTime createTime; + + /** + * 更新时间 + *
+ * 记录套餐最后更新的时间。 + */ + private LocalDateTime updateTime; + + /** + * 创建用户ID + *
+ * 创建套餐的用户ID。 + */ + private Long createUser; + + /** + * 更新用户ID + *
+ * 最后更新套餐的用户ID。 + */ + private Long updateUser; +} \ No newline at end of file diff --git a/sky/sky-pojo/src/main/java/com/sky/vo/BusinessDataVO.java b/sky/sky-pojo/src/main/java/com/sky/vo/BusinessDataVO.java new file mode 100644 index 0000000..62ff777 --- /dev/null +++ b/sky/sky-pojo/src/main/java/com/sky/vo/BusinessDataVO.java @@ -0,0 +1,56 @@ +package com.sky.vo; + +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; + +import java.io.Serializable; + +/** + * 数据概览视图对象 + *
+ * 此类用于展示业务数据概览,包括营业额、有效订单数、订单完成率、平均客单价和新增用户数等关键指标。 + */ +@Data // 使用lombok提供的注解来自动生成getter和setter方法,以及toString等方法 +@Builder // 提供builder模式的构建器 +@NoArgsConstructor // 提供无参数的构造函数 +@AllArgsConstructor // 提供包含所有属性的构造函数 +public class BusinessDataVO implements Serializable { + + /** + * 营业额 + *
+ * 表示在一定时间内的总营业额。 + */ + private Double turnover; + + /** + * 有效订单数 + *
+ * 表示在一定时间内完成的有效订单数量。 + */ + private Integer validOrderCount; + + /** + * 订单完成率 + *
+ * 表示订单完成率,通常是百分比形式。 + */ + private Double orderCompletionRate; + + /** + * 平均客单价 + *
+ * 表示平均每笔订单的消费金额。 + */ + private Double unitPrice; + + /** + * 新增用户数 + *
+ * 表示在一定时间内新增的用户数量。 + */ + private Integer newUsers; + +} \ No newline at end of file diff --git a/sky/sky-pojo/src/main/java/com/sky/vo/EmployeeLoginVO.java b/sky/sky-pojo/src/main/java/com/sky/vo/EmployeeLoginVO.java new file mode 100644 index 0000000..fd663ec --- /dev/null +++ b/sky/sky-pojo/src/main/java/com/sky/vo/EmployeeLoginVO.java @@ -0,0 +1,56 @@ +package com.sky.vo; + +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; + +import java.io.Serializable; + +/** + * 员工登录视图对象 + *
+ * 此类用于封装员工登录成功后返回的数据,包括员工的基本信息和JWT令牌。 + */ +@Data // 使用lombok提供的注解来自动生成getter和setter方法,以及toString等方法 +@Builder // 提供builder模式的构建器 +@NoArgsConstructor // 提供无参数的构造函数 +@AllArgsConstructor // 提供包含所有属性的构造函数 +@ApiModel(description = "员工登录返回的数据格式") // Swagger注解,用于描述这个VO对象 +public class EmployeeLoginVO implements Serializable { + + /** + * 主键值 + *
+ * 员工的唯一标识符。 + */ + @ApiModelProperty("主键值") // Swagger注解,用于描述字段 + private Long id; + + /** + * 用户名 + *
+ * 员工的用户名,用于登录系统。 + */ + @ApiModelProperty("用户名") // Swagger注解,用于描述字段 + private String userName; + + /** + * 姓名 + *
+ * 员工的真实姓名。 + */ + @ApiModelProperty("姓名") // Swagger注解,用于描述字段 + private String name; + + /** + * JWT令牌 + *
+ * 登录成功后颁发的JWT令牌,用于后续请求的认证。 + */ + @ApiModelProperty("jwt令牌") // Swagger注解,用于描述字段 + private String token; + +} \ No newline at end of file diff --git a/sky/sky-pojo/src/main/java/com/sky/vo/OrderStatisticsVO.java b/sky/sky-pojo/src/main/java/com/sky/vo/OrderStatisticsVO.java new file mode 100644 index 0000000..4cb9cca --- /dev/null +++ b/sky/sky-pojo/src/main/java/com/sky/vo/OrderStatisticsVO.java @@ -0,0 +1,32 @@ +package com.sky.vo; + +import lombok.Data; + +import java.io.Serializable; + +/** + * OrderStatisticsVO 是一个值对象,用于存储订单统计数据。 + * 该类实现了 Serializable 接口,可以支持对象的序列化和反序列化操作。 + * 使用了 Lombok 的 @Data 注解,自动生成 getter、setter、toString、equals 和 hashCode 方法。 + */ +@Data +public class OrderStatisticsVO implements Serializable { + + /** + * 表示待接单的订单数量。 + * 可能用于展示当前有多少订单等待确认。 + */ + private Integer toBeConfirmed; + + /** + * 表示已确认但尚未派送的订单数量。 + * 可能用于跟踪订单的待派送状态。 + */ + private Integer confirmed; + + /** + * 表示当前正在派送中的订单数量。 + * 可能用于监控派送过程中的订单进展。 + */ + private Integer deliveryInProgress; +} diff --git a/sky/sky-pojo/src/main/java/com/sky/vo/SetmealOverViewVO.java b/sky/sky-pojo/src/main/java/com/sky/vo/SetmealOverViewVO.java new file mode 100644 index 0000000..0030d95 --- /dev/null +++ b/sky/sky-pojo/src/main/java/com/sky/vo/SetmealOverViewVO.java @@ -0,0 +1,33 @@ +package com.sky.vo; + +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; + +import java.io.Serializable; + +/** + * SetmealOverViewVO 是一个值对象,用于表示套餐的总体情况。 + * 该类实现了 Serializable 接口,可以支持对象的序列化和反序列化操作。 + * 使用了 Lombok 的 @Data、@Builder、@NoArgsConstructor 和 @AllArgsConstructor 注解, + * 简化了类的构造、属性访问和对象构建。 + */ +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +public class SetmealOverViewVO implements Serializable { + + /** + * 表示已启售的套餐数量。 + * 可能用于统计或展示当前正在销售的套餐数量。 + */ + private Integer sold; + + /** + * 表示已停售的套餐数量。 + * 可能用于统计或展示已经停止销售的套餐数量。 + */ + private Integer discontinued; +} diff --git a/sky/sky-pojo/src/main/java/com/sky/vo/UserReportVO.java b/sky/sky-pojo/src/main/java/com/sky/vo/UserReportVO.java new file mode 100644 index 0000000..d1f4e0c --- /dev/null +++ b/sky/sky-pojo/src/main/java/com/sky/vo/UserReportVO.java @@ -0,0 +1,43 @@ +package com.sky.vo; + +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; + +import java.io.Serializable; + +/** + * UserReportVO 是一个值对象,用于存储用户统计报告的数据。 + * 该类实现了 Serializable 接口,支持对象的序列化和反序列化。 + * 使用了 Lombok 注解 @Data、@Builder、@NoArgsConstructor 和 @AllArgsConstructor, + * 自动生成了常用方法和构造器,简化了开发。 + */ +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +public class UserReportVO implements Serializable { + + /** + * 表示日期列表,用逗号分隔的字符串形式。 + * 示例:2022-10-01,2022-10-02,2022-10-03 + * 通常用于标识统计数据对应的时间段。 + */ + private String dateList; + + /** + * 表示用户总量列表,用逗号分隔的字符串形式。 + * 示例:200,210,220 + * 每个数值对应 dateList 中的日期,表示该日期的累计用户总量。 + */ + private String totalUserList; + + /** + * 表示新增用户数量列表,用逗号分隔的字符串形式。 + * 示例:20,21,10 + * 每个数值对应 dateList 中的日期,表示该日期新增的用户数量。 + */ + private String newUserList; + +}