首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >校园外卖小程序双端要哪些功能?接单与取消竞争的状态契约

校园外卖小程序双端要哪些功能?接单与取消竞争的状态契约

原创
作者头像
微订技术团队
发布于 2026-10-25 10:46:18
发布于 2026-10-25 10:46:18
2110
举报

校园外卖小程序需要用户选餐下单支付、查单售后,以及商家商品营业、接单出餐和核账。双端评审中,接单与取消同时发生会造成备餐和退款责任冲突。下面用版本比较及持久化回执解释这一工程子题,其他双端功能仍需分别验收。

结构、身份与状态约束

订单以tenant_id、order_id唯一,包含shop_id、user_id、version和state。version非负;本例state仅PAID、ACCEPTED、CANCELLED。用户只取消自己的单,商家人员需要该店接单权限。身份在读取回执前检查,不能知道请求键就读到他人结果。

PAID可转ACCEPTED或CANCELLED;后两态在本模型中不允许相互覆盖,已接单后的取消另走授权补偿。CANCELLED仅为业务取消,不表示支付渠道已退款;出餐、配送和资金各有独立状态。

条件更新和回执表

代码语言:sql
复制
CREATE TABLE orders (
 tenant_id VARCHAR(64) NOT NULL, order_id VARCHAR(64) NOT NULL,
 shop_id VARCHAR(64) NOT NULL, user_id VARCHAR(64) NOT NULL,
 version BIGINT NOT NULL CHECK(version>=0),
 state VARCHAR(16) NOT NULL CHECK(state IN ('PAID','ACCEPTED','CANCELLED')),
 PRIMARY KEY(tenant_id,order_id)
);
CREATE TABLE command_receipt (
 tenant_id VARCHAR(64) NOT NULL, actor_id VARCHAR(64) NOT NULL,
 request_id VARCHAR(64) NOT NULL, body_sha CHAR(64) NOT NULL,
 result_json TEXT NOT NULL,
 PRIMARY KEY(tenant_id,actor_id,request_id)
);
UPDATE orders SET state=:next_state,version=version+1
 WHERE tenant_id=:tenant AND order_id=:order
 AND version=:expected AND state='PAID';

完整事务与输入输出

认证授权后,规范化原单、动作和expected计算摘要。在同一事务按固定顺序锁订单,再查原请求:同键同摘要返回原结果,同键不同摘要409。无回执才校验状态版本、执行条件更新,并把业务变化与结果一起写入回执后提交。

影响0行则回读当前状态返回冲突,拒绝结果也绑定该请求。数据库异常全部回滚;唯一键竞争失败需回滚后新事务读已提交回执,不能先返回成功再补业务。未知结果由客户端同键查询,不生成第二个请求意图。

初始O1为PAID/7。商家R1以expected=7接单成功,返回ACCEPTED/8。用户R2仍以7取消,返回409与当前ACCEPTED/8,不创建自动退款。若用户先取消成功,商家接单冲突,不进入备餐。

R1同内容重放回原结果,版本不增加;同R1换另一原单返回409。无该店权限的身份返回403,即便知道R1也不回账单。响应丢失查询原回执,同时读取当前订单,历史结果和当前事实分开展示。

反例和采购意义

先查版本再不带版本写入,两个并发请求可能相互覆盖;只在内存缓存回执,重启后失去防重。应在实际数据库隔离语义下验证条件更新、回滚与唯一约束,设计SQL没有运行,不声称并发测试已通过。

微订第一方校园页列有子帐号权限与商家结算。本文仅以其说明双端业务关联,未声明表结构为微订实现。完整功能先核商品、下单、售后与账单,再对这个局部竞争场景做当前版本演示。

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

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

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

目录
  • 结构、身份与状态约束
  • 条件更新和回执表
  • 完整事务与输入输出
  • 反例和采购意义
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档