1. 方案概述

1.1 项目背景

本方案基于开源仓储系统GreaterWMS进行二次开发，面向三方物流企业(3PL)，解决企业多仓库、多配送网点、一车多仓串联装卸、干线+末端多终端配送、配送时效管控、冷链温控、商品批次效期管控、多货主租户隔离全业务场景。

系统完全开源无版权费用，基于Apache2.0协议，支持私有化部署、数据自主管控，适配常温仓、冷藏仓、冷冻仓混合仓储模式，适配生鲜、食品、医药、冷链化工等严格效期管控行业。

1.2 建设目标

1. 多仓集群管控：物理多仓、网点前置仓统一平台管理，数据隔离+全局可视；

2. 一车多仓串装卸：原生Milk-Run能力改造升级，实现干线车辆依次停靠多仓装卸货；

3. 冷链全链路管控：冷库+冷藏车IoT温控、超温报警、温度追溯；

4. 商品效期管控：批次管理、FEFO优先出库、临期冻结、过期拦截；

5. 配送时效SLA：全链路节点计时、超时预警、时效考核报表；

6. 多终端协同：管理后台、PDA、司机APP、网点终端、货主小程序；

7. 三方物流租户隔离：多货主、多结算、独立数据、独立权限。

1.3 适用范围

三方物流公司、冷链仓储公司、区域配送企业、多网点连锁配送企业，支持常温、冷藏、冷冻混合业态。

2. 总体技术架构（可直接落地）

2.1 技术栈（完全沿用原项目，无新增复杂技术）

2.1.1 后端技术栈

• 核心框架：Django 3.1 + Django REST Framework（原生保留）

• 异步通信：Daphne ASGI + WebSocket（实时库存、物流节点推送）

• 数据库：MySQL8.0（替换原生SQLite，支持高并发多仓）

• 定时任务：APScheduler（波次拣货、时效检测、库存预警）

• 通信协议：RESTful API + MQTT（IoT温控硬件对接）

• 中间件：Redis（缓存、令牌、实时消息）

• 部署服务：Nginx + Supervisor + Docker

2.1.2 前端技术栈

• 前端框架：Quasar 1.7.2 + Vue2.6（原生保留）

• 多端编译：同一套代码编译Web、安卓APP、PDA程序

• 小程序：原生微信小程序（调用后端API）

2.2 系统分层架构

架构不重构、只扩展，最大程度保留原生GreaterWMS内核，降低开发成本

1. 基础设施层：服务器、冷库温控传感器、车载GPS温湿度终端、PDA、打印设备；

2. 数据持久层：MySQL主从、Redis缓存、文件存储；

3. 核心业务层：原生WMS内核（库存、出入库、库位）；

4. 扩展业务层：多仓管理、冷链温控、TMS运输、串配调度、时效管控、结算；

5. 终端接入层：后台管理、PDA、司机APP、网点端、货主小程序；

6. 对外接口层：开放API，对接ERP、财务系统、硬件IoT平台。

2.3 网络部署架构

• 公有云：部署主业务系统、数据库、MQTT服务、消息推送服务；

• 本地机房：各仓库部署内网PDA、扫码设备、温控采集终端；

• 通信方式：4G/5G+内网局域网，车载设备4G实时上传定位与温度；

• 安全策略：HTTPS+WSS、Token鉴权、设备白名单、数据加密。

3. 核心功能设计（基于原生代码改造，可开发）

3.1 基础底座改造（必须修改原生代码）

3.1.1 多仓+网点改造

原生限制：仅第一个仓库生效，本次改造解除限制。

1. 新增仓库类型：中心冷链仓、常温储备仓、前置配送网点；

2. 新增温区字段：冷冻(-18℃)、冷藏(2~8℃)、恒温、常温；

3. 基于APPID实现货主隔离，一个货主可绑定N个仓库/网点；

4. 全局库存看板：跨仓库存汇总、在途库存、网点暂存库存。

3.1.2 三方物流租户体系

沿用原生OPENID+APPID机制，适配3PL多货主：

• APPID：货主ID（数据组隔离）；

• OPENID：子账号唯一标识；

• 新增货主结算台账、仓储费率、运输费率、温控服务费。

3.2 商品效期+冷链管控模块

3.2.1 商品档案改造

新增数据库字段（goods表扩展）：

• 管控类型：批次管控/效期管控/序列号管控；

• 储存温区：必填，绑定仓库温区；

• 预警天数：临期提前预警天数；

• 允许混放：禁止不同温区商品混放。

3.2.2 全链路效期逻辑

1. 入库：强制录入生产日期、失效日期、批次编码、入库温度；

2. 上架：系统自动推荐同温区空库位，禁止错温区上架；

3. 库存：自动标记临期商品、冻结过期商品不可出库；

4. 出库：强制FEFO（效期优先），PDA拦截过期、临期管控商品；

5. 盘点：单独生成效期盘点报表。

3.2.3 IoT冷链温控系统

1. 冷库：每区域部署温湿度传感器，MQTT上传数据，1分钟采集一次；

2. 运输：冷藏车搭载GPS+温度终端，实时上传位置、车厢温度；

3. 异常处理：超温自动弹窗、短信、小程序推送报警；

4. 追溯报表：商品入库-在库-装车-在途-签收全温度链路记录。

3.3 一车多仓串联装卸（核心业务，升级原生Milk-Run）

3.3.1 业务定义

同一台干线车辆，按照规划路线，依次停靠A仓→B仓→C仓，依次完成卸货、拣货、装车，最终配送至多网点/客户，是三方物流干线标配模式。

3.3.2 系统执行流程

1. 调度创建串配运输任务，勾选途经仓库、停靠顺序；

