一、系统概述

系统名称：JeeWMS（吉易仓储管理系统） 系统简介：JeeWMS 是基于 SpringBoot+Vue 开发的开源仓储管理系统，支持多货主、多仓库的第三方物流（3PL）仓储业务，同时适配工厂自有仓库管理。系统采用前后端分离架构，配套 UniApp 开发的 PDA 移动端，支持条码 / RFID 扫码、批次效期管理、波次拣货、仓储计费，可对接 OMS 订单系统、TMS 运输系统、ERP 系统，是毕业设计非常热门的 Java 仓储项目。

技术栈：SpringBoot 后端 + Vue 前端 + UniApp 移动端；数据库 MySQL，缓存 Redis，支持 Docker 容器部署。

适用场景：第三方物流 3PL 仓库、电商仓库、制造业原料 / 成品仓、冷链效期类货物仓储。 核心目标：实现仓库收货、质检、上架、拣货、复核、出库、盘点、库存预警、仓储费用结算全流程数字化管理，支持多货主隔离管理，满足第三方物流的仓储计费业务需求。

二、系统主要功能

1. 基础资料管理（系统初始化模块）

· 仓库库位管理：多仓库维护，库区、库位自定义编码，支持货架层级管理，划分收货区、质检区、存储区、拣选区、不良品区。

· 商品档案管理：物料编码、名称、规格、单位、条码、批次管理、效期管理、保质期预警，支持多规格多包装转换。

· 货主、供应商、客户档案：支持多货主独立隔离数据，适合第三方物流。

· 用户角色权限：管理员、仓库主管、拣货员、财务、货主查询账号；精细化数据权限（按货主、仓库隔离），完整操作日志。

· 系统参数配置：单据编号规则、库存策略、计费模板、条码打印模板。

2. 进货入库管理

· 采购入库 / 货主入库：订单导入或手工创建入库单，支持预约收货。

· 质检管理：收货后进入质检流程，区分合格、不合格品，不良品入不良库位。

· 上架管理：PDA 扫码推荐库位，执行上架操作，入库完成自动增加库存。

· 入库单据查询、打印、导出，记录入库流水。

3. 出库发货管理（特色波次拣货）

· 订单接收：可对接 OMS 自动拉取订单，也可手工新建出库单。

· 波次拣货：订单合并生成波次任务，支持按库区、货主、配送路线创建波次，提升拣货效率。

· 拣货、复核流程：PDA 扫码拣货，拣货完成后复核校验，复核通过才允许出库，防止错发。

· 出库单据管理、出库流水追溯。

4. 库存管理（核心模块）

· 库存查询：按仓库、库位、货品、批次、有效期查询库存，多货主数据隔离。

· 效期预警：临近过期、过期商品标红预警，适合食品、医药类仓储。

· 库内移库：库位之间转移货物，生成移库单据。

· 库存盘点：支持循环盘点、动态盘点、全盘，PDA 扫码盘点，系统对比账面库存，生成盘盈盘亏单，审核后调整库存。

· 库存冻结：可冻结指定批次库存，禁止出库。

5. PDA 移动端作业（UniApp）

· 独立 UniApp 手持端，可安装在安卓 PDA 设备；

· 功能：收货、质检、上架、波次拣货、复核、盘点、移库、库存查询；

· 支持一维码、二维码扫码，离线缓存，弱网环境可暂存数据。

6. 仓储计费模块（3PL 特色）

· 计费模板配置：仓储租赁费、入库作业费、出库作业费、装卸费等；

· 自动计费：根据货主出入库量、占用库位自动生成费用；

· 账单管理：生成货主对账单，账单核对、导出。

7. 单据中心与报表统计

· 单据统一管理：入库单、出库单、盘点单、移库单检索、打印、Excel 导出。

· 库存台账：记录每一笔收发流水，货品流转全程可追溯。

· 可视化驾驶舱：库存总量、出入库趋势、库位使用率、效期预警卡片、货主业务占比图表。

8. 系统集成接口

RESTful API 接口，支持对接 OMS 订单、TMS 运输、ERP 系统，实现订单、仓、运一体化打通。

三、系统优点 & 缺点

✅ 优点

1. 原生支持多货主 + 仓储计费，是少见的 3PL 第三方物流 WMS，业务场景丰富，毕业设计亮点突出；

2. Java SpringBoot 成熟技术栈，国内文档丰富，二次开发上手简单；

3. 配套完整 UniApp 的 PDA 移动端，不是简单网页 H5，支持离线缓存扫码作业；

4. 内置波次拣货、效期批次管理，贴近真实企业仓储业务；

5. Docker 一键部署，快速搭建演示环境；

