# wms

**Repository Path**: HVC511218/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-15
- **Last Updated**: 2026-01-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WMS-System 仓储管理系统

## 项目简介

WMS-System是一个基于Spring Boot + Vue 3开发的企业级仓储管理系统，旨在为企业提供高效、便捷、智能的仓库管理解决方案。系统涵盖了仓库管理、产品管理、库存管理、出入库管理、客户管理等核心功能，支持多仓库、多库区、多货位管理，能够满足不同规模企业的仓储管理需求。

## 技术栈

### 后端技术栈
| 技术 | 版本 | 用途 |
|------|------|------|
| Spring Boot | 2.7.15 | 后端框架 |
| MyBatis Plus | 3.5.3.1 | ORM框架 |
| Shiro | 1.9.1 | 安全框架 |
| JWT | 0.9.1 | 认证机制 |
| MySQL | 8.0.33 | 数据库 |
| Maven | 3.8.8 | 构建工具 |

### 前端技术栈
| 技术 | 版本 | 用途 |
|------|------|------|
| Vue | 3.2.47 | 前端框架 |
| Element Plus | 2.3.8 | UI组件库 |
| Axios | 1.4.0 | HTTP客户端 |
| Vue Router | 4.2.4 | 路由管理 |
| Vuex | 4.1.0 | 状态管理 |
| Vite | 4.4.9 | 构建工具 |

## 系统架构

### 整体架构
- **前后端分离**：前端和后端完全分离，通过RESTful API进行通信
- **分层设计**：后端采用Controller-Service-Mapper分层架构，职责明确
- **模块化设计**：按功能模块划分代码，便于维护和扩展
- **安全认证**：基于Shiro + JWT的认证授权机制

### 核心功能模块

```mermaid
graph TD
    A[WMS系统] --> B[用户及系统管理]
    A --> C[仓库管理]
    A --> D[产品管理]
    A --> E[库存模块]
    A --> F[出入库管理]
    A --> G[客户与首页模块]
    
    B --> B1[用户管理]
    B --> B2[角色管理]
    B --> B3[权限管理]
    B --> B4[系统参数配置]
    B --> B5[系统字典管理]
    
    C --> C1[仓库基本信息管理]
    C --> C2[库区管理]
    C --> C3[货架管理]
    C --> C4[库位管理]
    
    D --> D1[产品分类管理]
    D --> D2[产品SKU管理]
    D --> D3[产品标签管理]
    D --> D4[产品单位管理]
    
    E --> E1[库存查询]
    E --> E2[库存盘点]
    E --> E3[库存预警]
    E --> E4[库存变动记录]
    
    F --> F1[入库单管理]
    F --> F2[出库单管理]
    F --> F3[收货任务管理]
    F --> F4[拣货任务管理]
    
    G --> G1[客户管理]
    G --> G2[系统首页]
    G --> G3[数据看板]
```

## 项目结构

```
WMS-System/
├── .idea/                                # IDEA项目配置
├── database/                             # 数据库相关文件
│   └── wms-test.sql                      # 测试数据库脚本
├── wms-backend/                          # Spring Boot后端
│   ├── src/                              # 源代码
│   │   ├── main/                         # 主代码
│   │   │   ├── java/                     # Java代码
│   │   │   │   └── com/wms/              # 包名
│   │   │   │       ├── config/           # 配置类
│   │   │   │       ├── controller/       # 控制器层
│   │   │   │       ├── dto/              # 数据传输对象
│   │   │   │       ├── entity/           # 实体类
│   │   │   │       ├── mapper/           # MyBatis映射接口
│   │   │   │       ├── service/          # 业务逻辑层
│   │   │   │       │   └── impl/         # 业务逻辑实现
│   │   │   │       ├── utils/            # 工具类
│   │   │   │       ├── vo/               # 视图对象
│   │   │   │       └── WmsApplication.java # 启动类
│   │   │   └── resources/                # 资源文件
│   │   │       ├── mapper/               # MyBatis XML映射文件
│   │   │       └── application.yml       # 应用配置
│   │   └── test/                         # 测试代码
│   │       └── java/                     # 测试Java代码
│   ├── target/                           # 构建输出目录
│   └── pom.xml                           # Maven配置文件
├── wms-frontend/                         # Vue 3前端
│   ├── dist/                             # 构建输出目录
│   ├── src/                              # Vue源代码
│   │   ├── api/                          # API请求配置
│   │   ├── router/                       # 路由配置
│   │   ├── store/                        # Vuex状态管理
│   │   ├── views/                        # 页面组件
│   │   ├── App.vue                       # 根组件
│   │   └── main.js                       # 入口文件
│   ├── inventory_sample_data.md          # 库存示例数据
│   ├── picking-task-list.json            # 拣货任务列表数据
│   ├── package-lock.json                 # 依赖锁文件
│   ├── package.json                      # 依赖配置
│   └── vue.config.js                     # Vue配置
└── README.md                             # 项目说明文档
```

