CASE 04 · B2B 经销 · SaaS ERP

钢链云 · 钢材贸易经销商 ERP

钢材贸易规格复杂、批次成本难算、余料借货等行业单据通用软件难以支撑。 我们在自研经销商 OMS「钢链云」基线上完成钢铁行业化重塑:按板/管/线/材四大类结构化管理商品, 出库按批次先进先出自动核算成本,代客下单一单同时生成订单、成品单、余料与借货单; 合同模板可配置并导出 PDF,费用报销与多渠道收款全程留痕,低库存与一客多销主动预警。 平台端与经销商端双后台分离,多租户数据严格隔离。

FIFO 批次成本一单四据余料闭环一客一价多租户 SaaS
284个API 接口
64张业务数据表
9W+行自研代码
17个业务模块
Background

项目背景

钢材贸易经销商(板/管/线/型材批发)向下游甲方公司客户供货的日常经营,与快消电商截然不同: 同一材质下厚×宽×长、外径×壁厚等尺寸组合千变万化,还有理计/磅计双计重、吨为计价主单位; 同规格钢材不同批次进货价不同,卖出一单到底赚多少,需要按批次先进先出摊成本; 切割产生的余料、向同行借货、给客户结算的成品单,都是通用进销存软件没有的行业单据; 加上一客一价议价频繁、线下多渠道收款赊销普遍、业务员/仓管/配送/财务全靠电话微信人盯人。

我们以自营 SaaS 产品「钢链云」经销商 OMS 为基线,面向钢铁贸易行业完成重塑: 一套多租户 SaaS 化经销商 ERP,平台端管理租户(经销商),经销商端按 RBAC 权限服务 管理员、业务员、配送员、财务、收款五类预置角色,把商品、客户、订单、库存、合同、费用、 财务全部纳入一个系统,并通过站内信 + 微信订阅消息 + 定时预警主动推送关键事件。

Workflow

核心业务流程

代客下单业务员代客户录入订单,一单同时生成订单、成品单、余料补录与借货单
价格快照按「客户 × 商品」专属价实时取价,提交即固化快照,报价可审计
订单履约订单状态机驱动:确认 → 拣货 → 配送 → 送达 → 完成,出库单批量打印
FIFO 出库按进仓时间先进先出自动分配批次成本,完成单按实拣数量扣减并写入利润核算
多渠道收款微信 / 支付宝 / 现金 / 商户码多渠道多笔收款,与履约并行跟踪
凭据留底收款按途径上传凭据图片,列表角标展示,zip 打包下载
合同定稿条款可配置的合同模板关联订单生成合同,Chromium 渲染导出 PDF
财务与预警批次成本利润分析、费用报销,低库存与一客多销定时扫描主动预警
Architecture

双后台系统架构

Web · 平台管理后台

多租户运营中枢

经销商(租户)创建与启停。

  • 创建租户单事务完成管理员账号与全量权限绑定
  • 平台管理员管理与自保护机制
  • 平台级操作日志审计
Web · 经销商管理后台

17 个业务模块工作台

五类预置角色 RBAC 权限。

  • 商品、客户、订单、库存、合同、售后、供应商全模块
  • 管理员 / 业务员 / 配送员 / 财务 / 收款角色分离
  • 菜单 / 按钮 / 接口三层权限逐项绑定强制校验
API · Go 服务端

284 路由业务引擎

JWT 鉴权 + 多租户中间件。

  • 所有经销商数据以 supplier_id 自动隔离
  • PostgreSQL 64 张业务表,金额全链路以「分」存储
  • Redis 承担 Token、订单号序列与防重
Job · 后台任务与触达

主动运营体系

goroutine 定时扫描。

  • 低库存预警每 5 分钟扫描(按吨阈值)
  • 一客多销每小时扫描,保护客户归属
  • 异步导出任务中心(重启自动恢复)+ 微信订阅消息推送
Highlights

行业深度方案

🧱
钢材四类商品模型板/管/线/材按类校验尺寸字段,规格文本自动拼接,理计/磅计双计重,吨价以「分」精确存储
📊
FIFO 批次成本核算入库批次成本一经确认不可改,出库先进先出自动摊成本,退货按原批次回库,全程禁止负库存
📝
一单四据代采作业流代客下单一次录入,同时生成订单、成品单、余料补录与借货单,支持纯借货订单
♻️
余料闭环管理切割剩余登记回库、可手动创建、按数量标记使用,边角料变回资产
🏷️
一客一价 + 价格快照按「客户 × 商品」维护专属价并支持批量调价,报价不再靠销售记忆,快照固化可审计
💰
多渠道收款凭据微信/支付宝/现金/商户码分渠道多笔收款,凭据图片留底并 zip 打包下载
🔔
主动预警体系低库存 5 分钟扫描、一客多销每小时扫描防内部抢单,新订单微信订阅消息实时推送
🧪
工程化质量保障73 个后端单元测试文件覆盖状态机/FIFO/RBAC,Playwright 三档 E2E 巡检,4 周完成行业化重塑
Tech Stack

技术栈

后端 Backend

Go 1.25 / Gin / GORMPostgreSQL(64 张业务表)RedisJWT 多租户鉴权13 位短订单号(日序号防遍历)

前端 Frontend

Vben Admin v5Vue 3 + TypeScriptAnt Design Vue 4Vite / pnpm monorepo平台端 + 经销商端同一 SPA 双入口

质量与工程 Quality

73 个 Go 单测文件(SQLite 内存库)Playwright 三档 E2E金额以「分」整数存储三层 RBAC 接口强制校验数据库变更日期化追加可追溯

集成与交付 Integrations

阿里云 OSS(图片校验 + 缩略图)headless Chromium 合同 PDFexcelize 异步报表导出微信小程序订阅消息租户数据清理 / 权限审计运维工具
Screenshots

界面实录

以下均为生产环境真实界面截图 · 点击查看完整大图