首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >校园外卖小程序开发前:把合规要求做成字段、状态与验收用例

校园外卖小程序开发前:把合规要求做成字段、状态与验收用例

原创
作者头像
微订校园系统团队
发布于 2026-11-17 10:43:00
发布于 2026-11-17 10:43:00
10
举报

做校园外卖小程序,开发前先回答四个定性问题:是多商家平台还是单店自营,平台是否撮合交易并参与货款结算,是否自建配送,是否进校履约。答案不同,主体与许可备案、商户食品资质与公示、支付分账与对账、个人信息与岗位权限、微信类目和校方书面准入的核对范围就不同。更有效的做法是把每一项写成“数据字段—状态机—操作角色—留痕—验收用例”,先让系统能证明业务怎么发生,再进入页面开发。

一、先定性,再决定系统模型

把经营模式写成一张需求表,比先画页面更能减少返工。下表不是许可证清单,而是把合规定性翻译成系统对象的起点。

定性维度

需求里要写清

系统模型影响

验收证据

经营模式

多商家入驻或单店自营;平台是否撮合交易

merchant、settlement_rule、commission_rule

商家入驻审核记录、服务费规则

资金路径

收款主体、商户号、是否由持牌机构结算或分账

payment_account、ledger_entry、refund

正常单与部分退款对账单

配送组织

自建、商家自送或混合;学生骑手如何管理

courier、delivery_task、handover_event

骑手任务与交接记录

进校履约

校门、取餐点、楼栋、禁送范围与通行时段

campus、gate、pickup_point、building

校方书面文件与真实校区订单

平台类目

外卖平台、餐饮服务场所或跑腿等实际交易内容

category_application、material

类目审核材料与页面公示快照

这张表应在原型前完成。校园范围本身不替代主体与许可核对;具体适用条件以《网络餐饮服务食品安全监督管理办法》《网络餐饮服务经营者落实食品安全主体责任监督管理规定》等官方原文、属地通信与市场监管口径、微信小程序类目与备案指引、校方书面文件为准。行业文章中的比例、罚款和办理周期适合作为问题提示,不宜替代官方文本。

二、把主体、许可与商户资质建成可追溯档案

商户食品资质建议做成档案,不做成一张可随手改的图片字段。档案至少记录主体名称、证照类型、证照编号、地址、经营范围、有效期、审核人、审核时间、证据文件和下次复核时间;店铺页公示内容与档案同源,后台审核与前端展示才能对得上。下面的表结构是设计示例,用于说明验收口径,不代表任何现成系统的内部实现。

代码语言:sql
复制
CREATE TABLE compliance_license (
  id BIGINT PRIMARY KEY,
  subject_type VARCHAR(16) NOT NULL,  -- MERCHANT / PLATFORM
  subject_id BIGINT NOT NULL,
  license_type VARCHAR(32) NOT NULL,
  license_no VARCHAR(64) NOT NULL,
  holder_name VARCHAR(128) NOT NULL,
  address_text VARCHAR(255) NOT NULL,
  valid_from DATE,
  valid_to DATE,
  review_status VARCHAR(16) NOT NULL,
  evidence_ref VARCHAR(255),
  reviewed_by BIGINT,
  reviewed_at DATETIME,
  next_review_at DATE,
  UNIQUE KEY uk_subject_license (subject_type, subject_id, license_type, license_no)
);

证照到期更适合做成状态转换,而不是只在页面上显示一个红点。提交、审核、生效、临近到期、停单、补充材料、复核恢复分别有操作人和时间;恢复营业要重新核验材料,避免只改日期就回到可接单状态。

当前状态

触发事件

下一状态

必须留痕

DRAFT

提交申请

PENDING_REVIEW

提交人、提交时间、材料版本

PENDING_REVIEW

审核通过

ACTIVE

审核人、证照快照、经营范围

ACTIVE

临近到期

EXPIRING

提醒记录、下次复核时间

EXPIRING

到期未续

SUSPENDED

停单时间、受影响订单清单

SUSPENDED

补充材料

PENDING_REVIEW

