# 生鲜配送供应链管理系统

**Repository Path**: sunplay_admin/go-sxbscm-all

## Basic Information

- **Project Name**: 生鲜配送供应链管理系统
- **Description**: 升鲜宝供应链管理系统是面向生鲜配送的一体化系统平台，核心覆盖云商品库、商品中心、客户与价格体系、客户订单及门店订单（订货→发货→收货）等模块，实现从商品主数据、差异化定价到订单履约的闭环管理。系统按端划分包括：PC后台管理端（全功能管控）、客户订货协同端（小程序/H5下单）、供应商协同端（报价与发货协同）、分拣助手（iPad/安卓平板按商品或客户分拣）、司机配送端（导航与签收）。各端围绕同一套
- **Primary Language**: Go
- **License**: Apache-2.0
- **Default Branch**: dev
- **Homepage**: https://www.cnblogs.com/sunplay
- **GVP Project**: No

## Statistics

- **Stars**: 11
- **Forks**: 0
- **Created**: 2026-11-02
- **Last Updated**: 2026-11-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 生鲜配送, 供应链系统源代码, 集采平台, 食材配送, 门店收银

## README

# 升鲜宝生鲜配送供应链管理系统

升鲜宝是一套面向生鲜配送企业的供应链管理系统，围绕客户订货、采购、仓储、分拣、配送、结算和经营分析，连接企业员工、客户、供应商及配送人员，让业务数据在各环节之间流转。

本仓库是升鲜宝供应链生态的 **Go 重建项目**。项目面向单个企业或集团公司部署，使用 Go 构建后端 API，使用 React、TypeScript 和 Ant Design 构建管理界面，按业务领域逐步实现完整功能。

> **产品目标：已建设完（流程运行简易、流畅），陆续更新中；逻辑完整，实战性强。** 本仓库目前仍在持续建设：登录及部分系统底座已接入，其余业务模块、业务端与集团能力尚需逐步实现和验证。下文包括产品规划，具体实现和生产可用状态请以代码、版本说明及实际测试结果为准。

## 为什么开源

我们希望让每一家生鲜配送公司，都有机会拥有一套属于自己的供应链管理系统。

- **数据自主：**企业可以在符合自身条件的环境中部署和管理系统，掌握业务数据、备份和访问权限。
- **支出清晰：**基于公开代码了解系统组成，结合实际规模评估部署、运维、开发和第三方服务成本。
- **自主扩展：**在统一底座上开展个性化开发，逐步对接企业自己的业务流程、设备和外部系统。
- **共同完善：**让生鲜配送行业的从业者和开发者交流业务经验，共同改进产品。

开源和自主部署并不自动保证数据安全，也不意味着没有运维成本。企业仍需根据实际情况做好服务器、访问控制、密钥、备份、恢复及安全更新。

## 适合谁使用

系统主要面向为餐饮、食堂、商超、门店及其他企业客户提供生鲜和食材配送的企业和集团公司，也可作为希望建设自有供应链系统的开发团队的业务基础。

系统要解决的是配送企业日常经营中的一系列问题：客户如何下单，商品和价格如何维护，采购多少，仓库还有多少库存，订单如何分拣配送，以及每笔业务最终如何结算和分析。

## 业务流程

```text
商品、客户、供应商等基础资料
                ↓
客户订货 → 采购计划与采购 → 入库与库存 → 分拣与发货 → 配送与收货
    ↑                                                   ↓
    └──────────── 退货、差异处理、对账与经营分析 ─────────┘
```

不同企业的采购、库存、配送和结算流程可能不同。各模块应以实际业务规则和部署版本为准，逐步完成配置及定制。

## 系统对标与建设目标

升鲜宝以生鲜配送企业的实际业务为中心，对标用户提出的**树洞破 PHP 生鲜 ERP 系统**及**某麦生鲜配送系统**等同类产品，借鉴行业在订货、采购、分拣、仓储、配送与结算方面的业务流程，逐步建设适合企业或集团自主部署和二次开发的产品。

