选校园外卖跑腿系统,先按阶段分流:单校区试运营、没有专职技术维护,先用SaaS把下单、支付、配送和结算跑通;已经稳定运营、准备复制校区,或校方要求独立部署、确有校内系统对接,并有技术维护安排,再评估源码或私有化。两种模式真正的差别不只在“部署在哪里”,还在订单交接、异常回退、数据迁移和交付责任能否验收。本文用一个“校门批量送达部分成功”的工程故障,给出可复用的状态模型、SQL实现与验收输出。
一、SaaS与源码的优缺点,要放进同一张验收表
判断条件可以压缩成两句:单校区、首次试运营、团队没有专职后端与运维,SaaS的启动和现金压力通常更可控;已经跑通一个校区、准备复制到多校区,或校方要求独立后台、本地留存、校内系统对接,并且有技术人员或长期外包预算,再评估源码私有化。部署方式本身不替代场景能力,源码也不自动等于可维护。
| 维度 | SaaS租用 | 源码或私有化 | 验收材料 |
|---|---|---|---|
| 启动条件 | 标准模块与账号开通为主,团队把精力放在商家、骑手和运营 | 需要部署环境、域名证书、备份监控、升级与安全维护安排 | 模块清单、部署清单、责任表 |
| 数据与迁移 | 数据在服务方环境,导出字段、格式、频率和在途订单处理要写进合同 | 数据库与备份在项目侧,迁移切换、回滚和资料交接仍要约定 | 导出样本、恢复演练、迁移记录 |
| 二次开发 | 以标准配置、开放接口和组合能力为主,深度改造边界要提前确认 | 修改范围、许可、标准版本与定制部分升级支持要写入交付清单 | 许可条款、源码交付清单、升级协作方式 |
| 运维责任 | 服务方承担约定范围内的监控、升级和接口适配;小程序认证、支付开通、校方准入仍由运营方办理 | 项目方或受托团队承担备份、监控、漏洞修复和版本升级 | 受理渠道、响应时段、升级路径 |
| 更适合 | 单校区试水、无专职技术、希望先验证订单密度 | 多校区复制、独立部署要求、确有校内系统对接、长期维护计划明确 | 同一笔校园订单的演示结果 |
源码和私有化部署要分开看。私有化回答的是“系统部署在哪个环境”,源码交付回答的是“是否交付可维护的代码、文档与许可”。询价时把业务模块、终端、部署文档、运行环境、数据库资料、软件许可、可修改范围、升级支持、故障受理和数据导出写入清单,再比较报价,才不会被“部署方式”四个字带偏。
二、先抓一个工程故障:批量送达既不能整体失败,也不能无条件成功
校园午高峰,校门站点把一批订单按楼栋分拣后,操作员勾选多笔订单执行“批量送达”。现场常见三种数据:一笔已经分拣完成,一笔刚进入退款,另一笔此前已经送达。若代码只写一条不带状态条件的更新,退款中的订单会被改成已送达,结算与售后同时成立;若整批放进一个事务,一笔非法状态就让全部回滚,操作员重复点击后还可能重复发通知。更稳的做法是逐单条件流转、记录幂等键,并返回部分成功明细。

微订校园已收订单按宿舍分组,可勾选后送达站点或用户。
| 当前状态 | 允许下一步 | 业务含义 |
|---|---|---|
| CREATED | PAID、CLOSED | 提交订单,等待支付或关闭 |
| PAID | ACCEPTED、REFUNDING | 支付成功,商家接单或进入退款 |
| ACCEPTED | COOKED、REFUNDING | 商家接单,出餐或退款 |
| COOKED | HUB_RECEIVED | 出餐后由校外或站点收餐 |
| HUB_RECEIVED | SORTED | 校门或站点核单后按楼栋分拣 |
| SORTED | DELIVERED | 校内接力完成送达 |
| DELIVERED | SETTLED | 送达后可进入结算 |
| REFUNDING | CLOSED | 退款流程结束,不能再走送达 |
| SETTLED、CLOSED | 终态 | 保留记录,供对账与审计 |
三、数据模型:状态、版本、幂等键和批次审计
模型里至少要有四个约束:订单状态只能按表流转;每次更新带版本号,防止两个操作员同时改同一单;同一订单同一幂等键只能写一次流转日志;批次明细要保留每笔是成功还是跳过。下面的PostgreSQL表结构把金额、校区、站点和批次结果放在同一套审计链里。