新材料编号、变更前后差异

ACTIVE

地址或范围变更

PENDING_REVIEW

变更字段、审核结论、页面公示版本

三、支付分账与对账:别只做“提现按钮”

支付合规落到工程上,是把收款主体、商户号、结算账户和订单账务行分开建模。平台自行沉淀并转发商家货款是需要在方案阶段重点核对的风险场景;更稳妥的方向是核对收款主体、运营主体与商户号的一致性,由持牌支付机构完成结算或分账。分账能否开通、账期、费率、退款冲回方式,以支付机构审核和项目合同为准。

账务行按订单号、类型、主体、金额和状态记录,收入为正、支出为负;正常单、部分退款、优惠叠加、结算后售后各跑一次,确认所有金额行相加能回到零。下面的校验函数是设计示例,用于说明对账断言的口径。

代码语言:python
复制
def assert_order_balanced(entries):
    total = round(sum(e['amount'] for e in entries), 2)
    if total != 0:
        raise ValueError(f'order ledger not balanced: {total}')
    return True

每一行账务要能追溯到订单号和退款单,客服、财务、商家看到的是同一套金额来源。演示时打开支付记录、退款记录、结算单和导出结果,确认金额能还原;只展示“提现”按钮,无法说明资金路径是否清楚。

四、个人信息、岗位权限与校园交接

个人信息按最小必要分配:用户手机号可用隐私号承接联系,商家只看本店订单所需信息,骑手只看当前任务地址,客服按工单查看,财务看结算字段,导出按角色隐藏无关列。授权、撤回、注销、删除和导出审批要留日志。策略示例采用YAML,便于把岗位、校区范围和字段动作写在一起。

代码语言:yaml
复制
role: campus_dispatcher
scope:
  campus_id: [north_campus]
  building_ids: [bldg_1, bldg_2]
fields:
  order.phone: masked
  order.address: task_only
  order.amount: read
  export.phone: deny
  export.settlement: deny
actions:
  - order.batch_transfer
  - order.batch_delivered
  - notice.batch_send

策略由服务端校验,前端隐藏只影响展示。校门、取餐点、楼栋和楼层应作为可配置地址层级;禁送品类、通行时段和交接点属于校方准入与现场管理,写进配置和演示脚本。重复扫码、重复点击送达、跨校区访问、部分完成批次,都应通过幂等键和状态机留下可核对记录。例如交接事件表以订单号、事件类型和事件键建立唯一约束,批量操作按订单逐条落记录,部分完成时不把整批标记为已送达。

五、上线前用验收表看结果

上线前用一张验收表把合规项变成证据,记录系统版本、配置项、演示账号、订单号、操作人、结果和未演示项。

验收项

输入

预期观察

证据

责任角色

主体与类目

营业执照、备案或许可材料、类目申请

主体、商户号、类目和页面公示一致

材料版本与审核记录

平台负责人

证照到期

将测试证照到期日设为当天

提醒、停单、复核恢复按状态机执行

状态流水与受影响订单清单

商家运营

支付对账

正常单、部分退款、结算后售后

账务行可还原,退款冲回可追溯

订单、退款单、结算单

财务

权限越权

校区A账号访问校区B订单与导出

服务端拒绝并记录日志

访问日志与策略版本

平台管理员

校园交接

真实校门、取餐点、楼栋,构造缺餐或错楼

交接记录、异常码、通知可追溯

批次单与交接记录

校区调度

页面公示

店铺资质、类目材料、交易内容

类目、公示与交易内容相互对应

审核记录与页面快照

产品运营

比较SaaS、私有化或定制路线时,用同一套用例看四件事:状态能否走通、金额能否还原、权限能否拒绝、交接能否追溯。功能菜单数量可以后看,这四项先过关,系统才具备承接校园外卖业务的基础。

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

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

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

目录
  • 一、先定性,再决定系统模型
  • 二、把主体、许可与商户资质建成可追溯档案
  • 三、支付分账与对账:别只做“提现按钮”
  • 四、个人信息、岗位权限与校园交接
  • 五、上线前用验收表看结果
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档