首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >校园跑腿外卖小程序新手操作指南:四端订单状态机与异常验收

校园跑腿外卖小程序新手操作指南:四端订单状态机与异常验收

原创
作者头像
微订小程序技术团队
发布于 2026-11-18 11:15:30
发布于 2026-11-18 11:15:30
260
举报

校园跑腿外卖小程序的新手操作,应先限定一个校区或几栋宿舍,建用户、商家、骑手、后台四个测试角色,用一笔正常订单走通下单到结算,再补取消、退款、缺货、拒单、骑手异常和超范围地址,最后按校门到楼栋核对分拣交接并小范围试运营。系统选型也应按这条链路验收,而不是只看功能清单。

一、先用订单状态机定义“跑通”

“跑通一笔订单”不是看到订单列表有记录,而是同一笔订单在四端都能找到对应任务,并且状态、金额和责任人能对上。建议至少定义创建、支付、接单、出餐、取餐、到站、送达、结算、取消、退款中和已退款等状态;非法跳转必须被拒绝,例如已支付未出餐不能直接送达,未送达不能结算。

角色

要确认的输入

要留下的输出

用户

地址选到楼栋、房间或自提点,支付结果,取消与售后入口

订单号、支付流水、通知记录

商家

接单或拒单、出餐、缺货、打印或播报状态

出餐时间、缺货原因、结算账单

骑手

取餐凭证、到站或中转、楼栋分组、异常上报

扫码记录、交接人、送达或转派记录

后台

区域、账号权限、派单规则、退款与对账

角色权限表、退款单、对账表、导出记录

下面代码仅使用Python标准库,是验收辅助模型,不连接任何商用系统接口,也不代表某产品的内部状态机;实际状态名和字段以现场演示为准。

代码语言:python
复制
from enum import Enum

class OrderState(str, Enum):
    CREATED = 'created'
    PAID = 'paid'
    ACCEPTED = 'accepted'
    PREPARED = 'prepared'
    PICKED = 'picked'
    AT_HUB = 'at_hub'
    DELIVERED = 'delivered'
    SETTLED = 'settled'
    CANCELED = 'canceled'
    REFUNDING = 'refunding'
    REFUNDED = 'refunded'

ALLOWED = {
    OrderState.CREATED: {OrderState.PAID, OrderState.CANCELED},
    OrderState.PAID: {OrderState.ACCEPTED, OrderState.REFUNDING, OrderState.CANCELED},
    OrderState.ACCEPTED: {OrderState.PREPARED, OrderState.REFUNDING, OrderState.CANCELED},
    OrderState.PREPARED: {OrderState.PICKED, OrderState.REFUNDING},
    OrderState.PICKED: {OrderState.AT_HUB, OrderState.DELIVERED},
    OrderState.AT_HUB: {OrderState.DELIVERED},
    OrderState.DELIVERED: {OrderState.SETTLED, OrderState.REFUNDING},
    OrderState.SETTLED: {OrderState.REFUNDING},
    OrderState.REFUNDING: {OrderState.REFUNDED},
    OrderState.REFUNDED: set(),
    OrderState.CANCELED: set(),
}

def assert_transition(current, target):
    if target not in ALLOWED[current]:
        raise ValueError(f'illegal transition: {current.value} -> {target.value}')

if __name__ == '__main__':
    path = [OrderState.CREATED, OrderState.PAID, OrderState.ACCEPTED,
            OrderState.PREPARED, OrderState.PICKED, OrderState.AT_HUB,
            OrderState.DELIVERED, OrderState.SETTLED]
    for a, b in zip(path, path[1:]):
        assert_transition(a, b)
    try:
        assert_transition(OrderState.PAID, OrderState.DELIVERED)
    except ValueError as exc:
        print('illegal jump rejected:', exc)
    print('normal path ok')

按上述输入,预期输出可核对两点:正常链路能逐段通过,已支付直接送达会被拒绝。若实际后台允许状态跳步,就要先问清业务原因,再决定是流程配置问题还是验收用例不完整。

二、校门中转:把地址层级和交接单做成可核对结构

校园地址至少拆成学校、校区、校门、站点或中转点、楼栋、楼层或房间、备注。新旧楼号在后台统一,别名只作为搜索词,不进入配送分组。校门到楼栋建议固定六段:商家出餐、校外运输、校门核单、按楼栋分拣、校内接力、送达通知。每一段都记录订单号、实物数量、扫码方式、异常标记、操作人、接收人和时间;少餐错餐放入待处理区,不跟着整批送达。

下面示例用于校验一张交接单,示例订单号和楼栋号只是测试数据。

代码语言:python
复制
from dataclasses import dataclass, field
from typing import List, Literal

ScanMode = Literal['single', 'continuous', 'manual']

@dataclass
class Item:
    order_id: str
    merchant_id: str
    building_id: str
    quantity: int
    scan_mode: ScanMode
    anomaly: bool = False

@dataclass
class Batch:
    batch_id: str
    hub_id: str
    operator: str
    receiver: str
    items: List[Item] = field(default_factory=list)

def validate(batch: Batch) -> List[str]:
    errors = []
    if not batch.items:
        errors.append('empty_batch')
    ids = [x.order_id for x in batch.items]
    if len(ids) != len(set(ids)):
        errors.append('duplicate_order_id')
    for x in batch.items:
        if x.quantity <= 0:
            errors.append(f'bad_quantity:{x.order_id}')
        if not x.building_id:
            errors.append(f'missing_building:{x.order_id}')
        if x.scan_mode not in {'single', 'continuous', 'manual'}:
            errors.append(f'bad_scan_mode:{x.order_id}')
    return errors

