feat: 新增资产/用车/采购模块，完善课题、会员、财务与企微功能

liu

10 小时以前 5d34bdd3c426bb2ca5f6627424ae67984f745603

 yudao-module-ums/src/main/java/cn/iocoder/yudao/module/ums/service/member/UmsMemberServiceImpl.java

@@ -1,9 +1,14 @@
package cn.iocoder.yudao.module.ums.service.member;

import cn.hutool.core.util.StrUtil;
import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
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 +25,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.*;
@@ -35,7 +42,26 @@
     */
    private static final Long MEMBER_DEPT_ID = 129L;

    /**
     * 普通会员角色 ID（system_role「普通会员」）
     *
     * <p>该角色只分配「我的资料」菜单，不包含档案管理等后台菜单，用于实现权限隔离。
     */
    private static final Long MEMBER_ROLE_ID = 9100L;

    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 +74,9 @@

    @Resource
    private StorageAttachmentApi storageAttachmentApi;

    @Resource
    private ArchiveDocumentApi archiveDocumentApi;

    @Override
    @Transactional(rollbackFor = Exception.class)
@@ -96,6 +125,7 @@

        // 会员等级与类型匹配校验
        validateMemberGrade(createReqVO.getMemberType(), createReqVO.getMemberGrade());
        validateFeePaid(createReqVO);

        UmsMemberDO member = BeanUtils.toBean(createReqVO, UmsMemberDO.class, in -> in
                .setNo(no)
@@ -114,9 +144,21 @@
    public void updateMember(UmsMemberSaveReqVO updateReqVO) {
        validateMemberExists(updateReqVO.getId());
        validateMemberGrade(updateReqVO.getMemberType(), updateReqVO.getMemberGrade());
        validateFeePaid(updateReqVO);

        // 取消「已缴纳会费」时需要把缴费年度真正清空（updateById 会忽略 null 字段）
        boolean clearFeeYear = Boolean.FALSE.equals(updateReqVO.getFeePaid());
        if (clearFeeYear) {
            updateReqVO.setFeeYear(null);
        }

        UmsMemberDO updateObj = BeanUtils.toBean(updateReqVO, UmsMemberDO.class);
        memberMapper.updateById(updateObj);
        if (clearFeeYear) {
            memberMapper.update(null, new LambdaUpdateWrapper<UmsMemberDO>()
                    .eq(UmsMemberDO::getId, updateReqVO.getId())
                    .set(UmsMemberDO::getFeeYear, null));
        }

        storageAttachmentApi.updateAttachments("file", MEMBER_RECORD_TYPE,
                updateReqVO.getId(), updateReqVO.getBlobIds());
@@ -145,6 +187,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) {
@@ -159,6 +234,7 @@
                    .setNickname(nickname)
                    .setDeptId(MEMBER_DEPT_ID)
                    .setPostIds(Collections.emptySet())
                    .setRoleIds(Collections.singleton(MEMBER_ROLE_ID))
                    .setMobile(mobile)
                    .setPassword(mobile) // 默认密码为手机号
                    .setEmail(application.getContactEmail())
@@ -176,6 +252,13 @@
    /**
     * 校验会员等级与类型匹配：单位会员（type=2）不可选个人专有等级「5-理事长」
     */
    /** 已缴纳会费时必须填写缴费年度 */
    private void validateFeePaid(UmsMemberSaveReqVO reqVO) {
        if (Boolean.TRUE.equals(reqVO.getFeePaid()) && reqVO.getFeeYear() == null) {
            throw exception(MEMBER_FEE_YEAR_REQUIRED);
        }
    }

    private void validateMemberGrade(Integer memberType, String memberGrade) {
        if (memberType == null || StrUtil.isBlank(memberGrade)) {
            return;
@@ -193,4 +276,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;
    }

}