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.mdm.enums.MdmItemTypeEnum; 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 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 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 newList) { List oldList = contractProductMapper.selectListByContractId(id); List> 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 validateContractProducts(List list) { // 1. 校验物料存在且启用 Set itemIds = convertSet(list, CrmContractSaveReqVO.Product::getItemId); Map 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 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 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 getContractList(Collection ids) { if (CollUtil.isEmpty(ids)) { return ListUtil.empty(); } return contractMapper.selectByIds(ids); } @Override public PageResult 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 getContractPageByCustomerId(CrmContractPageReqVO pageReqVO) { return contractMapper.selectPageByCustomerId(pageReqVO); } @Override @CrmPermission(bizType = CrmBizTypeEnum.CRM_BUSINESS, bizId = "#pageReqVO.businessId", level = CrmPermissionLevelEnum.READ) public PageResult 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 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; } // 提醒天数未配置时按默认 7 天处理,避免 config.getNotifyDays() 为 null 时拆箱抛 NPE 导致接口 500 if (config.getNotifyDays() == null) { config = BeanUtils.toBean(config, CrmContractConfigDO.class); config.setNotifyDays(DEFAULT_NOTIFY_DAYS); } return contractMapper.selectCountByRemind(userId, config); } /** * 合同到期提醒的默认提前天数:合同提醒未配置 notifyDays 时使用 */ private static final Integer DEFAULT_NOTIFY_DAYS = 7; @Override public List 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 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. 构建订单项 Map itemMap = mdmItemApi.getItemMap( convertSet(contractProducts, CrmContractProductDO::getItemId)); List items = contractProducts.stream() .map(cp -> { ErpSaleOrderCreateReqDTO.Item item = new ErpSaleOrderCreateReqDTO.Item(); item.setProductId(cp.getItemId()); item.setProductPrice(cp.getContractPrice()); item.setCount(cp.getCount()); // 只有产品才进入生产计划;温控等外购物料可随合同进入销售订单, // 但不能创建 MPS,否则会导致整笔销售订单审批回滚。 MdmItemRespDTO mdmItem = itemMap.get(cp.getItemId()); item.setNeedProduction(mdmItem != null && MdmItemTypeEnum.isProduct(mdmItem.getItemType()) ? 1 : 0); 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 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> 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 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 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 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 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()); } }