没技术基础上手校园外卖系统,可行性取决于选型,而不是先写代码。单校或两三个校区、日单几百、没有专职技术人员的团队,选用可配置的现成系统,把校区、校门、楼栋、商家、骑手、支付与退款按清单配置,通常更容易启动;源码部署或自研则要自己维护服务器、数据库、接口和监控。真正的验收点不在页面数量,而在校门交接、集中收餐、楼栋分拣和退款异常能否被系统约束。下面用 PostgreSQL 16 给出一个最小可复现设计:订单状态机、校门与楼栋外键、扫码交接幂等表,并列出正常输入、异常反例与业务验收口径。
一、先回答容易吗:路线不同,工作量差在谁维护
零基础团队先分清四类路线。标准SaaS由服务方维护运行环境,团队把精力放在地址、商品、骑手和试运营;私有化部署和源码安装需要服务器、备份、升级与安全维护;自研还要前端、后端、测试和长期迭代。是否容易,不只看开通账号,而要看配置边界、异常处理和技术责任是否写清。
| 路线 | 主要技术维护 | 更适合的阶段 | 零基础要核对的点 |
|---|---|---|---|
| 标准SaaS | 服务方按约定维护 | 先试运营、无专职技术 | 地址、状态、扫码和退款能否配置并演示 |
| 私有化部署 | 自有或受托技术团队 | 订单稳定、需自主管理环境 | 备份、升级、监控和故障处理责任 |
| 源码安装 | 自有技术团队 | 有长期二次开发计划 | 代码交付、数据库权限和后续维护 |
| 自研 | 完整研发团队 | 有明确研发资源 | 周期、测试、支付安全和持续迭代 |
把路线选对后,再用三道关判断系统是否合用。第一关是地址:校门和楼栋能否做成字典,错楼栋能否在下单或分拣前被拦住。第二关是状态:订单能否按已定义路径迁移,跳过交接不能直接送达。第三关是幂等与账务:同一扫码重复提交是否只生效一次,退款是否不超过实付。三关都能演示,零基础上手才有可核对的基础。
| 验收问题 | 可观察证据 | 不合格表现 |
|---|---|---|
| 校门和楼栋是否结构化 | 地址来自字典表,楼栋绑定校门 | 自由文本录入,分拣靠人工猜 |
| 状态迁移是否受控 | 跳过交接直接送达会被拒绝 | 后台任意改状态,没有前后记录 |
| 重复扫码是否幂等 | 同一扫码编号只返回一次业务结果 | 重复扫码导致重复推进或重复通知 |
| 退款是否受限 | 退款金额不超过实付金额 | 可提交超过实付的退款 |
| 交接是否留痕 | 记录操作人、动作、前后状态和时间 | 只留最终状态,无法追查责任岗位 |
二、数据模型:地址字典与外键先卡住错楼栋
最小模型分为五张表:campus_gate 存校门,campus_building 存楼栋并绑定校门,delivery_order 存订单与状态,order_transition 存动作与前后状态,scan_event 存每次扫码的幂等键和结果。关键约束有三个:楼栋必须属于某个校门;订单的校门与楼栋必须匹配;退款金额不得超过实付金额。这样错楼栋不是靠分拣员记忆,而是在写入订单时被数据库拒绝。
DROP TABLE IF EXISTS scan_event, delivery_order, order_transition, campus_building, campus_gate CASCADE;
CREATE TABLE campus_gate (
id bigint generated by default as identity primary key,
tenant_id bigint not null,
campus_code varchar(32) not null,
gate_name varchar(64) not null,
unique (tenant_id, campus_code, gate_name)
);
CREATE TABLE campus_building (
id bigint generated by default as identity primary key,
tenant_id bigint not null,
gate_id bigint not null references campus_gate(id),
building_name varchar(64) not null,
unique (tenant_id, gate_id, building_name),
unique (id, gate_id)
);
CREATE TABLE delivery_order (
order_no varchar(32) primary key,
tenant_id bigint not null,
gate_id bigint not null references campus_gate(id),
building_id bigint not null,
status varchar(20) not null default 'WAIT_PAY'
check (status in ('WAIT_PAY','PAID','ACCEPTED','GATE_IN','SORTED','DELIVERING','DELIVERED','CLOSED')),
paid_cents integer not null check (paid_cents >= 0),
refund_cents integer not null default 0,
version integer not null default 0,
updated_at timestamptz not null default now(),
constraint ck_refund check (refund_cents >= 0 and refund_cents between 0 and paid_cents),
constraint fk_order_building_gate
foreign key (building_id, gate_id)
references campus_building(id, gate_id)
);
CREATE TABLE order_transition (
action varchar(16) primary key,
from_status varchar(20) not null,
to_status varchar(20) not null
);
INSERT INTO order_transition (action, from_status, to_status) VALUES
('GATE_IN','ACCEPTED','GATE_IN'),
('SORT','GATE_IN','SORTED'),
('HANDOFF','SORTED','DELIVERING'),
('DELIVER','DELIVERING','DELIVERED');
CREATE TABLE scan_event (
scan_id uuid primary key,
order_no varchar(32) not null references delivery_order(order_no),
action varchar(16) not null,
operator_id varchar(32) not null,
result varchar(24) not null default 'PROCESSING',
from_status varchar(20),
to_status varchar(20),
created_at timestamptz not null default now()
);
INSERT INTO campus_gate (id, tenant_id, campus_code, gate_name) VALUES
(1,1001,'XQ01','东门'),
(2,1001,'XQ01','西门');
INSERT INTO campus_building (id, tenant_id, gate_id, building_name) VALUES
(101,1001,1,'1号楼'),
(102,1001,1,'2号楼'),
(201,1001,2,'3号楼');
INSERT INTO delivery_order
(order_no, tenant_id, gate_id, building_id, status, paid_cents)
VALUES
('20240909001',1001,1,101,'ACCEPTED',2590);
这段模型把业务规则放进数据库:campus_building 的 gate_id 说明楼栋属于哪个校门;delivery_order 的复合外键 (building_id, gate_id) 引用 campus_building(id, gate_id),订单填了东门却选了西门楼栋时会直接失败。scan_event 以 scan_id 为主键,同一个扫码编号只能落一条记录。refund_cents 的检查约束把退款上限固定在实付金额内,避免只靠客服手工核对。
三、核心实现:扫码交接只走允许的状态迁移
扫码函数承担三件事:判断动作是否合法、在事务内锁定订单并推进状态、记录扫码事件。scan_id 主键用于幂等,重复提交同一扫码直接返回第一次结果;订单行使用 FOR UPDATE,避免两个岗位同时推进同一订单。动作与前后状态放在 order_transition 表,后续增加取餐、异常转派时只需补数据,不必把判断散落在页面代码中。
CREATE OR REPLACE FUNCTION apply_scan(
p_scan_id uuid,
p_order_no varchar,
p_action varchar,
p_operator_id varchar
) RETURNS text
LANGUAGE plpgsql
AS {mathJaxContainer[0]};
这里把读状态、写事件和改订单放在同一事务中。调用方执行一条 SELECT 即完成一次状态迁移;若中途失败,整笔操作回滚,不会留下订单已送达但交接记录未完成的情况。生产落地时还要把该函数放在服务端接口之后,业务账号只被授予函数执行权限,而不是订单表的直接更新权限。