6. 数据权限隔离，不同货主只能查看自己的库存数据，满足第三方物流安全需求。

❌ 缺点

1. 前端 UI 风格偏传统企业后台，炫酷大屏可视化能力较弱；

2. 系统模块多，配置项复杂，新手学习成本高于简易 WMS；

3. 高货主、海量订单场景下，数据库查询性能需要优化；

4. AGV、立体库等自动化设备仅预留接口，无原生驱动；

5. 计费模型固定，复杂阶梯报价需要二次开发；

6. 报表自定义能力有限，复杂财务报表需要代码改造。

四、保姆级部署教程

推荐环境：Ubuntu20.04，最低 2 核 4G，推荐 4 核 8G；两种部署方式：Docker Compose 一键部署（毕设演示）、源码手动部署（二次开发） 依赖组件：JDK1.8、MySQL8.0、Redis、Maven、Nginx

方式一：Docker Compose 一键部署（推荐）

步骤 1：安装 Docker 与 docker-compose

sudo apt update && sudo apt upgrade -y

sudo apt install git curl -y

curl -fsSL https://get.docker.com | sh

sudo apt install docker-compose -y

sudo systemctl start docker

sudo systemctl enable docker

步骤 2：拉取 JeeWMS 源码

git clone https://gitee.com/jeewms/jeewms.git

cd jeewms

步骤 3：启动容器

docker-compose up -d

容器自动拉起 MySQL、Redis、后端服务。

· Web 访问地址：http://服务器IP:8080

· 默认管理员账号密码：admin / 123456

查看容器状态与日志

docker-compose ps

docker-compose logs -f

方式二：源码手动部署（适合二次开发）

步骤 1：安装 JDK1.8

sudo apt install openjdk-8-jdk -y

java -version

步骤 2：安装 MySQL8.0 并创建数据库

sudo apt install mysql-server -y

sudo systemctl start mysql

sudo systemctl enable mysql

登录 MySQL 执行 SQL 脚本：

CREATE DATABASE jeewms DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

CREATE USER 'jeewms'@'%' IDENTIFIED BY 'Jee@123456';

GRANT ALL PRIVILEGES ON jeewms.* TO 'jeewms'@'%';

FLUSH PRIVILEGES;

导入项目数据库脚本

mysql -u jeewms -p jeewms < jeewms.sql

步骤 3：安装 Redis

sudo apt install redis-server -y

sudo systemctl start redis

sudo systemctl enable redis

redis-cli ping

步骤 4：后端 SpringBoot 配置、打包启动

修改application.yml，配置 MySQL 和 Redis 连接信息

spring:

 datasource:

   url: jdbc:mysql://127.0.0.1:3306/jeewms

   username: jeewms

   password: Jee@123456

 redis:

   host: 127.0.0.1

   port: 6379

Maven 打包并启动服务

sudo apt install maven -y

mvn clean package -DskipTests

java -run jeewms.jar --server.port=8080

步骤 5：Vue 前端部署

cd vue

sudo apt install nodejs npm -y

npm install

npm run build

Nginx 托管前端 dist 静态资源，反向代理后端接口。 Nginx 配置示例：

server {

   listen 80;

   server_name _;

   root /home/jeewms/vue/dist;

   index index.html;

   location /api/ {

       proxy_pass http://127.0.0.1:8080/api/;

   }

}

重启 Nginx

sudo systemctl restart nginx

五、系统基础操作流程

1. 系统初始化：管理员登录，维护仓库、库区库位；录入货品档案，开启批次 / 效期管理；维护货主、供应商、客户；创建操作员并分配权限。

2. 入库业务：创建入库单，仓库收货，执行质检；质检合格后，PDA 扫码完成上架，库存自动增加。

3. 出库业务：导入订单，创建波次拣货任务；拣货员使用 PDA 拣货，复核人员复核；复核完成，执行出库，扣减库存。

4. 库存盘点：新建盘点任务，PDA 扫码盘点；系统对比账面库存，生成盘盈盘亏单据，审核后更新库存。

5. 仓储计费：配置货主计费模板，系统自动计算仓储作业费用，生成货主账单。

6. 报表查询：导出库存台账、出入库统计、费用账单报表。

六、常见部署问题排查

1. PDA 移动端无法连接后台：检查服务器防火墙端口放行，确认移动端接口地址为公网 IP，不是 127.0.0.1；

2. 数据库连接报错：核对 MySQL 账号密码，开启远程访问，放行 3306 端口；

3. 单据保存异常：检查 Redis 是否正常运行，定时任务是否启动；

4. Docker 启动失败：查看日志排查端口占用，修改 docker-compose 端口映射；

5. 效期预警不显示：货品档案需要开启效期管理，并且录入保质期信息。