package cn.iocoder.yudao.module.trade.service.domestic; import cn.hutool.core.collection.CollUtil; 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.module.bpm.api.task.BpmProcessInstanceApi; import cn.iocoder.yudao.module.bpm.api.task.dto.BpmProcessInstanceCreateReqDTO; import cn.iocoder.yudao.module.bpm.dal.dataobject.definition.BpmProcessDefinitionInfoDO; import cn.iocoder.yudao.module.bpm.enums.task.BpmTaskStatusEnum; import cn.iocoder.yudao.module.bpm.service.definition.BpmCategoryService; import cn.iocoder.yudao.module.bpm.service.definition.BpmProcessDefinitionService; import cn.iocoder.yudao.module.crm.api.customer.CrmCustomerApi; import cn.iocoder.yudao.module.mes.api.productsales.MesWmProductSalesApi; import cn.iocoder.yudao.module.mes.api.productsales.dto.MesWmProductSalesOutboundReqDTO; import cn.iocoder.yudao.module.mes.api.wms.MesWmStockApi; import cn.iocoder.yudao.module.mes.api.wms.dto.MesWmMaterialStockRecordDTO; 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.storage.StorageAttachmentApi; import cn.iocoder.yudao.module.trade.controller.admin.domestic.vo.TradeDomesticOrderOutboundReqVO; import cn.iocoder.yudao.module.trade.controller.admin.domestic.vo.TradeDomesticOrderPageReqVO; import cn.iocoder.yudao.module.trade.controller.admin.domestic.vo.TradeDomesticOrderSaveReqVO; import cn.iocoder.yudao.module.trade.dal.dataobject.domestic.TradeDomesticOrderDO; import cn.iocoder.yudao.module.trade.dal.dataobject.domestic.TradeDomesticOrderItemDO; import cn.iocoder.yudao.module.trade.dal.mysql.domestic.TradeDomesticOrderItemMapper; import cn.iocoder.yudao.module.trade.dal.mysql.domestic.TradeDomesticOrderMapper; import cn.iocoder.yudao.module.trade.dal.redis.no.TradeNoRedisDAO; import cn.iocoder.yudao.module.trade.enums.TradeDomesticOrderStatusEnum; import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper; import com.mzt.logapi.context.LogRecordContext; import com.mzt.logapi.starter.annotation.LogRecord; import jakarta.annotation.Resource; import lombok.extern.slf4j.Slf4j; import org.flowable.engine.repository.ProcessDefinition; 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.*; 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.trade.enums.ErrorCodeConstants.*; import static cn.iocoder.yudao.module.trade.enums.LogRecordConstants.*; /** * 内贸订单 Service 实现类 * * @author mom */ @Service @Validated @Slf4j public class TradeDomesticOrderServiceImpl implements TradeDomesticOrderService { /** 内贸订单审批的 BPM 流程分类 code */ private static final String DOMESTIC_ORDER_APPROVE_CATEGORY_CODE = "domestic_order_approve"; /** 附件绑定的 recordType */ private static final String ATTACHMENT_RECORD_TYPE = "trade_domestic_order"; @Resource private TradeDomesticOrderMapper orderMapper; @Resource private TradeDomesticOrderItemMapper orderItemMapper; @Resource private TradeNoRedisDAO noRedisDAO; @Resource private MdmItemApi mdmItemApi; @Resource private CrmCustomerApi customerApi; @Resource private StorageAttachmentApi storageAttachmentApi; @Resource private MesWmProductSalesApi mesProductSalesApi; @Resource private MesWmStockApi mesStockApi; @Resource private BpmProcessInstanceApi bpmProcessInstanceApi; @Resource private BpmProcessDefinitionService bpmProcessDefinitionService; @Resource private BpmCategoryService bpmCategoryService; // ==================== 增删改查 ==================== @Override @Transactional(rollbackFor = Exception.class) @LogRecord(type = TRADE_DOMESTIC_ORDER_TYPE, subType = TRADE_DOMESTIC_ORDER_CREATE_SUB_TYPE, bizNo = "{{#order.id}}", success = TRADE_DOMESTIC_ORDER_CREATE_SUCCESS) public Long createOrder(TradeDomesticOrderSaveReqVO reqVO, Long userId) { // 1.1 校验客户 if (customerApi.validateCustomer(reqVO.getCustomerId()) == null) { throw exception(ORDER_CUSTOMER_NOT_EXISTS); } // 1.2 校验物料明细 List items = validateAndBuildItems(reqVO.getItems()); // 1.3 生成订单号,校验唯一 String no = noRedisDAO.generate(TradeNoRedisDAO.DOMESTIC_ORDER_NO_PREFIX); if (orderMapper.selectByNo(no) != null) { throw exception(ORDER_NO_EXISTS); } // 2. 插入订单 TradeDomesticOrderDO order = BeanUtils.toBean(reqVO, TradeDomesticOrderDO.class); order.setNo(no).setStatus(TradeDomesticOrderStatusEnum.DRAFT.getStatus()) .setOutStatus(0).setOutCount(BigDecimal.ZERO).setSaleUserId( reqVO.getSaleUserId() != null ? reqVO.getSaleUserId() : userId); calculateTotal(order, items); orderMapper.insert(order); // 2.1 插入明细 items.forEach(i -> i.setOrderId(order.getId())); orderItemMapper.insertBatch(items); // 2.2 绑定附件 storageAttachmentApi.bindAttachments("file", ATTACHMENT_RECORD_TYPE, order.getId(), reqVO.getBlobIds()); // 3. 操作日志上下文 LogRecordContext.putVariable("order", order); return order.getId(); } @Override @Transactional(rollbackFor = Exception.class) @LogRecord(type = TRADE_DOMESTIC_ORDER_TYPE, subType = TRADE_DOMESTIC_ORDER_UPDATE_SUB_TYPE, bizNo = "{{#order.id}}", success = TRADE_DOMESTIC_ORDER_UPDATE_SUCCESS) public void updateOrder(TradeDomesticOrderSaveReqVO reqVO) { // 1. 校验存在 + 草稿 TradeDomesticOrderDO old = validateOrderExists(reqVO.getId()); if (!TradeDomesticOrderStatusEnum.DRAFT.getStatus().equals(old.getStatus())) { throw exception(ORDER_UPDATE_FAIL_NOT_DRAFT, old.getNo()); } if (customerApi.validateCustomer(reqVO.getCustomerId()) == null) { throw exception(ORDER_CUSTOMER_NOT_EXISTS); } List items = validateAndBuildItems(reqVO.getItems()); // 2. 更新订单 TradeDomesticOrderDO updateObj = BeanUtils.toBean(reqVO, TradeDomesticOrderDO.class); calculateTotal(updateObj, items); orderMapper.updateById(updateObj); // 2.1 明细 diff 更新 updateOrderItemList(reqVO.getId(), items); // 2.2 附件 storageAttachmentApi.updateAttachments("file", ATTACHMENT_RECORD_TYPE, reqVO.getId(), reqVO.getBlobIds()); LogRecordContext.putVariable("order", old); } @Override @Transactional(rollbackFor = Exception.class) @LogRecord(type = TRADE_DOMESTIC_ORDER_TYPE, subType = TRADE_DOMESTIC_ORDER_DELETE_SUB_TYPE, bizNo = "{{#order.id}}", success = TRADE_DOMESTIC_ORDER_DELETE_SUCCESS) public void deleteOrder(Long id) { TradeDomesticOrderDO order = validateOrderExists(id); if (!TradeDomesticOrderStatusEnum.DRAFT.getStatus().equals(order.getStatus())) { throw exception(ORDER_DELETE_FAIL_NOT_DRAFT, order.getNo()); } storageAttachmentApi.deleteAttachmentsByRecord(ATTACHMENT_RECORD_TYPE, id); orderMapper.deleteById(id); orderItemMapper.deleteByOrderId(id); LogRecordContext.putVariable("order", order); } @Override public TradeDomesticOrderDO getOrder(Long id) { return orderMapper.selectById(id); } @Override public PageResult getOrderPage(TradeDomesticOrderPageReqVO reqVO) { return orderMapper.selectPage(reqVO); } @Override public List getOrderItemListByOrderId(Long orderId) { return orderItemMapper.selectListByOrderId(orderId); } @Override public List getOrderItemListByOrderIds(Collection orderIds) { if (CollUtil.isEmpty(orderIds)) { return Collections.emptyList(); } return orderItemMapper.selectListByOrderIds(orderIds); } // ==================== 审批(BPM 协同办公) ==================== @Override @Transactional(rollbackFor = Exception.class) @LogRecord(type = TRADE_DOMESTIC_ORDER_TYPE, subType = TRADE_DOMESTIC_ORDER_SUBMIT_SUB_TYPE, bizNo = "{{#order.id}}", success = TRADE_DOMESTIC_ORDER_SUBMIT_SUCCESS) public void submitOrder(Long id, String processDefinitionKey, Long userId) { TradeDomesticOrderDO order = validateOrderExists(id); // 1. 仅草稿 / 审核不通过 可提交 if (!TradeDomesticOrderStatusEnum.DRAFT.getStatus().equals(order.getStatus()) && !TradeDomesticOrderStatusEnum.REJECTED.getStatus().equals(order.getStatus())) { throw exception(ORDER_SUBMIT_FAIL_STATUS, order.getNo()); } // 2. 校验分类与流程定义 validateApproveCategoryAndProcessDefinition(); ProcessDefinition processDefinition = bpmProcessDefinitionService.getActiveProcessDefinition(processDefinitionKey); if (processDefinition == null) { throw exception(ORDER_BPM_PROCESS_DEFINITION_NOT_EXISTS); } // 3. 创建审批流程实例(businessKey = 订单编号) String processInstanceId = bpmProcessInstanceApi.createProcessInstance(userId, new BpmProcessInstanceCreateReqDTO() .setProcessDefinitionKey(processDefinitionKey).setBusinessKey(String.valueOf(id))); // 4. 更新工作流编号 + 状态为审批中 orderMapper.updateById(new TradeDomesticOrderDO().setId(id).setProcessInstanceId(processInstanceId) .setStatus(TradeDomesticOrderStatusEnum.APPROVING.getStatus())); LogRecordContext.putVariable("order", order); } @Override public void updateOrderAuditStatus(Long id, Integer bpmResult) { TradeDomesticOrderDO order = validateOrderExists(id); if (!TradeDomesticOrderStatusEnum.APPROVING.getStatus().equals(order.getStatus())) { log.warn("[updateOrderAuditStatus][内贸订单({}) 不处于审批中,无法更新审批结果({})]", id, bpmResult); throw exception(ORDER_UPDATE_AUDIT_STATUS_FAIL_NOT_PROCESS, order.getNo()); } Integer status = convertBpmResultToStatus(bpmResult); orderMapper.updateById(new TradeDomesticOrderDO().setId(id).setStatus(status)); } @Override public List> getApproveProcessDefinitionList() { validateApproveCategoryAndProcessDefinition(); List definitionInfoList = bpmProcessDefinitionService .getProcessDefinitionInfoListByCategory(DOMESTIC_ORDER_APPROVE_CATEGORY_CODE); Set processDefinitionIds = convertSet(definitionInfoList, BpmProcessDefinitionInfoDO::getProcessDefinitionId); List processDefinitions = bpmProcessDefinitionService.getProcessDefinitionList(processDefinitionIds); Map latestVersionMap = new HashMap<>(); for (ProcessDefinition pd : processDefinitions) { if (pd.isSuspended()) { continue; } ProcessDefinition existing = latestVersionMap.get(pd.getKey()); if (existing == null || pd.getVersion() > existing.getVersion()) { latestVersionMap.put(pd.getKey(), pd); } } List> result = new ArrayList<>(); for (ProcessDefinition pd : latestVersionMap.values()) { Map item = new HashMap<>(); item.put("id", pd.getId()); item.put("key", pd.getKey()); item.put("name", pd.getName()); item.put("version", pd.getVersion()); result.add(item); } return result; } // ==================== 完结 / 作废 ==================== @Override @Transactional(rollbackFor = Exception.class) @LogRecord(type = TRADE_DOMESTIC_ORDER_TYPE, subType = TRADE_DOMESTIC_ORDER_COMPLETE_SUB_TYPE, bizNo = "{{#order.id}}", success = TRADE_DOMESTIC_ORDER_COMPLETE_SUCCESS) public void completeOrder(Long id) { TradeDomesticOrderDO order = validateOrderExists(id); if (!TradeDomesticOrderStatusEnum.APPROVED.getStatus().equals(order.getStatus())) { throw exception(ORDER_COMPLETE_FAIL_NOT_APPROVE, order.getNo()); } // 更新为已完结(核心字段锁定) orderMapper.updateById(new TradeDomesticOrderDO().setId(id) .setStatus(TradeDomesticOrderStatusEnum.COMPLETED.getStatus())); // 归档(预留) archiveOrder(id); LogRecordContext.putVariable("order", order); } @Override @Transactional(rollbackFor = Exception.class) @LogRecord(type = TRADE_DOMESTIC_ORDER_TYPE, subType = TRADE_DOMESTIC_ORDER_CANCEL_SUB_TYPE, bizNo = "{{#order.id}}", success = TRADE_DOMESTIC_ORDER_CANCEL_SUCCESS) public void cancelOrder(Long id) { TradeDomesticOrderDO order = validateOrderExists(id); if (!TradeDomesticOrderStatusEnum.APPROVED.getStatus().equals(order.getStatus())) { throw exception(ORDER_CANCEL_FAIL_NOT_APPROVE, order.getNo()); } orderMapper.updateById(new TradeDomesticOrderDO().setId(id) .setStatus(TradeDomesticOrderStatusEnum.CANCELLED.getStatus())); LogRecordContext.putVariable("order", order); } // ==================== 预留接口 ==================== @Override public void archiveOrder(Long id) { // TODO 【预留】依赖「全系统统一电子档案库」(需求11);接入后改为:生成归档快照 + 调用档案库服务 log.info("[archiveOrder][内贸订单({}) 归档为预留接口,待接入统一电子档案库]", id); } @Override @Transactional(rollbackFor = Exception.class) @LogRecord(type = TRADE_DOMESTIC_ORDER_TYPE, subType = TRADE_DOMESTIC_ORDER_UPLOAD_DOC_SUB_TYPE, bizNo = "{{#order.id}}", success = TRADE_DOMESTIC_ORDER_UPLOAD_DOC_SUCCESS) public void uploadDocuments(Long id, List blobIds) { TradeDomesticOrderDO order = validateOrderExists(id); if (CollUtil.isNotEmpty(blobIds)) { storageAttachmentApi.bindAttachments("file", ATTACHMENT_RECORD_TYPE, id, blobIds); } LogRecordContext.putVariable("order", order); } @Override @Transactional(rollbackFor = Exception.class) @LogRecord(type = TRADE_DOMESTIC_ORDER_TYPE, subType = TRADE_DOMESTIC_ORDER_OUTBOUND_SUB_TYPE, bizNo = "{{#order.id}}", success = TRADE_DOMESTIC_ORDER_OUTBOUND_SUCCESS) public void outbound(TradeDomesticOrderOutboundReqVO reqVO, Long userId) { // 1. 校验订单已审批通过 TradeDomesticOrderDO order = validateOrderExists(reqVO.getId()); if (!TradeDomesticOrderStatusEnum.APPROVED.getStatus().equals(order.getStatus())) { throw exception(ORDER_OUTBOUND_FAIL_NOT_APPROVE, order.getNo()); } if (CollUtil.isEmpty(reqVO.getItems())) { throw exception(ORDER_OUTBOUND_ITEMS_EMPTY); } // 2. 校验数量 + 组装 MES 出库请求 List orderItems = orderItemMapper.selectListByOrderId(order.getId()); Map itemMap = convertMap(orderItems, TradeDomesticOrderItemDO::getItemId); MesWmProductSalesOutboundReqDTO mesReq = new MesWmProductSalesOutboundReqDTO(); mesReq.setCode(noRedisDAO.generate("CKCK")); mesReq.setName("内贸订单出库-" + order.getNo()); mesReq.setClientId(order.getCustomerId()); mesReq.setSalesDate(LocalDateTime.now()); mesReq.setCarrier(reqVO.getCarrier()); mesReq.setShippingNumber(reqVO.getShippingNumber()); mesReq.setRemark("内贸订单出库:" + order.getNo()); List mesLines = new ArrayList<>(); for (TradeDomesticOrderOutboundReqVO.Item it : reqVO.getItems()) { if (it.getQuantity() == null || it.getQuantity().compareTo(BigDecimal.ZERO) <= 0) { throw exception(ORDER_OUTBOUND_QTY_INVALID); } TradeDomesticOrderItemDO oi = itemMap.get(it.getItemId()); BigDecimal already = oi != null && oi.getOutCount() != null ? oi.getOutCount() : BigDecimal.ZERO; BigDecimal ordered = oi != null && oi.getCount() != null ? oi.getCount() : BigDecimal.ZERO; if (already.add(it.getQuantity()).compareTo(ordered) > 0) { throw exception(ORDER_OUTBOUND_QTY_EXCEED, order.getNo(), it.getItemId()); } MesWmProductSalesOutboundReqDTO.Line ml = new MesWmProductSalesOutboundReqDTO.Line(); ml.setItemId(it.getItemId()); ml.setQuantity(it.getQuantity()); ml.setMaterialStockId(it.getMaterialStockId()); ml.setWarehouseId(it.getWarehouseId()); ml.setBatchId(it.getBatchId()); ml.setBatchCode(it.getBatchCode()); ml.setLocationId(it.getLocationId()); ml.setAreaId(it.getAreaId()); mesLines.add(ml); } mesReq.setLines(mesLines); // 3. 调用 MES 成品出库(扣库存) mesProductSalesApi.createAndFinishProductSales(mesReq); // 4. 回写订单明细 out_count + 订单 out_count/out_status for (TradeDomesticOrderOutboundReqVO.Item it : reqVO.getItems()) { TradeDomesticOrderItemDO oi = itemMap.get(it.getItemId()); if (oi != null) { BigDecimal already = oi.getOutCount() != null ? oi.getOutCount() : BigDecimal.ZERO; orderItemMapper.updateById(new TradeDomesticOrderItemDO().setId(oi.getId()) .setOutCount(already.add(it.getQuantity()))); } } refreshOrderOutStatus(order); LogRecordContext.putVariable("order", order); } private void refreshOrderOutStatus(TradeDomesticOrderDO order) { List items = orderItemMapper.selectListByOrderId(order.getId()); BigDecimal total = BigDecimal.ZERO; BigDecimal out = BigDecimal.ZERO; boolean allOut = !items.isEmpty(); for (TradeDomesticOrderItemDO i : items) { BigDecimal c = i.getCount() != null ? i.getCount() : BigDecimal.ZERO; BigDecimal o = i.getOutCount() != null ? i.getOutCount() : BigDecimal.ZERO; total = total.add(c); out = out.add(o); if (o.compareTo(c) < 0) { allOut = false; } } int outStatus = out.compareTo(BigDecimal.ZERO) <= 0 ? 0 : (allOut ? 2 : 1); orderMapper.updateById(new TradeDomesticOrderDO().setId(order.getId()) .setOutCount(out).setOutStatus(outStatus)); } @Override public List getAvailableStock(Long itemId) { return mesStockApi.getAvailableStockListByItemIds(Collections.singletonList(itemId)); } @Override public void syncToK3(Long id) { // TODO 【预留】依赖「金蝶 K3 对接」;接入后改为:调用 K3 接口同步订单基础数据 log.info("[syncToK3][内贸订单({}) K3 同步为预留接口,待接入金蝶 K3]", id); } // ==================== 私有方法 ==================== private TradeDomesticOrderDO validateOrderExists(Long id) { TradeDomesticOrderDO order = orderMapper.selectById(id); if (order == null) { throw exception(ORDER_NOT_EXISTS); } return order; } private List validateAndBuildItems(List list) { Set itemIds = convertSet(list, TradeDomesticOrderSaveReqVO.Item::getItemId); Map itemMap = mdmItemApi.getItemMap(itemIds); return convertList(list, o -> BeanUtils.toBean(o, TradeDomesticOrderItemDO.class, item -> { MdmItemRespDTO mdmItem = itemMap.get(item.getItemId()); if (mdmItem == null) { throw exception(ORDER_ITEM_NOT_EXISTS); } item.setItemUnitId(mdmItem.getUnitMeasureId()); item.setOutCount(BigDecimal.ZERO); if (item.getItemPrice() != null && item.getCount() != null) { item.setTotalPrice(MoneyUtils.priceMultiply(item.getItemPrice(), item.getCount())); if (item.getTaxPercent() != null) { item.setTaxPrice(MoneyUtils.priceMultiplyPercent(item.getTotalPrice(), item.getTaxPercent())); } } })); } private void updateOrderItemList(Long orderId, List newList) { List oldList = orderItemMapper.selectListByOrderId(orderId); List> diffList = diffList(oldList, newList, (oldVal, newVal) -> oldVal.getId() != null && oldVal.getId().equals(newVal.getId())); if (CollUtil.isNotEmpty(diffList.get(0))) { diffList.get(0).forEach(o -> o.setOrderId(orderId)); orderItemMapper.insertBatch(diffList.get(0)); } if (CollUtil.isNotEmpty(diffList.get(1))) { orderItemMapper.updateBatch(diffList.get(1)); } if (CollUtil.isNotEmpty(diffList.get(2))) { orderItemMapper.deleteByIds(convertList(diffList.get(2), TradeDomesticOrderItemDO::getId)); } } private void calculateTotal(TradeDomesticOrderDO order, List items) { order.setTotalCount(getSumValue(items, TradeDomesticOrderItemDO::getCount, BigDecimal::add, BigDecimal.ZERO)); order.setTotalPrice(getSumValue(items, TradeDomesticOrderItemDO::getTotalPrice, BigDecimal::add, BigDecimal.ZERO)); } private Integer convertBpmResultToStatus(Integer bpmResult) { if (BpmTaskStatusEnum.APPROVE.getStatus().equals(bpmResult)) { return TradeDomesticOrderStatusEnum.APPROVED.getStatus(); } else if (BpmTaskStatusEnum.REJECT.getStatus().equals(bpmResult)) { return TradeDomesticOrderStatusEnum.REJECTED.getStatus(); } else if (BpmTaskStatusEnum.CANCEL.getStatus().equals(bpmResult)) { return TradeDomesticOrderStatusEnum.CANCELLED.getStatus(); } throw exception(ORDER_UPDATE_AUDIT_STATUS_FAIL_NOT_PROCESS, ""); } private void validateApproveCategoryAndProcessDefinition() { List codes = Collections.singletonList(DOMESTIC_ORDER_APPROVE_CATEGORY_CODE); Map categoryMap = bpmCategoryService.getCategoryMap(codes); if (!categoryMap.containsKey(DOMESTIC_ORDER_APPROVE_CATEGORY_CODE)) { throw exception(ORDER_BPM_PROCESS_DEFINITION_NOT_EXISTS); } List definitionInfoList = bpmProcessDefinitionService .getProcessDefinitionInfoListByCategory(DOMESTIC_ORDER_APPROVE_CATEGORY_CODE); if (CollUtil.isEmpty(definitionInfoList)) { throw exception(ORDER_BPM_PROCESS_DEFINITION_NOT_EXISTS); } Set processDefinitionIds = convertSet(definitionInfoList, BpmProcessDefinitionInfoDO::getProcessDefinitionId); List processDefinitions = bpmProcessDefinitionService.getProcessDefinitionList(processDefinitionIds); boolean hasActiveDefinition = processDefinitions.stream().anyMatch(pd -> !pd.isSuspended()); if (!hasActiveDefinition) { throw exception(ORDER_BPM_PROCESS_DEFINITION_NOT_EXISTS); } } }