package cn.iocoder.yudao.module.ums.service.member;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.ums.controller.admin.member.vo.UmsMemberPageReqVO;
import cn.iocoder.yudao.module.ums.controller.admin.member.vo.UmsMemberSaveReqVO;
import cn.iocoder.yudao.module.ums.dal.dataobject.application.UmsApplicationDO;
import cn.iocoder.yudao.module.ums.dal.dataobject.member.UmsMemberDO;

import jakarta.validation.Valid;

public interface UmsMemberService {

    /**
     * 从入会申请单创建会员（审批通过钩子）
     */
    UmsMemberDO createMemberFromApplication(UmsApplicationDO application);

    Long createMember(@Valid UmsMemberSaveReqVO createReqVO);

    void updateMember(@Valid UmsMemberSaveReqVO updateReqVO);

    void deleteMember(Long id);

    UmsMemberDO getMember(Long id);

    UmsMemberDO getMemberByUserId(Long userId);

    PageResult<UmsMemberDO> getMemberPage(UmsMemberPageReqVO pageReqVO);

    /**
     * 将「正常」状态的会员按来源单据归档到档案管理，并回写归档档案 ID
     *
     * @param id 会员编号
     * @return 生成的档案编号（用于前端提示）
     */
    String archiveMember(Long id);

}