package cn.iocoder.yudao.module.crm.service.clue;
|
|
import cn.hutool.core.collection.CollUtil;
|
import cn.hutool.core.lang.Assert;
|
import cn.hutool.core.util.StrUtil;
|
import cn.hutool.extra.spring.SpringUtil;
|
import cn.iocoder.yudao.framework.common.exception.ServiceException;
|
import cn.iocoder.yudao.framework.common.pojo.PageResult;
|
import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
|
import cn.iocoder.yudao.module.crm.controller.admin.clue.vo.CrmClueImportExcelVO;
|
import cn.iocoder.yudao.module.crm.controller.admin.clue.vo.CrmClueImportReqVO;
|
import cn.iocoder.yudao.module.crm.controller.admin.clue.vo.CrmClueImportRespVO;
|
import cn.iocoder.yudao.module.crm.controller.admin.clue.vo.CrmCluePageReqVO;
|
import cn.iocoder.yudao.module.crm.controller.admin.clue.vo.CrmClueSaveReqVO;
|
import cn.iocoder.yudao.module.crm.controller.admin.clue.vo.CrmClueTransferReqVO;
|
import cn.iocoder.yudao.module.crm.controller.admin.customer.vo.customer.CrmCustomerSaveReqVO;
|
import cn.iocoder.yudao.module.crm.dal.dataobject.clue.CrmClueDO;
|
import cn.iocoder.yudao.module.crm.dal.dataobject.followup.CrmFollowUpRecordDO;
|
import cn.iocoder.yudao.module.crm.dal.mysql.clue.CrmClueMapper;
|
import cn.iocoder.yudao.module.crm.enums.common.CrmBizTypeEnum;
|
import cn.iocoder.yudao.module.crm.enums.permission.CrmPermissionLevelEnum;
|
import cn.iocoder.yudao.module.crm.framework.permission.core.annotations.CrmPermission;
|
import cn.iocoder.yudao.module.crm.service.customer.CrmCustomerService;
|
import cn.iocoder.yudao.module.crm.service.customer.bo.CrmCustomerCreateReqBO;
|
import cn.iocoder.yudao.module.crm.service.followup.CrmFollowUpRecordService;
|
import cn.iocoder.yudao.module.crm.service.followup.bo.CrmFollowUpCreateReqBO;
|
import cn.iocoder.yudao.module.crm.service.permission.CrmPermissionService;
|
import cn.iocoder.yudao.module.crm.service.permission.bo.CrmPermissionCreateReqBO;
|
import cn.iocoder.yudao.module.crm.service.permission.bo.CrmPermissionTransferReqBO;
|
import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
|
import com.mzt.logapi.context.LogRecordContext;
|
import com.mzt.logapi.service.impl.DiffParseFunction;
|
import com.mzt.logapi.starter.annotation.LogRecord;
|
import jakarta.annotation.Resource;
|
import org.springframework.stereotype.Service;
|
import org.springframework.transaction.annotation.Transactional;
|
import org.springframework.validation.annotation.Validated;
|
|
import java.time.LocalDateTime;
|
import java.util.ArrayList;
|
import java.util.LinkedHashMap;
|
import java.util.List;
|
import java.util.Objects;
|
|
import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
|
import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
|
import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.filterList;
|
import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.singleton;
|
import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
|
import static cn.iocoder.yudao.module.crm.enums.ErrorCodeConstants.*;
|
import static cn.iocoder.yudao.module.crm.enums.LogRecordConstants.*;
|
import static cn.iocoder.yudao.module.system.enums.ErrorCodeConstants.USER_NOT_EXISTS;
|
|
/**
|
* 线索 Service 实现类
|
*
|
* @author Wanwan
|
*/
|
@Service
|
@Validated
|
public class CrmClueServiceImpl implements CrmClueService {
|
|
@Resource
|
private CrmClueMapper clueMapper;
|
|
@Resource
|
private CrmCustomerService customerService;
|
@Resource
|
private CrmPermissionService crmPermissionService;
|
@Resource
|
private CrmFollowUpRecordService followUpRecordService;
|
|
@Resource
|
private AdminUserApi adminUserApi;
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
@LogRecord(type = CRM_CLUE_TYPE, subType = CRM_CLUE_CREATE_SUB_TYPE, bizNo = "{{#clue.id}}",
|
success = CRM_CLUE_CREATE_SUCCESS)
|
public Long createClue(CrmClueSaveReqVO createReqVO) {
|
// 1.1 校验关联数据
|
validateRelationDataExists(createReqVO);
|
// 1.2 校验负责人是否存在
|
adminUserApi.validateUser(createReqVO.getOwnerUserId());
|
|
// 2. 插入线索
|
CrmClueDO clue = BeanUtils.toBean(createReqVO, CrmClueDO.class);
|
clueMapper.insert(clue);
|
|
// 3. 创建数据权限
|
CrmPermissionCreateReqBO createReqBO = new CrmPermissionCreateReqBO().setBizType(CrmBizTypeEnum.CRM_CLUE.getType())
|
.setBizId(clue.getId()).setUserId(clue.getOwnerUserId()).setLevel(CrmPermissionLevelEnum.OWNER.getLevel());
|
crmPermissionService.createPermission(createReqBO);
|
|
// 4. 记录操作日志上下文
|
LogRecordContext.putVariable("clue", clue);
|
return clue.getId();
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
@LogRecord(type = CRM_CLUE_TYPE, subType = CRM_CLUE_UPDATE_SUB_TYPE, bizNo = "{{#updateReqVO.id}}",
|
success = CRM_CLUE_UPDATE_SUCCESS)
|
@CrmPermission(bizType = CrmBizTypeEnum.CRM_CLUE, bizId = "#updateReqVO.id", level = CrmPermissionLevelEnum.OWNER)
|
public void updateClue(CrmClueSaveReqVO updateReqVO) {
|
Assert.notNull(updateReqVO.getId(), "线索编号不能为空");
|
// 1.1 校验线索是否存在
|
CrmClueDO oldClue = validateClueExists(updateReqVO.getId());
|
// 1.2 校验关联数据
|
validateRelationDataExists(updateReqVO);
|
|
// 2. 更新线索
|
CrmClueDO updateObj = BeanUtils.toBean(updateReqVO, CrmClueDO.class);
|
clueMapper.updateById(updateObj);
|
|
// 3. 记录操作日志上下文
|
updateReqVO.setOwnerUserId(oldClue.getOwnerUserId()); // 避免操作日志出现“删除负责人”的情况
|
LogRecordContext.putVariable(DiffParseFunction.OLD_OBJECT, BeanUtils.toBean(oldClue, CrmClueSaveReqVO.class));
|
LogRecordContext.putVariable("clueName", oldClue.getName());
|
}
|
|
private void validateRelationDataExists(CrmClueSaveReqVO reqVO) {
|
// 校验负责人
|
if (Objects.nonNull(reqVO.getOwnerUserId()) &&
|
Objects.isNull(adminUserApi.getUser(reqVO.getOwnerUserId()))) {
|
throw exception(USER_NOT_EXISTS);
|
}
|
}
|
|
@Override
|
@LogRecord(type = CRM_CLUE_TYPE, subType = CRM_CLUE_FOLLOW_UP_SUB_TYPE, bizNo = "{{#id}}",
|
success = CRM_CLUE_FOLLOW_UP_SUCCESS)
|
@CrmPermission(bizType = CrmBizTypeEnum.CRM_CLUE, bizId = "#id", level = CrmPermissionLevelEnum.WRITE)
|
public void updateClueFollowUp(Long id, LocalDateTime contactNextTime, String contactLastContent) {
|
// 校验线索是否存在
|
CrmClueDO oldClue = validateClueExists(id);
|
|
// 更新线索
|
clueMapper.updateById(new CrmClueDO().setId(id).setFollowUpStatus(true).setContactNextTime(contactNextTime)
|
.setContactLastTime(LocalDateTime.now()).setContactLastContent(contactLastContent));
|
|
// 3. 记录操作日志上下文
|
LogRecordContext.putVariable("clueName", oldClue.getName());
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
@LogRecord(type = CRM_CLUE_TYPE, subType = CRM_CLUE_DELETE_SUB_TYPE, bizNo = "{{#id}}",
|
success = CRM_CLUE_DELETE_SUCCESS)
|
@CrmPermission(bizType = CrmBizTypeEnum.CRM_CLUE, bizId = "#id", level = CrmPermissionLevelEnum.OWNER)
|
public void deleteClue(Long id) {
|
// 1. 校验存在
|
CrmClueDO clue = validateClueExists(id);
|
|
// 2. 删除
|
clueMapper.deleteById(id);
|
|
// 3. 删除数据权限
|
crmPermissionService.deletePermission(CrmBizTypeEnum.CRM_CLUE.getType(), id);
|
|
// 4. 删除跟进
|
followUpRecordService.deleteFollowUpRecordByBiz(CrmBizTypeEnum.CRM_CLUE.getType(), id);
|
|
// 5. 记录操作日志上下文
|
LogRecordContext.putVariable("clueName", clue.getName());
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
@LogRecord(type = CRM_CLUE_TYPE, subType = CRM_CLUE_TRANSFER_SUB_TYPE, bizNo = "{{#reqVO.id}}",
|
success = CRM_CLUE_TRANSFER_SUCCESS)
|
@CrmPermission(bizType = CrmBizTypeEnum.CRM_CLUE, bizId = "#reqVO.id", level = CrmPermissionLevelEnum.OWNER)
|
public void transferClue(CrmClueTransferReqVO reqVO, Long userId) {
|
// 1 校验线索是否存在
|
CrmClueDO clue = validateClueExists(reqVO.getId());
|
|
// 2.1 数据权限转移
|
crmPermissionService.transferPermission(new CrmPermissionTransferReqBO(userId, CrmBizTypeEnum.CRM_CLUE.getType(),
|
reqVO.getId(), reqVO.getNewOwnerUserId(), reqVO.getOldOwnerPermissionLevel()));
|
// 2.2 设置新的负责人
|
clueMapper.updateById(new CrmClueDO().setId(reqVO.getId()).setOwnerUserId(reqVO.getNewOwnerUserId()));
|
|
// 3. 记录转移日志
|
LogRecordContext.putVariable("clue", clue);
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
@LogRecord(type = CRM_CLUE_TYPE, subType = CRM_CLUE_TRANSLATE_SUB_TYPE, bizNo = "{{#id}}",
|
success = CRM_CLUE_TRANSLATE_SUCCESS)
|
@CrmPermission(bizType = CrmBizTypeEnum.CRM_CLUE, bizId = "#id", level = CrmPermissionLevelEnum.OWNER)
|
public void transformClue(Long id, Long userId) {
|
// 1.1 校验线索都存在
|
CrmClueDO clue = validateClueExists(id);
|
// 1.2 存在已经转化的
|
if (clue.getTransformStatus()) {
|
throw exception(CLUE_TRANSFORM_FAIL_ALREADY);
|
}
|
|
// 2.1 遍历线索(未转化的线索)，创建对应的客户
|
Long customerId = customerService.createCustomer(BeanUtils.toBean(clue, CrmCustomerCreateReqBO.class), userId);
|
// 2.2 更新线索
|
clueMapper.updateById(new CrmClueDO().setId(id).setTransformStatus(Boolean.TRUE).setCustomerId(customerId));
|
// 2.3 复制跟进记录
|
List<CrmFollowUpRecordDO> followUpRecords = followUpRecordService.getFollowUpRecordByBiz(
|
CrmBizTypeEnum.CRM_CLUE.getType(), singleton(clue.getId()));
|
if (CollUtil.isNotEmpty(followUpRecords)) {
|
followUpRecordService.createFollowUpRecordBatch(convertList(followUpRecords, record ->
|
BeanUtils.toBean(record, CrmFollowUpCreateReqBO.class)
|
.setBizType(CrmBizTypeEnum.CRM_CUSTOMER.getType()).setBizId(customerId)));
|
}
|
|
// 3. 记录操作日志上下文
|
LogRecordContext.putVariable("clueName", clue.getName());
|
}
|
|
private CrmClueDO validateClueExists(Long id) {
|
CrmClueDO crmClueDO = clueMapper.selectById(id);
|
if (crmClueDO == null) {
|
throw exception(CLUE_NOT_EXISTS);
|
}
|
return crmClueDO;
|
}
|
|
@Override
|
@CrmPermission(bizType = CrmBizTypeEnum.CRM_CLUE, bizId = "#id", level = CrmPermissionLevelEnum.READ)
|
public CrmClueDO getClue(Long id) {
|
return clueMapper.selectById(id);
|
}
|
|
@Override
|
public PageResult<CrmClueDO> getCluePage(CrmCluePageReqVO pageReqVO, Long userId) {
|
return clueMapper.selectPage(pageReqVO, userId);
|
}
|
|
@Override
|
public Long getFollowClueCount(Long userId) {
|
return clueMapper.selectCountByFollow(userId);
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public CrmClueImportRespVO importClueList(List<CrmClueImportExcelVO> importClues,
|
CrmClueImportReqVO importReqVO) {
|
// 1. 校验非空
|
importClues = filterList(importClues, item -> StrUtil.isNotBlank(item.getName()));
|
if (CollUtil.isEmpty(importClues)) {
|
throw exception(CLUE_IMPORT_LIST_IS_EMPTY);
|
}
|
// 2. 校验负责人（为空则默认当前操作人）
|
Long ownerUserId = importReqVO.getOwnerUserId() != null ? importReqVO.getOwnerUserId() : getLoginUserId();
|
adminUserApi.validateUser(ownerUserId);
|
|
// 3. 逐条处理
|
CrmClueImportRespVO respVO = CrmClueImportRespVO.builder()
|
.createClueNames(new ArrayList<>())
|
.updateClueNames(new ArrayList<>())
|
.failureClueNames(new LinkedHashMap<>())
|
.build();
|
importClues.forEach(importClue -> {
|
try {
|
// 3.1 判断是否存在
|
CrmClueDO existClue = clueMapper.selectByName(importClue.getName());
|
if (existClue == null) {
|
// 3.1.1 新增
|
CrmClueDO clue = BeanUtils.toBean(importClue, CrmClueDO.class)
|
.setOwnerUserId(ownerUserId);
|
clueMapper.insert(clue);
|
// 创建数据权限
|
crmPermissionService.createPermission(new CrmPermissionCreateReqBO()
|
.setBizType(CrmBizTypeEnum.CRM_CLUE.getType()).setBizId(clue.getId())
|
.setUserId(ownerUserId).setLevel(CrmPermissionLevelEnum.OWNER.getLevel()));
|
respVO.getCreateClueNames().add(importClue.getName());
|
// 记录操作日志
|
getSelf().importClueLog(clue, false);
|
return;
|
}
|
// 3.1.2 已存在，判断是否允许更新
|
if (!importReqVO.getUpdateSupport()) {
|
respVO.getFailureClueNames().put(importClue.getName(),
|
StrUtil.format(CLUE_NAME_EXISTS.getMsg(), importClue.getName()));
|
return;
|
}
|
CrmClueDO updateClue = BeanUtils.toBean(importClue, CrmClueDO.class)
|
.setId(existClue.getId());
|
clueMapper.updateById(updateClue);
|
respVO.getUpdateClueNames().add(importClue.getName());
|
// 记录操作日志
|
getSelf().importClueLog(updateClue, true);
|
} catch (ServiceException ex) {
|
respVO.getFailureClueNames().put(importClue.getName(), ex.getMessage());
|
}
|
});
|
return respVO;
|
}
|
|
/**
|
* 记录导入线索时的操作日志
|
*
|
* @param clue 线索信息
|
* @param isUpdate 是否更新；true - 更新，false - 新增
|
*/
|
@LogRecord(type = CRM_CLUE_TYPE, subType = CRM_CLUE_IMPORT_SUB_TYPE, bizNo = "{{#clue.id}}",
|
success = CRM_CLUE_IMPORT_SUCCESS)
|
public void importClueLog(CrmClueDO clue, boolean isUpdate) {
|
LogRecordContext.putVariable("clue", clue);
|
LogRecordContext.putVariable("isUpdate", isUpdate);
|
}
|
|
/**
|
* 获得自身的代理对象，解决 AOP 生效问题
|
*
|
* @return 自己
|
*/
|
private CrmClueServiceImpl getSelf() {
|
return SpringUtil.getBean(getClass());
|
}
|
|
}
|
