开源跑腿系统源码整体架构解析：从下单到配送的完整流程

跑腿业务看似简单，但真正落到系统层面，会涉及下单、计价、调度、接单、配送、结算等一整套闭环逻辑。本文结合一套典型的开源跑腿系统源码，从整体架构入手，完整拆解“从用户下单到骑手配送完成”的核心流程，并通过代码示例说明关键实现方式。

一、整体系统架构设计

在源码层面，成熟的跑腿系统通常采用前后端分离 + 模块化设计，整体架构可以拆分为以下几层：

接入层：用户端、骑手端、管理后台
业务层：订单服务、骑手服务、计价服务、调度服务
基础服务层：支付、消息推送、地图与距离计算
数据层：MySQL、Redis、消息队列

客户端（用户/骑手） ↓ API 网关 ↓ 业务服务层（订单/调度/计价） ↓ 数据存储&消息系统

这种架构的好处在于：
业务解耦清晰，方便后期扩展外卖、同城配送、即时服务等能力。

二、下单流程：订单是如何产生的

跑腿系统的第一步，是用户提交跑腿需求。通常包含以下信息：

取件地址 / 收件地址
跑腿类型（代买、代送、代办）
备注说明
预估费用

订单创建接口示例

@PostMapping("/order/create")publicResultcreate(@RequestBodyRunOrderDTOdto){RunOrderorder=newRunOrder();order.setUserId(dto.getUserId());order.setPickupAddress(dto.getPickupAddress());order.setDeliveryAddress(dto.getDeliveryAddress());order.setType(dto.getType());order.setRemark(dto.getRemark());order.setStatus(OrderStatus.WAITING);order.setCreateTime(LocalDateTime.now());runOrderService.save(order);returnResult.success(order.getId());}

在实际源码中，下单阶段还会叠加：

距离计算
价格规则匹配
下单频率限制

三、计价逻辑：费用是如何算出来的

跑腿计价通常由基础价 + 距离价 + 加价规则构成，源码中一般会独立成一个计价服务。

publicBigDecimalcalculatePrice(doubledistanceKm){BigDecimalbasePrice=newBigDecimal("5.00");BigDecimalperKmPrice=newBigDecimal("2.00");returnbasePrice.add(perKmPrice.multiply(BigDecimal.valueOf(distanceKm)));}

将计价逻辑独立出来，有两个好处：

不同城市可配置不同规则
后期支持夜间、雨天等动态加价

四、订单调度与骑手接单流程

当订单创建完成后，系统会进入待接单状态，并通过消息推送或 WebSocket 通知骑手。

订单推送（示意）

publicvoidpushOrderToRiders(RunOrderorder){List<Long>riderIds=riderService.findNearbyRiders(order.getPickupAddress());riderIds.forEach(riderId->{messageService.send(riderId,"新跑腿订单："+order.getId());});}

骑手接单并发控制

这是跑腿系统中非常关键的一步，需要避免多骑手同时抢单。

@TransactionalpublicbooleanacceptOrder(LongorderId,LongriderId){RunOrderorder=runOrderMapper.selectForUpdate(orderId);if(!OrderStatus.WAITING.equals(order.getStatus())){returnfalse;}order.setStatus(OrderStatus.ACCEPTED);order.setRiderId(riderId);order.setAcceptTime(LocalDateTime.now());runOrderMapper.update(order);returntrue;}

通过数据库锁或 Redis 分布式锁，确保订单只会被成功接一次。

五、配送流程与状态流转

订单被接单后，会进入配送阶段，常见状态包括：

已接单
已取件
配送中
已完成

publicvoidupdateStatus(LongorderId,OrderStatusstatus){RunOrderorder=runOrderMapper.selectById(orderId);order.setStatus(status);order.setUpdateTime(LocalDateTime.now());runOrderMapper.update(order);}