package cn.iocoder.yudao.module.crm.service.contract;
|
|
import cn.hutool.core.collection.CollUtil;
|
import cn.hutool.core.collection.ListUtil;
|
import cn.hutool.core.lang.Assert;
|
import cn.hutool.core.util.ObjUtil;
|
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.number.MoneyUtils;
|
import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
|
import cn.iocoder.yudao.framework.common.util.object.ObjectUtils;
|
import cn.iocoder.yudao.module.crm.controller.admin.contract.vo.contract.CrmContractImportExcelVO;
|
import cn.iocoder.yudao.module.crm.controller.admin.contract.vo.contract.CrmContractImportReqVO;
|
import cn.iocoder.yudao.module.crm.controller.admin.contract.vo.contract.CrmContractImportRespVO;
|
import cn.iocoder.yudao.module.crm.controller.admin.contract.vo.contract.CrmContractPageReqVO;
|
import cn.iocoder.yudao.module.crm.controller.admin.contract.vo.contract.CrmContractSaveReqVO;
|
import cn.iocoder.yudao.module.crm.controller.admin.contract.vo.contract.CrmContractTransferReqVO;
|
import cn.iocoder.yudao.module.crm.dal.dataobject.contract.CrmContractConfigDO;
|
import cn.iocoder.yudao.module.crm.dal.dataobject.contract.CrmContractDO;
|
import cn.iocoder.yudao.module.crm.dal.dataobject.contract.CrmContractProductDO;
|
import cn.iocoder.yudao.module.crm.dal.dataobject.customer.CrmCustomerDO;
|
import cn.iocoder.yudao.module.crm.dal.dataobject.quotation.CrmSaleQuotationDO;
|
import cn.iocoder.yudao.module.crm.dal.dataobject.quotation.CrmSaleQuotationProductDO;
|
import cn.iocoder.yudao.module.crm.dal.mysql.contract.CrmContractMapper;
|
import cn.iocoder.yudao.module.crm.dal.mysql.contract.CrmContractProductMapper;
|
import cn.iocoder.yudao.module.crm.dal.mysql.customer.CrmCustomerMapper;
|
import cn.iocoder.yudao.module.crm.dal.redis.no.CrmNoRedisDAO;
|
import cn.iocoder.yudao.module.crm.enums.common.CrmAuditStatusEnum;
|
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.business.CrmBusinessService;
|
import cn.iocoder.yudao.module.crm.service.contact.CrmContactService;
|
import cn.iocoder.yudao.module.crm.service.customer.CrmCustomerService;
|
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.crm.service.quotation.CrmSaleQuotationService;
|
import cn.iocoder.yudao.module.crm.service.receivable.CrmReceivableService;
|
import cn.iocoder.yudao.module.bpm.api.task.BpmProcessInstanceApi;
|
import cn.iocoder.yudao.module.bpm.api.task.dto.BpmProcessInstanceCreateReqDTO;
|
import cn.iocoder.yudao.module.bpm.enums.task.BpmTaskStatusEnum;
|
import cn.iocoder.yudao.module.erp.api.sale.ErpSaleOrderApi;
|
import cn.iocoder.yudao.module.erp.api.sale.dto.ErpSaleOrderCreateReqDTO;
|
import cn.iocoder.yudao.module.erp.api.sale.dto.ErpSaleOrderRespDTO;
|
import cn.iocoder.yudao.module.mdm.api.item.MdmItemApi;
|
import cn.iocoder.yudao.module.mdm.api.item.dto.MdmItemRespDTO;
|
import cn.iocoder.yudao.module.system.api.approval.ApprovalConfigApi;
|
import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
|
import cn.iocoder.yudao.module.system.api.user.dto.AdminUserRespDTO;
|
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 lombok.extern.slf4j.Slf4j;
|
import org.springframework.context.annotation.Lazy;
|
import org.springframework.stereotype.Service;
|
import org.springframework.transaction.annotation.Transactional;
|
import org.springframework.validation.annotation.Validated;
|
|
import java.math.BigDecimal;
|
import java.time.LocalDateTime;
|
import java.util.ArrayList;
|
import java.util.Collection;
|
import java.util.Collections;
|
import java.util.HashMap;
|
import java.util.LinkedHashMap;
|
import java.util.List;
|
import java.util.Map;
|
import java.util.Set;
|
|
import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
|
import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.*;
|
import static cn.iocoder.yudao.module.crm.enums.ErrorCodeConstants.*;
|
import static cn.iocoder.yudao.module.crm.enums.LogRecordConstants.*;
|
import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
|
|
/**
|
* CRM 合同 Service 实现类
|
*
|
* @author dhb52
|
*/
|
@Service
|
@Validated
|
@Slf4j
|
public class CrmContractServiceImpl implements CrmContractService {
|
|
/**
|
* CRM 合同审批的业务类型编码
|
*
|
* 与 system_approval_config.biz_type 对应，审批人在「系统管理 - 审批配置」中维护。
|
*/
|
private static final String CONTRACT_APPROVE_BIZ_TYPE = "contract_approve";
|
|
/**
|
* CRM 合同审批的 BPM 流程定义 Key
|
*/
|
private static final String CONTRACT_APPROVE_PROCESS_KEY = "contract_approve";
|
|
@Resource
|
private CrmContractMapper contractMapper;
|
@Resource
|
private CrmContractProductMapper contractProductMapper;
|
@Resource
|
private CrmCustomerMapper customerMapper;
|
|
@Resource
|
private CrmNoRedisDAO noRedisDAO;
|
|
@Resource
|
private CrmPermissionService crmPermissionService;
|
@Resource
|
private CrmCustomerService customerService;
|
@Resource
|
private CrmBusinessService businessService;
|
@Resource
|
private CrmContactService contactService;
|
@Resource
|
private CrmContractConfigService contractConfigService;
|
@Resource
|
@Lazy // 延迟加载，避免循环依赖
|
private CrmReceivableService receivableService;
|
@Resource
|
private AdminUserApi adminUserApi;
|
@Resource
|
private ApprovalConfigApi approvalConfigApi;
|
@Resource
|
private BpmProcessInstanceApi bpmProcessInstanceApi;
|
@Resource
|
private ErpSaleOrderApi saleOrderApi;
|
@Resource
|
private MdmItemApi mdmItemApi;
|
@Resource
|
@Lazy // 延迟加载，避免循环依赖（quotation 内部引用了 contractService）
|
private CrmSaleQuotationService crmSaleQuotationService;
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
@LogRecord(type = CRM_CONTRACT_TYPE, subType = CRM_CONTRACT_CREATE_SUB_TYPE, bizNo = "{{#contract.id}}",
|
success = CRM_CONTRACT_CREATE_SUCCESS)
|
public Long createContract(CrmContractSaveReqVO createReqVO, Long userId) {
|
// 1.1 校验产品项的有效性
|
List<CrmContractProductDO> contractProducts = validateContractProducts(createReqVO.getProducts());
|
// 1.2 校验关联字段
|
validateRelationDataExists(createReqVO);
|
// 1.3 生成序号
|
String no = noRedisDAO.generate(CrmNoRedisDAO.CONTRACT_NO_PREFIX);
|
if (contractMapper.selectByNo(no) != null) {
|
throw exception(CONTRACT_NO_EXISTS);
|
}
|
|
// 2.1 插入合同
|
CrmContractDO contract = BeanUtils.toBean(createReqVO, CrmContractDO.class)
|
.setNo(no)
|
.setAuditStatus(CrmAuditStatusEnum.DRAFT.getStatus()); // 默认为未提交状态
|
calculateTotalPrice(contract, contractProducts);
|
contractMapper.insert(contract);
|
// 2.2 插入合同关联商品
|
if (CollUtil.isNotEmpty(contractProducts)) {
|
contractProducts.forEach(item -> item.setContractId(contract.getId()));
|
contractProductMapper.insertBatch(contractProducts);
|
}
|
|
// 3. 创建数据权限
|
crmPermissionService.createPermission(new CrmPermissionCreateReqBO().setUserId(contract.getOwnerUserId())
|
.setBizType(CrmBizTypeEnum.CRM_CONTRACT.getType()).setBizId(contract.getId())
|
.setLevel(CrmPermissionLevelEnum.OWNER.getLevel()));
|
// 3.1 客户负责人自动拥有该合同的读写权限
|
crmPermissionService.createPermissionForCustomerOwner(CrmBizTypeEnum.CRM_CONTRACT.getType(),
|
contract.getId(), contract.getCustomerId(), contract.getOwnerUserId());
|
|
// 4. 记录操作日志上下文
|
LogRecordContext.putVariable("contract", contract);
|
return contract.getId();
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
@LogRecord(type = CRM_CONTRACT_TYPE, subType = CRM_CONTRACT_UPDATE_SUB_TYPE, bizNo = "{{#updateReqVO.id}}",
|
success = CRM_CONTRACT_UPDATE_SUCCESS)
|
@CrmPermission(bizType = CrmBizTypeEnum.CRM_CONTRACT, bizId = "#updateReqVO.id", level = CrmPermissionLevelEnum.WRITE)
|
public void updateContract(CrmContractSaveReqVO updateReqVO) {
|
Assert.notNull(updateReqVO.getId(), "合同编号不能为空");
|
updateReqVO.setOwnerUserId(null); // 不允许更新的字段
|
// 1.1 校验存在
|
CrmContractDO oldContract = validateContractExists(updateReqVO.getId());
|
// 1.2 只有草稿、审核不通过，可以编辑；
|
if (!ObjectUtils.equalsAny(oldContract.getAuditStatus(), CrmAuditStatusEnum.DRAFT.getStatus(),
|
CrmAuditStatusEnum.REJECT.getStatus())) {
|
throw exception(CONTRACT_UPDATE_FAIL_NOT_DRAFT);
|
}
|
// 1.3 校验产品项的有效性
|
List<CrmContractProductDO> contractProducts = validateContractProducts(updateReqVO.getProducts());
|
// 1.4 校验关联字段
|
validateRelationDataExists(updateReqVO);
|
|
// 2.1 更新合同
|
CrmContractDO updateObj = BeanUtils.toBean(updateReqVO, CrmContractDO.class);
|
calculateTotalPrice(updateObj, contractProducts);
|
contractMapper.updateById(updateObj);
|
// 2.2 更新合同关联商品
|
updateContractProduct(updateReqVO.getId(), contractProducts);
|
|
// 3. 记录操作日志上下文
|
updateReqVO.setOwnerUserId(oldContract.getOwnerUserId()); // 避免操作日志出现“删除负责人”的情况
|
LogRecordContext.putVariable(DiffParseFunction.OLD_OBJECT, BeanUtils.toBean(oldContract, CrmContractSaveReqVO.class));
|
LogRecordContext.putVariable("contractName", oldContract.getName());
|
}
|
|
private void updateContractProduct(Long id, List<CrmContractProductDO> newList) {
|
List<CrmContractProductDO> oldList = contractProductMapper.selectListByContractId(id);
|
List<List<CrmContractProductDO>> diffList = diffList(oldList, newList, // id 不同，就认为是不同的记录
|
(oldVal, newVal) -> oldVal.getId().equals(newVal.getId()));
|
if (CollUtil.isNotEmpty(diffList.get(0))) {
|
diffList.get(0).forEach(o -> o.setContractId(id));
|
contractProductMapper.insertBatch(diffList.get(0));
|
}
|
if (CollUtil.isNotEmpty(diffList.get(1))) {
|
contractProductMapper.updateBatch(diffList.get(1));
|
}
|
if (CollUtil.isNotEmpty(diffList.get(2))) {
|
contractProductMapper.deleteByIds(convertSet(diffList.get(2), CrmContractProductDO::getId));
|
}
|
}
|
|
/**
|
* 校验关联数据是否存在
|
*
|
* @param reqVO 请求
|
*/
|
private void validateRelationDataExists(CrmContractSaveReqVO reqVO) {
|
// 1. 校验客户
|
if (reqVO.getCustomerId() != null) {
|
customerService.validateCustomer(reqVO.getCustomerId());
|
}
|
// 2. 校验负责人
|
if (reqVO.getOwnerUserId() != null) {
|
adminUserApi.validateUser(reqVO.getOwnerUserId());
|
}
|
// 3. 如果有关联商机，则需要校验存在
|
if (reqVO.getBusinessId() != null) {
|
businessService.validateBusiness(reqVO.getBusinessId());
|
}
|
// 4. 校验签约相关字段
|
if (reqVO.getSignContactId() != null) {
|
contactService.validateContact(reqVO.getSignContactId());
|
}
|
if (reqVO.getSignUserId() != null) {
|
adminUserApi.validateUser(reqVO.getSignUserId());
|
}
|
}
|
|
private List<CrmContractProductDO> validateContractProducts(List<CrmContractSaveReqVO.Product> list) {
|
// 1. 校验物料存在且启用
|
Set<Long> itemIds = convertSet(list, CrmContractSaveReqVO.Product::getItemId);
|
Map<Long, MdmItemRespDTO> itemMap = mdmItemApi.getItemMap(itemIds);
|
// 2. 转化为 CrmContractProductDO 列表
|
return convertList(list, o -> BeanUtils.toBean(o, CrmContractProductDO.class, item -> {
|
MdmItemRespDTO mdmItem = itemMap.get(item.getItemId());
|
if (mdmItem == null) {
|
throw exception(PRODUCT_NOT_EXISTS);
|
}
|
item.setItemUnitId(mdmItem.getUnitMeasureId());
|
item.setItemPrice(mdmItem.getSalesPrice());
|
item.setTotalPrice(MoneyUtils.priceMultiply(item.getContractPrice(), item.getCount()));
|
}));
|
}
|
|
private void calculateTotalPrice(CrmContractDO contract, List<CrmContractProductDO> contractProducts) {
|
contract.setTotalProductPrice(getSumValue(contractProducts, CrmContractProductDO::getTotalPrice, BigDecimal::add, BigDecimal.ZERO));
|
BigDecimal discountPrice = MoneyUtils.priceMultiplyPercent(contract.getTotalProductPrice(), contract.getDiscountPercent());
|
contract.setTotalPrice(contract.getTotalProductPrice().subtract(discountPrice));
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
@LogRecord(type = CRM_CONTRACT_TYPE, subType = CRM_CONTRACT_DELETE_SUB_TYPE, bizNo = "{{#id}}",
|
success = CRM_CONTRACT_DELETE_SUCCESS)
|
@CrmPermission(bizType = CrmBizTypeEnum.CRM_CONTRACT, bizId = "#id", level = CrmPermissionLevelEnum.OWNER)
|
public void deleteContract(Long id) {
|
// 1.1 校验存在
|
CrmContractDO contract = validateContractExists(id);
|
// 1.2 只有草稿、审核不通过，可以删除；
|
if (!ObjectUtils.equalsAny(contract.getAuditStatus(), CrmAuditStatusEnum.DRAFT.getStatus(),
|
CrmAuditStatusEnum.REJECT.getStatus())) {
|
throw exception(CONTRACT_DELETE_FAIL_NOT_EDITABLE);
|
}
|
// 1.3 如果被 CrmReceivableDO 所使用，则不允许删除
|
if (receivableService.getReceivableCountByContractId(contract.getId()) > 0) {
|
throw exception(CONTRACT_DELETE_FAIL);
|
}
|
|
// 2.1 删除合同
|
contractMapper.deleteById(id);
|
// 2.2 删除合同时，解除关联的报价单引用
|
CrmSaleQuotationDO quotation = crmSaleQuotationService.getByContractId(id);
|
if (quotation != null) {
|
crmSaleQuotationService.clearContractReference(quotation.getId());
|
}
|
// 2.2 删除数据权限
|
crmPermissionService.deletePermission(CrmBizTypeEnum.CRM_CONTRACT.getType(), id);
|
|
// 3. 记录操作日志上下文
|
LogRecordContext.putVariable("contractName", contract.getName());
|
}
|
|
private CrmContractDO validateContractExists(Long id) {
|
CrmContractDO contract = contractMapper.selectById(id);
|
if (contract == null) {
|
throw exception(CONTRACT_NOT_EXISTS);
|
}
|
return contract;
|
}
|
|
/**
|
* 获取用户昵称
|
*
|
* @param userId 用户编号
|
* @return 昵称，用户不存在时返回 null
|
*/
|
private String getUserNickname(Long userId) {
|
if (userId == null) {
|
return null;
|
}
|
AdminUserRespDTO user = adminUserApi.getUser(userId);
|
return user == null ? null : user.getNickname();
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
@LogRecord(type = CRM_CONTRACT_TYPE, subType = CRM_CONTRACT_TRANSFER_SUB_TYPE, bizNo = "{{#reqVO.id}}",
|
success = CRM_CONTRACT_TRANSFER_SUCCESS)
|
@CrmPermission(bizType = CrmBizTypeEnum.CRM_CONTRACT, bizId = "#reqVO.id", level = CrmPermissionLevelEnum.OWNER)
|
public void transferContract(CrmContractTransferReqVO reqVO, Long userId) {
|
// 1. 校验合同是否存在
|
CrmContractDO contract = validateContractExists(reqVO.getId());
|
|
// 2.1 数据权限转移
|
crmPermissionService.transferPermission(new CrmPermissionTransferReqBO(userId, CrmBizTypeEnum.CRM_CONTRACT.getType(),
|
reqVO.getId(), reqVO.getNewOwnerUserId(), reqVO.getOldOwnerPermissionLevel()));
|
// 2.2 设置负责人
|
contractMapper.updateById(new CrmContractDO().setId(reqVO.getId()).setOwnerUserId(reqVO.getNewOwnerUserId()));
|
|
// 3. 记录转移日志
|
LogRecordContext.putVariable("contract", contract);
|
}
|
|
@Override
|
@LogRecord(type = CRM_CONTRACT_TYPE, subType = CRM_CONTRACT_FOLLOW_UP_SUB_TYPE, bizNo = "{{#id}}",
|
success = CRM_CONTRACT_FOLLOW_UP_SUCCESS)
|
@CrmPermission(bizType = CrmBizTypeEnum.CRM_CONTRACT, bizId = "#id", level = CrmPermissionLevelEnum.WRITE)
|
public void updateContractFollowUp(Long id, LocalDateTime contactNextTime, String contactLastContent) {
|
// 1. 校验存在
|
CrmContractDO contract = validateContractExists(id);
|
|
// 2. 更新联系人的跟进信息
|
contractMapper.updateById(new CrmContractDO().setId(id).setContactLastTime(LocalDateTime.now()));
|
|
// 3. 记录操作日志上下文
|
LogRecordContext.putVariable("contractName", contract.getName());
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
@LogRecord(type = CRM_CONTRACT_TYPE, subType = CRM_CONTRACT_SUBMIT_SUB_TYPE, bizNo = "{{#id}}",
|
success = CRM_CONTRACT_SUBMIT_SUCCESS)
|
@CrmPermission(bizType = CrmBizTypeEnum.CRM_CONTRACT, bizId = "#id", level = CrmPermissionLevelEnum.WRITE)
|
public void submitContract(Long id) {
|
// 1. 校验存在 + 可提交状态（未提交 / 审核不通过）
|
CrmContractDO contract = validateContractExists(id);
|
if (ObjUtil.notEqual(contract.getAuditStatus(), CrmAuditStatusEnum.DRAFT.getStatus())
|
&& ObjUtil.notEqual(contract.getAuditStatus(), CrmAuditStatusEnum.REJECT.getStatus())) {
|
throw exception(CONTRACT_SUBMIT_FAIL_NOT_EDITABLE);
|
}
|
|
// 2. 校验审批配置已启用且配置了有效审批人（未配置时抛出带明确提示的业务异常）
|
approvalConfigApi.validateApprovalEnabledAndGetApprovers(CONTRACT_APPROVE_BIZ_TYPE);
|
|
// 3. 状态置为审批中，并清空上一轮审核结果，避免残留「审核不通过」的原因
|
if (contractMapper.submitAndResetAuditInfo(id, CrmAuditStatusEnum.PROCESS.getStatus()) != 1) {
|
throw exception(CONTRACT_SUBMIT_FAIL_NOT_EDITABLE);
|
}
|
|
// 4. 创建 BPM 流程实例，使审批出现在「协同办公 - 我的流程」
|
bpmProcessInstanceApi.createProcessInstance(getLoginUserId(),
|
new BpmProcessInstanceCreateReqDTO()
|
.setProcessDefinitionKey(CONTRACT_APPROVE_PROCESS_KEY)
|
.setBusinessKey(String.valueOf(id)));
|
|
// 5. 记录日志
|
LogRecordContext.putVariable("contractName", contract.getName());
|
}
|
|
@Override
|
public Set<Long> getContractApproverUserIds() {
|
return approvalConfigApi.getApproverUserIds(CONTRACT_APPROVE_BIZ_TYPE);
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public void auditContract(Long id, Boolean pass, String reviewRemark) {
|
// 1. 校验存在
|
CrmContractDO contract = validateContractExists(id);
|
// 2. 校验处于审批中状态
|
if (ObjUtil.notEqual(contract.getAuditStatus(), CrmAuditStatusEnum.PROCESS.getStatus())) {
|
throw exception(CONTRACT_AUDIT_FAIL_NOT_PROCESS);
|
}
|
// 3. 校验当前登录用户是该业务类型的审批人（或签：任一人均可审核）
|
Long userId = getLoginUserId();
|
approvalConfigApi.validateApprover(CONTRACT_APPROVE_BIZ_TYPE, userId);
|
// 4. 审核不通过：必须填写原因，状态置为审核不通过，退回提交人修改后可重新提交
|
if (!Boolean.TRUE.equals(pass)) {
|
if (StrUtil.isBlank(reviewRemark)) {
|
throw exception(CONTRACT_AUDIT_REJECT_REASON_REQUIRED);
|
}
|
if (contractMapper.auditContract(id, CrmAuditStatusEnum.REJECT.getStatus(),
|
userId, getUserNickname(userId), reviewRemark) != 1) {
|
throw exception(CONTRACT_AUDIT_FAIL_NOT_PROCESS);
|
}
|
return;
|
}
|
// 5. 审核通过：记录审核人与审核意见，状态置为审核通过
|
if (contractMapper.auditContract(id, CrmAuditStatusEnum.APPROVE.getStatus(),
|
userId, getUserNickname(userId), reviewRemark) != 1) {
|
throw exception(CONTRACT_AUDIT_FAIL_NOT_PROCESS);
|
}
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public void updateContractAuditStatus(Long id, Integer bpmStatus, String reason) {
|
// BPM 审批结果映射为合同审核状态：通过=20 / 不通过=30 / 取消=40
|
Integer auditStatus;
|
if (BpmTaskStatusEnum.APPROVE.getStatus().equals(bpmStatus)) {
|
auditStatus = CrmAuditStatusEnum.APPROVE.getStatus();
|
} else if (BpmTaskStatusEnum.REJECT.getStatus().equals(bpmStatus)) {
|
auditStatus = CrmAuditStatusEnum.REJECT.getStatus();
|
} else if (BpmTaskStatusEnum.CANCEL.getStatus().equals(bpmStatus)) {
|
auditStatus = CrmAuditStatusEnum.CANCEL.getStatus();
|
} else {
|
return;
|
}
|
if (contractMapper.updateAuditStatusByBpm(id, auditStatus, reason) != 1) {
|
log.warn("[updateContractAuditStatus] 合同({}) 不处于审批中状态，忽略 BPM 结果({})", id, bpmStatus);
|
}
|
}
|
|
// ======================= 查询相关 =======================
|
|
@Override
|
@CrmPermission(bizType = CrmBizTypeEnum.CRM_CONTRACT, bizId = "#id", level = CrmPermissionLevelEnum.READ)
|
public CrmContractDO getContract(Long id) {
|
return contractMapper.selectById(id);
|
}
|
|
@Override
|
public CrmContractDO validateContract(Long id) {
|
return validateContractExists(id);
|
}
|
|
@Override
|
public List<CrmContractDO> getContractList(Collection<Long> ids) {
|
if (CollUtil.isEmpty(ids)) {
|
return ListUtil.empty();
|
}
|
return contractMapper.selectByIds(ids);
|
}
|
|
@Override
|
public PageResult<CrmContractDO> getContractPage(CrmContractPageReqVO pageReqVO, Long userId) {
|
// 1. 即将到期，需要查询合同配置
|
CrmContractConfigDO config = null;
|
if (CrmContractPageReqVO.EXPIRY_TYPE_ABOUT_TO_EXPIRE.equals(pageReqVO.getExpiryType())) {
|
config = contractConfigService.getContractConfig();
|
if (config != null && Boolean.FALSE.equals(config.getNotifyEnabled())) {
|
config = null;
|
}
|
if (config == null) {
|
return PageResult.empty();
|
}
|
}
|
// 2. 查询分页
|
// 合同可见性完全由 appendPermissionCondition 控制（合同团队 ∪ 客户团队），
|
// 不再额外按「有权限的客户」过滤，否则不在客户团队、但属于合同负责人/合同团队的用户会被错误过滤掉
|
return contractMapper.selectPage(pageReqVO, userId, config);
|
}
|
|
@Override
|
@CrmPermission(bizType = CrmBizTypeEnum.CRM_CUSTOMER, bizId = "#pageReqVO.customerId", level = CrmPermissionLevelEnum.READ)
|
public PageResult<CrmContractDO> getContractPageByCustomerId(CrmContractPageReqVO pageReqVO) {
|
return contractMapper.selectPageByCustomerId(pageReqVO);
|
}
|
|
@Override
|
@CrmPermission(bizType = CrmBizTypeEnum.CRM_BUSINESS, bizId = "#pageReqVO.businessId", level = CrmPermissionLevelEnum.READ)
|
public PageResult<CrmContractDO> getContractPageByBusinessId(CrmContractPageReqVO pageReqVO) {
|
return contractMapper.selectPageByBusinessId(pageReqVO);
|
}
|
|
@Override
|
public Long getContractCountByContactId(Long contactId) {
|
return contractMapper.selectCountByContactId(contactId);
|
}
|
|
@Override
|
public Long getContractCountByCustomerId(Long customerId) {
|
return contractMapper.selectCount(CrmContractDO::getCustomerId, customerId);
|
}
|
|
@Override
|
public Long getContractCountByBusinessId(Long businessId) {
|
return contractMapper.selectCountByBusinessId(businessId);
|
}
|
|
@Override
|
public List<CrmContractProductDO> getContractProductListByContractId(Long contactId) {
|
return contractProductMapper.selectListByContractId(contactId);
|
}
|
|
@Override
|
public Long getAuditContractCount(Long userId) {
|
return contractMapper.selectCountByAudit(userId);
|
}
|
|
@Override
|
public Long getRemindContractCount(Long userId) {
|
CrmContractConfigDO config = contractConfigService.getContractConfig();
|
if (config == null || Boolean.FALSE.equals(config.getNotifyEnabled())) {
|
return 0L;
|
}
|
return contractMapper.selectCountByRemind(userId, config);
|
}
|
|
@Override
|
public List<CrmContractDO> getContractListByCustomerIdOwnerUserId(Long customerId, Long ownerUserId) {
|
return contractMapper.selectListByCustomerIdOwnerUserId(customerId, ownerUserId);
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
@LogRecord(type = CRM_CONTRACT_TYPE, subType = "生成销售订单", bizNo = "{{#id}}",
|
success = "合同【{{#contractName}}】生成销售订单【{{#orderNo}}】成功")
|
@CrmPermission(bizType = CrmBizTypeEnum.CRM_CONTRACT, bizId = "#id", level = CrmPermissionLevelEnum.WRITE)
|
public Long generateSaleOrder(Long id, Long userId) {
|
// 1. 校验合同存在且已审批通过
|
CrmContractDO contract = contractMapper.selectByIdForUpdate(id);
|
if (contract == null) throw exception(CONTRACT_NOT_EXISTS);
|
if (!CrmAuditStatusEnum.APPROVE.getStatus().equals(contract.getAuditStatus())) {
|
throw exception(CONTRACT_GENERATE_ORDER_FAIL_NOT_APPROVE);
|
}
|
// 2. 校验是否已生成销售订单
|
ErpSaleOrderRespDTO existOrder = saleOrderApi.getSaleOrderByContractId(id).getCheckedData();
|
if (existOrder != null) {
|
throw exception(CONTRACT_GENERATE_ORDER_FAIL_EXISTS_ORDER, existOrder.getNo());
|
}
|
|
// 3. 获取合同产品列表
|
List<CrmContractProductDO> contractProducts = contractProductMapper.selectListByContractId(id);
|
if (CollUtil.isEmpty(contractProducts)) {
|
throw exception(CONTRACT_GENERATE_ORDER_FAIL_NO_PRODUCT);
|
}
|
|
// 4. 构建销售订单创建请求
|
ErpSaleOrderCreateReqDTO createReqDTO = new ErpSaleOrderCreateReqDTO();
|
createReqDTO.setCustomerId(contract.getCustomerId());
|
createReqDTO.setContractId(contract.getId());
|
createReqDTO.setContractNo(contract.getNo());
|
createReqDTO.setSaleUserId(contract.getOwnerUserId());
|
createReqDTO.setOrderTime(LocalDateTime.now().toString());
|
createReqDTO.setDiscountPercent(contract.getDiscountPercent() != null ? contract.getDiscountPercent() : BigDecimal.ZERO);
|
createReqDTO.setDepositPrice(contract.getDepositPrice() != null ? contract.getDepositPrice() : BigDecimal.ZERO);
|
createReqDTO.setRemark("由合同【" + contract.getNo() + "】自动生成");
|
|
// 5. 构建订单项
|
List<ErpSaleOrderCreateReqDTO.Item> items = contractProducts.stream()
|
.map(cp -> {
|
ErpSaleOrderCreateReqDTO.Item item = new ErpSaleOrderCreateReqDTO.Item();
|
item.setProductId(cp.getItemId());
|
item.setProductPrice(cp.getContractPrice());
|
item.setCount(cp.getCount());
|
// 合同产品默认需要生产：订单审批通过后才能自动创建 MPS，
|
// 否则「合同 → 订单 → 生产」链路在合同来源的订单上会断掉。
|
// 若个别产品为外购/转售，可在销售订单明细中把「需要生产」改为否。
|
item.setNeedProduction(1);
|
return item;
|
})
|
.toList();
|
createReqDTO.setItems(items);
|
|
// 6. 创建销售订单
|
Long orderId = saleOrderApi.createSaleOrder(createReqDTO).getCheckedData();
|
ErpSaleOrderRespDTO order = saleOrderApi.getSaleOrder(orderId).getCheckedData();
|
|
// 7. 更新合同关联订单信息
|
contractMapper.updateById(new CrmContractDO()
|
.setId(id)
|
.setOrderId(orderId)
|
.setOrderNo(order.getNo()));
|
|
// 8. 记录操作日志
|
LogRecordContext.putVariable("contractName", contract.getName());
|
LogRecordContext.putVariable("orderNo", order.getNo());
|
|
return orderId;
|
}
|
|
@Override
|
public void updateContractStatus(Long id, Integer status) {
|
contractMapper.updateById(new CrmContractDO()
|
.setId(id)
|
.setAuditStatus(status));
|
}
|
|
@Override
|
public void updateContractStatusByOrderId(Long orderId, Integer status) {
|
CrmContractDO contract = contractMapper.selectByOrderId(orderId);
|
if (contract != null) {
|
contractMapper.updateById(new CrmContractDO()
|
.setId(contract.getId())
|
.setAuditStatus(status));
|
}
|
}
|
|
@Override
|
public CrmContractImportRespVO importContractList(List<CrmContractImportExcelVO> rows, CrmContractImportReqVO req) {
|
if (CollUtil.isEmpty(rows)) throw exception(CONTRACT_IMPORT_LIST_IS_EMPTY);
|
Long ownerId = req.getOwnerUserId() != null ? req.getOwnerUserId() : getLoginUserId();
|
adminUserApi.validateUser(ownerId);
|
CrmContractImportRespVO result = CrmContractImportRespVO.builder()
|
.createContractNames(new ArrayList<>()).updateContractNames(new ArrayList<>())
|
.failureContractNames(new LinkedHashMap<>()).build();
|
Map<String, List<CrmContractImportExcelVO>> groups = new LinkedHashMap<>();
|
int rowNo = 0;
|
for (CrmContractImportExcelVO row : rows) {
|
rowNo++;
|
if (row == null) continue;
|
if (StrUtil.isBlank(row.getName()) && StrUtil.isBlank(row.getCustomerName()) && StrUtil.isBlank(row.getProductCode())) continue;
|
if (StrUtil.isBlank(row.getName()) || StrUtil.isBlank(row.getCustomerName())) {
|
throw exception(CONTRACT_IMPORT_INVALID, "第" + rowNo + "行合同名称和客户名称不能为空");
|
}
|
String key = row.getCustomerName().trim() + " / " + row.getName().trim();
|
groups.computeIfAbsent(key, ignored -> new ArrayList<>()).add(row);
|
}
|
if (groups.isEmpty() && result.getFailureContractNames().isEmpty()) throw exception(CONTRACT_IMPORT_LIST_IS_EMPTY);
|
groups.forEach((key, group) -> {
|
try {
|
boolean created = getSelf().importContractGroup(group, ownerId, Boolean.TRUE.equals(req.getUpdateSupport()));
|
(created ? result.getCreateContractNames() : result.getUpdateContractNames()).add(key);
|
} catch (ServiceException ex) {
|
result.getFailureContractNames().put(key, ex.getMessage());
|
}
|
});
|
return result;
|
}
|
|
/** 一张合同及全部明细在同一事务中保存。 */
|
@Transactional(rollbackFor = Exception.class)
|
public boolean importContractGroup(List<CrmContractImportExcelVO> rows, Long ownerId, boolean updateSupport) {
|
CrmContractImportExcelVO first = rows.get(0);
|
CrmCustomerDO customer = customerMapper.selectByCustomerName(first.getCustomerName().trim());
|
if (customer == null) throw exception(CONTRACT_IMPORT_CUSTOMER_NOT_EXISTS, first.getCustomerName());
|
CrmContractDO existing = contractMapper.selectByNameAndCustomerId(first.getName().trim(), customer.getId());
|
if (existing != null && !updateSupport) throw exception(CONTRACT_NAME_EXISTS, first.getName());
|
if (existing != null && !ObjectUtils.equalsAny(existing.getAuditStatus(), CrmAuditStatusEnum.DRAFT.getStatus(), CrmAuditStatusEnum.REJECT.getStatus())) {
|
throw exception(CONTRACT_UPDATE_FAIL_NOT_DRAFT);
|
}
|
if (first.getDiscountPercent() != null && (first.getDiscountPercent().signum() < 0 || first.getDiscountPercent().compareTo(new BigDecimal("100")) > 0)) {
|
throw exception(CONTRACT_IMPORT_INVALID, "折扣必须在 0 到 100 之间");
|
}
|
if (first.getStartTime() != null && first.getEndTime() != null && first.getEndTime().isBefore(first.getStartTime())) {
|
throw exception(CONTRACT_IMPORT_INVALID, "结束时间不能早于开始时间");
|
}
|
List<CrmContractSaveReqVO.Product> products = new ArrayList<>();
|
for (CrmContractImportExcelVO row : rows) {
|
if (row.getOrderDate() != null && !row.getOrderDate().equals(first.getOrderDate())
|
|| row.getDiscountPercent() != null && (first.getDiscountPercent() == null || row.getDiscountPercent().compareTo(first.getDiscountPercent()) != 0)) {
|
throw exception(CONTRACT_IMPORT_INVALID, "同一合同的下单日期和折扣必须一致");
|
}
|
if (row.getStartTime() != null && !row.getStartTime().equals(first.getStartTime())
|
|| row.getEndTime() != null && !row.getEndTime().equals(first.getEndTime())
|
|| row.getTotalPrice() != null && (first.getTotalPrice() == null || row.getTotalPrice().compareTo(first.getTotalPrice()) != 0)
|
|| row.getDepositPrice() != null && (first.getDepositPrice() == null || row.getDepositPrice().compareTo(first.getDepositPrice()) != 0)
|
|| StrUtil.isNotBlank(row.getContractType()) && !StrUtil.equals(row.getContractType(), first.getContractType())
|
|| StrUtil.isNotBlank(row.getVoltageLevel()) && !StrUtil.equals(row.getVoltageLevel(), first.getVoltageLevel())
|
|| StrUtil.isNotBlank(row.getElectricityType()) && !StrUtil.equals(row.getElectricityType(), first.getElectricityType())
|
|| row.getContractCapacity() != null && (first.getContractCapacity() == null || row.getContractCapacity().compareTo(first.getContractCapacity()) != 0)
|
|| StrUtil.isNotBlank(row.getTariffMode()) && !StrUtil.equals(row.getTariffMode(), first.getTariffMode())
|
|| StrUtil.isNotBlank(row.getMeterMode()) && !StrUtil.equals(row.getMeterMode(), first.getMeterMode())
|
|| row.getPayCycle() != null && !row.getPayCycle().equals(first.getPayCycle())
|
|| StrUtil.isNotBlank(row.getRemark()) && !StrUtil.equals(row.getRemark(), first.getRemark())) {
|
throw exception(CONTRACT_IMPORT_INVALID, "同一合同的主表信息必须一致");
|
}
|
boolean hasDetail = StrUtil.isNotBlank(row.getProductCode()) || row.getProductPrice() != null || row.getProductCount() != null;
|
if (!hasDetail) continue;
|
if (StrUtil.isBlank(row.getProductCode()) || row.getProductPrice() == null || row.getProductPrice().signum() < 0 || row.getProductCount() == null || row.getProductCount() <= 0) {
|
throw exception(CONTRACT_IMPORT_INVALID, "物料编码、非负合同单价和大于零的整数数量必须同时填写");
|
}
|
MdmItemRespDTO item = mdmItemApi.getItemByCode(row.getProductCode().trim()).getCheckedData();
|
if (item == null) throw exception(CONTRACT_IMPORT_INVALID, "物料不存在：" + row.getProductCode());
|
CrmContractSaveReqVO.Product product = new CrmContractSaveReqVO.Product();
|
product.setItemId(item.getId());
|
product.setItemPrice(item.getSalesPrice());
|
product.setContractPrice(row.getProductPrice());
|
product.setCount(row.getProductCount());
|
products.add(product);
|
}
|
if (!products.isEmpty() && products.size() != rows.size()) throw exception(CONTRACT_IMPORT_INVALID, "同一合同的每一行都必须填写产品明细");
|
CrmContractDO contract = BeanUtils.toBean(first, CrmContractDO.class).setCustomerId(customer.getId());
|
contract.setName(first.getName().trim());
|
if (existing == null) {
|
String no = noRedisDAO.generate(CrmNoRedisDAO.CONTRACT_NO_PREFIX);
|
if (contractMapper.selectByNo(no) != null) throw exception(CONTRACT_NO_EXISTS);
|
contract.setNo(no).setOwnerUserId(ownerId).setAuditStatus(CrmAuditStatusEnum.DRAFT.getStatus());
|
if (contract.getOrderDate() == null) contract.setOrderDate(LocalDateTime.now());
|
if (contract.getDiscountPercent() == null) contract.setDiscountPercent(BigDecimal.ZERO);
|
if (!products.isEmpty() || contract.getTotalPrice() == null) calculateTotalPrice(contract, validateContractProducts(products));
|
contractMapper.insert(contract);
|
crmPermissionService.createPermission(new CrmPermissionCreateReqBO().setBizType(CrmBizTypeEnum.CRM_CONTRACT.getType()).setBizId(contract.getId()).setUserId(ownerId).setLevel(CrmPermissionLevelEnum.OWNER.getLevel()));
|
// 客户负责人自动拥有该合同的读写权限
|
crmPermissionService.createPermissionForCustomerOwner(CrmBizTypeEnum.CRM_CONTRACT.getType(),
|
contract.getId(), customer.getId(), ownerId);
|
} else {
|
contract.setId(existing.getId());
|
List<CrmContractProductDO> amountDetails = products.isEmpty()
|
? contractProductMapper.selectListByContractId(existing.getId()) : validateContractProducts(products);
|
if (CollUtil.isNotEmpty(amountDetails)) {
|
if (contract.getDiscountPercent() == null) contract.setDiscountPercent(
|
existing.getDiscountPercent() == null ? BigDecimal.ZERO : existing.getDiscountPercent());
|
calculateTotalPrice(contract, amountDetails);
|
}
|
contractMapper.updateById(contract);
|
}
|
if (!products.isEmpty()) {
|
List<CrmContractProductDO> details = validateContractProducts(products);
|
if (existing != null) contractProductMapper.delete(CrmContractProductDO::getContractId, existing.getId());
|
details.forEach(detail -> detail.setContractId(contract.getId()));
|
contractProductMapper.insertBatch(details);
|
}
|
getSelf().importContractLog(contract, existing != null);
|
return existing == null;
|
}
|
|
|
/**
|
* 记录导入合同时的操作日志
|
*
|
* @param contract 合同信息
|
* @param isUpdate 是否更新；true - 更新，false - 新增
|
*/
|
@LogRecord(type = CRM_CONTRACT_TYPE, subType = CRM_CONTRACT_IMPORT_SUB_TYPE, bizNo = "{{#contract.id}}",
|
success = CRM_CONTRACT_IMPORT_SUCCESS)
|
public void importContractLog(CrmContractDO contract, boolean isUpdate) {
|
LogRecordContext.putVariable("contract", contract);
|
LogRecordContext.putVariable("isUpdate", isUpdate);
|
}
|
|
/**
|
* 获得自身的代理对象，解决 AOP 生效问题
|
*
|
* @return 自己
|
*/
|
private CrmContractServiceImpl getSelf() {
|
return SpringUtil.getBean(getClass());
|
}
|
|
}
|