| 对标领域 | 升鲜宝的建设目标 |
|---|---|
| 客户与订货 | 客户档案、客户专属价格、订货商城、常购商品、订单模板、代客下单及订单跟踪 |
| 采购与供应商 | 供应商档案、商品与报价、订单需求汇总、采购任务、到货验收及采购退货 |
| 仓储与分拣 | 仓库和库位、入出库与盘点，按商品、客户或线路分拣，计重、缺货和差异处理 |
| 配送与售后 | 配送任务、线路、司机、发货、签收、退货和周转物管理 |
| 财务与经营 | 客户和供应商对账、收付款、费用、账期，以及销售、采购、库存和利润分析 |
| 多端协作 | 管理后台、客户订货端、供应商协作端、仓储分拣端、司机端及经营看板 |
| 企业与集团 | 集团及下属组织、业务单元、数据权限、跨组织协作和经营汇总 |
| 自主开发 | 自主部署、可扩展的领域模块、开放 API 和企业个性化开发底座 |

对标用于说明产品规划方向，不表示本项目与上述产品存在合作、隶属关系或功能完全相同。上述目标并非当前版本的功能清单；实现进度以本仓库代码和版本说明为准。

## 企业与集团业务

系统定位于由一个企业或一个集团自主部署和管理，规划覆盖集团总部、子公司、分支机构、部门、门店和仓库等组织与经营单元。集团可按实际业务选择集中管理、分支协作或分级经营，并逐步建设跨组织的数据授权和经营汇总。

- **组织与人员：**维护集团及下属组织、岗位、员工和角色，按职责分配功能权限。
- **基础资料：**按企业治理规则规划商品、客户、供应商、价格、仓库及配送资料的共享和使用范围。
- **业务协同：**支持按组织、仓库和业务单元规划采购、订单履约、配送与结算流程。
- **数据与核算：**按授权范围查看业务数据，规划组织维度的经营报表、往来对账和汇总分析。

集团组织、跨组织权限和汇总等能力属于建设目标，不代表当前版本已经具备完整集团管控或独立法人核算能力。系统不以多租户 SaaS 为前提；集团内部组织与为无关企业提供租户隔离是不同的需求。

## 生鲜配送场景

项目参考生鲜 ERP 和食材配送系统常见业务流程，重点解决商品规格多、价格波动频繁、计重与差异多、时效要求高、损耗难控制及对账繁琐等问题：

- **客户订货：**按客户、门店、协议和配送日期组织商品、报价、订货模板、订单与变更。
- **采购协同：**汇总需求，结合库存和采购规则形成采购任务，跟踪供应商报价、到货和质量验收。
- **仓储分拣：**规划按客户、商品或线路分拣，支持实际重量、缺货、替代、损耗和差异记录。
- **配送交付：**规划配送线路、车辆、司机、发货、签收、退货及周转物管理。
- **财务经营：**按实际业务单据形成客户与供应商往来、收付款、费用、对账和经营分析。
- **食品安全：**规划批次、保质期、供应商资质、检验记录和商品流向追溯。

上述能力是产品规划和业务设计范围，不构成与其他产品的功能等同性承诺；具体能力以本项目实际实现和版本发布说明为准。

## 整体功能版图

| 领域 | 计划覆盖的主要功能 |
|---|---|
| 商品与基础资料 | 商品、SKU、销售单位与卖法、分类、品牌、单位、税率、商品资料和授权范围 |
| 客户管理 | 客户档案、客户组与等级、合同、账期、价格、报价、债务及客户商城配置 |
| 供应商管理 | 供应商档案、商品与 SKU、资质、报价、合同、授权、账号、债务及通知 |
| 采购管理 | 采购申请、采购订单、采购任务、每日采购价、采购退货、采购结算及入库交接 |
| 订单履约 | 客户订单、订单模板、退货、缺货与差异处理、波次、拣货、发货及收货确认 |
| 库存与仓储 | 仓库、库区、货架与库位，库存、入出库、盘点、调拨、成本调整、报损报溢及库存分析 |
| 分拣与配送 | 按客户、商品等维度分拣，配送任务、线路、司机、周转箱及配送相关作业 |
| 财务与对账 | 财务账户、付款方式、收付款、费用、期初、客户及供应商账单与对账 |
| 生产加工 | 配方、BOM、拆分模板、生产单、领料、退料、完工入库及生产报表 |
| 客户经营与招采 | 客户线索、联系人、商机、跟进和拜访，以及招投标、供应商商品及竞价支持 |
| 门店与会员 | 门店资料、门店商品和订单、线下收银、会员、等级、余额、积分、充值及礼品卡 |
| 商城运营 | 客户订货商城、门店线上商城、商品展示、分类、促销、Banner、公告和订单支持 |
| 溯源与车辆 | 溯源码、规则、批次、使用记录，以及车辆、司机、加油、维修、保险等资料 |
| 报表与分析 | 销售、采购、库存、分类、利润、调拨、报损报溢等报表，以及看板和大屏 |
| 系统与组织 | 集团、公司、部门、岗位、人员、角色、菜单、数据与字段权限、脱敏、审计、数据字典和系统配置 |
| 通用能力 | 消息、文件、打印、编码规则、Excel 导入导出、API 管理和 AI 助手 |
| 工作流与运维 | 审批流程、待办任务、流程表单，定时任务、运行日志和系统通知 |

