首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >校园订餐小程序新手流程:首单状态机与异常验收

校园订餐小程序新手流程:首单状态机与异常验收

原创
作者头像
微订小程序技术团队
发布于 2026-11-19 14:40:51
发布于 2026-11-19 14:40:51
100
举报

学生第一次用校园订餐小程序,通常按“进入登录—选校区—填楼栋或取餐点—选餐—选定自提或配送及时间—支付—查看订单状态和通知—凭取餐码或到指定点取餐”完成;遇到取消、漏餐或错餐,保留订单号、支付凭证和餐品照片,从订单售后入口处理。对准备运营校园平台的团队,首单链路可按地址校验、订单状态机、履约配置、通知记录和退款对账逐项验收。

一、首单七步:每一步都要留下可核对记录

首单流程可以拆成七步。学生看到的是页面和通知,运营方要留下的是账号、校区、地址、金额、状态与责任人;两边对得上,才算真正跑通。

步骤

学生动作

页面应留下

运营方记录

1

进入并登录

授权或手机号登录、账号

账号能否进入正确平台

2

选择校区

学校与校区、可选商家

校区与商家、服务范围是否匹配

3

填楼栋或取餐点

地址是否可选、是否超范围

楼栋、取餐点是否为启用状态

4

选餐

菜品、规格、数量、价格

商品状态与计价

5

选履约方式与时间

自提或配送、即时或预约、备注、费用

履约方式与时段规则

6

支付

订单号、实付金额、支付结果

支付记录与订单状态

7

看状态、通知并取餐

订单状态、取餐码或到点通知

通知渠道与交接记录

售后

取消或售后申请

退款或处理进度

原订单、责任人与结果

不同学校的字段名称和状态名称会不同,学生以页面提示为准;运营方验收时,把页面文字抄下来并不够,还要记录字段是否可选、状态是否可追溯、金额是否变化、处理人是谁。

二、校区、楼栋和取餐点属于路由数据

学生选错校区后看不到目标商家,通常不是搜索问题,而是订单被路由到了另一个校区。地址层级建议按“学校—校区—校门或中转点—楼栋—楼层或房间—备注”组织;自提点单独建表。校区ID、楼栋ID、取餐点ID、履约类型和服务时段应是结构化字段,备注只补充门牌和联系说明。

情形

示例判定

学生看到

运营方核对

校区与当前平台不一致

campus_mismatch

回到校区切换

校区与商家映射

配送楼栋未启用

building_out_of_service

换楼栋或联系客服

服务楼栋清单

自提未选取餐点

missing_pickup_point

选择具体取餐点

自提点配置

预约时间超出截单

time_window_closed

改即时单或下一时段

截单与营业时段

商品为空或金额异常

empty_items / bad_amount

返回选餐或重新结算

商品状态与计价规则

这些判定名称是验收模型中的示例,用于让开发、运营和客服使用同一套语言;实际页面文案以演示为准。关键点是下单前拦截并说明原因,而不是支付后再人工补地址。

三、用订单状态机约束首单与售后

“跑通一笔订单”不是订单列表里有记录,而是状态只能按业务顺序前进。已支付未出餐不能直接送达,未送达不能结算;退款要能从原订单追溯。下面给出一个验收用的状态集合和允许转换,状态名称可按实际业务调整,但非法跳转应被拒绝。

状态

含义

允许前往(示例)

CREATED

已创建未支付

PAID、CANCELED

PAID

已支付

ACCEPTED、REFUNDING、CANCELED

ACCEPTED

商家接单

PREPARED、REFUNDING

PREPARED

已出餐

PICKED、REFUNDING

PICKED

已取餐

AT_HUB、DELIVERED

AT_HUB

到中转点

DELIVERED

DELIVERED

已送达

SETTLED、REFUNDING

SETTLED

已结算

REFUNDING

REFUNDING

退款中

REFUNDED

