feat:添加了excel的dict注解

feat:优化了学生导入

pjcloud-hardware/pjcloud-hardware-api/src/main/java/com/bsd/pjcloud/hard/api/vo/android/ReservationMenuQueryVo.java

@@ -11,36 +11,78 @@ import java.util.List;
 @Data
 public class ReservationMenuQueryVo {
 
+    /** 脱敏后的用餐人姓名。 */
     private String maskedName;
 
+    /** 用餐人所属部门或班级名称。 */
     private String deptName;
 
+    /** 当前终端绑定的食堂名称。 */
     private String merchantName;
 
+    /** 返回结果中包含预约的日期数量。 */
     private Integer totalDayCount;
 
+    /** 返回结果中包含预约的餐段数量。 */
     private Integer totalMealCount;
 
+    /** 按预约日期升序排列的菜单列表。 */
     private List<Day> days;
 
     @Data
     public static class Day {
 
+        /** 预约用餐日期。 */
         private LocalDate date;
 
+        /** 当天按餐段顺序排列的预约菜单。 */
         private List<Meal> meals;
     }
 
     @Data
     public static class Meal {
 
+        /** 预约餐段编码，沿用硬件订单餐段契约。 */
         private String hourType;
 
+        /** 预约餐段显示名称。 */
         private String mealTitle;
 
+        /** 当前餐段所有预约订单的去重餐品汇总，保留用于兼容旧终端。 */
         private List<String> items;
 
         /** 同一日期餐段可能合并多笔预约，终端按订单逐笔确认核销。 */
         private List<Long> orderIds;
+
+        /**
+         * 同一餐段内每笔预约与餐品的明确对应关系。
+         *
+         * <p>items、orderIds 继续保留给旧终端使用，新终端必须优先读取该字段，
+         * 避免把餐段汇总餐品误展示为每笔订单都包含的餐品。</p>
+         */
+        private List<Order> orders;
+    }
+
+    @Data
+    public static class Order {
+
+        /** 可核销的预约订单 ID。 */
+        private Long orderId;
+
+        /** 该笔预约订单实际购买的商品与数量明细。 */
+        private List<OrderItem> items;
+    }
+
+    @Data
+    public static class OrderItem {
+
+        /** 该笔预约订单购买的商品名称。 */
+        private String productName;
+
+        /** 该笔预约订单购买的商品图片地址。 */
+        private String productPic;
+
+        /** 该笔预约订单购买的商品数量；历史异常数据缺失时可能为空。 */
+        private Integer productCount;
     }
 }