微订校园配送按商家汇总订单,并提供扫码收单入口。
复现依赖与步骤
依赖为 PostgreSQL 16 与 psql 客户端。将上面的 DDL、函数和种子数据按顺序保存为 schema.sql,本地可用容器临时库运行;生产环境要按实际账号、网络、备份和监控策略调整。以下命令只演示本地临时库,不连接任何现网资源。
docker run --name campus-pg -e POSTGRES_PASSWORD=devpass -p 5432:5432 -d postgres:16
docker cp schema.sql campus-pg:/schema.sql
docker exec -it campus-pg psql -U postgres -d postgres -f /schema.sql
docker exec -it campus-pg psql -U postgres -d postgres
正常输入与预期输出
先用一笔已接单订单执行校门交接。下列结果为预期输出,执行时应记录数据库版本、脚本哈希和实际返回。
SELECT apply_scan(
'3f1b0f6e-6d5a-4a2e-9e0a-000000000001',
'20240909001','GATE_IN','gate_staff_01'
) AS result;
SELECT order_no, status, version
FROM delivery_order WHERE order_no = '20240909001';
预期第一句返回 OK;第二句返回订单号 20240909001、状态 GATE_IN、version 为 1。随后用同一个 scan_id 重复执行,预期仍返回 OK,订单状态和 version 不变,说明重复扫码没有重复推进。再用新的 scan_id 依次执行 SORT、HANDOFF、DELIVER,预期状态依次变为 SORTED、DELIVERING、DELIVERED,version 依次为 2、3、4。
| 步骤 | 动作 | 预期返回 | 预期状态 | 预期 version |
|---|---|---|---|---|
| 首次交接 | GATE_IN | OK | GATE_IN | 1 |
| 重复同一扫码编号 | GATE_IN | OK | GATE_IN | 1 |
| 按楼栋分拣 | SORT | OK | SORTED | 2 |
| 校内骑手接手 | HANDOFF | OK | DELIVERING | 3 |
| 送达 | DELIVER | OK | DELIVERED | 4 |
四、异常反例:错楼栋、跨状态、超额退款和越权更新
正常单走通只说明路径存在,异常单才暴露系统是否可控。下面四个反例用于验收:错楼栋在写入订单时被外键拒绝;跨状态在函数内被拦截;重复扫码保持幂等;退款超过实付时被检查约束拒绝。结果口径为 PostgreSQL 16 的预期行为,实际错误文本以所用版本为准。
| 反例 | 输入 | 预期系统行为 | 业务验收含义 |
|---|---|---|---|
| 错楼栋 | 订单填东门,楼栋填西门下的3号楼 | 复合外键拒绝插入 | 分拣前就发现地址不匹配 |
| 跳过状态 | 订单仍在 GATE_IN,直接执行 HANDOFF | 返回 STATE_CONFLICT,状态不变 | 不能绕过楼栋分拣 |
| 重复扫码 | 同一 scan_id 再次提交同一动作 | 返回原结果,version 不变 | 重复操作不重复推进 |
| 超额退款 | 实付2590分,退款改为3000分 | 检查约束拒绝更新 | 退款不超过实付 |
| 越权改表 | 业务账号直接更新订单状态 | 应无直接更新权限 | 状态只能经受控接口迁移 |
错楼栋可以用一条插入语句复现。3号楼属于西门,而订单 gate_id 填东门,因此 (building_id, gate_id) 与 campus_building 不匹配,预期报外键约束 fk_order_building_gate 错误。这个反例应写进验收记录,而不是只在页面检查楼栋名称。
INSERT INTO delivery_order
(order_no, tenant_id, gate_id, building_id, status, paid_cents)
VALUES
('20240909002',1001,1,201,'ACCEPTED',2590);
跨状态反例在订单处于 GATE_IN 时直接执行 HANDOFF。函数查到 HANDOFF 要求前置状态为 SORTED,与当前状态不一致,返回 STATE_CONFLICT,订单仍停在 GATE_IN,scan_event 记录冲突。这样现场人员知道要回到分拣动作,而不是把订单强行改成已送达。
SELECT apply_scan(
'3f1b0f6e-6d5a-4a2e-9e0a-000000000002',
'20240909001','HANDOFF','sorter_01'
) AS result;
超额退款用于验证账务约束。订单实付2590分,退款直接改成3000分会触发 ck_refund。业务上应先在售后单确认退款商品、配送费和优惠承担,再写退款金额;数据库约束只守住上限,具体分摊仍要由账单逻辑完成。

