# wms

**Repository Path**: macca-pacca02/wms

## Basic Information

- **Project Name**: wms
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-01-13
- **Last Updated**: 2026-01-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 仓库管理系统 (WMS)

一个基于前后端分离架构的现代化仓库管理系统，提供完整的仓储管理解决方案。

## 项目简介

本仓库管理系统(WMS)是一个功能完善的仓储管理解决方案，支持库存管理、入库管理、出库管理、仓库管理、客户管理等核心功能。系统采用前后端分离架构，后端使用Spring Boot提供RESTful API，前端使用Vue 3构建现代化的用户界面。

## 技术栈

### 后端技术栈
- **Spring Boot 2.7.4** - 企业级Java应用开发框架
- **MyBatis Plus 3.5.2** - 增强型MyBatis ORM框架
- **Apache Shiro 1.11.0** - 安全框架，提供认证和授权
- **Redis** - 分布式缓存
- **MySQL** - 关系型数据库
- **Druid 1.2.12** - 数据库连接池
- **FastJSON 2.0.14** - JSON处理库
- **Hutool 5.8.8** - Java工具库

### 前端技术栈
- **Vue 3** - 渐进式JavaScript框架
- **Element Plus 2.13.0** - Vue 3 UI组件库
- **Vue Router 4.6.4** - Vue路由管理器
- **Axios 1.13.2** - HTTP客户端
- **Vite 7.2.4** - 前端构建工具

## 功能模块

### 1. 库存管理
- 实时库存查询
- 库存变动记录
- 库存预警
- 库存盘点

### 2. 入库管理
- 入库订单创建与管理
- 入库货物接收
- 入库明细记录

### 3. 出库管理
- 出库订单创建与管理
- 出库货物拣选
- 出库明细记录

### 4. 仓库管理
- 仓库信息管理
- 库区管理
- 库位管理

### 5. 产品管理
- 产品信息管理
- 产品SKU管理
- 产品分类管理

### 6. 客户管理
- 客户信息管理
- 客户订单管理

### 7. 系统管理
- 用户管理
- 角色管理
- 权限管理
- 系统配置

### 8. 数据统计
- 仪表板展示
- 库存统计
- 出入库统计

## 快速开始

### 环境要求

#### 后端环境
- JDK 17+
- Maven 3.3.9+
- MySQL 5.7+
- Redis 3.2+

#### 前端环境
- Node.js 20.19.0+ 或 22.12.0+
- npm 或 yarn

### 安装与运行

#### 1. 克隆项目
```bash
git clone <仓库地址>
cd wms
```

#### 2. 后端部署

1. **配置数据库**
   - 创建MySQL数据库：`CREATE DATABASE wms DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
   - 导入数据库脚本（如果有）

2. **配置应用**
   - 编辑 `backend/src/main/resources/application-dev.yml`
   - 配置数据库连接：
     ```yaml
     spring:
       datasource:
         druid:
           url: jdbc:mysql://localhost:3306/wms?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=GMT%2B8
           username: root
           password: your_password
     ```
   - 配置Redis连接：
     ```yaml
     spring:
       redis:
         host: localhost
         port: 6379
         password: your_redis_password
     ```

3. **运行后端**
   ```bash
   cd backend
   mvn spring-boot:run
   ```

   或打包后运行：
   ```bash
   mvn clean package -Dmaven.test.skip=true
   java -jar target/wms-backend.jar
   ```

#### 3. 前端部署

1. **安装依赖**
   ```bash
   cd frontend
   npm install
   ```

2. **配置前端**
   - 编辑 `frontend/src/api/request.js`（如果存在）配置API基础URL

3. **运行前端开发服务器**
   ```bash
   npm run dev
   ```

4. **构建生产版本**
   ```bash
   npm run build
   ```

### 访问系统

- 前端访问：默认 `http://localhost:5173`
- 后端API：默认 `http://localhost:8080`
- Druid监控：默认 `http://localhost:8080/druid`（用户名：admin，密码：123456）

## 项目结构