2. 系统根据仓库生成独立拣货单，波次合并；

3. 车辆到达仓库，PDA扫码确认到仓；

4. 当前仓库完成拣货、验货、装车、封签；

5. 自动跳转下一仓库，重复装卸流程；

6. 全部仓库完成，干线发车，驶向末端配送网点；

7. 网点分拣后，末端司机多点配送签收。

3.3.3 系统改造点

• 新增运输任务表、停靠站点表；

• 原生DN出库单绑定运输车辆、停靠顺序；

• 每仓独立装车确认，防止串货、漏装；

• 支持同车多温区货物混装（车辆为双温/多温冷藏车）。

3.4 配送时效SLA管控模块

3.4.1 时效节点（全链路计时）

1. 下单时间 → 审核时间 → 拣货开始 → 装车完成 → 干线发车 → 到达网点 → 末端派送 → 客户签收；

2. 每个节点配置标准耗时，超时系统自动标红预警。

3.4.2 时效规则配置

• 配送类型：当日达、次日达、定时达、特惠配送；

• 区域时效：省内、跨省、同城网点配送；

• 考核报表：司机时效达成率、仓库出库延误率、网点滞留时长。

3.5 多终端协同体系

终端类型	使用人员	核心功能
Web管理后台	管理员、调度、财务、货主	系统配置、多仓管理、调度排班、结算对账、报表分析、温控监控
仓库PDA	仓管员、拣货员	收货、上架、拣货、装车、盘点、效期校验、扫码封车
司机APP(安卓)	干线/末端司机	路线查看、多仓停靠、在途温控、签收上传、异常报备
网点终端	网点管理员	到货验收、暂存管理、二次分拣、末端派单
货主小程序	货主、客户	库存查询、物流轨迹、温度追溯、效期查看、对账确认

4. 数据库改造方案（最小改动，不破坏原生表）

原则：绝不修改原生核心表字段，全部新增扩展表，方便后续升级原版代码

4.1 新增扩展数据表

1. wms_warehouse_ext：仓库扩展表（温区、网点类型、地理位置）；

2. wms_goods_valid：商品效期管控表（批次、生产日期、失效日期、储存温度）；

3. tms_transport：运输主表（串配任务、车辆、司机、路线）；

4. tms_station：停靠站点表（多仓停靠顺序、装卸时间）；

5. iot_temperature：温控记录表（冷库、车辆温度）；

6. sla_time_record：时效节点记录表；

7. tenant_bill：货主结算账单表。

5. 硬件适配清单（可直接采购）

硬件名称	用途	技术要求
安卓工业PDA	仓内扫码作业	安卓10+、蓝牙扫码、离线缓存
冷库温湿度传感器	冷库实时测温	4G/MQTT、低温防水、精度±0.3℃
车载GPS温控终端	冷藏车监控	定位+双探头测温、断电报警
热敏打印机	标签、单据打印	USB/蓝牙、支持批次效期标签
冷链封签	装车封车防篡改	一次性防伪、扫码记录

6. 部署安装方案（生产环境，一键部署）

6.1 服务器配置最低要求

• CPU：4核

• 内存：8G

• 硬盘：100G SSD

• 系统：Ubuntu 20.04

6.2 部署命令（沿用原生，无复杂修改）

# 克隆官方源码 git clone https://gitee.com/sounshu/GreaterWMS.git # 安装依赖 pip install -r requirements.txt # 数据库迁移 python manage.py makemigrations python manage.py migrate # 启动异步服务 daphne -p 8008 greaterwms.asgi:application # 生产守护进程 supervisorctl start greaterwms # Nginx反向代理 + WebSocket配置

6.3 上线环境要求

1. 关闭Django-silk（防止生产数据泄露）；

2. 修改baseurl、wsurl为公网域名；

3. 开启SSL证书，采用HTTPS+WSS；

4. 定时备份MySQL数据库，每日凌晨自动备份。

7. 实施阶段规划（落地工期）

7.1 第一阶段（1个月）基础改造

• 原生代码部署、多仓限制解除；

• 商品效期、批次功能开发；

• PDA适配、基础出入库流程调试。

7.2 第二阶段（1.5个月）冷链+串配

• IoT温控对接、冷库+车载温度采集；

• 一车多仓串联装卸逻辑开发；

• 干线运输、司机APP开发编译。

7.3 第三阶段（1.5个月）时效+终端+结算

• SLA时效管控、超时预警；

• 网点终端、货主小程序开发；

• 租户结算、财务报表、数据看板。

8. 方案优势（商业对比）

1. 零版权成本：核心WMS永久开源商用，无年费、无节点费；

2. 最小侵入改造：不改动原生核心代码，后期可无缝升级官方新版本；

3. 适配三方物流：天然多租户、多仓、隔离数据，适配货主托管；

4. 冷链专业管控：效期+温控+追溯一体化，满足食品医药合规；

5. 一车多仓成熟：基于官方Milk-Run机制改造，业务逻辑稳定；

6. 多端统一技术栈：无需多套开发语言，维护成本极低。

9. 风险控制与注意事项

• 禁止直接修改原生models核心表，全部使用扩展表；

• 生产环境必须关闭Django Silk调试工具；

• 冷链硬件必须采用MQTT标准协议，方便后期替换硬件厂商；

• 所有运输、温度、效期数据永久留存，不可物理删除，用于合规追溯；

• 多仓部署必须做好网络互通，WebSocket保证实时库存同步。

10. 交付产物清单

1. 改造后完整源代码（可直接部署）；

2. 数据库扩展设计文档；

3. 服务器部署手册；

4. PDA、APP、小程序操作手册；

5. 硬件对接协议文档；

6. 全部业务流程图+架构图。