微订官方下载页公开的商家App售后申请与退款处理
UPDATE delivery_order
SET refund_cents = 3000
WHERE order_no = '20240909001';
越权更新是最容易被忽略的反例。如果业务账号拥有 delivery_order 的直接 UPDATE 权限,即使函数写得再完整,也可以绕过状态机。部署时应撤销无关更新权限,只授予函数执行权限;应用账号名按实际环境替换。
REVOKE UPDATE ON delivery_order FROM PUBLIC;
GRANT EXECUTE ON FUNCTION
apply_scan(uuid, varchar, varchar, varchar) TO app_role;
五、零基础上线与业务验收清单
零基础团队可以按六步推进。第一步和校方确认通行规定、校门交接点和可送达位置,把答复映射到校门、楼栋和订单字段。第二步导入真实楼栋布局,做一次错楼栋插入。第三步用状态表画出正常单,确认每个岗位只做允许动作。第四步配置权限,业务账号不直接改订单表。第五步用正常、退款、跨状态和重复扫码跑一遍,记录 scan_id、version、result 和处理人。第六步限定一栋楼或一个片区试运营,观察高峰收餐、分拣、通知和异常处理。

微订校园配送站点收单与已收订单送达页面,按宿舍组织处理。
对SaaS选型,带这三张表去演示:地址字典、状态迁移、扫码幂等。重点问目标版本是否支持楼栋绑定校门、是否允许配置动作与前后状态、同一扫码是否只生效一次、退款是否受金额约束。对私有化或源码方案,再补数据库权限、备份、升级和故障处理责任。能演示异常单的系统,才比只看功能列表更有判断依据。
本地容器里的 PostgreSQL 只用于演示模型。若部署到云数据库或云服务器,需要另配网络访问、账号权限、备份、监控、连接池和高可用;本地演示与云上环境在备份、网络和故障恢复上存在差异,不能把本地运行结果当作现网容量或稳定性证明。
FAQ:零基础最常问的三个问题
没有技术团队,能自己上线吗?标准SaaS按清单配置可以推进,重点是地址、商品、骑手、支付和异常演练;源码或私有化需要技术维护。选型时要求演示错楼栋和重复扫码,比只看页面更有效。
为什么不能直接在后台把订单改成已送达?直接改表会绕过校门交接和楼栋分拣,也无法追查操作岗位。应用账号应只调用受控函数,状态变更保留 scan_id、操作人、前后状态和结果。
本地SQL示例能直接当生产方案吗?它用于说明验收模型,生产还要补权限、备份、监控、并发压测、告警和支付对账;上云时按云数据库的网络与运维差异配置。
作者:微订(上海逊柯计算机科技有限公司)。