目录背景
商城整体架构
订单系统
商品系统
促销系统
支付系统
推荐系统
积分系统
会员系统
总结
1 背景
随着互联网技术广泛应用，各行各业都依托线上平
目录
1. 背景
随着互联网技术广泛应用，各行各业都依托线上平台进行商务活动。小到个人带货，大到企业商业活动，都少不了需要少不了在线交易。于是，到处可见商城影响，不管是加盟大的电商平台如淘宝、京东、拼多多，或是企业自建商城平台，目的基本都是扩大生意渠道，卖货增加业绩收入。
下面基于我们公司自建商城平台，来谈谈我们商城架构设计方案。
2. 商城整体架构
一般来说，商城系统按单体服务方案去构思的话，按模块划分至少包括：商品、订单、会员、促销、支付、积分、仓储、物流、风控、企业内部erp、财务系统等。
公司原有技术架构是SpringCloud微服务架构 ，所以商城系统也是在这个体系下，同时根据我们公司实际业务特殊和复杂性，对各个模块进行微服务划分，业务领域分成多个业务中台和数据中台。
设计商城整架构如下：
一个完整商城体系结构是比较复杂的，涉及到很多关联系统和子系统模块。
采用分层设计，从系统分层设计角度考虑，可以划分：前端接入层、应用表示层、中台服务、后端服务层、基础服务层。
3. 订单系统
2.1、订单系统边界
在搭建企业订单系统之前，需要先梳理整体业务系统之间的关系和订单系统上下游关系，只有划分清业务系统边界，才能确定订单系统的职责与功能，进而保证各系统之间高效简洁的工作。
对外服务展示，所有给企业外部用户使用的系统都在这一层，包括WEB、普通用户使用的C端，还包括给商户使用的商家后台和在各个销售渠道进行分销的系统，比如与银行信用卡中心合作、微信合作在合作商的平台展示出本产品。这类系统站在与客户接触的最前线，是企业实现商业模式的桥头堡。
中后台系统，每个C端的业务形态都会有一个对应的系统模块，如负责管理平台交易的订单系统，管理优惠信息的促销系统，管理平台所有产品的产商品系统，以及管理所有对外系统显示内容的内容系统（CMS）等。
基础服务系统，随着企业的发展，信息化建设到达一定程度后，企业需要将通用功能服务化、平台化，以保证应用架构的合理性，提升服务效率。这类系统主要给其他应用系统提供基础服务能力支持。
由此可见，订单系统对上接收用户信息，将用户信息转化为产品订单，同时管理并跟踪订单信息和数据，承载了整个交易线的重要对客环节。
对下则衔接产品系统、促销系统、仓储系统、会员系统、积分系统、支付系统等，对整个电商平台起着承上启下的作用。
2.2、订单系统业务架构
订单服务，该模块的主要功能是用户日常使用的服务和页面，主要有订单列表、订单详情、在线下单等，还包括为公共业务模块提供的多维度订单数据服务。
订单逻辑，订单系统的核心，起着至关重要的作用，在订单系统负责管理订单创建、订单支付、订单生产、订单确认、订单完成、取消订单等订单流程。还涉及到复杂的订单状态规则、订单金额计算规则以及增减库存规则等。
底层服务，信息化建设达到一定程度的企业，一般会将公共服务模块化和中台化，比如：产品，会构建对应的产品系统，代码、数据库，接口等相对独立。但是，这也带来了一个问题，比如：订单创建的场景下需要获取的信息分散在各个系统。组装信息的时候会比较麻烦。
如果需要从各个中台系统调用：一是会花费大量时间，二是代码的维护成本非常高。因此，订单系统接入所需的公共服务模块聚合接口，在订单系统即可完成对接公共系统的服务。
2.3、订单核心功能
功能脑图
为了使订单系统能够对订单进行高效、精准的管理和跟踪，订单会储存关于产品、优惠、用户、支付信息等一系列的订单实时数据，来和下游系统，如：促销、仓储、物流进行交互。
以一个通用B2C商城的订单为例，梳理其包含的信息如下：
这里要注意的是订单类型，随着平台业务的不断发展，品类丰富、交易方式丰富后，需要对订单进行多维度的分类管理，同时订单类型利于订单系统的扩展性。每种订单类型将会对应一套流程及一套状态，便于对订单进行分类管理和复用。
2.4、订单正向流程
2.4.1、订单创建
用户下单后，系统需要生成订单，此时需要先获取下单中涉及的商品信息，然后获取该商品所涉及到的优惠信息，如果商品不参与优惠信息，则无此环节。
接着获取该账户的会员权益，这里要注意的是：优惠信息与会员权益的区别，比如：商品满减是优惠信息，会员全场9.8折指的是会员权益，一个是针对商品，另一个是针对账户。其次就是优惠活动的叠加规则和优先级规则等。
增减库存规则是指订单中的商品，何时从库存系统中对相应商品库存进行扣除，目前主流有两种方式：
（1）下单减库存——即用户下单成功时减少库存数量
优势：用户体验友好，系统逻辑简洁。
缺点：会导致恶意下单或下单后却不买，使得真正有需求的用户无法购买，影响真实销量。
解决办法：
设置订单有效时间，若订单创建成功N分钟不付款，则订单取消，库存回滚；
限购，用各种条件来限制买家的购买件数，比如一个账号、一个ip，只能买一件；
风控，从技术角度进行判断，屏蔽恶意账号，禁止恶意账号购买。
（2）付款减库存——即用户支付完成并反馈给平台后再减少库存数量
优势：减少无效订单带来的资源损耗。
缺点：因第三方支付返回结果存在时差，同一时间多个用户同时付款成功，会导致下单数目超过库存，商家库存不足容易引发断货和投诉，成本增加。
解决办法：
付款前再次校验库存，如确认订单要付款时再验证一次，并友好提示用户库存不足；
增加提示信息：在商品详情页，订单步骤页面提示不及时付款，不能保证有库存等。
综上所述，两种方式各有优缺点，因此，需结合实际场景进行考虑，如：秒杀、抢购、促销活动等，可使用下单减库存的方式。而对于产品库存量大，并发流量没有那么强的产品使用付款减库存的方式（秒杀系统设计是在另外文档中专题描述）。
将两种方式带入到销售场景中，关联商品类型、促销类型、供需关系等，灵活使用，以充分发挥计算机系统的优势。
2.4.2、订单支付
用户支付完订单后，需要获取订单的支付信息，包括支付流水号、支付时间等。支付完订单接着就是等商家发货，但在发货过程中，根据平台业务模式的不同，可能会涉及到订单的拆分。
订单拆分一般分两种：
一种是用户挑选的商品来自于不同渠道（自营与商家，商家与商家）；
另一种是在SKU层面上拆分订单：不同仓库，不同运输要求的SKU，包裹重量体积限制等因素需要将订单拆分。
订单拆分也是一个相对独立的模块，可以采用子母单的形式，也可以采用服务单和订单形式，总的来说就是1：N关系。
2.4.3、订单生产
订单生产，是指产品从企业到用户这一流程的概述。如电商平台中，商家发货过程已有一个标准化的流程，订单内容会发送到仓库，仓库对商品进行打单、拣货、包装、交接快递进行配送（在我们这里一般是由供应商完成）。
2.4.4、订单确认
收到货后，订单系统需要在快递被签收后提醒用户对商品做评价。这里要注意，确认收到货不代表交易成功，而是售后服务的开始。
2.4.5、订单完成
订单完成是指在收到货X天的状态，此时订单不在售后的支持时间范围内。到此，一个订单的正向流程就算走完了。
2.4、订单逆向流程
上面说到逆向流程是各种修改订单、取消订单、退款、退货等操作，需要梳理清楚这些流程与正向流程的关系，才能理清订单系统完整的订单流程。
2.4.1、订单修改
可梳理订单内信息，根据信息关联程度及业务诉求，设定订单的可修改范围是什么，比如：客户下单后，想修改收货人地址及电话。此时只需对相应数据进行更新即可。
2.4.2、订单取消
用户提交订单后没有进行支付操作，此时用户原则上属于取消订单，因为还未付款，则比较简单，只需要将原本提交订单时扣减的库存补回，促销优惠中使用的优惠券，权益等视平台规则，进行相应补回。
2.4.3、退款
用户支付成功后，客户发出退款的诉求后，需商户进行退款审核，双方达成一致后，系统应以退款单的形式完成退款，关联原订单数据。因商品无变化，所以不许考虑与库存系统的交互，仅需考虑促销系统及支付系统交互即可。
2.4.4、退货
用户支付成功后，客户发出退货的诉求后，需商户进行退款审核，双方达成一致后，需对库存系统进行补回，支付系统、促销系统以退款单形式完成退款。最后，在退款/退货流程中，需结合平台业务场景，考虑优惠分摊的逻辑，在发生退款/退货时，优惠该如何退回的处理规则和流程。
2.5、状态机设计
状态机是管理订单状态逻辑的工具。状态机可归纳为3个要素，即现态、动作、次态。
现态：是指当前所处的状态。
动作：动作执行完毕后，可以迁移到新的状态，也可以仍旧保持原状态。
次态：动作满足后要迁往的新状态，“次态”是相对于“现态”而言的，“次态”一旦被激活，就转变成新的“现态”了。
状态机的设计需要结合平台实际业务场景，将状态间的切换细化成了执行了某个动作。
以一个B2C商城的订单系统举例，状态分类如下：
订单系统为了高效的对订单进行跟踪和管理，会对订单流程当中的关键节点，抽象出订单状态。而订单状态从不同用户的角度可分为：系统订单状态、商家订单状态、买家订单状态等。
对于订单系统来说，订单状态细分的颗粒度越细、越明确，订单系统管理的精度和可靠性就越高，比如：在待付款和待发货两个状态中，订单系统后台会细分为：订单超时取消、订单支付失败、订单付款完成等。
因此，订单状态模块中，通常会维护状态映射表，以不同的用户角色对系统订单状态进行重新划分，以满足不同用户的需求。
除此以外，随着业务的不断发展，不同的业务类型，所对应的订单状态都会有所区别。所以，订单系统中一般会储存多套状态机，以满足不同的订单类型来使用。
2.5、关键代码片断
对前商提供API访问接口
@Module("订单模块-C端")
@RestController
@RequestMapping("/customer-api/v1/order")
public class OrderCustomerController {
@Resource
private OrderService orderService;
@Resource
private OrderCreateCmdExe orderCreateCmdExe;
@Resource
private OrderPayCmdExe orderPayCmdExe;
@Resource
private OrderCancelCmdExe orderCancelCmdExe;
@Resource
private RefundApplyCmdExe refundApplyCmdExe;
@Resource
private OrderDeleteCmdExe orderDeleteCmdExe;
/**
* 生成订单
*
* @param cmd 订单内容
* @return 订单信息
*/
@RestApi(name = "生成订单", logabled = true)
@PostMapping("/create")
@CheckResubmit
public DataResponse<OrderCreateCO> create(@RequestBody @Valid OrderCreateCmd cmd) {
OrderCreateCO orderCreateCO = orderCreateCmdExe.create(cmd);
return DataResponse.of(orderCreateCO);
}
/**
* 订单支付
*/
@RestApi(name = "订单支付", logabled = true)
@PostMapping("/pay")
@CheckResubmit
public DataResponse<OrderPaymentInfoCO> pay(@RequestBody @Valid OrderPayCmd cmd, HttpServletRequest request) {
OrderPaymentInfoCO paymentInfoCO = orderPayCmdExe.pay(cmd, request);
return DataResponse.of(paymentInfoCO);
}
/**
* 订单列表(分页)
*
* @param cmd 查询条件
* @return 查询结果
*/
@RestApi(name = "订单列表(分页)", logabled = true)
@PostMapping("/page")
public DataResponse<CustomizePage<OrderPageCO>> page(@RequestBody OrderPageQryCmd cmd) {
OrderQryDTO dto = BeanToolkit.instance().copy(cmd, OrderQryDTO.class);
dto.setPageNo(cmd.getPageNo());
dto.setPageSize(cmd.getPageSize());
dto.setCreatorId(HttpContext.getCustomerId());
dto.setCustomerDeleted(0);
CustomizePage<OrderDTO> orderDTOPage = orderService.customerPage(dto);
CustomizePage<OrderPageCO> result = new CustomizePage<>(orderDTOPage.getCurrent(), orderDTOPage.getSize(), orderDTOPage.getTotal());
result.setRecords(OrderConverter.converter2OrderCO(orderDTOPage.getRecords()));
return DataResponse.of(result);
}
/**
* 订单详情
*
* @param orderId 订单ID
* @return 订单详情
*/
@RestApi(name = "主订单详情", logabled = true)
@GetMapping("/detail/{orderId}")
public DataResponse<OrderPageCO> detail(@PathVariable("orderId") Long orderId) {
OrderDTO orderDTO = orderService.detail(orderId, TerminalEnum.CUSTOMER);
return DataResponse.of(OrderConverter.converter2OrderCO(orderDTO));
}
/**
* 订单状态统计
*/
@RestApi(name = "订单状态统计", logabled = true)
@GetMapping("/stateStatistics")
public DataResponse<OrderStateStatisticsCustomerCO> orderStateStatistics() {
OrderStateStatisticsCustomerCO result = orderService.customerOrderStateStatistics();
return DataResponse.of(result);
}
/**
* 取消订单
*
* @param cmd 取消订单
*/
@RestApi(name = "取消订单", logabled = true)
@PostMapping("/cancel")
public Response cancel(@RequestBody @Valid OrderCancelCmd cmd) {
orderCancelCmdExe.cancel(cmd);
return Response.buildSuccess();
}
/**
* 退/换货申请
*
* @param cmd 申请内容
*/
@RestApi(name = "退/换货申请", logabled = true)
@PostMapping("/refundApply")
public Response refundApply(@RequestBody @Valid RefundApplyCmd cmd) {
refundApplyCmdExe.refundApply(cmd);
return Response.buildSuccess();
}
/**
* 退/换货订单列表(分页)
*
* @param qry 查询条件
* @return 查询结果
*/
@RestApi(name = "退/换货订单列表(分页)", logabled = true)
@PostMapping("/refundApply/page")
public DataResponse<CustomizePage<OrderPageCO>> refundOrderPage(@RequestBody RefundApplyQry qry) {
CustomizePage<OrderDTO> orderDTOPage = orderService.refundOrderPage(qry);
CustomizePage<OrderPageCO> result = new CustomizePage<>(orderDTOPage.getCurrent(), orderDTOPage.getSize(), orderDTOPage.getTotal());
result.setRecords(OrderConverter.converter2OrderCO(orderDTOPage.getRecords()));
return DataResponse.of(result);
}
/**
* 删除订单
*/
@RestApi(name = "删除订单", logabled = true)
@DeleteMapping("/delete")
public Response deleteOrder(@Valid @RequestBody OrderDeleteCmd cmd) {
orderDeleteCmdExe.deleteOrder(cmd);
return Response.buildSuccess();
}
/**
* 获取订单开票信息
*
* @param orderId 主订单ID
* @return 开票信息
*/
@RestApi(name = "获取订单开票信息", logabled = true)
@GetMapping("/orderInvoiceInfo/{orderId}")
public DataResponse<OrderInvoiceInfoCO> getOrderInvoiceInfo(@PathVariable("orderId") Long orderId) {
return DataResponse.of(orderService.getOrderInvoiceInfo(orderId));
}
}订单创建执行器
@Slf4j
@Component
public class OrderCreateCmdExe {
@Resource
private NumberingGateway numberingGateway;
@Resource
private OrderValidator orderValidator;
@Resource
private GoodsService goodsService;
@Resource
private PointsGateway pointsGateway;
@Resource
private CustomerMemberGateway customerMemberGateway;
@Resource
private OrderAutoCancelPublisher orderAutoCancelPublisher;
@Resource
private OrderDaiZhiFuNoticePublisher orderDaiZhiFuNoticePublisher;
@Resource
private MemberCartGateway memberCartGateway;
/**
* 生成订单
*/
@Transactional(rollbackFor = Exception.class)
public OrderCreateCO create(OrderCreateCmd cmd) {
// 1、查询商品信息
List<String> skuIds = cmd.getGoodsList().stream().map(OrderCreateCmd.GoodsList::getSkuId).collect(Collectors.toList());
Map<String, SpuApiCO> skuMap = goodsService.mapSkuCO(skuIds);
// 2、查询客户积分
BigDecimal customerIntegral = pointsGateway.getCustomerIntegral(HttpContext.getCustomerId());
// 3、查询会员信息
MemberDTO memberDTO = customerMemberGateway.findByCustomerId(HttpContext.getCustomerId());
// 4、检查下单条件
orderValidator.createOrderValidate(cmd, skuMap, customerIntegral, memberDTO);
// 5、 组装订单信息
List<MallOrderE> mallOrderDOS = newMallOrderE(cmd, skuMap, memberDTO.getMemberLevel());
// 6、检查用户积分余额
orderValidator.customerIntegralValidate(mallOrderDOS.get(0), customerIntegral);
// 7、保存订单信息
MallOrderE.queryInstance().saveBatch(mallOrderDOS);
// 8、批量扣除库存，考虑到没有分布式事务，因此最后进行RPC扣库存
List<UpdateInventoryDTO> updateInventoryDTOS = GoodsConverter.convert2UpdateInventoryDTO(cmd.getGoodsList());
goodsService.updateInventory(updateInventoryDTOS);
// 9、开启延迟队列
// 9.1、待支付订单自动取消
OrderEvent orderEvent = new OrderEvent();
orderEvent.setMainOrderId(mallOrderDOS.get(0).getId());
orderEvent.setMainOrderCode(mallOrderDOS.get(0).getCode());
orderAutoCancelPublisher.sendMessage(orderEvent);
// 9.2、待支付订单提醒
orderDaiZhiFuNoticePublisher.sendMessage(orderEvent);
// 10、删除购物车中的商品
if (SubmitPageEnum.orderConfirm.getValue().equals(cmd.getSubmitPage())) {
deleteGoodsCart(cmd.getGoodsList());
}
OrderCreateCO result = new OrderCreateCO();
result.setOrderId(mallOrderDOS.get(0).getId().toString());
result.setOrderNo(mallOrderDOS.get(0).getCode());
return result;
}
/**
* 组装订单信息
* 返回的订单集合中，index=0的为主订单
*/
private List<MallOrderE> newMallOrderE(OrderCreateCmd cmd, Map<String, SpuApiCO> skuMap, Integer memberLevel) {
List<MallOrderE> result = new ArrayList<>();
// 1、打包主订单信息
MallOrderE mallOrderE = BeanToolkit.instance().copy(cmd, MallOrderE.class);
result.add(mallOrderE);
mallOrderE.setId(numberingGateway.getNextId());
String orderCode = numberingGateway.generateOrderCode();
mallOrderE.setCode(orderCode);
mallOrderE.setStatus(OrderStatusEnum.DAI_ZHI_FU.getValue());
// 订单总价格、订单总积分、订单总运费
Long totalPrice = 0L;
Long totalFreight = 0L;
Long totalIntegral = 0L;
// 2、打包子订单信息
Queue<String> subOrderCode = numberingGateway.generateSubOrderCode(orderCode, cmd.getGoodsList().size());
for (OrderCreateCmd.GoodsList goods : cmd.getGoodsList()) {
SpuApiCO spu = skuMap.get(goods.getSkuId());
MallOrderE mallOrderEItem = BeanToolkit.instance().copy(cmd, MallOrderE.class);
mallOrderEItem.setId(numberingGateway.getNextId());
mallOrderEItem.setCode(subOrderCode.poll());
mallOrderEItem.setMainOrderId(mallOrderE.getId());
mallOrderEItem.setMainOrderCode(mallOrderE.getCode());
mallOrderEItem.setStatus(OrderStatusEnum.DAI_ZHI_FU.getValue());
CalcPayPriceDTO calcPayPriceDTO = goodsService.calcPayPrice(spu.getSku(), goods.getCount(), memberLevel, cmd.getReceiverRegion());
mallOrderEItem.setPrice(calcPayPriceDTO.getPayPrice()); // 子订单价格
mallOrderEItem.setIntegral(calcPayPriceDTO.getGoodsTotalIntegral()); // 子订单积分
mallOrderEItem.setFreight(calcPayPriceDTO.getFreight()); // 子订单运费
mallOrderEItem.setSpuId(Long.valueOf(goods.getSpuId()));
mallOrderEItem.setSkuId(Long.valueOf(goods.getSkuId()));
mallOrderEItem.setQuantity(goods.getCount());
mallOrderEItem.setGoodsName(spu.getGoodsName());
mallOrderEItem.setGoodsSupplierId(spu.getSupplierId());
mallOrderEItem.setGoodsType(spu.getGoodsType());
mallOrderEItem.setCreatorId(HttpContext.getCustomerId());
mallOrderEItem.setCreator(HttpContext.getCustomerName());
mallOrderEItem.setCreateDt(LocalDateTime.now());
mallOrderEItem.setLastUpdatorId(HttpContext.getCustomerId());
mallOrderEItem.setLastUpdator(HttpContext.getCustomerName());
mallOrderEItem.setLastUpdateDt(LocalDateTime.now());
result.add(mallOrderEItem);
totalPrice += calcPayPriceDTO.getPayPrice();
totalFreight += calcPayPriceDTO.getFreight();
totalIntegral += calcPayPriceDTO.getGoodsTotalIntegral();
}
mallOrderE.setPrice(totalPrice); // 订单总价
mallOrderE.setIntegral(totalIntegral); // 订单总积分
mallOrderE.setFreight(totalFreight); // 订单总运费
mallOrderE.setCreatorId(HttpContext.getCustomerId());
mallOrderE.setCreator(HttpContext.getCustomerName());
mallOrderE.setCreateDt(LocalDateTime.now());
mallOrderE.setLastUpdatorId(HttpContext.getCustomerId());
mallOrderE.setLastUpdator(HttpContext.getCustomerName());
mallOrderE.setLastUpdateDt(LocalDateTime.now());
return result;
}
/**
* 批量删除购物车数据
*
* @param goodsList 待删除的商品
*/
private void deleteGoodsCart(List<OrderCreateCmd.GoodsList> goodsList) {
for (OrderCreateCmd.GoodsList list : goodsList) {
DeleteGoodsCartCmd deleteGoodsCartCmd = new DeleteGoodsCartCmd();
deleteGoodsCartCmd.setSpuId(Long.valueOf(list.getSpuId()));
deleteGoodsCartCmd.setSkuId(Long.valueOf(list.getSkuId()));
memberCartGateway.deleteGoodsCart(HttpContext.getCustomerId(), deleteGoodsCartCmd);
}
}
}订单取消执行器
/**
* 订单取消执行器
*
* @author cgli
* @date 2022/12/30 09:19
*/
@Component
public class OrderCancelCmdExe {
@Resource
private OrderValidator orderValidator;
@Resource
private MallOrderGateway orderGateway;
@Resource
private RollbackIntegralExe rollbackIntegralExe;
@Resource
private GoodsService goodsService;
/**
* 取消订单
*/
@Transactional(rollbackFor = Exception.class)
public void cancel(OrderCancelCmd cmd) {
MallOrderE mallOrderE = MallOrderE.queryInstance().getById(cmd.getOrderId());
orderValidator.cancelOrderValidate(mallOrderE);
List<MallOrderE> orderUpdateList = new ArrayList<>();
List<UpdateInventoryDTO> inventoryUpdateList = new ArrayList<>();
//主订单状态置为"已取消"
MallOrderE mainOrderEForUpdate = new MallOrderE();
mainOrderEForUpdate.setId(mallOrderE.getId());
mainOrderEForUpdate.setStatus(OrderStatusEnum.YI_QU_XIAO.getValue());
orderUpdateList.add(mainOrderEForUpdate);
List<OrderDTO> orderDTOS = orderGateway.listByMainOrderId(cmd.getOrderId());
for (OrderDTO orderDTO : orderDTOS) {
//子订单状态置为"已取消"
MallOrderE subOrderEForUpdate = new MallOrderE();
subOrderEForUpdate.setId(orderDTO.getId());
subOrderEForUpdate.setStatus(OrderStatusEnum.YI_QU_XIAO.getValue());
orderUpdateList.add(subOrderEForUpdate);
//回滚库存
UpdateInventoryDTO updateInventoryDTO = new UpdateInventoryDTO(orderDTO.getSkuId().toString(), orderDTO.getQuantity());
inventoryUpdateList.add(updateInventoryDTO);
}
orderGateway.updateBatchById(orderUpdateList);
// 判断是否已经进行了积分支付，需要将积分回滚
rollbackIntegralExe.execute(mallOrderE, "订单取消积分返还");
// 库存回滚
goodsService.updateInventory(inventoryUpdateList);
}
}订单删除执行器
/**
* 订单删除执行器
*
* @author cgli
* @date 2022/12/30 09:30
*/
@Component
public class OrderDeleteCmdExe {
@Resource
private OrderValidator orderValidator;
/**
* 删除订单
*/
@Transactional(rollbackFor = Exception.class)
public void deleteOrder(OrderDeleteCmd cmd) {
MallOrderE mallOrderE = MallOrderE.queryInstance().getById(cmd.getOrderId());
orderValidator.deleteValidate(mallOrderE);
MallOrderE.queryInstance().customerDeleteByMainOrderId(mallOrderE.getId());
}
}订单查询服务
@Slf4j
@Service
public class OrderService extends BaseService {
@Autowired
private MallOrderGateway orderGateway;
@Autowired
private MallDeliveryGateway deliveryGateway;
@Autowired
private GoodsService goodsService;
@Autowired
private MallOrderBillGateway mallOrderBillGateway;
@Autowired
private MallInvoiceRecordGateway invoiceRecordGateway;
/**
* 订单列表(分页)
*/
public CustomizePage<OrderDTO> page(OrderQryDTO dto) {
dto.setQuerySubOrder(true);
CustomizePage<OrderDTO> page = orderGateway.page(dto);
Map<String, SupplierDTO> supplierMap = goodsService.mapSupplierCO();
//查询订单物流信息
List<Long> deliveryIds = page.getRecords().stream().map(OrderDTO::getDeliveryId).filter(Objects::nonNull).distinct().collect(Collectors.toList());
Map<Long, MallDeliveryE> deliveryEMap = deliveryGateway.mapById(deliveryIds);
for (OrderDTO orderDTO : page.getRecords()) {
//整合供应商名称
SupplierDTO supplierDTO = supplierMap.get(orderDTO.getGoodsSupplierId());
if (supplierDTO != null) {
orderDTO.setGoodsSupplierName(supplierDTO.getSupplierName());
}
//转译订单状态
orderDTO.setStatusDesc(OrderStatusEnum.value2Desc(TerminalEnum.ADMIN, orderDTO.getStatus()));
// 物流信息
MallDeliveryE mallDeliveryE = deliveryEMap.get(orderDTO.getDeliveryId());
orderDTO.setDeliveryInfo(mallDeliveryE);
// 商品信息
GoodsCO goodsCO = new GoodsCO();
goodsCO.setGoodsName(orderDTO.getGoodsName());
orderDTO.setGoods(goodsCO);
}
return page;
}
/**
* 消费者端分页查询订单信息
*
* @param dto 查询条件
* @return 查询结果
*/
public CustomizePage<OrderDTO> customerPage(OrderQryDTO dto) {
dto.setQueryMainOrder(true);
CustomizePage<OrderDTO> mainOrderPage = orderGateway.page(dto);
if (CollUtil.isEmpty(mainOrderPage.getRecords())) {
return new CustomizePage<>(mainOrderPage.getCurrent(), mainOrderPage.getSize(), mainOrderPage.getTotal());
}
List<Long> mainOrderIds = mainOrderPage.getRecords().stream().map(OrderDTO::getId).collect(Collectors.toList());
//查询子订单信息
OrderQryDTO subOrderQry = new OrderQryDTO();
subOrderQry.setMainOrderIds(mainOrderIds);
List<OrderDTO> subOrderList = orderGateway.list(subOrderQry);
//查询商品信息
List<String> skuIds = subOrderList.stream().map(OrderDTO::getSkuId).map(String::valueOf).collect(Collectors.toList());
Map<String, SpuApiCO> spuMap = goodsService.mapSkuCO(skuIds);
//查询派送信息
List<Long> deliveryIds = subOrderList.stream().map(OrderDTO::getDeliveryId).filter(Objects::nonNull).distinct().collect(Collectors.toList());
Map<Long, MallDeliveryE> deliveryMap = deliveryGateway.mapById(deliveryIds);
//查询支付信息
Map<Long, MallOrderBillE> billMap = mallOrderBillGateway.getBill(mainOrderIds, BillingTypeEnum.PAY, OrderPayWayEnum.INTEGRAL_PAY);
//整合发票信息
Map<Long, MallInvoiceRecordE> orderInvoiceMap = invoiceRecordGateway.getOrderInvoice(mainOrderIds);
//整合子母单、商品信息和物流信息
return OrderConverter.converter2OrderDTO(mainOrderPage, subOrderList, spuMap, deliveryMap, billMap, orderInvoiceMap);
}
/**
* B端订单状态统计
*/
public OrderStateStatisticsCO orderStateStatistics(OrderPageQryCmd cmd) {
return orderGateway.orderStateStatistics(cmd);
}
/**
* C端订单状态统计
*/
public OrderStateStatisticsCustomerCO customerOrderStateStatistics() {
return orderGateway.customerOrderStateStatistics(HttpContext.getCustomerId());
}
/**
* 获取订单详情
*
* @param orderId 订单ID
* @param terminal 终端类型
* @return 订单详情
*/
public OrderDTO detail(Long orderId, TerminalEnum terminal) {
OrderDTO result = null;
// 1、获取订单信息
MallOrderE mallOrderE = MallOrderE.queryInstance().getById(orderId);
if (mallOrderE.isMainOrder()) {
// 2、查看主订单维度的详情
// 2.1、查询子订单信息
List<OrderDTO> orderDTOS = orderGateway.listByMainOrderId(orderId);
// 2.2、查询商品信息
List<String> skuIds = orderDTOS.stream().map(OrderDTO::getSkuId).map(String::valueOf).collect(Collectors.toList());
Map<String, SpuApiCO> spuMap = goodsService.mapSkuCO(skuIds);
result = OrderConverter.converter2OrderDTO(mallOrderE, orderDTOS, spuMap, terminal);
} else {
// 3、查看子单维度的详情
// 3.1、查询母单订单信息
MallOrderE mainOrderInfo = MallOrderE.queryInstance().getById(mallOrderE.getMainOrderId());
// 3.2、查询商品信息
Map<String, SpuApiCO> spuMap = goodsService.mapSkuCO(Collections.singletonList(String.valueOf(mallOrderE.getSkuId())));
// 4、整合订单详情
OrderDTO subOrderDTO = BeanToolkit.instance().copy(mallOrderE, OrderDTO.class);
result = OrderConverter.converter2OrderDTO(mainOrderInfo, Collections.singletonList(subOrderDTO), spuMap, terminal);
}
return result;
}
/**
* 商品销量统计
*/
public List<GoodsSalesCO> goodsSalesStatistics(GoodsSalesStatisticsQryCmd cmd) {
return orderGateway.goodsSalesStatistics(cmd.getSkuIds(), cmd.getCreateDtBegin(), cmd.getCreateDtEnd(), cmd.getLimit());
}
/**
* 退款订单列表
*
* @param qry 查询条件
* @return 查询结果
*/
public CustomizePage<OrderDTO> refundOrderPage(RefundApplyQry qry) {
OrderQryDTO qryDTO = BeanToolkit.instance().copy(qry, OrderQryDTO.class);
qryDTO.setPageNo(qry.getPageNo());
qryDTO.setPageSize(qry.getPageSize());
qryDTO.setStatusList(Arrays.asList(OrderStatusEnum.TUI_HUO_SHEN_QING.getValue(), OrderStatusEnum.TUI_HUO_WAN_CHENG.getValue()));
qryDTO.setQuerySubOrder(true);
qryDTO.setCreatorId(HttpContext.getCustomerId());
CustomizePage<OrderDTO> page = orderGateway.page(qryDTO);
//查询商品信息
List<String> skuIds = page.getRecords().stream().map(OrderDTO::getSkuId).map(String::valueOf).collect(Collectors.toList());
Map<String, SpuApiCO> spuMap = goodsService.mapSkuCO(skuIds);
return OrderConverter.converter2OrderDTO(page, spuMap);
}
/**
* 获取导出数据
*
* @param cmd 查询条件
* @return 查询结果
*/
public List<OrderExcelDTO> export(OrderPageQryCmd cmd) {
int exportCount = 0; //已经处理的数据
OrderQryDTO orderQryDTO = OrderQryDTO.of(cmd);
orderQryDTO.setPageNo(1);
orderQryDTO.setPageSize(200); //分批整合数据
CustomizePage<OrderDTO> orderPage = page(orderQryDTO);
if (CollUtil.isEmpty(orderPage.getRecords())) {
throw new DataNotFoundException();
}
List<OrderExcelDTO> result = new ArrayList<>();
while (CollUtil.isNotEmpty(orderPage.getRecords()) && BizConstant.MAX_EXPORT_SIZE > exportCount) {
List<OrderExcelDTO> orderExcelDTOList = OrderConverter.converter2OrderExcelDTO(orderPage.getRecords());
result.addAll(orderExcelDTOList);
//处理下一页的数据
exportCount += orderQryDTO.getPageSize();
orderQryDTO.setPageNo(orderQryDTO.getPageNo() + 1);
orderPage = page(orderQryDTO);
}
return result;
}
/**
* 获取订单退货申请记录
*
* @param orderId 订单ID
* @return 查询结果
*/
public RefundApplyInfoCO getRefundApplyInfoCO(Long orderId) {
MallRefundApplyE refundApplyE = MallRefundApplyE.queryInstance().getByOrderId(orderId);
if (refundApplyE == null) {
throw new DataNotFoundException();
}
RefundApplyInfoCO result = BeanToolkit.instance().copy(refundApplyE, RefundApplyInfoCO.class);
result.setRefundTypeDesc(OrderRefundTypeEnum.value2Desc(result.getRefundType()));
return result;
}
/**
* 获取订单列表
*
* @param cmd 查询条件
* @return 查询结果
*/
public List<OrderDTO> queryOrderList(OrderQryCmd cmd) {
OrderQryDTO subOrderQry = BeanToolkit.instance().copy(cmd, OrderQryDTO.class);
subOrderQry.setQuerySubOrder(true);
return orderGateway.list(subOrderQry);
}
/**
* 获取SKU产生的最新订单
*
* @param skuIds skuId集合
* @return 订单信息
*/
public List<OrderCO> skuLatestSale(List<Long> skuIds) {
return orderGateway.skuLatestSale(skuIds);
}
/**
* 获取订单开票信息
*/
public OrderInvoiceInfoCO getOrderInvoiceInfo(Long orderId) {
MallOrderE mainOrderE = MallOrderE.queryInstance().getById(orderId);
if (Objects.isNull(mainOrderE)) {
throw new ServiceException("订单不存在");
}
if (!OrderStatusEnum.YI_WAN_CHENG.getValue().equals(mainOrderE.getStatus())) {
throw new ServiceException("未完成的订单无法申请开发票");
}
if (!mainOrderE.moneyPaid()) {
throw new ServiceException("该订单未进行现金支付，无法开具发票");
}
OrderInvoiceInfoCO result = new OrderInvoiceInfoCO();
result.setOrderId(mainOrderE.getId().toString());
result.setOrderCode(mainOrderE.getCode());
//开票金额，该母单的实际支付金额，部分退款则取最终收款金额
long totalRefund = orderGateway.listByMainOrderId(orderId)
.stream()
.filter(orderDTO -> OrderStatusEnum.TUI_HUO_WAN_CHENG.getValue().equals(orderDTO.getStatus()))
.mapToLong(OrderDTO::getPayPrice)
.sum();
long invoicePrice = mainOrderE.getPayPrice() - totalRefund;
result.setInvoicePrice(BigDecimalUtils.penny2yuan(invoicePrice));
return result;
}
}
/**
* 订单领域层服务接口
*
*/
public interface MallOrderGateway {
/**
* 分页查询
*/
CustomizePage<OrderDTO> page(OrderQryDTO dto);
/**
* 订单列表
*/
List<OrderDTO> list(OrderQryDTO dto);
/**
* 根据主订单ID获取自订单集合
*/
List<OrderDTO> listByMainOrderId(Long orderId);
List<OrderDTO> listByMainOrderIdList(List<Long> orderIdList);
/**
* 统计消费者购买的商品数量
*
* @param customerId 消费者ID
* @param skuId skuId
* @return 统计结果
*/
Integer countBySkuId(String customerId, Long skuId);
/**
* 根据ID查询订单信息
*
* @param id 订单ID
* @return 查询结果
*/
MallOrderE getById(Long id);
/**
* 根据子单查询母单数据
*
* @param id 子单ID
* @return 母单数据
*/
MallOrderE getMainOrderBySubId(Long id);
MallOrderE getByCode(String code);
/**
* 根据ID批量查询订单信息
*
* @param ids 订单ID集合
* @return 查询结果
*/
List<MallOrderE> listById(List<Long> ids);
/**
* 批量保存订单信息
*
* @param mallOrderES 待保存内容
* @return 保存结果
*/
Boolean saveBatch(List<MallOrderE> mallOrderES);
/**
* 根据主键更新订单信息
*
* @param mallOrderE 更新内容
* @return 更新结果
*/
Boolean updateById(MallOrderE mallOrderE);
Boolean updateBatchById(List<MallOrderE> orderEList);
/**
* B端订单状态统计
*/
OrderStateStatisticsCO orderStateStatistics(OrderPageQryCmd cmd);
/**
* 消费者订单状态统计
*/
OrderStateStatisticsCustomerCO customerOrderStateStatistics(String customerId);
/**
* 商品销量统计
*
* @param skuIds 商品SKUID
* @return 统计结果
*/
List<GoodsSalesCO> goodsSalesStatistics(List<Long> skuIds, LocalDateTime createDtBegin, LocalDateTime createDtEnd, Integer limit);
/**
* 删除主订单
*
* @param mainOrderId 主订单ID
* @return 删除结果
*/
Boolean customerDeleteByMainOrderId(Long mainOrderId);
/**
* 获取SKU产生的最新订单
*
* @param skuIds skuId集合
* @return 订单信息
*/
List<OrderCO> skuLatestSale(List<Long> skuIds);
/**
* 根据订单ID集合批量删除订单
*
* @param ids 订单ID集合
* @return 删除结果
*/
Boolean deleteBatchById(Collection<Long> ids);
}
3. 产品商品系统
由于写在一起篇幅太长，拉上拉下的设置一格式实在不好编辑；另外各位看官看文章太长也心思看完，看久也累！故每个子系统分开写！
请看下一篇》》》》产商品系统架构设计
