package cn.iocoder.yudao.module.crm.service.invoice; 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.ObjectUtil; import cn.iocoder.yudao.framework.common.pojo.PageResult; import cn.iocoder.yudao.framework.common.util.collection.CollectionUtils; import cn.iocoder.yudao.framework.common.util.object.BeanUtils; import cn.iocoder.yudao.framework.common.util.object.ObjectUtils; import cn.iocoder.yudao.module.bpm.api.task.BpmProcessInstanceApi; import cn.iocoder.yudao.module.bpm.api.task.dto.BpmProcessInstanceCreateReqDTO; import cn.iocoder.yudao.module.crm.controller.admin.invoice.vo.invoice.CrmInvoicePageReqVO; import cn.iocoder.yudao.module.crm.controller.admin.invoice.vo.invoice.CrmInvoiceSaveReqVO; import cn.iocoder.yudao.module.crm.dal.dataobject.contract.CrmContractDO; import cn.iocoder.yudao.module.crm.dal.dataobject.invoice.CrmInvoiceDO; import cn.iocoder.yudao.module.crm.dal.mysql.invoice.CrmInvoiceMapper; 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.contract.CrmContractService; import cn.iocoder.yudao.module.crm.service.permission.CrmPermissionService; import cn.iocoder.yudao.module.crm.service.permission.bo.CrmPermissionCreateReqBO; import cn.iocoder.yudao.module.system.api.storage.StorageAttachmentApi; 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 lombok.extern.slf4j.Slf4j; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; import org.springframework.validation.annotation.Validated; import java.math.BigDecimal; import java.util.Collection; import java.util.List; import java.util.Map; import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception; import static cn.iocoder.yudao.module.crm.enums.ErrorCodeConstants.*; import static cn.iocoder.yudao.module.crm.enums.LogRecordConstants.*; import static cn.iocoder.yudao.module.crm.util.CrmAuditStatusUtils.convertBpmResultToAuditStatus; /** * CRM 开票 Service 实现类 * * @author 超级管理员 */ @Service @Validated @Slf4j public class CrmInvoiceServiceImpl implements CrmInvoiceService { /** * BPM 开票审批流程标识 */ public static final String BPM_PROCESS_DEFINITION_KEY = "crm-invoice-audit"; /** * 发票附件的业务记录类型,对应 {@link cn.iocoder.yudao.module.system.enums.storage.StorageRecordTypeEnum#CRM_INVOICE} */ private static final String INVOICE_RECORD_TYPE = "crm_invoice"; @Resource private CrmInvoiceMapper invoiceMapper; @Resource private CrmNoRedisDAO noRedisDAO; @Resource private CrmContractService contractService; @Resource private CrmPermissionService permissionService; @Resource private AdminUserApi adminUserApi; @Resource private BpmProcessInstanceApi bpmProcessInstanceApi; @Resource private StorageAttachmentApi storageAttachmentApi; @Override @Transactional(rollbackFor = Exception.class) @LogRecord(type = CRM_INVOICE_TYPE, subType = CRM_INVOICE_CREATE_SUB_TYPE, bizNo = "{{#invoice.id}}", success = CRM_INVOICE_CREATE_SUCCESS) public Long createInvoice(CrmInvoiceSaveReqVO createReqVO) { // 1.1 校验可开票金额超过上限 validateInvoicePriceExceedsLimit(createReqVO); // 1.2 校验关联数据存在 validateRelationDataExists(createReqVO); // 1.3 生成开票编号 String no = noRedisDAO.generate(CrmNoRedisDAO.INVOICE_PREFIX); if (invoiceMapper.selectByNo(no) != null) { throw exception(INVOICE_NO_EXISTS); } // 2.1 插入开票 CrmInvoiceDO invoice = BeanUtils.toBean(createReqVO, CrmInvoiceDO.class) .setNo(no).setAuditStatus(CrmAuditStatusEnum.DRAFT.getStatus()); invoiceMapper.insert(invoice); // 2.2 绑定发票附件 if (CollUtil.isNotEmpty(createReqVO.getBlobIds())) { storageAttachmentApi.bindAttachments("file", INVOICE_RECORD_TYPE, invoice.getId(), createReqVO.getBlobIds()); } // 3. 创建数据权限 permissionService.createPermission(new CrmPermissionCreateReqBO().setBizType(CrmBizTypeEnum.CRM_INVOICE.getType()) .setBizId(invoice.getId()).setUserId(createReqVO.getOwnerUserId()) .setLevel(CrmPermissionLevelEnum.OWNER.getLevel())); // 设置当前操作的人为负责人 // 4. 记录操作日志上下文 LogRecordContext.putVariable("invoice", invoice); return invoice.getId(); } private void validateInvoicePriceExceedsLimit(CrmInvoiceSaveReqVO reqVO) { // 1. 计算剩余可开票金额,不包括 reqVO 自身(审批中也占用额度,防止累计开票超过合同金额) CrmContractDO contract = contractService.validateContract(reqVO.getContractId()); List invoices = invoiceMapper.selectListByContractIdAndStatus(reqVO.getContractId(), List.of(CrmAuditStatusEnum.APPROVE.getStatus(), CrmAuditStatusEnum.PROCESS.getStatus())); if (reqVO.getId() != null) { invoices.removeIf(invoice -> ObjectUtil.equal(invoice.getId(), reqVO.getId())); } BigDecimal notInvoicePrice = contract.getTotalPrice().subtract( CollectionUtils.getSumValue(invoices, CrmInvoiceDO::getPrice, BigDecimal::add, BigDecimal.ZERO)); // 2. 校验金额是否超过 if (reqVO.getPrice().compareTo(notInvoicePrice) > 0) { throw exception(INVOICE_CREATE_FAIL_PRICE_EXCEEDS_LIMIT, notInvoicePrice); } } private void validateRelationDataExists(CrmInvoiceSaveReqVO reqVO) { if (reqVO.getOwnerUserId() != null) { adminUserApi.validateUser(reqVO.getOwnerUserId()); // 校验负责人存在 } if (reqVO.getContractId() != null) { CrmContractDO contract = contractService.validateContract(reqVO.getContractId()); if (ObjectUtil.notEqual(contract.getAuditStatus(), CrmAuditStatusEnum.APPROVE.getStatus())) { throw exception(INVOICE_CREATE_FAIL_CONTRACT_NOT_APPROVE); } reqVO.setCustomerId(contract.getCustomerId()); // 设置客户编号 } } @Override @Transactional(rollbackFor = Exception.class) @LogRecord(type = CRM_INVOICE_TYPE, subType = CRM_INVOICE_UPDATE_SUB_TYPE, bizNo = "{{#updateReqVO.id}}", success = CRM_INVOICE_UPDATE_SUCCESS) @CrmPermission(bizType = CrmBizTypeEnum.CRM_INVOICE, bizId = "#updateReqVO.id", level = CrmPermissionLevelEnum.WRITE) public void updateInvoice(CrmInvoiceSaveReqVO updateReqVO) { Assert.notNull(updateReqVO.getId(), "开票编号不能为空"); updateReqVO.setOwnerUserId(null).setCustomerId(null).setContractId(null); // 不允许修改的字段 // 1.1 校验存在 CrmInvoiceDO oldInvoice = validateInvoiceExists(updateReqVO.getId()); updateReqVO.setOwnerUserId(oldInvoice.getOwnerUserId()).setCustomerId(oldInvoice.getCustomerId()) .setContractId(oldInvoice.getContractId()); // 设置已存在的值 // 1.2 校验可开票金额超过上限 validateInvoicePriceExceedsLimit(updateReqVO); // 1.3 只有草稿、审批中,可以编辑; if (!ObjectUtils.equalsAny(oldInvoice.getAuditStatus(), CrmAuditStatusEnum.DRAFT.getStatus(), CrmAuditStatusEnum.PROCESS.getStatus())) { throw exception(INVOICE_UPDATE_FAIL_EDITING_PROHIBITED); } // 2. 更新开票 CrmInvoiceDO updateObj = BeanUtils.toBean(updateReqVO, CrmInvoiceDO.class); invoiceMapper.updateById(updateObj); // 3. 增量更新发票附件 storageAttachmentApi.updateAttachments("file", INVOICE_RECORD_TYPE, updateReqVO.getId(), updateReqVO.getBlobIds()); // 4. 记录操作日志上下文 updateReqVO.setOwnerUserId(oldInvoice.getOwnerUserId()); // 避免操作日志出现“删除负责人”的情况 LogRecordContext.putVariable("invoice", oldInvoice); LogRecordContext.putVariable(DiffParseFunction.OLD_OBJECT, BeanUtils.toBean(oldInvoice, CrmInvoiceSaveReqVO.class)); } @Override public void updateInvoiceAuditStatus(Long id, Integer bpmResult) { // 1.1 校验存在 CrmInvoiceDO invoice = validateInvoiceExists(id); // 1.2 只有审批中,可以更新审批结果 if (ObjUtil.notEqual(invoice.getAuditStatus(), CrmAuditStatusEnum.PROCESS.getStatus())) { log.error("[updateInvoiceAuditStatus][invoice({}) 不处于审批中,无法更新审批结果({})]", invoice.getId(), bpmResult); throw exception(INVOICE_UPDATE_AUDIT_STATUS_FAIL_NOT_PROCESS); } // 2. 更新开票审批状态 Integer auditStatus = convertBpmResultToAuditStatus(bpmResult); invoiceMapper.updateById(new CrmInvoiceDO().setId(id).setAuditStatus(auditStatus)); } @Override @Transactional(rollbackFor = Exception.class) @LogRecord(type = CRM_INVOICE_TYPE, subType = CRM_INVOICE_DELETE_SUB_TYPE, bizNo = "{{#id}}", success = CRM_INVOICE_DELETE_SUCCESS) @CrmPermission(bizType = CrmBizTypeEnum.CRM_INVOICE, bizId = "#id", level = CrmPermissionLevelEnum.OWNER) public void deleteInvoice(Long id) { // 1.1 校验存在 CrmInvoiceDO invoice = validateInvoiceExists(id); // 1.2 审批通过时,不允许删除 if (ObjUtil.equal(invoice.getAuditStatus(), CrmAuditStatusEnum.APPROVE.getStatus())) { throw exception(INVOICE_DELETE_FAIL_IS_APPROVE); } // 2.1 删除发票附件 storageAttachmentApi.deleteAttachmentsByRecord(INVOICE_RECORD_TYPE, id); // 2.2 删除开票 invoiceMapper.deleteById(id); // 2.3 删除数据权限 permissionService.deletePermission(CrmBizTypeEnum.CRM_INVOICE.getType(), id); // 3. 记录操作日志上下文 LogRecordContext.putVariable("invoice", invoice); } @Override @Transactional(rollbackFor = Exception.class) @LogRecord(type = CRM_INVOICE_TYPE, subType = CRM_INVOICE_SUBMIT_SUB_TYPE, bizNo = "{{#id}}", success = CRM_INVOICE_SUBMIT_SUCCESS) public void submitInvoice(Long id, Long userId) { // 1. 校验开票是否在审批 CrmInvoiceDO invoice = validateInvoiceExists(id); if (ObjUtil.notEqual(invoice.getAuditStatus(), CrmAuditStatusEnum.DRAFT.getStatus())) { throw exception(INVOICE_SUBMIT_FAIL_NOT_DRAFT); } // 1.1 重新校验可开票金额,防止累计开票超过合同金额(草稿期后可能有其他单进入审批中) validateInvoicePriceExceedsLimit(new CrmInvoiceSaveReqVO() .setId(invoice.getId()).setContractId(invoice.getContractId()).setPrice(invoice.getPrice())); // 2. 创建开票审批流程实例 String processInstanceId = bpmProcessInstanceApi.createProcessInstance(userId, new BpmProcessInstanceCreateReqDTO() .setProcessDefinitionKey(BPM_PROCESS_DEFINITION_KEY).setBusinessKey(String.valueOf(id))); // 3. 更新开票工作流编号 invoiceMapper.updateById(new CrmInvoiceDO().setId(id).setProcessInstanceId(processInstanceId) .setAuditStatus(CrmAuditStatusEnum.PROCESS.getStatus())); // 4. 记录日志 LogRecordContext.putVariable("invoiceNo", invoice.getNo()); } private CrmInvoiceDO validateInvoiceExists(Long id) { CrmInvoiceDO invoice = invoiceMapper.selectById(id); if (invoice == null) { throw exception(INVOICE_NOT_EXISTS); } return invoice; } @Override @CrmPermission(bizType = CrmBizTypeEnum.CRM_INVOICE, bizId = "#id", level = CrmPermissionLevelEnum.READ) public CrmInvoiceDO getInvoice(Long id) { return invoiceMapper.selectById(id); } @Override public List getInvoiceList(Collection ids) { if (CollUtil.isEmpty(ids)) { return ListUtil.empty(); } return invoiceMapper.selectByIds(ids); } @Override public PageResult getInvoicePage(CrmInvoicePageReqVO pageReqVO, Long userId) { return invoiceMapper.selectPage(pageReqVO, userId); } @Override @CrmPermission(bizType = CrmBizTypeEnum.CRM_CUSTOMER, bizId = "#pageReqVO.customerId", level = CrmPermissionLevelEnum.READ) public PageResult getInvoicePageByCustomerId(CrmInvoicePageReqVO pageReqVO) { return invoiceMapper.selectPageByCustomerId(pageReqVO); } @Override public Long getAuditInvoiceCount(Long userId) { return invoiceMapper.selectCountByAudit(userId); } @Override public List getInvoiceListByContractIdAndStatus(Long contractId, Collection auditStatuses) { return invoiceMapper.selectListByContractIdAndStatus(contractId, auditStatuses); } @Override public Map getInvoicePriceMapByContractId(Collection contractIds) { return invoiceMapper.selectInvoicePriceMapByContractId(contractIds); } @Override public Long getInvoiceCountByContractId(Long contractId) { return invoiceMapper.selectCountByContractId(contractId); } }