打卡记录

alien-entity/src/main/java/shop/alien/entity/store/vo/ClockInRecordValidateVo.java

@@ -0,0 +1,24 @@
+package shop.alien.entity.store.vo;
+
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+import java.util.List;
+
+/**
+ * 打卡记录筛选校验/元数据（年份月份、城市列表）
+ */
+@Data
+@ApiModel("打卡记录筛选信息")
+public class ClockInRecordValidateVo {
+
+    @ApiModelProperty(value = "用户历史上存在打卡记录的年份（降序）")
+    private List<Integer> years;
+
+    @ApiModelProperty(value = "指定年份下每月是否有打卡；传入城市时仅统计该城市下的月份")
+    private List<MonthClockInItem> months;
+
+    @ApiModelProperty(value = "当前用户在哪些城市打过卡（门店行政区域市名称去重）")
+    private List<String> cities;
+}

alien-entity/src/main/java/shop/alien/entity/store/vo/MonthClockInItem.java

@@ -0,0 +1,19 @@
+package shop.alien.entity.store.vo;
+
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+/**
+ * 某年某月是否有打卡记录（用于打卡记录筛选）
+ */
+@Data
+@ApiModel("打卡月份状态")
+public class MonthClockInItem {
+
+    @ApiModelProperty(value = "月份 1-12")
+    private int month;
+
+    @ApiModelProperty(value = "该月是否存在打卡记录")
+    private boolean hasClockIn;
+}

alien-entity/src/main/java/shop/alien/entity/store/vo/StoreClockInPageVo.java

@@ -0,0 +1,24 @@
+package shop.alien.entity.store.vo;
+
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import java.util.List;
+
+/**
+ * 打卡列表分页结果（保留原分页结构，附加城市与地点回显）
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ApiModel("打卡分页结果")
+public class StoreClockInPageVo extends Page<StoreClockInVo> {
+
+    @ApiModelProperty(value = "打卡过的城市列表（按名称去重）")
+    private List<String> clockInCities;
+
+    @ApiModelProperty(value = "地点总数（去重门店数）")
+    private Integer placeCount;
+}