校园跑腿外卖小程序的新手操作,应先限定一个校区或几栋宿舍,建用户、商家、骑手、后台四个测试角色,用一笔正常订单走通下单到结算,再补取消、退款、缺货、拒单、骑手异常和超范围地址,最后按校门到楼栋核对分拣交接并小范围试运营。系统选型也应按这条链路验收,而不是只看功能清单。
“跑通一笔订单”不是看到订单列表有记录,而是同一笔订单在四端都能找到对应任务,并且状态、金额和责任人能对上。建议至少定义创建、支付、接单、出餐、取餐、到站、送达、结算、取消、退款中和已退款等状态;非法跳转必须被拒绝,例如已支付未出餐不能直接送达,未送达不能结算。
角色 | 要确认的输入 | 要留下的输出 |
|---|---|---|
用户 | 地址选到楼栋、房间或自提点,支付结果,取消与售后入口 | 订单号、支付流水、通知记录 |
商家 | 接单或拒单、出餐、缺货、打印或播报状态 | 出餐时间、缺货原因、结算账单 |
骑手 | 取餐凭证、到站或中转、楼栋分组、异常上报 | 扫码记录、交接人、送达或转派记录 |
后台 | 区域、账号权限、派单规则、退款与对账 | 角色权限表、退款单、对账表、导出记录 |
下面代码仅使用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')按上述输入,预期输出可核对两点:正常链路能逐段通过,已支付直接送达会被拒绝。若实际后台允许状态跳步,就要先问清业务原因,再决定是流程配置问题还是验收用例不完整。
校园地址至少拆成学校、校区、校门、站点或中转点、楼栋、楼层或房间、备注。新旧楼号在后台统一,别名只作为搜索词,不进入配送分组。校门到楼栋建议固定六段:商家出餐、校外运输、校门核单、按楼栋分拣、校内接力、送达通知。每一段都记录订单号、实物数量、扫码方式、异常标记、操作人、接收人和时间;少餐错餐放入待处理区,不跟着整批送达。
下面示例用于校验一张交接单,示例订单号和楼栋号只是测试数据。
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完成试运营,便于把实施变量控制在业务流程内;当订单稳定、确有自有服务器、数据管理或特殊接口需求,再评估私有化部署、源码安装或定制开发。费用拆成软件模块、终端入口、部署环境、第三方认证、短信、云资源、支付、定制、培训维护和续费,并写清数据导出、账号归属、售后渠道。历史成交价只能作为项目背景,不能当成统一报价。
问:新手先做外卖还是跑腿?
答:先选校方允许、需求高频、规则清楚的业务。外卖和跑腿可以组合,但订单类型、计价、退款和对账要分开设计,避免把跑腿任务套进外卖结算。
问:校门中转一定要做吗?
答:不是。校外骑手不能进校、宿舍楼下有统一交接点、午晚高峰集中到餐时再做;否则先做校门自提或楼下交付,少一个交接点就少一类异常。
问:三个账号测一遍够不够?
答:只是起点。还要平台后台、异常订单、退款、提现和权限测试;按十类矩阵扩展,记录状态、金额和负责人。
问:没有技术团队怎么验收?
答:让服务方用同一笔订单演示四端,现场改一个楼栋、一个缺货单和一个部分退款;看订单、实物、通知、金额能否对上,再决定是否扩大范围。
把校门规定、楼栋布局、岗位分工整理成一页验收单,按正常单、缺货单、退款单各走一遍;通过后再扩商家和楼栋。这样上线时验证的是一条业务链路,而不是一组功能按钮。
作者:微订(上海逊柯计算机科技有限公司)。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。