# WMS

**Repository Path**: uinaa/wms

## Basic Information

- **Project Name**: WMS
- **Description**: wms仓储管理系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-12
- **Last Updated**: 2026-01-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WMS仓储管理系统
### :globe_with_meridians: 访问地址: [`http://121.43.154.162:3000`](http://121.43.154.162:3000)


## 系统首页

<img src="https://gitee.com/uinaa/wms/raw/master/RuoYi-Vue-master/首页.png" alt="系统首页" width="350"/>


## 项目简介

本系统是基于RuoYi框架二次开发的仓储管理系统，基于Spring Boot + Vue技术栈，采用前后端分离架构，提供完整的仓储管理解决方案。

### 技术栈

- **后端**: Spring Boot、Spring Security、MyBatis-Plus、Redis、JWT
- **前端**: Vue 3、Element UI、Axios
- **数据库**: MySQL
- **缓存**: Redis

### 核心功能

1. **入库管理**
   - 入库单创建与管理
   - 收货任务分配与执行
   - 智能库位推荐

2. **出库管理**
   - 出库单创建与管理
   - 拣货任务分配与执行
   - 库位精确定位

3. **库存管理**
   - 实时库存查询
   - 库存冻结/解冻

4. **仓储配置**
   - 仓库区域管理
   - 货架管理
   - 库位管理
   - 商品SKU管理

5. **基础数据**
   - 客户管理
   - 商品分类管理
   - 计量单位管理
   - 标签管理

### Redis缓存功能

- **用户会话管理**: 缓存用户登录信息和在线状态
- **验证码存储**: 存储图形验证码和短信验证码
- **数据字典缓存**: 缓存系统数据字典，提高查询效率
- **防重复提交**: 防止用户重复提交表单
- **限流控制**: 控制接口访问频率
- **系统配置缓存**: 缓存系统参数配置信息

## 快速开始

### 环境要求

- JDK 1.8+
- Node.js 14+
- MySQL 5.7+
- Redis 5.0+
- Maven 3.5+

### 后端启动

1. **创建数据库**

```sql
CREATE DATABASE wms CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
```

2. **导入数据库表结构**

执行项目中的SQL文件初始化数据库

3. **配置数据库连接**

修改 `ruoyi-admin/src/main/resources/application-druid.yml` 中的数据库配置

4. **启动后端服务**

```bash
# 进入项目目录
cd RuoYi-Vue-master

# 使用Maven构建项目
mvn clean install

# 启动后端服务
mvn spring-boot:run -pl ruoyi-admin
```

### 前端启动

1. **安装依赖**

```bash
cd ruoyi-ui
npm install
```

2. **启动开发环境**

```bash
npm run dev
```

## 项目结构

```
RuoYi-Vue-master/                # 项目根目录
├── ruoyi-admin/                 # 后端启动模块（核心业务逻辑）
│   └── src/main/java/com/ruoyi/wms  # WMS核心业务代码
│       ├── controller/          # 控制器层
│       ├── domain/              # 实体类
│       ├── mapper/              # 数据访问层
│       └── service/             # 业务逻辑层
└── ruoyi-ui/                    # 前端模块
    └── src/
        ├── api/                 # API接口定义
        ├── assets/              # 静态资源
        ├── components/          # 公共组件
        ├── views/               # 页面视图
        │   └── wms/             # WMS相关页面
        └── router/              # 路由配置
```

## WMS核心模块

### 1. 入库管理模块

- **InboundController**: 入库单管理
- **InboundReceivingTaskController**: 收货任务管理
- 支持入库单创建、收货任务分配、库位智能推荐

### 2. 出库管理模块

- **OutboundController**: 出库单管理
- **OutboundPickingTaskController**: 拣货任务管理
- 支持出库单处理、拣货任务分配、库存扣减

### 3. 库存管理模块

- **InventorySummaryController**: 库存汇总
- **InventoryFreezeController**: 库存冻结管理
- **InventoryWarningController**: 库存预警管理

### 4. 仓储配置模块

- **WarehouseController**: 仓库管理
- **WarehouseZoneController**: 仓库区域管理
- **WarehouseRackController**: 货架管理
- **WarehouseBinController**: 库位管理

## API接口

### 入库相关

- `GET /wms/inbound/list` - 获取入库单列表
- `POST /wms/inbound` - 创建入库单
- `PUT /wms/inbound` - 修改入库单
- `GET /wms/receivingTask/list` - 获取收货任务列表
- `POST /wms/receivingTask/cancel/{taskId}` - 撤销收货任务

### 出库相关

- `GET /wms/outbound/list` - 获取出库单列表
- `PUT /wms/outbound/complete` - 完成出库单
- `GET /wms/pickingTask/list` - 获取拣货任务列表
- `PUT /wms/pickingTask/complete` - 完成拣货任务

## 部署

### 生产环境打包

```bash
# 后端打包
mvn clean package -pl ruoyi-admin -am

# 前端打包
cd ruoyi-ui
npm run build:prod
```