# wms

**Repository Path**: xiaoker/wms

## Basic Information

- **Project Name**: wms
- **Description**: RuoYi-WMS 是一套面向第三方仓储（3PL）与自有仓库的仓储管理系统，在若依权限、组织、日志、监控、代码生成等基础设施之上，扩展了完整的仓内作业链路：基础资料 → 入库 → 上架 → 库存 → 拣货 → 下架 → 出库 → 移库 → 盘点 → 计费 → 运输（TMS）→ 报表 / BI。
- **Primary Language**: Java
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2026-07-20
- **Last Updated**: 2026-07-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# wms

#### 介绍
RuoYi-WMS 是一套面向第三方仓储（3PL）与自有仓库的仓储管理系统，在若依权限、组织、日志、监控、代码生成等基础设施之上，扩展了完整的仓内作业链路：基础资料 → 入库 → 上架 → 库存 → 拣货 → 下架 → 出库 → 移库 → 盘点 → 计费 → 运输（TMS）→ 报表 / BI。

#### 目录与文件布局

```
RuoYi-Vue-v3.9.2/
├── pom.xml                     # 父 POM（版本 3.9.2，定义模块与依赖管理）
├── ry.bat / ry.sh              # 一键启动脚本（前端+后端）
├── sql/                        # 数据库初始化脚本（含 sys_config / sys_job 种子）
│   ├── 01_*.sql ... 10_*.sql
│   └── 04_wms_seed.sql         # WMS 参数与定时任务种子
├── ruoyi-admin/                # 启动模块
│   └── src/main/resources/     # application.yml / application-druid.yml
├── ruoyi-framework/            # 框架与安全
├── ruoyi-system/               # 系统管理
├── ruoyi-quartz/               # 调度
├── ruoyi-generator/            # 代码生成
├── ruoyi-common/               # 通用
├── ruoyi-wms/                  # WMS 业务（核心扩展）
│   └── src/main/java/com/ruoyi/wms/{md,wm,ba,tms,wmapi,api,task,util,event,report,wave}
└── ruoyi-ui/                   # 前端 Vue 工程
```

#### 核心能力

| 能力域 | 主要描述 |
|---|---|
| 基础资料 | 货品、客户（货主）、储位（库位）、供应商、仓库/库区/月台、商品类型/分类、计量单位、托盘 |
| 入库作业 | 入库通知单、收货质检、上架、入库流水 |
| 出库作业 | 出库通知单、拣货任务、下架、装车复核、回单、发货/打包 |
| 库存管理 | 实时库存查询、库存调整（增/减）、库存冻结/解冻、库存预警 |
| 库内作业 | 移库（移储）、盘点（计划→实盘→过账→差异） |
| 计费管理 | 计费规则配置、按客户与期间生成结算单（计费引擎） |
| 运输管理（TMS） | 运输订单、状态机流转、运费自动计算、车辆/到账 |
| 波次作业 | 波次配置、波次下架、波次分拣 |
| 报表与 BI | 上下架/收货/历史库存/期出入库报表，BI 大屏 |
| 集成 | PDA 开放接口、外部系统 REST、订单/RFID/重量开放接口、WCS/SAP/微信推送 |

#### 部署架构

```
┌─────────────┐      HTTPS/JSON       ┌──────────────────────────────┐
│  ruoyi-ui   │ ───────────────────▶ │   ruoyi-admin (Spring Boot)  │
│  (Vue SPA)  │                      │  端口 8080, context-path /   │
└─────────────┘                      └──────────┬───────────┬────────┘
                                                 │           │
                                        ┌────────▼───┐   ┌───▼────────┐
                                        │   MySQL    │   │   Redis    │
                                        │   ruoyi库  │   │  (缓存/JWT)│
                                        └────────────┘   └────────────┘
                                                 ▲
                              WCS / SAP / 微信 ──┴── 外部推送 (HttpPushUtil)
```

- **表示层**：ruoyi-ui（Vue 2 + Element-UI），通过 `Authorization` 头携带 JWT 调用后端。
- **服务层**：ruoyi-admin 聚合所有模块，提供 RESTful API。
- **存储层**：MySQL 持久化业务与系统数据；Redis 缓存字典/配置并存储 JWT 与验证码。
- **外部集成**：通过 `HttpPushUtil` 向 WCS/SAP/微信推送，地址由参数表配置。

#### 工程模块划分

工程为 Maven 多模块聚合项目，根 `pom.xml` 的 `packaging` 为 `pom`，定义 7 个子模块：

| 模块 | artifactId | 职责 |
|---|---|---|
| 启动模块 | `ruoyi-admin` | 应用入口（`RuoYiApplication`）、统一配置、打包为可执行 jar/war |
| 框架模块 | `ruoyi-framework` | 安全（Spring Security + JWT）、Redis、MyBatis、Druid、AOP（数据权限/日志/限流） |
| 系统模块 | `ruoyi-system` | 系统管理域模型与 Mapper（用户/角色/菜单/部门/字典/日志等） |
| 调度模块 | `ruoyi-quartz` | 定时任务调度（Quartz）与管理接口 |
| 代码生成 | `ruoyi-generator` | 基于表结构生成前后端代码 |
| 通用模块 | `ruoyi-common` | 通用工具、常量、注解、基础 DTO |
| **WMS 业务** | `ruoyi-wms` | 仓储全部业务（基础资料/作业/计费/TMS/报表/集成） |

> **Important**：`ruoyi-wms` 是本工程相对原生若依的核心扩展模块，包含约 80 个 Spring MVC 控制器。


#### 运行时与框架版本

> **Note**：版本号取自工程根 `pom.xml` 的 `<properties>` 与 `<dependencyManagement>`，均经核对。

| 组件 | 版本 | 说明 |
|---|---|---|
| Java | 17 | `java.version=17`，编译器 source/target=17 |
| Spring Boot | 4.0.5 | 由 `spring-boot-dependencies` BOM 导入（本工程定制 BOM） |
| Spring Framework | 随 Boot 4.0.5 托管 | 未单独声明版本 |
| Spring Security | 随 Boot 托管（约 7.0.x） | `ruoyi-framework` 显式引入 `spring-boot-starter-security` |
| MyBatis-Spring-Boot | 4.0.1 | ORM |
| PageHelper | 2.1.1 | 物理分页 |
| Druid | 1.2.28 | 连接池 + 监控（`/druid/**`） |
| Fastjson2 | 2.0.61 | JSON 解析 |
| JWT（jjwt） | 0.9.1 | 令牌签发/校验 |
| Kaptcha | 2.3.3 | 验证码 |
| OSHI | 6.10.0 | 服务器监控 |
| POI | 4.1.2 | Excel 导入导出 |
| Velocity | 2.3 | 代码生成模板 |
| Yauaa | 8.1.0 | 客户端解析 |
| springdoc-openapi | 3.0.2 | OpenAPI 3 文档（`/v3/api-docs`、`/swagger-ui.html`） |
| Quartz | 随 Boot 托管（约 2.5.x） | 定时调度 |