## 环境要求

| 环境 | 版本 | 说明 |
|------|------|------|
| JDK | 1.8+ | Java开发环境 |
| MySQL | 8.0+ | 数据库 |
| Node.js | 14+ | 前端开发环境 |
| Maven | 3.6+ | 后端构建工具 |


## 快速开始

### 1. 克隆项目

```bash
git clone https://github.com/your-username/WMS-System.git
cd WMS-System
```

### 2. 数据库初始化

1. **创建数据库**
   ```sql
   CREATE DATABASE wms DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
   ```

2. **导入数据库脚本**
   ```bash
   mysql -u root -p wms < database/wms-test.sql
   ```

### 3. 配置修改

1. **后端配置修改**
   - 编辑 `wms-backend/src/main/resources/application.yml`
   - 修改数据库连接信息：
     ```yaml
     spring:
       datasource:
         url: jdbc:mysql://localhost:3306/wms?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=UTC
         username: root
         password: your-password
     ```

2. **前端配置修改**
   - 编辑 `wms-frontend/vue.config.js`
   - 修改后端API地址（如果需要）：
     ```javascript
     devServer: {
       proxy: {
         '/api': {
           target: 'http://localhost:8080',
           changeOrigin: true
         }
       }
     }
     ```

### 4. 启动项目

#### 启动后端

```bash
cd wms-backend
mvn spring-boot:run
```

后端服务将在 `http://localhost:8080` 启动

#### 启动前端

```bash
cd wms-frontend
npm install  # 首次启动需要安装依赖
npm run serve
```

前端服务将在 `http://localhost:8081` 启动

### 5. 访问系统

1. 打开浏览器，访问 `http://localhost:8081`
2. 默认登录账号：
   - 用户名：admin
   - 密码：123456

## 核心功能

### 1. 用户及系统管理
- **用户管理**：支持用户的增删改查、密码重置、角色分配
- **角色管理**：支持角色的创建、修改、删除，权限分配
- **权限管理**：基于角色的细粒度权限控制
- **系统参数配置**：支持系统全局参数的配置
- **系统字典管理**：管理系统中使用的各种字典数据

### 2. 仓库管理
- **仓库基本信息管理**：仓库的增删改查、状态管理
- **库区管理**：库区的增删改查、归属管理
- **货架管理**：货架的增删改查、位置管理
- **库位管理**：库位的增删改查、状态管理

### 3. 产品管理
- **产品分类管理**：产品分类的层级管理
- **产品SKU管理**：产品最小库存单位的管理
- **产品标签管理**：产品标签的增删改查、关联管理
- **产品单位管理**：产品计量单位的管理，支持单位换算

### 4. 库存模块
- **库存查询**：多维度的库存查询，支持按产品、仓库、库位等查询
- **库存盘点**：支持库存盘点任务的创建、执行、差异处理
- **库存预警**：库存不足、过期等情况的预警通知
- **库存变动记录**：所有库存变动的详细记录

### 5. 出入库管理
- **入库单管理**：入库单的创建、审核、执行、关闭
- **出库单管理**：出库单的创建、审核、执行、关闭
- **收货任务管理**：入库单分解为收货任务，支持任务分配和执行
- **拣货任务管理**：出库单分解为拣货任务，支持任务分配、执行和完成

### 6. 客户与首页模块
- **客户管理**：客户信息的增删改查
- **系统首页**：系统概览信息，包括库存总量、出入库统计等
- **数据看板**：直观的数据可视化展示，支持多维度分析

## API文档

系统提供了完整的RESTful API接口，可通过Swagger UI进行访问和测试：

- **本地访问**：`http://localhost:8080/swagger-ui.html`
- **生产环境**：`http://<server-ip>:<server-port>/swagger-ui.html`

## 开发指南

### 后端开发
1. 遵循RESTful API设计规范
2. 控制器层返回统一的响应格式
3. 业务逻辑写在Service层
4. 使用DTO和VO进行数据传输
5. 编写单元测试和集成测试

### 前端开发
1. 遵循Vue 3 Composition API规范
2. 组件化开发，提高组件复用性
3. 使用Vuex管理全局状态
4. 统一的API请求处理
5. 响应式设计，适配不同屏幕尺寸