状态机不是让页面多几个标签,而是把订单、通知、金额和责任人绑定在同一状态上。学生看到“配送中”时,后台应能定位骑手任务;学生申请售后时,后台应能回到原订单。若状态能随意跳步,后续对账和客服排查会失去依据。

四、最小可复现验收脚本:地址、幂等与非法状态

下面脚本只使用Python标准库,作为验收辅助模型,使用测试数据;支付与配送接口在目标环境单独联调。依赖:Python 3.9及以上。脚本覆盖三个首单高风险点:校区与楼栋校验、同一请求重复提交的幂等处理、非法状态跳转。

代码语言:python
复制
from dataclasses import dataclass
from enum import Enum
from typing import Dict, List, Optional, Set

class State(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 = {
    State.CREATED: {State.PAID, State.CANCELED},
    State.PAID: {State.ACCEPTED, State.REFUNDING, State.CANCELED},
    State.ACCEPTED: {State.PREPARED, State.REFUNDING},
    State.PREPARED: {State.PICKED, State.REFUNDING},
    State.PICKED: {State.AT_HUB, State.DELIVERED},
    State.AT_HUB: {State.DELIVERED},
    State.DELIVERED: {State.SETTLED, State.REFUNDING},
    State.SETTLED: {State.REFUNDING},
    State.REFUNDING: {State.REFUNDED},
}

def transit(current: State, target: State) -> State:
    if target not in ALLOWED.get(current, set()):
        raise ValueError(f'illegal transition: {current.value} -> {target.value}')
    return target

@dataclass(frozen=True)
class Building:
    campus_id: str
    building_id: str
    active: bool = True

@dataclass
class Checkout:
    campus_id: str
    building_id: Optional[str]
    fulfillment: str
    pickup_point_id: Optional[str]
    items: List[str]
    amount_cents: int

def validate_checkout(order: Checkout, campus_id: str, buildings: Dict[str, Building], pickup_points: Set[str]) -> List[str]:
    errors: List[str] = []
    if order.campus_id != campus_id:
        errors.append('campus_mismatch')
    if order.fulfillment not in {'pickup', 'delivery'}:
        errors.append('bad_fulfillment')
    if order.fulfillment == 'pickup' and not order.pickup_point_id:
        errors.append('missing_pickup_point')
    if order.fulfillment == 'pickup' and order.pickup_point_id not in pickup_points:
        errors.append('unknown_pickup_point')
    if order.fulfillment == 'delivery':
        building = buildings.get(order.building_id or '')
        if building is None or not building.active or building.campus_id != campus_id:
            errors.append('building_out_of_service')
    if not order.items:
        errors.append('empty_items')
    if order.amount_cents <= 0:
        errors.append('bad_amount')
    return errors

class OrderService:
    def __init__(self) -> None:
        self.orders: Dict[str, dict] = {}
    def create(self, idempotency_key: str, checkout: Checkout, errors: List[str]) -> dict:
        if errors:
            raise ValueError(errors)
        if idempotency_key in self.orders:
            return self.orders[idempotency_key]
        order = {'key': idempotency_key, 'state': State.CREATED, 'amount_cents': checkout.amount_cents}
        self.orders[idempotency_key] = order
        return order

if __name__ == '__main__':
    buildings = {'bldg-12': Building('campus-main', 'bldg-12')}
    ok = Checkout('campus-main', 'bldg-12', 'delivery', None, ['meal-1'], 1800)
    bad = Checkout('campus-north', 'bldg-99', 'delivery', None, [], 0)
    print(validate_checkout(ok, 'campus-main', buildings, {'pickup-01'}))
    print(validate_checkout(bad, 'campus-main', buildings, {'pickup-01'}))
    service = OrderService()
    first = service.create('student-001-20260901', ok, [])
    second = service.create('student-001-20260901', ok, [])
    print(first is second, first['state'].value)
    print(transit(State.CREATED, State.PAID).value)
    try:
        transit(State.PAID, State.DELIVERED)
    except ValueError as exc:
        print(str(exc))

按示例输入,预期输出包括:正常结算返回空错误列表;跨校区且楼栋失效、无商品、金额为零的订单返回对应错误;同一幂等键两次创建返回同一对象;已支付直接送达会抛出非法转换。上线前应在目标环境用真实校区、楼栋、取餐点和支付测试单复现这些用例,并保存所用版本、输入与输出记录。

五、异常输入:把首单失败拆成可处理动作

首单异常比正常单更能暴露系统边界。验收时不要只测“能不能下单”,要测学生能否看懂提示、运营方能否定位、客服能否闭环。下面五类最常见。

异常

学生动作

系统期望

运营方核对

选错校区

返回校区切换,核对学校与校区

商家列表随校区变化

校区与商家映射、服务范围

地址超出范围

核对楼栋或取餐点,联系客服

下单前提示超范围及原因

服务楼栋、配送范围、收费说明

自提与配送选错

未支付时回结算页改履约

费用、取餐点、送达时间随方式变化

自提点、配送费、截单规则

未收到通知

查看订单状态与通知记录,联系客服

状态与通知可追溯

通知渠道、模板、授权与重发

漏餐错餐

保留订单号、照片,走售后

售后关联原订单,进度可查

处理人、责任、补送或退款结果

这些动作不依赖某个界面名称,但依赖字段完整。比如通知记录如果只存在客服聊天里,后台无法复盘;售后如果脱离原订单,金额和责任人就会失焦。

六、回到经营与选型:用同一笔订单看四端是否对得上

准备搭建校园外卖系统或校园订餐平台的团队,选型时可以让服务方用一笔正常单和一笔退款单走完用户、商家、骑手、后台四个角色。判断依据不是功能按钮数量,而是同一订单的状态、金额、通知和处理人能否对上。

四端验收表

角色

正常单看什么

退款单看什么

学生

选校区、楼栋、履约方式、支付、状态、取餐凭证

售后入口、退款进度、原订单

商家

接单、出餐、缺货或拒单

退款冲回、账单变化

骑手

取餐、交接、送达

是否需转派或退回

后台

校区楼栋、权限、费用、通知记录

退款审核、对账与责任人

如果四端对不上,先不要扩大商家和楼栋范围。把本校真实校区、楼栋、自提点各建一笔测试单,再补超范围、取消、部分退款、漏餐错餐和角色越权;记录订单号、状态、金额变化、通知结果和处理人。能复现、能追溯、能交接,才说明首单链路具备运营基础。

首单验收清单

选型记录可以按“业务输入—页面输出—后台记录—异常处理—费用与部署”五列整理。费用构成、部署方式、通知渠道、退款规则和权限范围分别在演示中确认;涉及学校准入、支付开通和场地条件的,按主管部门、支付机构和校方流程推进。

常见问题

问:第一次进入先选校区还是先选餐?

答:先确认学校和校区,再看商家和餐品。多校区平台里,校区会影响商家列表、楼栋范围和履约方式。

问:自提和配送的取餐凭证一样吗?

答:通常不一样。自提常见取餐码或二维码,配送看通知中的交接地点和时间;具体凭证以页面提示为准。

问:预约单错过截单时间还能下单吗?

答:一般改为即时单或选择下一时段,截单规则由平台配置。下单前应看到可预约时段和截止提示。

问:运营者第一次演示看什么?

答:用正常单加退款单走四端,核对校区楼栋、履约方式、通知记录、退款状态、角色权限和账单变化,并保存演示版本与测试数据。

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

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

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

目录
  • 一、首单七步:每一步都要留下可核对记录
  • 二、校区、楼栋和取餐点属于路由数据
  • 三、用订单状态机约束首单与售后
  • 四、最小可复现验收脚本:地址、幂等与非法状态
  • 五、异常输入:把首单失败拆成可处理动作
  • 六、回到经营与选型:用同一笔订单看四端是否对得上
    • 四端验收表
    • 首单验收清单
  • 常见问题
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档