```
wms/
├── backend/                # 后端代码
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/com/wms/
│   │   │   │   ├── common/       # 公共资源
│   │   │   │   ├── controller/   # 控制器
│   │   │   │   ├── dto/          # 数据传输对象
│   │   │   │   ├── entity/       # 实体类
│   │   │   │   ├── enums/        # 枚举类
│   │   │   │   ├── exception/    # 异常处理
│   │   │   │   ├── mapper/       # Mapper接口
│   │   │   │   ├── service/      # 服务层
│   │   │   │   ├── utils/        # 工具类
│   │   │   │   ├── vo/           # 视图对象
│   │   │   │   └── WmsApplication.java # 启动类
│   │   │   └── resources/
│   │   │       ├── mapper/       # MyBatis XML
│   │   │       └── application*.yml # 配置文件
│   │   └── test/                 # 测试代码
│   └── pom.xml                   # Maven配置
├── frontend/               # 前端代码
│   ├── public/             # 静态资源
│   ├── src/
│   │   ├── assets/         # 资源文件
│   │   ├── components/     # 组件
│   │   ├── router/         # 路由配置
│   │   ├── api/            # API请求
│   │   ├── views/          # 页面组件
│   │   ├── App.vue         # 根组件
│   │   └── main.js         # 入口文件
│   ├── index.html          # HTML模板
│   └── package.json        # npm配置
└── README.md               # 项目说明
```

## 核心功能说明

### 1. 库存管理
- **实时库存查询**：查看当前库存状况
- **库存变动记录**：记录所有库存变动历史
- **库存预警**：设置库存上下限，超出范围时预警
- **库存盘点**：定期盘点库存，确保数据准确性

### 2. 入库管理
- **入库订单**：创建和管理入库订单
- **货物接收**：记录实际入库的货物信息
- **入库明细**：详细记录每个产品的入库情况

### 3. 出库管理
- **出库订单**：创建和管理出库订单
- **货物拣选**：根据出库订单生成拣选任务
- **出库明细**：详细记录每个产品的出库情况

### 4. 仓库管理
- **仓库信息**：管理多个仓库的基本信息
- **库区管理**：对仓库进行分区管理
- **库位管理**：管理每个库区的具体库位

### 5. 产品管理
- **产品信息**：管理产品的基本信息
- **产品SKU**：管理产品的不同规格
- **产品分类**：对产品进行分类管理

### 6. 客户管理
- **客户信息**：管理客户的基本信息
- **客户订单**：查看和管理客户的出入库订单

## 配置说明

### 后端配置文件

主要配置文件位于 `backend/src/main/resources/`：

- `application.yml`：通用配置
- `application-dev.yml`：开发环境配置
- `application-prd.yml`：生产环境配置

### 主要配置项

1. **数据库配置**
   ```yaml
   spring:
     datasource:
       druid:
         url: jdbc:mysql://localhost:3306/wms?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=GMT%2B8
         username: root
         password: your_password
   ```

2. **Redis配置**
   ```yaml
   spring:
     redis:
       host: localhost
       port: 6379
       password: your_redis_password
   ```

3. **文件上传配置**
   ```yaml
   file:
     upload-folder: /path/to/upload
     access-prefix-url: http://localhost:8080/upload/
   ```

4. **Shiro配置**
   ```yaml
   shiro:
     loginUrl: /login
     successUrl: /index
     unauthorizedUrl: /403
     session:
       timeout: 3600
   ```

## 技术特性

- **前后端分离**：采用现代化的前后端分离架构，提高开发效率
- **权限管理**：基于Apache Shiro实现完善的权限控制
- **数据持久化**：使用MyBatis Plus简化数据库操作
- **缓存机制**：集成Redis提高系统性能
- **文件存储**：支持本地存储、七牛云和阿里云OSS
- **响应式设计**：前端使用Element Plus实现响应式界面
- **RESTful API**：后端提供标准化的RESTful接口

## 开发指南

### 后端开发

1. **添加新功能模块**
   - 创建实体类（entity）
   - 创建Mapper接口和XML
   - 创建Service接口和实现
   - 创建Controller

2. **运行测试**
   ```bash
   cd backend
   mvn test
   ```

### 前端开发

1. **添加新页面**
   - 在 `src/views/` 创建新页面组件
   - 在 `src/router.js` 配置路由
   - 在 `src/api/` 添加API请求

2. **组件开发**
   - 在 `src/components/` 创建可复用组件
   - 使用Element Plus组件库

## 许可证

MIT License

## 贡献

欢迎提交Issue和Pull Request！

## 联系方式

如有问题或建议，请联系项目维护者。