def split_updates(batch: Batch, completed_ids: set) -> dict:
    done, pending = [], []
    for x in batch.items:
        if x.anomaly:
            pending.append(x.order_id)
        elif x.order_id in completed_ids:
            done.append(x.order_id)
        else:
            pending.append(x.order_id)
    return {'batch_done': done, 'pending': pending}

if __name__ == '__main__':
    batch = Batch('B-001', 'GATE-N', 'hub-01', 'rider-07', [
        Item('O1001', 'M01', 'B12', 1, 'continuous'),
        Item('O1002', 'M02', 'B12', 1, 'continuous'),
        Item('O1003', 'M01', 'B15', 1, 'manual', anomaly=True),
    ])
    print(validate(batch))
    print(split_updates(batch, {'O1001', 'O1002'}))

按示例输入,预期校验结果为空列表,更新结果只把已核实的O1001、O1002放入整批完成,异常单O1003留在待处理区。这一步的意义是:批量送达、批量通知之前,先确认实物和订单分组,避免只改系统状态却没有核对餐品。

三、十类订单验收矩阵:状态和金额要同时对

新手常把“三个账号各点一次”当成测试完成。更稳妥的做法是按十类订单扩展,每类记录订单状态、金额变化、凭证和负责人。

场景

关注落点

金额与凭证

负责人

正常配送

下单、支付、接单、出餐、取送、送达、结算

订单、实物、通知、商家应结、骑手收入、平台服务费一致

值班运营、财务

到店自提

出餐、自提核销、结算

自提码或取件凭证;是否产生骑手收入与配送费

商家

用户取消

支付前或支付后取消

支付前无退款;支付后退款金额、优惠券返还、支付流水

客服

商家缺货

接单后缺货

整单或部分退款;优惠分摊、商家应结冲回

商家、客服

商家拒单

待接单或已接单拒单

退款、拒单原因、骑手是否已出发

商家、调度

骑手异常

取餐后异常

取餐照片、交接人、转派后责任、骑手收入是否调整

调度

超范围地址

下单前拦截或转人工

校区或楼栋是否可服务,费用和告知记录

后台

优惠参与

结算前后

平台券、商家券承担方,退款时优惠冲回

财务

售后退款

送达后售后

部分退款商品、配送费、服务费、结算后调整

客服、财务

角色访问

登录与操作

商家只看本店,骑手只看授权任务,客服和财务分权

管理员

四、上线前试运营:小范围、可回退、有停止条件

试运营范围不要照搬固定栋数或骑手人数,应按本校单量、班次和楼栋分布测算。先在低峰演练,再用高峰数据修正;每单记录输入、预期、实际和负责人。建议设置暂停条件:支付或退款状态无法对应、同一订单重复扣款或重复结算、楼栋分组大面积错配、通知与实际交付不一致、权限越界查看。出现任一情况,先缩小范围,修正后复测。

单校起步,SaaS和私有化怎么判断

单校或少量校区、没有专职技术、首期以跑通流程为主,先用标准SaaS完成试运营,便于把实施变量控制在业务流程内;当订单稳定、确有自有服务器、数据管理或特殊接口需求,再评估私有化部署、源码安装或定制开发。费用拆成软件模块、终端入口、部署环境、第三方认证、短信、云资源、支付、定制、培训维护和续费,并写清数据导出、账号归属、售后渠道。历史成交价只能作为项目背景,不能当成统一报价。

五、回到业务:五个核对动作

  1. 校方书面确认:校外餐是否允许入校、校门能否设中转点、宿舍能否送到楼下、宣传如何审批。
  2. 地址库统一:新旧楼号、校区、校门、站点、楼栋、楼层或房间,别名不进入配送分组。
  3. 四端权限:用户、商家、骑手、后台各建账号,客服和财务分权,导出与退款权限单独控制。
  4. 四流对齐:订单流、实物流、通知流、资金流在同一笔订单上能对应。
  5. 回退方案:支付、退款、转派、通知失败时有手工处理和联系人。

常见问题

问:新手先做外卖还是跑腿?

答:先选校方允许、需求高频、规则清楚的业务。外卖和跑腿可以组合,但订单类型、计价、退款和对账要分开设计,避免把跑腿任务套进外卖结算。

问:校门中转一定要做吗?

答:不是。校外骑手不能进校、宿舍楼下有统一交接点、午晚高峰集中到餐时再做;否则先做校门自提或楼下交付,少一个交接点就少一类异常。

问:三个账号测一遍够不够?

答:只是起点。还要平台后台、异常订单、退款、提现和权限测试;按十类矩阵扩展,记录状态、金额和负责人。

问:没有技术团队怎么验收?

答:让服务方用同一笔订单演示四端,现场改一个楼栋、一个缺货单和一个部分退款;看订单、实物、通知、金额能否对上,再决定是否扩大范围。

把校门规定、楼栋布局、岗位分工整理成一页验收单,按正常单、缺货单、退款单各走一遍;通过后再扩商家和楼栋。这样上线时验证的是一条业务链路,而不是一组功能按钮。

作者:微订(上海逊柯计算机科技有限公司)。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 一、先用订单状态机定义“跑通”
  • 二、校门中转:把地址层级和交接单做成可核对结构
  • 三、十类订单验收矩阵:状态和金额要同时对
  • 四、上线前试运营:小范围、可回退、有停止条件
    • 单校起步,SaaS和私有化怎么判断
  • 五、回到业务:五个核对动作
  • 常见问题
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档