From 241e9b0c4605da7b0ca749a62caffab3a93bf3fa Mon Sep 17 00:00:00 2001
From: dzc <2388224167@qq.com>
Date: Thu, 10 Sep 2026 15:34:34 +0800
Subject: [PATCH] =?UTF-8?q?feat:=E4=BA=BA=E8=84=B8=E8=B4=A8=E9=87=8F?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../pjcloud/admin/api/dto/SysUserFaceDto.java |  8 +++++++
 .../resources/mapper/SysUserFaceMapper.xml    | 22 +++++++++++++++++++
 2 files changed, 30 insertions(+)

diff --git a/pjcloud-upms/pjcloud-upms-api/src/main/java/com/bsd/pjcloud/admin/api/dto/SysUserFaceDto.java b/pjcloud-upms/pjcloud-upms-api/src/main/java/com/bsd/pjcloud/admin/api/dto/SysUserFaceDto.java
index 96b976f53..dd82f28fb 100644
--- a/pjcloud-upms/pjcloud-upms-api/src/main/java/com/bsd/pjcloud/admin/api/dto/SysUserFaceDto.java
+++ b/pjcloud-upms/pjcloud-upms-api/src/main/java/com/bsd/pjcloud/admin/api/dto/SysUserFaceDto.java
@@ -36,4 +36,12 @@ public class SysUserFaceDto extends SysUserFaceEntity implements BaseIsIncludeTr
     private String username;
 
     private String phone;
+
+    /**
+     * 人脸质量查询分类。
+     *
+     * <p>分页查询支持 {@code qualified}（质量分大于等于固定阈值）、{@code low}（质量分低于固定阈值）、
+     * {@code failed}（检测失败）和 {@code pending}（未检测）；为空或未知值时不按质量过滤。</p>
+     */
+    private String qualityCategory;
 }
diff --git a/pjcloud-upms/pjcloud-upms-biz/src/main/resources/mapper/SysUserFaceMapper.xml b/pjcloud-upms/pjcloud-upms-biz/src/main/resources/mapper/SysUserFaceMapper.xml
index ad805e185..96a17d84b 100644
--- a/pjcloud-upms/pjcloud-upms-biz/src/main/resources/mapper/SysUserFaceMapper.xml
+++ b/pjcloud-upms/pjcloud-upms-biz/src/main/resources/mapper/SysUserFaceMapper.xml
@@ -10,6 +10,11 @@
                a.process_id,
                a.process_status,
                a.face_img,
+               a.quality_score,
+               a.quality_status,
+               a.quality_checked_at,
+               a.quality_error_code,
+               a.quality_device_id,
                a.create_by,
                a.create_time,
                a.update_by,
@@ -33,6 +38,23 @@
         <if test="pa.processStatus != null">
             and a.process_status = #{pa.processStatus}
         </if>
+        <!-- 固定 0.60 阈值与终端默认在库阈值、PC 列表质量标签的分类规则保持一致。 -->
+        <if test="pa.qualityCategory != null and pa.qualityCategory != ''">
+            <choose>
+                <when test="pa.qualityCategory == 'qualified'">
+                    and a.quality_status = 'detected' and a.quality_score &gt;= 0.60
+                </when>
+                <when test="pa.qualityCategory == 'low'">
+                    and a.quality_status = 'detected' and a.quality_score &lt; 0.60
+                </when>
+                <when test="pa.qualityCategory == 'failed'">
+                    and a.quality_status = 'failed'
+                </when>
+                <when test="pa.qualityCategory == 'pending'">
+                    and a.quality_status is null
+                </when>
+            </choose>
+        </if>
         <if test="pa.isProcessIdNotNull != null and pa.isProcessIdNotNull == true ">
             and a.process_id is not null
         </if>