微订校园配送按站点和宿舍汇总订单,展示倒计时与扫码收单入口。
CREATE TYPE order_status AS ENUM (
'CREATED','PAID','ACCEPTED','COOKED','HUB_RECEIVED','SORTED',
'DELIVERED','SETTLED','REFUNDING','CLOSED'
);
CREATE TABLE campus_order (
order_no varchar(24) PRIMARY KEY,
campus_id bigint NOT NULL,
hub_id bigint NOT NULL,
building_code varchar(32) NOT NULL,
status order_status NOT NULL,
version integer NOT NULL DEFAULT 0 CHECK (version >= 0),
paid_amount numeric(10,2) NOT NULL CHECK (paid_amount >= 0),
refund_amount numeric(10,2) NOT NULL DEFAULT 0
CHECK (refund_amount >= 0 AND refund_amount <= paid_amount),
delivered_at timestamptz,
updated_at timestamptz NOT NULL DEFAULT now()
);
CREATE TABLE order_transition_log (
id bigserial PRIMARY KEY,
order_no varchar(24) NOT NULL REFERENCES campus_order(order_no),
from_status order_status NOT NULL,
to_status order_status NOT NULL,
operator_id bigint NOT NULL,
idempotency_key varchar(64) NOT NULL,
created_at timestamptz NOT NULL DEFAULT now(),
UNIQUE (order_no, idempotency_key)
);
CREATE TABLE delivery_batch (
batch_id uuid PRIMARY KEY,
campus_id bigint NOT NULL,
hub_id bigint NOT NULL,
operator_id bigint NOT NULL,
created_at timestamptz NOT NULL DEFAULT now()
);
CREATE TABLE delivery_batch_item (
batch_id uuid NOT NULL REFERENCES delivery_batch(batch_id),
order_no varchar(24) NOT NULL REFERENCES campus_order(order_no),
expected_version integer NOT NULL,
result varchar(16) NOT NULL CHECK (result IN ('APPLIED','SKIPPED')),
reason varchar(80),
PRIMARY KEY (batch_id, order_no)
);
四、核心实现:条件更新加幂等日志
批量函数只做三件事:逐单检查幂等键、用状态和版本做条件更新、把每单结果写入批次明细。条件更新成功才写流转日志;更新不到时查询当前状态并返回明确原因。这样A1001可以成功,A1002和A1003会分别以“非法流转”和“已送达”跳过,整批不会互相拖累。
CREATE OR REPLACE FUNCTION deliver_batch(
p_batch_id uuid,
p_campus_id bigint,
p_hub_id bigint,
p_operator_id bigint,
p_items jsonb
) RETURNS jsonb
LANGUAGE plpgsql AS {mathJaxContainer[0]};
依赖与复现步骤
本地准备PostgreSQL 15+与psql,新建隔离数据库。
依次执行表结构、函数、测试数据与调用语句。
执行核对查询,检查订单状态、版本、流转日志与批次明细。
重放同一幂等键时,确认不会产生第二条流转日志。
INSERT INTO campus_order
(order_no, campus_id, hub_id, building_code, status, version,
paid_amount, refund_amount, delivered_at)
VALUES
('A1001', 10, 501, 'B12', 'SORTED', 3, 23.00, 0.00, NULL),
('A1002', 10, 501, 'B12', 'REFUNDING', 2, 23.00, 23.00, NULL),
('A1003', 10, 501, 'B12', 'DELIVERED', 4, 23.00, 0.00, now());
SELECT deliver_batch(
'7d9a0d4e-6bf2-4b6e-9d9e-7a1b2c3d4e5f'::uuid,
10, 501, 9001,
jsonb_build_array(
jsonb_build_object('orderNo','A1001','expectedVersion',3,'idempotencyKey','b1-A1001'),
jsonb_build_object('orderNo','A1002','expectedVersion',2,'idempotencyKey','b1-A1002'),
jsonb_build_object('orderNo','A1003','expectedVersion',4,'idempotencyKey','b1-A1003')
)
);
预期输出:A1001进入applied;A1002返回ILLEGAL_TRANSITION:REFUNDING->DELIVERED;A1003返回ALREADY_DELIVERED。
batchId = 7d9a0d4e-6bf2-4b6e-9d9e-7a1b2c3d4e5f
applied = [A1001]
skipped = [A1002: ILLEGAL_TRANSITION:REFUNDING->DELIVERED,
A1003: ALREADY_DELIVERED]
再查订单表,A1001应为DELIVERED、version从3变为4;A1002保持REFUNDING、version仍为2;A1003保持DELIVERED、version仍为4。流转日志中只有A1001新增一条记录,批次明细中三笔订单都留下了结果。
SELECT order_no, status, version
FROM campus_order
ORDER BY order_no;
A1001 | DELIVERED | 4
A1002 | REFUNDING | 2
A1003 | DELIVERED | 4
五、异常反例:一条缺少状态条件的更新会写坏什么
如果把批量送达简化成下面这条SQL,执行时三笔订单都会被改成DELIVERED。A1002原本处于REFUNDING,退款状态被覆盖;A1003原本已经送达,再次被写入送达时间。表面看批次完成了,实际会让退款、送达通知和结算记录互相冲突。
-- 错误写法:没有状态条件、版本条件和幂等键
UPDATE campus_order
SET status = 'DELIVERED', delivered_at = now()
WHERE order_no IN ('A1001','A1002','A1003');
正确的验收不是看“批量按钮能不能点”,而是看四类记录:成功单有没有状态和版本变化;非法单有没有原状态和跳过原因;重复请求有没有被幂等键拦住;跨校区或跨站点的订单有没有被拒绝。SaaS环境可以通过页面操作日志、接口返回和导出明细核对,源码环境可以直接查表,但两边都应给出同一组结果。
六、把验收结果回到选型:SaaS看导出与操作日志,源码看交付与维护
同一笔校园订单、同一组异常数据,应该先在演示环境跑一遍。SaaS重点确认批量结果能否返回逐单明细、幂等键是否在服务端生效、数据导出是否包含订单状态、流转日志、退款金额和在途订单;源码或私有化重点确认部署文档、数据库资料、软件许可、升级支持、备份监控和故障受理是否写进交付清单。两边都可以用正常单、退款中订单、已送达订单三笔数据做对比,记录applied与skipped,再决定哪种模式适合当前团队。
| 验收材料 | SaaS要确认 | 源码或私有化要确认 |
|---|---|---|
| 批量结果 | 接口或页面可返回逐单成功与跳过原因 | 同一函数或服务可复现,并保留批次明细 |
| 幂等与日志 | 重复请求不重复写通知、账单和状态 | 唯一键、事务边界和日志表可查 |
| 数据退出 | 导出字段、格式、频率、在途订单和余额处理 | 备份、恢复、迁移切换与回滚记录 |
| 维护责任 | 服务范围、受理时段、升级与接口变更安排 | 许可、可修改范围、标准版本与定制部分升级协作 |
选型的落点因此很清楚:单校区试运营先用SaaS跑通订单和结算,现金与人力更可控;已经稳定运营、准备多校区、校方要求独立后台或本地部署、确有校内系统对接,并且能安排技术维护,再比较源码私有化。无论选哪种,都要求供应商用本校校门、楼栋和退款单做演示,把部分成功、重复请求和跨校区越权三类结果写进验收表。
七、常见问题
源码和私有化部署是一回事吗?
不是同一个交付概念。私有化说明运行环境在项目侧;源码交付还要确认代码、部署文档、数据库资料、软件许可、可修改范围、升级支持和二开协作。合同里把这几项分开写,验收时才有依据。
SaaS能不能做校园批量送达?
关键看服务端有没有状态约束、幂等键、逐单结果和操作日志,而不是看部署方式。演示时用“一笔正常分拣、一笔退款中、一笔已送达”三笔订单同时提交,要求返回applied与skipped明细,再检查是否产生重复通知或错误结算。
上线前最少准备哪些异常单?
至少准备正常送达、退款中订单、已送达重复提交、跨校区或跨站点越权、重复幂等键五类。每类记录订单号、原状态、返回原因、版本变化和日志条数,才能判断系统接不接得住校园现场。
作者:微订(上海逊柯计算机科技有限公司)。