从零起一个接单系统
三个人、六周内要上线第一个下单流程。模板自带迁移、接口文档和 Docker Compose,第 2 天就能跑通下单到支付的闭环。
三段现场,不是产品介绍。
这套骨架来自一个真实上线的订单服务,去掉业务敏感字段后保留 18 个模块:下单、库存预占、支付回调、退款、对账、通知、审计等。默认单库 PostgreSQL 17,Redis 只做幂等键,不承担核心状态。
代码按“接口层、应用层、领域层、基础设施层”分开,目录不按框架命名。23 张表的迁移脚本按版本编号,能从空库跑到最新;41 个 HTTP 接口都有请求示例和错误码表。测试分单元、集成、端到端三层,共 86 个,默认 4 分 10 秒跑完。
仓库保留 broken 分支,故意把库存预占写成先扣减后校验。切过去跑测试会看到 7 个失败,对照 main 的 3 个提交能看清幂等和补偿怎么写。ZIP 快照包含同样的代码和一份 22 页的模块说明。
每个场合都写到具体命令或数据量。
三个人、六周内要上线第一个下单流程。模板自带迁移、接口文档和 Docker Compose,第 2 天就能跑通下单到支付的闭环。
现有订单逻辑散在 7 个控制器里,想拆又怕漏。模块说明标了 18 个边界和 23 张表的归属,可以按表逐步迁移。
面试或内部培训要讲重复支付。broken 分支的 7 个失败用例能现场复现,不用另写 demo。
以最新版本为准,交付前会再核对一次。
| 参数项 | 内容 |
|---|---|
| 版本 | v1.7,2026 年 10 月更新 |
| 技术栈 | Go 1.23、PostgreSQL 17、Redis 7.4 |
| 模块数量 | 18 个领域与应用模块 |
| 数据表 | 23 张表、14 个迁移版本 |
| 接口与测试 | 41 个 HTTP 接口、86 个测试 |
| 依赖 | pgx v5、chi v5、sqlc 1.27,无付费云服务 |
| 许可 | 单团队商用许可,不限项目数量,不可转售 |
| 交付方式 | 付款后 48 小时内开通仓库只读权限并发送 ZIP |
三条可以逐项核对的差异。
23 张表从 V001 到 V014 按顺序执行,默认 38 秒建完。隔壁模板常只给最终 schema,缺中间版本,二次开发时无法安全加字段。
broken 分支保留 7 个失败测试,覆盖重复支付、库存回滚和回调乱序。买家可以亲眼看到问题再对照修法,不用猜。
对象存储用本地 MinIO,消息用 PostgreSQL 事务表加轮询,整包在本机 Docker 就能跑。隔壁方案常默认依赖某个云队列,迁移成本被隐藏。
时间、形式和退款条件都写死。
付款后 48 小时内开通私有仓库只读权限,同时发送 ZIP 快照下载链接。仓库权限保持 12 个月,ZIP 永久保留。首次启动按 README 的 6 条命令执行,默认 8 分钟内跑通健康检查。
30 天内代码无法按文档启动,可退款并保留 ZIP。12 个月内可在仓库 issue 区提问,工作日 24 小时内回。框架小版本升级给迁移说明,不重写整包。
买之前先看这一段,能省一次退款。
如果你只做单体小服务,先用 41 个接口里的 12 个核心接口,别一次把所有模块打开。团队有 3 人以上、准备接真实支付时,再引入对账和审计模块。需要多租户的,先在 issue 里说明,模板默认单租户。
三个问题,答案不绕弯。
可以。单团队商用许可不限项目数量,不能把源码作为模板再次出售,也不能公开到公共仓库。
默认 PostgreSQL 17,迁移脚本和 sqlc 查询不兼容 MySQL。2026 年 12 月计划补一版 MySQL 8.0 分支,已购读者免费。
没有。订单服务只提供 HTTP 接口和一份 9 页的接口示例,后台界面需要另配,React 后台模板可以对接。
同一问题域里的另外两件东西。
每周二、五发一封邮件,只放当周的排障笔记、命令清单和一处容易踩错的细节。不发广告,随时可退。
也可以直接打电话:0668-339 7712,工作日 09:30 至 18:00。