## 系统有哪些端

升鲜宝按不同角色和使用场景规划多个业务端，具体实现和发布进度以各版本为准：

| 业务端 | 主要使用者 | 主要场景 |
|---|---|---|
| 企业 / 集团管理后台 | 管理员、运营、采购、仓库和财务人员 | 组织与基础资料、业务单据、权限配置、对账和报表 |
| 客户订货端 / B2B 商城 | 企业客户及其订货人员 | 浏览商品、查看价格、下单、查看订单及相关通知 |
| 供应商协作端 | 供应商及其业务人员 | 商品资料、报价、采购协作及相关单据 |
| 仓储与分拣作业端 | 仓库、拣货和分拣人员 | 入库、上架、拣货、移库、盘点和分拣作业 |
| 配送与司机端 | 调度、司机及配送人员 | 配送任务、线路、发货与收货相关操作 |
| 门店收银与运营端 | 门店店员和运营人员 | 收银、门店商品、会员和门店订单管理 |
| 门店线上商城 / 会员端 | 消费者及会员 | 商品浏览、下单、会员权益及订单服务 |
| 移动作业端 | 现场业务人员 | 围绕采购、仓库、配送等场景的移动操作 |
| 经营报表与大屏 | 管理者和运营人员 | 查看经营指标、报表和作业看板 |
| 开放 API / 对接端 | 企业技术团队及第三方系统 | 在授权范围内对接业务数据和能力 |

这些名称描述的是**业务角色和使用场景**，不代表每一端都已有独立应用、移动端或开源代码。具体终端形态将在对应模块实现时确定。

## 技术方向

- **后端：**Go、Gin，按领域划分身份、组织、授权和供应链业务模块。
- **前端：**React、TypeScript、Ant Design。
- **数据与缓存：**MySQL、Redis。
- **权限：**面向企业或集团组织架构，逐步建设角色、功能、数据和字段权限，以及敏感数据脱敏与审计。
- **工程质量：**Go 格式化、测试、静态检查和构建，前端格式化、静态检查和构建；使用版本化数据库迁移。

系统按单个企业或集团部署规划，不以多租户 SaaS 为前提。具体依赖版本以项目的 `go.mod`、`go.sum` 和前端锁文件为准。

## 当前进展

目前已建立登录与主界面的初始版本，并正在建设用户权限、组织、字典、审计、数据权限和迁移等基础能力。部分模块仍处于独立开发、测试或待接入阶段；短信服务商、完整业务流程和各业务端尚需逐步实现与联调。

部署、生产安全、兼容性、备份恢复和性能仍需按实际发布版本验证。请勿把正在开发的功能直接用于生产业务。

## 参与项目

欢迎生鲜配送企业、业务专家和开发者参与讨论、反馈问题及贡献代码。提交问题时，建议说明业务场景、使用版本、复现步骤和预期结果；请不要在公开内容中发布客户资料、密码、密钥或其他敏感数据。

如需使用或分发项目，请以仓库中实际提供的开源许可证为准；在许可证明确前，请勿假定特定授权条款。

## 联系方式

**升鲜宝供应链管理系统创始人：余东升**

- 微信：sxbscm2012
- 手机：15382353715
- 邮箱：yds666666@126.com