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

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

一、整体系统架构设计

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

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

java 复制代码

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

这种架构的好处在于：

业务解耦清晰，方便后期扩展外卖、同城配送、即时服务等能力。

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

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

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

订单创建接口示例

java 复制代码

@PostMapping("/order/create")
public Result create(@RequestBody RunOrderDTO dto) {
    RunOrder order = new RunOrder();
    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);
    return Result.success(order.getId());
}

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

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

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

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

java 复制代码

public BigDecimal calculatePrice(double distanceKm) {
    BigDecimal basePrice = new BigDecimal("5.00");
    BigDecimal perKmPrice = new BigDecimal("2.00");
    return basePrice.add(
        perKmPrice.multiply(BigDecimal.valueOf(distanceKm))
    );
}

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

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

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

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

订单推送（示意）

java 复制代码

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

骑手接单并发控制

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

java 复制代码

@Transactional
public boolean acceptOrder(Long orderId, Long riderId) {
    RunOrder order = runOrderMapper.selectForUpdate(orderId);
    if (!OrderStatus.WAITING.equals(order.getStatus())) {
        return false;
    }
    order.setStatus(OrderStatus.ACCEPTED);
    order.setRiderId(riderId);
    order.setAcceptTime(LocalDateTime.now());
    runOrderMapper.update(order);
    return true;
}

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

五、配送流程与状态流转

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

已接单

已取件

配送中

已完成

java 复制代码

public void updateStatus(Long orderId, OrderStatus status) {
    RunOrder order = runOrderMapper.selectById(orderId);
    order.setStatus(status);
    order.setUpdateTime(LocalDateTime.now());
    runOrderMapper.update(order);
}

每一次状态变更，都会同步通知用户端，保证信息实时可见。

六、为什么整体架构比功能更重要

很多人看跑腿系统，只关注"有没有下单、有没有接单"，但真正决定系统能否长期运行的，是整体架构是否合理：

能否支持多城市扩展

能否承载并发接单

能否灵活调整业务规则

能否快速接入新场景

而这些，正是开源跑腿系统源码的价值所在。

七、结语

从下单到配送，跑腿系统并不只是几个接口的组合，而是一套完整的业务闭环。通过理解开源跑腿系统源码的整体架构和关键流程，才能真正把系统"跑起来"，并在此基础上持续扩展更多同城服务能力。