11

2026-08-25 13:07:03 +08:00
1 parent 890b927354
commit 388ef914fc
@@ -9,14 +9,17 @@ import lombok.Data;
 import java.time.LocalDateTime;
 import java.util.List;

-@Data
 /** 硬件商品库存更新记录查询条件，支持按上架用户身份快速筛选。 */
+@Data
 public class HardSpuRepertoryDto extends HardSpuRepertoryEntity implements BaseUserIdentityQueryInterface {

+    /** 库存更新记录创建时间闭区间；数组长度为 2 时生效。 */
    private LocalDateTime[] createTimeList;

+    /** 身份预筛选后用于库存记录查询的上架用户主键集合。 */
    private List<Long> userIds;

+    /** 目标柜门主键；为空时不限制柜门。 */
    private Long cabinetId;

    /** UPMS 用户身份协议编码集合；为空表示不限制身份。 */
@@ -5,6 +5,7 @@ import com.bsd.pjcloud.admin.api.dto.user.SysUserTeacherDto;
 import com.bsd.pjcloud.admin.api.vo.base.BaseDeptInterface;
 import com.bsd.pjcloud.admin.api.vo.base.BaseUserDeptInterface;
 import com.bsd.pjcloud.admin.api.vo.base.BaseUserIdentityInterface;
+import com.bsd.pjcloud.admin.api.vo.base.BaseUserInterface;
 import com.bsd.pjcloud.hard.api.entity.order.HardAfterSaleEntity;
 import com.bsd.pjcloud.hard.api.vo.base.BaseOrderInterface;
 import lombok.Data;
@@ -12,8 +13,13 @@ import lombok.Data;
 import java.time.LocalDateTime;
 import java.util.List;

+/**
+ * 硬件订单售后详情。
+ *
+ * <p>同时保留历史用户、用户部门和用户身份协议，兼容售后详情的旧用户装配逻辑及管理端身份展示。</p>
+ */
@Data
-public class HardAfterSaleVo extends HardAfterSaleEntity implements BaseUserDeptInterface, BaseUserIdentityInterface, BaseDeptInterface, BaseOrderInterface {
+public class HardAfterSaleVo extends HardAfterSaleEntity implements BaseUserInterface, BaseUserDeptInterface, BaseUserIdentityInterface, BaseDeptInterface, BaseOrderInterface {
    /**
     * 自动退款任务状态；为空表示当前售后仍走人工审核，非空时前端不得展示审核或取消操作。
     */
@@ -30,6 +30,9 @@ public class HardOrderVo extends HardOrderEntity implements BaseUserDeptInterfac

    private String userMobile;

+    /** 用户标准手机号字段，供统一身份组件展示；与历史 userMobile 字段并存。 */
+    private String phone;
+
    private String userAvatar;

    /** 用户身份协议编码集合；没有身份时为空集合或空值。 */
@@ -10,44 +10,58 @@ import com.bsd.pjcloud.hard.api.vo.base.BaseHardInterface;
 import com.bsd.pjcloud.wallet.api.vo.base.BaseMchInterface;
 import lombok.Data;

-@Data
+import java.util.List;
+
 /** 硬件商品库存更新记录展示对象，包含上架用户主资料、部门和身份信息。 */
+@Data
 public class HardSpuRepertoryVo extends HardSpuRepertoryEntity implements BaseMchInterface, BaseUserInterface, BaseUserDeptInterface, BaseUserIdentityInterface, BaseHardInterface {

    /**
     * 商品相关
     */
+    /** 本次更新对应的商品名称。 */
    private String spuName;

+    /** 商品分类主键。 */
    private Long spuCategoryId;

+    /** 商品所属商户主键。 */
    private Long spuMchId;

+    /** 商品所在硬件柜门数量。 */
    private Long hardDoorNumber;

    /**
     * 分类相关
     */
+    /** 商品分类名称。 */
    private String spuCategoryName;

    /**
     * 商户相关
     */
+    /** 商品所属商户主键，供公共商户展示契约读取。 */
    private Long merchantId;

+    /** 商品所属商户名称。 */
    private String merchantName;

+    /** 商品所属商户 Logo 地址。 */
    private String logoPic;

+    /** 商品所属商户类型协议编码。 */
    private String merchantType;

    /**
     * 用户相关
     */
+    /** 上架用户姓名，保留历史接口字段名。 */
    private String username;

+    /** 上架用户手机号，保留历史接口字段名。 */
    private String userMobile;

+    /** 上架用户头像地址，保留历史接口字段名。 */
    private String userAvatar;

    /** 用户标准手机号字段，供统一身份组件展示；与历史 userMobile 字段并存。 */
@@ -63,7 +77,7 @@ public class HardSpuRepertoryVo extends HardSpuRepertoryEntity implements BaseMc
    private String deptName;

    /** 用户拥有的 UPMS 身份协议编码集合。 */
-    private java.util.List<String> identityTypes;
+    private List<String> identityTypes;

    /** 用户的学生身份扩展资料；无学生身份时为空。 */
    private SysUserStudentDto studentInfo;
@@ -99,12 +113,16 @@ public class HardSpuRepertoryVo extends HardSpuRepertoryEntity implements BaseMc
    /**
     * 设备相关
     */
+    /** 执行库存更新的硬件主键。 */
    private Long hardId;

+    /** 执行库存更新的硬件名称。 */
    private String hardName;

+    /** 执行库存更新的硬件类型协议编码。 */
    private String hardType;

+    /** 执行库存更新的硬件设备编号。 */
    private String deviceCode;

 }