三端一体 · 全链路闭环 · 已部署公网

一笔订单的
完整旅程，
在这套系统里闭环

小赵集市是三端一体的商城系统：微信小程序购物端、Vue3 管理后台、Node.js 交易中台。 从多规格 SKU 到支付结算，从满减营销到审计留痕——每个环节都按生产级要求打磨。

进入管理后台 看订单怎么走
3端一体
92接口路由
115自动化测试
15数据库迁移
小赵集市 ···
🧺
星屿棉麻收纳箱
360mm · 原木色 ×1
¥96.00
商品金额¥96.00
满 88 减 8（自动择优）−¥8.00
优惠券 · 满 80 减 8−¥8.00
运费¥8.00
实付¥88.00
立即支付 ¥88.00
✅ 支付成功 ¥88.00
🎫 满 88 减 8 · 已自动抵扣
⭐ 积分 +88 即将到账
ORDER JOURNEY

一笔订单的一生

六个关键节点，每一步都有服务端兜底：金额一律重定价、状态流转全 CAS、库存变动必留流水。

🛍️

01选购

多规格 SKU
活动价划线

🧮

02结算

服务端重定价
满减 + 券自动择优

💳

03支付

微信 v3 形态
事务防重复开单

📦

04发货

超时自动取消
库存回补

🌟

05收货

积分到账
会员等级成长

🤝

06售后

全额 / 部分退款
累计不超额

SYSTEM PANORAMA

系统全景，一格一角都是真的

每个格子对应仓库里真实存在的模块与测试，点进后台和接口文档都能摸到。

🛒C 端 · 买家侧全流程

逛 / 选规格 / 加购 / 结算 / 支付 / 售后全链路。客户端不算钱——提交的每一单都由服务端重新定价，本地算价只用于展示。

多规格 SKU活动价划线购物车结算重定价 满减自动择优优惠券三档模拟支付超时自动取消 售后退款积分明细地址管理会员等级
115 自动化测试用例
真实子进程 + 独立测试库
92 接口路由全量文档化
OpenAPI 双向对账卡关

🖥️B 端 · 运营驾驶舱

商品 / SKU / 库存预警、订单发货与退款审核、满减规则与优惠券发行、会员与管理员角色、数据看板运营待办、审计日志与库存流水对账。

$ curl -X POST api.zhaolong.online/api/order/preview
{ "payAmount": 8800, // 金额全整数分
"promotionCut": 800, "couponCut": 800 }
→ 200 OK Authorization: Bearer · 仅请求头

🧾库存对账

stock_ledger 只增不改，六个写路径全挂账，SUM(delta) = sku.stock 入测试。

🔐权限双层

前端 v-permission 管 29 个写按钮，服务端 PERM_MAP 强校验兜底。

ARCHITECTURE

三个仓库，一套契约

共用 OpenAPI 全量文档：路径从路由注册表自动导出，前端类型自动生成，前后端零手写漂移。

🛒

交易中台

zhao-market-server

Node.js ESM + MySQL + knex 迁移链。内存读模型承接热查询，数据库是唯一事实源。

  • 订单状态机全 CAS 化（发货 / 取消 / 售后交错不脏写）
  • 支付关旧开新单走事务 + 唯一活跃单约束，死锁友好降级
  • 券领取即快照，改模板不追溯已发持券人
  • 库存只增流水，对账不变量写进测试
  • 结构化日志 + 请求 ID 贯穿，SQL 全参数化
🖥️

管理后台

zhao-market-admin

Vue3 + TypeScript + Element Plus + ECharts。接口类型由 OpenAPI 自动生成，构建 15s→1s。

  • 主包 766KB→49KB，element-plus / echarts 按需引入
  • 按钮级权限与服务端 PERM_MAP 双层对齐
  • GET 幂等重试 + 两级错误边界 + 旧 chunk 404 自愈
  • 数据看板：运营待办直达、趋势 7/30 天切换
  • Playwright E2E：登录/建品/下单/发货主链路冒烟
📱

购物小程序

zhao-market-miniapp

uni-app（vue3）多端工程。结算金额一律服务端重定价，客户端不采信本地算价。

  • 领券中心 / 我的券 / 下单选券（默认自动选最优）
  • 待付款倒计时（配合服务端 30 分钟自动取消）
  • 售后申请 / 撤销 / 进度可视化，商家拒绝原因透传
  • 模拟支付对齐微信 v3 交易结构，接真实支付只换通知入口
  • 头像上传走服务端、登出吊销会话、地址一次性消费
3端一体 · 数据互通
92接口路由 · 全量文档
115测试用例 · 本地门禁
15数据库迁移 · 可回放
GET STARTED

部署在公网，随时可摸

🖥️

管理后台

商品 / 订单 / 营销 / 会员 / 看板
角色权限演示环境

admin.zhaolong.online
🧧

微信小程序

买家购物端
小程序备案中，敬请期待

备案后上架
📜

接口文档

92 个路由全量文档化
人读版 + openapi.json 机器可读

api.zhaolong.online/api/docs