From f87ce86307056f63f79312178037cc8714eb2b13 Mon Sep 17 00:00:00 2001
From: 云 <2163098428@qq.com>
Date: 星期二, 29 九月 2026 14:17:52 +0800
Subject: [PATCH] feat(docs): 添加档案管理模块业务流程文档
---
yudao-module-ums/src/main/java/cn/iocoder/yudao/module/ums/service/member/UmsMemberServiceImpl.java | 69 ++++++++++++++++++++++++++++++++++
1 files changed, 69 insertions(+), 0 deletions(-)
diff --git a/yudao-module-ums/src/main/java/cn/iocoder/yudao/module/ums/service/member/UmsMemberServiceImpl.java b/yudao-module-ums/src/main/java/cn/iocoder/yudao/module/ums/service/member/UmsMemberServiceImpl.java
index c84cefe..aa99b99 100644
--- a/yudao-module-ums/src/main/java/cn/iocoder/yudao/module/ums/service/member/UmsMemberServiceImpl.java
+++ b/yudao-module-ums/src/main/java/cn/iocoder/yudao/module/ums/service/member/UmsMemberServiceImpl.java
@@ -3,7 +3,11 @@
import cn.hutool.core.util.StrUtil;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.archive.api.document.ArchiveDocumentApi;
+import cn.iocoder.yudao.module.archive.api.document.dto.ArchiveDocumentCreateReqDTO;
+import cn.iocoder.yudao.module.archive.api.document.dto.ArchiveDocumentRespDTO;
import cn.iocoder.yudao.module.system.api.storage.StorageAttachmentApi;
+import cn.iocoder.yudao.module.system.api.storage.dto.StorageBlobRespDTO;
import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
import cn.iocoder.yudao.module.system.api.user.dto.AdminUserCreateReqDTO;
import cn.iocoder.yudao.module.ums.controller.admin.member.vo.UmsMemberPageReqVO;
@@ -20,7 +24,9 @@
import java.time.LocalDate;
import java.util.Collections;
+import java.util.List;
import java.util.Set;
+import java.util.stream.Collectors;
import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
import static cn.iocoder.yudao.module.ums.enums.ErrorCodeConstants.*;
@@ -37,6 +43,18 @@
public static final String MEMBER_RECORD_TYPE = "ums_member";
+ /** 浼氬憳鐘舵�侊細姝ｅ父锛堝彲褰掓。锛� */
+ private static final Integer MEMBER_STATUS_NORMAL = 1;
+
+ /** 褰掓。鏉ユ簮绫诲瀷锛�3-浼氬憳锛堝搴� archive 妯″潡 source_type锛� */
+ private static final Integer ARCHIVE_SOURCE_TYPE_MEMBER = 3;
+
+ /** 褰掓。瀵嗙骇锛�2-鍐呴儴 */
+ private static final Integer ARCHIVE_SECRET_LEVEL_INTERNAL = 2;
+
+ /** 浼氬憳妗ｆ鍒嗙被缂栫爜锛堝搴� archive_category.code锛� */
+ private static final String ARCHIVE_CATEGORY_CODE_MEMBER = "member";
+
@Resource
private UmsMemberMapper memberMapper;
@@ -48,6 +66,9 @@
@Resource
private StorageAttachmentApi storageAttachmentApi;
+
+ @Resource
+ private ArchiveDocumentApi archiveDocumentApi;
@Override
@Transactional(rollbackFor = Exception.class)
@@ -145,6 +166,39 @@
return memberMapper.selectPage(pageReqVO);
}
+ @Override
+ @Transactional(rollbackFor = Exception.class)
+ public String archiveMember(Long id) {
+ // 1.1 鏍￠獙浼氬憳瀛樺湪
+ UmsMemberDO member = validateMemberExists(id);
+ // 1.2 鍙湁銆屾甯搞�嶇姸鎬佺殑浼氬憳鎵嶈兘褰掓。
+ if (!MEMBER_STATUS_NORMAL.equals(member.getStatus())) {
+ throw exception(MEMBER_ARCHIVE_FAIL_STATUS, member.getNo(), memberStatusName(member.getStatus()));
+ }
+ // 1.3 閲嶅褰掓。鏍￠獙
+ if (member.getArchiveDocumentId() != null) {
+ throw exception(MEMBER_ALREADY_ARCHIVED, member.getNo(),
+ StrUtil.blankToDefault(archiveNo(id), "鏈煡"));
+ }
+
+ // 2. 甯﹀叆浼氬憳鏉愭枡闄勪欢锛屾寜鏉ユ簮鍗曟嵁褰掓。
+ List<Long> blobIds = storageAttachmentApi.listAttachments(MEMBER_RECORD_TYPE, id).stream()
+ .map(StorageBlobRespDTO::getId).collect(Collectors.toList());
+ Long archiveDocumentId = archiveDocumentApi.archiveBySource(new ArchiveDocumentCreateReqDTO()
+ .setSourceType(ARCHIVE_SOURCE_TYPE_MEMBER)
+ .setSourceId(id)
+ .setSourceNo(member.getNo())
+ .setSourceTitle(member.getName())
+ .setCategoryCode(ARCHIVE_CATEGORY_CODE_MEMBER)
+ .setSecretLevel(ARCHIVE_SECRET_LEVEL_INTERNAL)
+ .setSummary("浼氬憳鏉愭枡褰掓。")
+ .setBlobIds(blobIds)).getCheckedData();
+
+ // 3. 鍥炲啓褰掓。妗ｆ ID锛堜綔涓哄凡褰掓。纭爣璁帮級
+ memberMapper.updateById(new UmsMemberDO().setId(id).setArchiveDocumentId(archiveDocumentId));
+ return StrUtil.blankToDefault(archiveNo(id), "鏈煡");
+ }
+
// =================== 鍐呴儴鏂规硶 ===================
private Long createSystemUser(UmsApplicationDO application) {
@@ -193,4 +247,19 @@
return member;
}
+ /** 浼氬憳鐘舵�佷腑鏂囧悕锛�1-姝ｅ父 0-鏆傚仠锛堢敤浜庡綊妗ｅけ璐ユ彁绀猴級 */
+ private String memberStatusName(Integer status) {
+ if (status == null) {
+ return "鏈煡";
+ }
+ return MEMBER_STATUS_NORMAL.equals(status) ? "姝ｅ父" : "鏆傚仠";
+ }
+
+ /** 鏌ヨ鏉ユ簮鍗曟嵁宸茬敓鎴愮殑妗ｆ缂栧彿锛堟湭褰掓。鏃惰繑鍥� null锛� */
+ private String archiveNo(Long memberId) {
+ ArchiveDocumentRespDTO archive = archiveDocumentApi
+ .getBySource(ARCHIVE_SOURCE_TYPE_MEMBER, memberId).getCheckedData();
+ return archive != null ? archive.getNo() : null;
+ }
+
}
\ No newline at end of file
--
Gitblit v1.9.3