feat:hard、wallet表格添加人员、人员身份字段和搜索

fix:优化hard模块统计导出

pjcloud-hardware/pjcloud-hardware-api/src/main/java/com/bsd/pjcloud/hard/api/dto/HardAuthDto.java

@@ -1,12 +1,31 @@
 package com.bsd.pjcloud.hard.api.dto;
 
+import com.bsd.pjcloud.admin.api.dto.user.SysUserStudentDto;
+import com.bsd.pjcloud.admin.api.dto.user.SysUserTeacherDto;
+import com.bsd.pjcloud.admin.api.vo.base.BaseUserIdentityQueryInterface;
 import com.bsd.pjcloud.hard.api.entity.HardAuthEntity;
 import lombok.Data;
 
 import java.time.LocalDate;
+import java.util.List;
 
 @Data
-public class HardAuthDto extends HardAuthEntity {
+public class HardAuthDto extends HardAuthEntity implements BaseUserIdentityQueryInterface {
+
+    /** 身份预筛选后用于授权记录查询的用户主键集合。 */
+    private List<Long> userIds;
+
+    /** UPMS 用户身份协议编码集合；为空时不限制身份。 */
+    private List<String> identityTypes;
+
+    /** 学生身份扩展查询条件；对象为空或字段均为空时不限制学生资料。 */
+    private SysUserStudentDto studentInfo;
+
+    /** 老师身份扩展查询条件；对象为空或老师学号为空时不限制老师资料。 */
+    private SysUserTeacherDto teacherInfo;
+
+    /** 人脸录入状态；1 表示已录入，0 表示未录入，空值表示不限制。 */
+    private String hasFace;
 
     private LocalDate[] createTimeList;
 

pjcloud-hardware/pjcloud-hardware-api/src/main/java/com/bsd/pjcloud/hard/api/dto/HardBroadcastDto.java

@@ -1,12 +1,31 @@
 package com.bsd.pjcloud.hard.api.dto;
 
+import com.bsd.pjcloud.admin.api.dto.user.SysUserStudentDto;
+import com.bsd.pjcloud.admin.api.dto.user.SysUserTeacherDto;
+import com.bsd.pjcloud.admin.api.vo.base.BaseUserIdentityQueryInterface;
 import com.bsd.pjcloud.hard.api.entity.HardBroadcastEntity;
 import lombok.Data;
 
 import java.time.LocalDate;
+import java.util.List;
 
 @Data
-public class HardBroadcastDto extends HardBroadcastEntity {
+public class HardBroadcastDto extends HardBroadcastEntity implements BaseUserIdentityQueryInterface {
+
+    /** 身份预筛选后用于广播记录查询的用户主键集合。 */
+    private List<Long> userIds;
+
+    /** UPMS 用户身份协议编码集合；为空时不限制身份。 */
+    private List<String> identityTypes;
+
+    /** 学生身份扩展查询条件；对象为空或字段均为空时不限制学生资料。 */
+    private SysUserStudentDto studentInfo;
+
+    /** 老师身份扩展查询条件；对象为空或老师学号为空时不限制老师资料。 */
+    private SysUserTeacherDto teacherInfo;
+
+    /** 人脸录入状态；1 表示已录入，0 表示未录入，空值表示不限制。 */
+    private String hasFace;
 
     private LocalDate[] createTimeList;
     

pjcloud-hardware/pjcloud-hardware-api/src/main/java/com/bsd/pjcloud/hard/api/dto/HardDoorFlowDto.java

@@ -1,12 +1,31 @@
 package com.bsd.pjcloud.hard.api.dto;
 
+import com.bsd.pjcloud.admin.api.dto.user.SysUserStudentDto;
+import com.bsd.pjcloud.admin.api.dto.user.SysUserTeacherDto;
+import com.bsd.pjcloud.admin.api.vo.base.BaseUserIdentityQueryInterface;
 import com.bsd.pjcloud.hard.api.entity.HardDoorFlowEntity;
 import lombok.Data;
 
 import java.time.LocalDate;
+import java.util.List;
 
 @Data
-public class HardDoorFlowDto extends HardDoorFlowEntity {
+public class HardDoorFlowDto extends HardDoorFlowEntity implements BaseUserIdentityQueryInterface {
+
+    /** 身份预筛选后用于开门流程查询的用户主键集合。 */
+    private List<Long> userIds;
+
+    /** UPMS 用户身份协议编码集合；为空时不限制身份。 */
+    private List<String> identityTypes;
+
+    /** 学生身份扩展查询条件；对象为空或字段均为空时不限制学生资料。 */
+    private SysUserStudentDto studentInfo;
+
+    /** 老师身份扩展查询条件；对象为空或老师学号为空时不限制老师资料。 */
+    private SysUserTeacherDto teacherInfo;
+
+    /** 人脸录入状态；1 表示已录入，0 表示未录入，空值表示不限制。 */
+    private String hasFace;
 
     private LocalDate[] createTimeList;
 

pjcloud-hardware/pjcloud-hardware-api/src/main/java/com/bsd/pjcloud/hard/api/dto/HardInvoiceDto.java

@@ -1,5 +1,8 @@
 package com.bsd.pjcloud.hard.api.dto;
 
+import com.bsd.pjcloud.admin.api.dto.user.SysUserStudentDto;
+import com.bsd.pjcloud.admin.api.dto.user.SysUserTeacherDto;
+import com.bsd.pjcloud.admin.api.vo.base.BaseUserIdentityQueryInterface;
 import com.bsd.pjcloud.hard.api.entity.HardInvoiceEntity;
 import lombok.Data;
 
@@ -7,12 +10,24 @@ import java.time.LocalDate;
 import java.util.List;
 
 @Data
-public class HardInvoiceDto extends HardInvoiceEntity {
+public class HardInvoiceDto extends HardInvoiceEntity implements BaseUserIdentityQueryInterface {
 
     private List<Long> deptIds;
 
     private List<Long> userIds;
 
+    /** UPMS 用户身份协议编码集合；为空时不限制身份。 */
+    private List<String> identityTypes;
+
+    /** 学生身份扩展查询条件；对象为空或字段均为空时不限制学生资料。 */
+    private SysUserStudentDto studentInfo;
+
+    /** 老师身份扩展查询条件；对象为空或老师学号为空时不限制老师资料。 */
+    private SysUserTeacherDto teacherInfo;
+
+    /** 人脸录入状态；1 表示已录入，0 表示未录入，空值表示不限制。 */
+    private String hasFace;
+
     private List<Long> merchantIds;
 
     private String hardType;

pjcloud-hardware/pjcloud-hardware-api/src/main/java/com/bsd/pjcloud/hard/api/dto/order/HardAfterSaleDto.java

@@ -1,5 +1,8 @@
 package com.bsd.pjcloud.hard.api.dto.order;
 
+import com.bsd.pjcloud.admin.api.dto.user.SysUserStudentDto;
+import com.bsd.pjcloud.admin.api.dto.user.SysUserTeacherDto;
+import com.bsd.pjcloud.admin.api.vo.base.BaseUserIdentityQueryInterface;
 import com.bsd.pjcloud.hard.api.entity.order.HardAfterSaleEntity;
 import lombok.Data;
 
@@ -8,10 +11,22 @@ import java.time.LocalDateTime;
 import java.util.List;
 
 @Data
-public class HardAfterSaleDto extends HardAfterSaleEntity {
+public class HardAfterSaleDto extends HardAfterSaleEntity implements BaseUserIdentityQueryInterface {
 
     private List<Long> userIds;
 
+    /** UPMS 用户身份协议编码集合；为空时不限制身份。 */
+    private List<String> identityTypes;
+
+    /** 学生身份扩展查询条件；对象为空或字段均为空时不限制学生资料。 */
+    private SysUserStudentDto studentInfo;
+
+    /** 老师身份扩展查询条件；对象为空或老师学号为空时不限制老师资料。 */
+    private SysUserTeacherDto teacherInfo;
+
+    /** 人脸录入状态；1 表示已录入，0 表示未录入，空值表示不限制。 */
+    private String hasFace;
+
     private LocalDate[] createTimeList;
 
     private List<Long> mchIds;

pjcloud-hardware/pjcloud-hardware-api/src/main/java/com/bsd/pjcloud/hard/api/dto/order/HardOrderDto.java

@@ -1,6 +1,9 @@
 package com.bsd.pjcloud.hard.api.dto.order;
 
 import com.bsd.pjcloud.admin.api.vo.base.BaseIsIncludeTreeInterface;
+import com.bsd.pjcloud.admin.api.vo.base.BaseUserIdentityQueryInterface;
+import com.bsd.pjcloud.admin.api.dto.user.SysUserStudentDto;
+import com.bsd.pjcloud.admin.api.dto.user.SysUserTeacherDto;
 import com.bsd.pjcloud.common.core.constant.enums.DateRangeTypeEnum;
 import com.bsd.pjcloud.hard.api.entity.order.HardOrderEntity;
 import lombok.Data;
@@ -9,8 +12,9 @@ import java.time.LocalDate;
 import java.time.LocalDateTime;
 import java.util.List;
 
+/** 硬件订单后台查询条件，身份字段用于按订单用户的身份资料筛选。 */
 @Data
-public class HardOrderDto extends HardOrderEntity implements BaseIsIncludeTreeInterface {
+public class HardOrderDto extends HardOrderEntity implements BaseIsIncludeTreeInterface, BaseUserIdentityQueryInterface {
 
     private DateRangeTypeEnum dateRangeType = DateRangeTypeEnum.YESTERDAY;
 
@@ -131,4 +135,16 @@ public class HardOrderDto extends HardOrderEntity implements BaseIsIncludeTreeIn
      * `apptId`或者`appt_rule_id`不为null(筛选预约订单)
      */
     Boolean apptIdOrApptRuleIdNotNull = false;
+
+    /** 用户身份协议编码集合；为空表示不限制身份。 */
+    private List<String> identityTypes;
+
+    /** 学生身份扩展筛选条件。 */
+    private SysUserStudentDto studentInfo;
+
+    /** 老师身份扩展筛选条件。 */
+    private SysUserTeacherDto teacherInfo;
+
+    /** 人脸录入状态：1 已录入、0 未录入、空值表示全部。 */
+    private String hasFace;
 }

pjcloud-hardware/pjcloud-hardware-api/src/main/java/com/bsd/pjcloud/hard/api/dto/spu/HardSpuRepertoryDto.java

@@ -1,5 +1,8 @@
 package com.bsd.pjcloud.hard.api.dto.spu;
 
+import com.bsd.pjcloud.admin.api.dto.user.SysUserStudentDto;
+import com.bsd.pjcloud.admin.api.dto.user.SysUserTeacherDto;
+import com.bsd.pjcloud.admin.api.vo.base.BaseUserIdentityQueryInterface;
 import com.bsd.pjcloud.hard.api.entity.spu.HardSpuRepertoryEntity;
 import lombok.Data;
 
@@ -7,7 +10,8 @@ import java.time.LocalDateTime;
 import java.util.List;
 
 @Data
-public class HardSpuRepertoryDto extends HardSpuRepertoryEntity {
+/** 硬件商品库存更新记录查询条件，支持按上架用户身份快速筛选。 */
+public class HardSpuRepertoryDto extends HardSpuRepertoryEntity implements BaseUserIdentityQueryInterface {
 
     private LocalDateTime[] createTimeList;
 
@@ -15,4 +19,16 @@ public class HardSpuRepertoryDto extends HardSpuRepertoryEntity {
 
     private Long cabinetId;
 
+    /** UPMS 用户身份协议编码集合；为空表示不限制身份。 */
+    private List<String> identityTypes;
+
+    /** 学生身份扩展查询条件；对象为空或字段均为空时不限制学生资料。 */
+    private SysUserStudentDto studentInfo;
+
+    /** 老师身份扩展查询条件；对象为空或老师学号为空时不限制老师资料。 */
+    private SysUserTeacherDto teacherInfo;
+
+    /** 人脸录入状态；1 表示已录入，0 表示未录入，空值表示不限制。 */
+    private String hasFace;
+
 }

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

@@ -1,6 +1,9 @@
 package com.bsd.pjcloud.hard.api.vo;
 
+import com.bsd.pjcloud.admin.api.dto.user.SysUserStudentDto;
+import com.bsd.pjcloud.admin.api.dto.user.SysUserTeacherDto;
 import com.bsd.pjcloud.admin.api.vo.base.BaseUserDeptInterface;
+import com.bsd.pjcloud.admin.api.vo.base.BaseUserIdentityInterface;
 import com.bsd.pjcloud.hard.api.entity.HardAuthEntity;
 import com.bsd.pjcloud.hard.api.vo.base.BaseHardInterface;
 import lombok.Data;
@@ -8,7 +11,7 @@ import lombok.Data;
 import java.util.List;
 
 @Data
-public class HardAuthVo extends HardAuthEntity implements BaseHardInterface, BaseUserDeptInterface {
+public class HardAuthVo extends HardAuthEntity implements BaseHardInterface, BaseUserDeptInterface, BaseUserIdentityInterface {
 
     /**
      * 设备相关
@@ -26,10 +29,22 @@ public class HardAuthVo extends HardAuthEntity implements BaseHardInterface, Bas
 
     private String userMobile;
 
+    /** 用户标准手机号字段，供身份组件展示；与历史 userMobile 同步回填。 */
+    private String phone;
+
     private String userAvatar;
 
     private Long userDeptId;
 
     private String userDeptName;
 
+    /** 用户拥有的 UPMS 身份协议编码集合。 */
+    private List<String> identityTypes;
+
+    /** 用户的学生身份扩展资料；无学生身份时为空。 */
+    private SysUserStudentDto studentInfo;
+
+    /** 用户的老师身份扩展资料；无老师身份时为空。 */
+    private SysUserTeacherDto teacherInfo;
+
 }

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

@@ -1,6 +1,9 @@
 package com.bsd.pjcloud.hard.api.vo;
 
+import com.bsd.pjcloud.admin.api.dto.user.SysUserStudentDto;
+import com.bsd.pjcloud.admin.api.dto.user.SysUserTeacherDto;
 import com.bsd.pjcloud.admin.api.vo.base.BaseUserDeptInterface;
+import com.bsd.pjcloud.admin.api.vo.base.BaseUserIdentityInterface;
 import com.bsd.pjcloud.hard.api.entity.HardBroadcastEntity;
 import com.bsd.pjcloud.hard.api.vo.base.BaseHardInterface;
 import lombok.Data;
@@ -8,7 +11,7 @@ import lombok.Data;
 import java.util.List;
 
 @Data
-public class HardBroadcastVo extends HardBroadcastEntity implements BaseHardInterface, BaseUserDeptInterface {
+public class HardBroadcastVo extends HardBroadcastEntity implements BaseHardInterface, BaseUserDeptInterface, BaseUserIdentityInterface {
 
     /**
      * 设备相关
@@ -26,12 +29,24 @@ public class HardBroadcastVo extends HardBroadcastEntity implements BaseHardInte
 
     private String userMobile;
 
+    /** 用户标准手机号字段，供身份组件展示；与历史 userMobile 同步回填。 */
+    private String phone;
+
     private String userAvatar;
 
     private Long userDeptId;
 
     private String userDeptName;
 
+    /** 用户拥有的 UPMS 身份协议编码集合。 */
+    private List<String> identityTypes;
+
+    /** 用户的学生身份扩展资料；无学生身份时为空。 */
+    private SysUserStudentDto studentInfo;
+
+    /** 用户的老师身份扩展资料；无老师身份时为空。 */
+    private SysUserTeacherDto teacherInfo;
+
     /**
      * 订单相关
      */

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

@@ -1,6 +1,9 @@
 package com.bsd.pjcloud.hard.api.vo;
 
+import com.bsd.pjcloud.admin.api.dto.user.SysUserStudentDto;
+import com.bsd.pjcloud.admin.api.dto.user.SysUserTeacherDto;
 import com.bsd.pjcloud.admin.api.vo.base.BaseUserDeptInterface;
+import com.bsd.pjcloud.admin.api.vo.base.BaseUserIdentityInterface;
 import com.bsd.pjcloud.hard.api.entity.HardAuthEntity;
 import com.bsd.pjcloud.hard.api.entity.HardDoorFlowEntity;
 import com.bsd.pjcloud.hard.api.vo.base.BaseHardInterface;
@@ -9,7 +12,7 @@ import lombok.Data;
 import java.util.List;
 
 @Data
-public class HardDoorFlowVo extends HardDoorFlowEntity implements BaseHardInterface, BaseUserDeptInterface {
+public class HardDoorFlowVo extends HardDoorFlowEntity implements BaseHardInterface, BaseUserDeptInterface, BaseUserIdentityInterface {
 
     /**
      * 设备相关
@@ -27,12 +30,24 @@ public class HardDoorFlowVo extends HardDoorFlowEntity implements BaseHardInterf
 
     private String userMobile;
 
+    /** 用户标准手机号字段，供身份组件展示；与历史 userMobile 同步回填。 */
+    private String phone;
+
     private String userAvatar;
 
     private Long userDeptId;
 
     private String userDeptName;
 
+    /** 用户拥有的 UPMS 身份协议编码集合。 */
+    private List<String> identityTypes;
+
+    /** 用户的学生身份扩展资料；无学生身份时为空。 */
+    private SysUserStudentDto studentInfo;
+
+    /** 用户的老师身份扩展资料；无老师身份时为空。 */
+    private SysUserTeacherDto teacherInfo;
+
     private HardAuthEntity hardAuth;
 
 

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

@@ -1,7 +1,10 @@
 package com.bsd.pjcloud.hard.api.vo;
 
+import com.bsd.pjcloud.admin.api.dto.user.SysUserStudentDto;
+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.BaseUserInterface;
+import com.bsd.pjcloud.admin.api.vo.base.BaseUserDeptInterface;
+import com.bsd.pjcloud.admin.api.vo.base.BaseUserIdentityInterface;
 import com.bsd.pjcloud.hard.api.entity.HardInvoiceEntity;
 import com.bsd.pjcloud.hard.api.vo.base.BaseHardInterface;
 import com.bsd.pjcloud.hard.api.vo.base.BaseOrderInterface;
@@ -9,9 +12,10 @@ import com.bsd.pjcloud.wallet.api.vo.base.BaseMchInterface;
 import lombok.Data;
 
 import java.time.LocalDateTime;
+import java.util.List;
 
 @Data
-public class HardInvoiceVo extends HardInvoiceEntity implements BaseDeptInterface, BaseMchInterface, BaseOrderInterface, BaseHardInterface, BaseUserInterface {
+public class HardInvoiceVo extends HardInvoiceEntity implements BaseUserDeptInterface, BaseUserIdentityInterface, BaseDeptInterface, BaseMchInterface, BaseOrderInterface, BaseHardInterface {
 
     private Long historyId;
 
@@ -72,6 +76,24 @@ public class HardInvoiceVo extends HardInvoiceEntity implements BaseDeptInterfac
 
     private String userMobile;
 
+    /** 用户标准手机号字段，供身份组件展示；与历史 userMobile 同步回填。 */
+    private String phone;
+
     private String userAvatar;
 
+    /** UPMS 当前用户部门主键，用于公共用户信息组件的标准别名。 */
+    private Long userDeptId;
+
+    /** UPMS 当前用户部门名称，用于公共用户信息组件的标准别名。 */
+    private String userDeptName;
+
+    /** 用户拥有的 UPMS 身份协议编码集合。 */
+    private List<String> identityTypes;
+
+    /** 用户的学生身份扩展资料；无学生身份时为空。 */
+    private SysUserStudentDto studentInfo;
+
+    /** 用户的老师身份扩展资料；无老师身份时为空。 */
+    private SysUserTeacherDto teacherInfo;
+
 }

pjcloud-hardware/pjcloud-hardware-api/src/main/java/com/bsd/pjcloud/hard/api/vo/order/HardAfterSaleVo.java

@@ -1,15 +1,19 @@
 package com.bsd.pjcloud.hard.api.vo.order;
 
+import com.bsd.pjcloud.admin.api.dto.user.SysUserStudentDto;
+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.BaseUserInterface;
+import com.bsd.pjcloud.admin.api.vo.base.BaseUserDeptInterface;
+import com.bsd.pjcloud.admin.api.vo.base.BaseUserIdentityInterface;
 import com.bsd.pjcloud.hard.api.entity.order.HardAfterSaleEntity;
 import com.bsd.pjcloud.hard.api.vo.base.BaseOrderInterface;
 import lombok.Data;
 
 import java.time.LocalDateTime;
+import java.util.List;
 
 @Data
-public class HardAfterSaleVo extends HardAfterSaleEntity implements BaseUserInterface, BaseDeptInterface, BaseOrderInterface {
+public class HardAfterSaleVo extends HardAfterSaleEntity implements BaseUserDeptInterface, BaseUserIdentityInterface, BaseDeptInterface, BaseOrderInterface {
     /**
      * 自动退款任务状态；为空表示当前售后仍走人工审核，非空时前端不得展示审核或取消操作。
      */
@@ -40,8 +44,26 @@ public class HardAfterSaleVo extends HardAfterSaleEntity implements BaseUserInte
 
     private String userMobile;
 
+    /** 用户标准手机号字段，供身份组件展示；与历史 userMobile 同步回填。 */
+    private String phone;
+
     private String userAvatar;
 
+    /** UPMS 当前用户部门主键，用于公共用户信息组件的标准别名。 */
+    private Long userDeptId;
+
+    /** UPMS 当前用户部门名称，用于公共用户信息组件的标准别名。 */
+    private String userDeptName;
+
+    /** 用户拥有的 UPMS 身份协议编码集合。 */
+    private List<String> identityTypes;
+
+    /** 用户的学生身份扩展资料；无学生身份时为空。 */
+    private SysUserStudentDto studentInfo;
+
+    /** 用户的老师身份扩展资料；无老师身份时为空。 */
+    private SysUserTeacherDto teacherInfo;
+
     /**
      * 部门相关
      */

pjcloud-hardware/pjcloud-hardware-api/src/main/java/com/bsd/pjcloud/hard/api/vo/order/HardCanteenProductApptExportRecord.java

@@ -11,6 +11,11 @@ import lombok.Data;
 @Data
 public class HardCanteenProductApptExportRecord {
 
+    /**
+     * 导出聚合层级，固定为 SUMMARY、MERCHANT 或 PRODUCT；仅用于一次查询后拆分三级结果，不持久化。
+     */
+    private String recordLevel;
+
     /** 业务发生日期，格式为 yyyy-MM-dd；线下取支付日期，预约取核销日期。 */
     private String statisticsDate;
 

pjcloud-hardware/pjcloud-hardware-api/src/main/java/com/bsd/pjcloud/hard/api/vo/order/HardOrderVo.java

@@ -1,6 +1,9 @@
 package com.bsd.pjcloud.hard.api.vo.order;
 
 import com.bsd.pjcloud.admin.api.vo.base.BaseUserDeptInterface;
+import com.bsd.pjcloud.admin.api.vo.base.BaseUserIdentityInterface;
+import com.bsd.pjcloud.admin.api.dto.user.SysUserStudentDto;
+import com.bsd.pjcloud.admin.api.dto.user.SysUserTeacherDto;
 import com.bsd.pjcloud.hard.api.entity.order.HardOrderEntity;
 import com.bsd.pjcloud.hard.api.vo.base.BaseHardInterface;
 import com.bsd.pjcloud.wallet.api.vo.base.BaseMchInterface;
@@ -11,8 +14,9 @@ import lombok.Data;
 import java.time.LocalTime;
 import java.util.List;
 
+/** 硬件订单管理端展示对象，包含公共用户主资料、部门及身份信息。 */
 @Data
-public class HardOrderVo extends HardOrderEntity implements BaseUserDeptInterface, BaseMchInterface, BaseHardInterface {
+public class HardOrderVo extends HardOrderEntity implements BaseUserDeptInterface, BaseUserIdentityInterface, BaseMchInterface, BaseHardInterface {
     /** 统计明细来源编码；线下订单为 OFFLINE_PURCHASE，预约已核销订单为 RESERVATION_VERIFIED。 */
     private String saleSource;
 
@@ -28,6 +32,15 @@ public class HardOrderVo extends HardOrderEntity implements BaseUserDeptInterfac
 
     private String userAvatar;
 
+    /** 用户身份协议编码集合；没有身份时为空集合或空值。 */
+    private List<String> identityTypes;
+
+    /** 学生身份扩展资料；没有学生身份时为空。 */
+    private SysUserStudentDto studentInfo;
+
+    /** 老师身份扩展资料；没有老师身份时为空。 */
+    private SysUserTeacherDto teacherInfo;
+
     /**
      * 部门相关
      */

pjcloud-hardware/pjcloud-hardware-api/src/main/java/com/bsd/pjcloud/hard/api/vo/spu/HardSpuRepertoryVo.java

@@ -1,5 +1,9 @@
 package com.bsd.pjcloud.hard.api.vo.spu;
 
+import com.bsd.pjcloud.admin.api.dto.user.SysUserStudentDto;
+import com.bsd.pjcloud.admin.api.dto.user.SysUserTeacherDto;
+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.spu.HardSpuRepertoryEntity;
 import com.bsd.pjcloud.hard.api.vo.base.BaseHardInterface;
@@ -7,7 +11,8 @@ import com.bsd.pjcloud.wallet.api.vo.base.BaseMchInterface;
 import lombok.Data;
 
 @Data
-public class HardSpuRepertoryVo extends HardSpuRepertoryEntity implements BaseMchInterface, BaseUserInterface, BaseHardInterface {
+/** 硬件商品库存更新记录展示对象，包含上架用户主资料、部门和身份信息。 */
+public class HardSpuRepertoryVo extends HardSpuRepertoryEntity implements BaseMchInterface, BaseUserInterface, BaseUserDeptInterface, BaseUserIdentityInterface, BaseHardInterface {
 
     /**
      * 商品相关
@@ -45,6 +50,52 @@ public class HardSpuRepertoryVo extends HardSpuRepertoryEntity implements BaseMc
 
     private String userAvatar;
 
+    /** 用户标准手机号字段，供统一身份组件展示；与历史 userMobile 字段并存。 */
+    private String phone;
+
+    /** 用户当前所属部门主键，由 UPMS 用户资料回填。 */
+    private Long userDeptId;
+
+    /** 用户当前所属部门名称，由 UPMS 用户资料回填。 */
+    private String userDeptName;
+
+    /** 用户所属部门展示名称，供用户信息单元格读取。 */
+    private String deptName;
+
+    /** 用户拥有的 UPMS 身份协议编码集合。 */
+    private java.util.List<String> identityTypes;
+
+    /** 用户的学生身份扩展资料；无学生身份时为空。 */
+    private SysUserStudentDto studentInfo;
+
+    /** 用户的老师身份扩展资料；无老师身份时为空。 */
+    private SysUserTeacherDto teacherInfo;
+
+    /** 获取 UPMS 返回的用户当前部门主键。 */
+    @Override
+    public Long getUserDeptId() {
+        return userDeptId;
+    }
+
+    /** 保存 UPMS 返回的用户当前部门主键。 */
+    @Override
+    public void setUserDeptId(Long userDeptId) {
+        this.userDeptId = userDeptId;
+    }
+
+    /** 获取 UPMS 返回的用户当前部门名称。 */
+    @Override
+    public String getUserDeptName() {
+        return userDeptName;
+    }
+
+    /** 保存 UPMS 返回的用户当前部门名称，并同步公共展示字段。 */
+    @Override
+    public void setUserDeptName(String userDeptName) {
+        this.userDeptName = userDeptName;
+        this.deptName = userDeptName;
+    }
+
     /**
      * 设备相关
      */