package cn.iocoder.yudao.module.trade.service.foreign; import cn.hutool.core.collection.CollUtil; import cn.hutool.core.util.StrUtil; import cn.iocoder.yudao.framework.common.util.object.BeanUtils; import cn.iocoder.yudao.module.system.api.storage.StorageAttachmentApi; import cn.iocoder.yudao.module.system.api.storage.dto.StorageBlobRespDTO; import cn.iocoder.yudao.module.trade.controller.admin.foreign.vo.TradeForeignDocumentSaveReqVO; import cn.iocoder.yudao.module.trade.controller.admin.foreign.vo.TradeForeignRequiredDocRespVO; import cn.iocoder.yudao.module.trade.dal.dataobject.foreign.TradeForeignDocumentDO; import cn.iocoder.yudao.module.trade.dal.dataobject.foreign.TradeForeignOrderDO; import cn.iocoder.yudao.module.trade.dal.mysql.foreign.TradeForeignDocumentMapper; import cn.iocoder.yudao.module.trade.dal.mysql.foreign.TradeForeignOrderMapper; import cn.iocoder.yudao.module.trade.enums.foreign.TradeForeignDeliveryModeEnum; import cn.iocoder.yudao.module.trade.enums.foreign.TradeForeignDocTypeEnum; import cn.iocoder.yudao.module.trade.enums.foreign.TradeForeignOrderStatusEnum; import jakarta.annotation.Resource; import org.springframework.stereotype.Service; import org.springframework.validation.annotation.Validated; import java.util.*; import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception; import static cn.iocoder.yudao.module.trade.enums.ErrorCodeConstants.FOREIGN_ORDER_NOT_APPROVED_FOR_DOC; import static cn.iocoder.yudao.module.trade.enums.ErrorCodeConstants.FOREIGN_ORDER_NOT_EXISTS; /** * 外贸订单单据 Service 实现类 * * @author mom */ @Service @Validated public class TradeForeignDocumentServiceImpl implements TradeForeignDocumentService { /** 统一附件区:application / recordType(与外贸订单附件一致) */ private static final String ATTACHMENT_APPLICATION = "file"; private static final String ATTACHMENT_RECORD_TYPE = "trade_foreign_order"; /** 各出货模式的必填单据类型 */ private static final Map> REQUIRED_DOCS = new HashMap<>(); static { REQUIRED_DOCS.put(TradeForeignDeliveryModeEnum.FACTORY_DIRECT.getMode(), new LinkedHashSet<>(Arrays.asList( TradeForeignDocTypeEnum.CONTRACT.getType(), TradeForeignDocTypeEnum.PACKING_LIST.getType(), TradeForeignDocTypeEnum.PRODUCT_OUTBOUND.getType()))); REQUIRED_DOCS.put(TradeForeignDeliveryModeEnum.PORT_PREPARE.getMode(), new LinkedHashSet<>(Arrays.asList( TradeForeignDocTypeEnum.CONTRACT.getType(), TradeForeignDocTypeEnum.PACKING_LIST.getType(), TradeForeignDocTypeEnum.PORT_INBOUND.getType()))); } /** 需「审批通过」才能登记的单据类型(报关/出运资料) */ private static final Set APPROVAL_REQUIRED_DOCS = new HashSet<>(Arrays.asList( TradeForeignDocTypeEnum.CUSTOMS_DECLARATION.getType(), TradeForeignDocTypeEnum.RELEASE_NOTICE.getType(), TradeForeignDocTypeEnum.EXPORT_INVOICE.getType(), TradeForeignDocTypeEnum.PACKING_LIST.getType(), TradeForeignDocTypeEnum.PRODUCT_OUTBOUND.getType())); @Resource private TradeForeignDocumentMapper documentMapper; @Resource private TradeForeignOrderMapper orderMapper; @Resource private StorageAttachmentApi storageAttachmentApi; @Override public Long addDocument(TradeForeignDocumentSaveReqVO reqVO) { TradeForeignOrderDO order = orderMapper.selectById(reqVO.getOrderId()); if (order == null) { throw exception(FOREIGN_ORDER_NOT_EXISTS); } // 需求2:审批通过后才可登记报关/出运资料 if (APPROVAL_REQUIRED_DOCS.contains(reqVO.getDocType()) && !TradeForeignOrderStatusEnum.APPROVED.getStatus().equals(order.getStatus()) && !TradeForeignOrderStatusEnum.COMPLETED.getStatus().equals(order.getStatus())) { throw exception(FOREIGN_ORDER_NOT_APPROVED_FOR_DOC, order.getNo()); } TradeForeignDocumentDO document = BeanUtils.toBean(reqVO, TradeForeignDocumentDO.class); documentMapper.insert(document); // 统一附件区:把文件追加绑定到订单附件(recordType=trade_foreign_order),与表单附件区共用一处。 // 注意 bindAttachments 是「整体替换」语义,需带上订单已有附件,避免覆盖其它已登记单据的附件 if (reqVO.getBlobId() != null) { List blobIds = new ArrayList<>(); List existing = storageAttachmentApi.listAttachments(ATTACHMENT_RECORD_TYPE, reqVO.getOrderId()); if (CollUtil.isNotEmpty(existing)) { existing.forEach(blob -> { if (blob.getId() != null) { blobIds.add(blob.getId()); } }); } if (!blobIds.contains(reqVO.getBlobId())) { blobIds.add(reqVO.getBlobId()); } storageAttachmentApi.bindAttachments(ATTACHMENT_APPLICATION, ATTACHMENT_RECORD_TYPE, reqVO.getOrderId(), blobIds); } return document.getId(); } @Override public List getDocumentListByOrderId(Long orderId) { List documents = documentMapper.selectListByOrderId(orderId); if (CollUtil.isEmpty(documents)) { return documents; } // 从统一附件区回填文件 url/name(登记时仅保存了 blobId) Map blobMap = buildAttachmentBlobMap(orderId); for (TradeForeignDocumentDO document : documents) { StorageBlobRespDTO blob = blobMap.get(document.getBlobId()); if (blob == null) { continue; } if (StrUtil.isBlank(document.getUrl())) { document.setUrl(blob.getUrl()); } if (StrUtil.isBlank(document.getName())) { document.setName(blob.getName()); } } return documents; } private Map buildAttachmentBlobMap(Long orderId) { Map map = new HashMap<>(); List blobs = storageAttachmentApi.listAttachments(ATTACHMENT_RECORD_TYPE, orderId); if (CollUtil.isEmpty(blobs)) { return map; } for (StorageBlobRespDTO blob : blobs) { if (blob.getId() != null) { map.putIfAbsent(blob.getId(), blob); } } return map; } @Override public List getRequiredDocs(Long orderId) { TradeForeignOrderDO order = orderMapper.selectById(orderId); if (order == null) { throw exception(FOREIGN_ORDER_NOT_EXISTS); } Set required = requiredTypes(order.getDeliveryMode()); Set uploaded = new HashSet<>(); for (TradeForeignDocumentDO doc : documentMapper.selectListByOrderId(orderId)) { uploaded.add(doc.getDocType()); } List result = new ArrayList<>(); for (TradeForeignDocTypeEnum type : TradeForeignDocTypeEnum.values()) { TradeForeignRequiredDocRespVO vo = new TradeForeignRequiredDocRespVO(); vo.setDocType(type.getType()); vo.setDocName(type.getName()); vo.setRequired(required.contains(type.getType())); vo.setUploaded(uploaded.contains(type.getType())); result.add(vo); } return result; } @Override public List getMissingRequiredDocNames(Long orderId, boolean excludeApprovalRequired) { TradeForeignOrderDO order = orderMapper.selectById(orderId); if (order == null) { throw exception(FOREIGN_ORDER_NOT_EXISTS); } Set required = requiredTypes(order.getDeliveryMode()); if (excludeApprovalRequired) { required.removeAll(APPROVAL_REQUIRED_DOCS); } if (required.isEmpty()) { return Collections.emptyList(); } Set uploaded = new HashSet<>(); for (TradeForeignDocumentDO doc : documentMapper.selectListByOrderId(orderId)) { uploaded.add(doc.getDocType()); } return collectMissingNames(required, uploaded); } @Override public Map> getMissingRequiredDocNamesByOrderIds(Collection orderIds) { Map> result = new HashMap<>(); if (CollUtil.isEmpty(orderIds)) { return result; } Map> uploadedMap = new HashMap<>(); for (TradeForeignDocumentDO doc : documentMapper.selectListByOrderIds(orderIds)) { uploadedMap.computeIfAbsent(doc.getOrderId(), k -> new HashSet<>()).add(doc.getDocType()); } for (TradeForeignOrderDO order : orderMapper.selectBatchIds(orderIds)) { Set required = requiredTypes(order.getDeliveryMode()); Set uploaded = uploadedMap.getOrDefault(order.getId(), Collections.emptySet()); result.put(order.getId(), collectMissingNames(required, uploaded)); } return result; } /** 复制出货模式对应的必填单据集合(保持顺序,避免污染静态常量) */ private Set requiredTypes(Integer deliveryMode) { return new LinkedHashSet<>(REQUIRED_DOCS.getOrDefault(deliveryMode, Collections.emptySet())); } private List collectMissingNames(Set required, Set uploaded) { List missing = new ArrayList<>(); for (String type : required) { if (!uploaded.contains(type)) { missing.add(TradeForeignDocTypeEnum.getNameByType(type)); } } return missing; } }