Merge remote-tracking branch 'origin/dev' into dev

web-app/src/main/java/com/zcloud/primeport/command/DaHuaPersonSyncExe.java

@@ -20,7 +20,7 @@ import java.util.List;
 import java.util.Map;
 
 /**
- * 相关方人员同步大华平台。
+ * 相关方及临时访客人员同步大华平台。
  */
 @Slf4j
 @Component
@@ -28,6 +28,7 @@ import java.util.Map;
 public class DaHuaPersonSyncExe {
 
     private static final int RELATED_PARTY = 3;
+    private static final int TEMPORARY_VISITOR = 4;
 
     private final DaHuaGateway daHuaGateway;
     private final PersonApplyGateway personApplyGateway;
@@ -36,11 +37,11 @@ public class DaHuaPersonSyncExe {
     private String fileUrl;
 
     /**
-     * 相关方人员审核通过后，按证件号判断新增或更新大华人员。
+     * 相关方及临时访客人员审核通过后，按证件号判断新增或更新大华人员。
      */
     public void syncApprovedPersons(Long applyId) {
         XgfApplyPersonE apply = personApplyGateway.getXgfApplyPersonById(applyId);
-        if (apply == null || !Integer.valueOf(RELATED_PARTY).equals(apply.getPersonBelongType())) {
+        if (apply == null || !isDahuaSyncPerson(apply.getPersonBelongType())) {
             return;
         }
         List<PersonApplyE> persons = personApplyGateway.personListByxgfApplyPersonId(applyId);
@@ -65,10 +66,10 @@ public class DaHuaPersonSyncExe {
     }
 
     /**
-     * 相关方人员信息修改后，同步更新大华人员。
+     * 相关方及临时访客人员信息修改后，同步更新大华人员。
      */
     public void syncUpdatedPerson(PersonApplyE original, PersonApplyUpdateCmd updated) {
-        if (original == null || !Integer.valueOf(RELATED_PARTY).equals(updated.getPersonBelongType())) {
+        if (original == null || !isDahuaSyncPerson(updated.getPersonBelongType())) {
             return;
         }
         String originalPaperNumber = decodeUserCard(original.getUserCard());
@@ -84,7 +85,7 @@ public class DaHuaPersonSyncExe {
     }
 
     /**
-     * 删除相关方人员时，同步删除对应的大华人员。
+     * 删除相关方及临时访客人员时，同步删除对应的大华人员。
      */
     public void syncDeletedPersons(List<PersonApplyE> persons) {
         if (persons == null || persons.isEmpty()) {
@@ -93,7 +94,7 @@ public class DaHuaPersonSyncExe {
         List<Long> dahuaPersonIds = new ArrayList<>();
         for (PersonApplyE person : persons) {
             XgfApplyPersonE apply = personApplyGateway.getXgfApplyPersonById(person.getXgfApplyPersonId());
-            if (apply == null || !Integer.valueOf(RELATED_PARTY).equals(apply.getPersonBelongType())) {
+            if (apply == null || !isDahuaSyncPerson(apply.getPersonBelongType())) {
                 continue;
             }
             Long dahuaPersonId = daHuaGateway.findPersonIdByPaperNumber(decodeUserCard(person.getUserCard()));
@@ -132,12 +133,12 @@ public class DaHuaPersonSyncExe {
     }
 
     /**
-     * 根据文件服务地址读取相关方人员头像并转换为图片 Base64。
+     * 根据文件服务地址读取人员头像并转换为图片 Base64。
      * 大华人员接口的 path 必须是大华图片上传接口返回的 fileUrl，不能直接使用本系统路径。
      */
     private String resolveFaceBase64(String faceUrl) {
         if (faceUrl == null || faceUrl.trim().isEmpty()) {
-            throw new BizException("相关方人员头像不能为空");
+            throw new BizException("人员头像不能为空");
         }
         if (fileUrl == null || fileUrl.trim().isEmpty()) {
             throw new BizException("文件访问地址未配置");
@@ -150,14 +151,14 @@ public class DaHuaPersonSyncExe {
         try {
             String faceBase64 = Base64Util.urlToBase64(imageUrl);
             if (faceBase64 == null || faceBase64.trim().isEmpty()) {
-                throw new BizException("相关方人员头像转换失败");
+                throw new BizException("人员头像转换失败");
             }
             return faceBase64;
         } catch (BizException e) {
             throw e;
         } catch (Exception e) {
-            log.error("获取相关方人员头像失败, imageUrl={}", imageUrl, e);
+            log.error("获取人员头像失败, imageUrl={}", imageUrl, e);
-            throw new BizException("获取相关方人员头像失败");
+            throw new BizException("获取人员头像失败");
         }
     }
 
@@ -165,6 +166,11 @@ public class DaHuaPersonSyncExe {
         return path.startsWith("/") ? path.substring(1) : path;
     }
 
+    private boolean isDahuaSyncPerson(Integer personBelongType) {
+        return Integer.valueOf(RELATED_PARTY).equals(personBelongType)
+                || Integer.valueOf(TEMPORARY_VISITOR).equals(personBelongType);
+    }
+
     private String decodeUserCard(String userCard) {
         try {
             return Base64.decodeToString(userCard);