# wms

**Repository Path**: rorrson/wms

## Basic Information

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

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 仓储管理系统 (WMS)

## 项目简介

仓储管理系统(Warehouse Management System, WMS)是一个用于管理仓库日常运营的综合系统，包括入库、出库、库存管理、产品管理、客户管理等核心功能。

## 技术栈

### 前端
- **框架**: Vue 3
- **UI组件库**: Element Plus
- **构建工具**: Vite
- **路由**: Vue Router
- **HTTP客户端**: Axios

### 后端
- **框架**: Spring Boot 3.2.2
- **ORM框架**: MyBatis 3.0.3
- **数据库**: MySQL
- **权限管理**: Apache Shiro 2.0.0
- **工具库**: 
  - Hutool 5.8.25
  - Fastjson 2.0.44
  - Lombok

## 项目结构

```
wms/
├── frontend/          # 前端项目
│   ├── src/           # 前端源码
│   │   ├── components/ # Vue组件
│   │   ├── router/     # 路由配置
│   │   ├── utils/      # 工具函数
│   │   ├── views/      # 页面组件
│   │   ├── App.vue     # 根组件
│   │   ├── main.js     # 入口文件
│   │   └── style.css   # 全局样式
│   ├── index.html      # HTML模板
│   ├── package.json    # 前端依赖
│   └── vite.config.js  # Vite配置
├── src/               # 后端项目
│   ├── main/          # 后端主源码
│   │   ├── java/      # Java源码
│   │   │   └── org/example/  # 包路径
│   │   │       ├── config/    # 配置类
│   │   │       ├── controller/ # 控制器
│   │   │       ├── dao/        # 数据访问层
│   │   │       ├── entity/     # 实体类
│   │   │       ├── service/    # 服务层
│   │   │       ├── shiro/      # Shiro配置
│   │   │       └── WmsApplication.java # 启动类
│   │   └── resources/  # 资源文件
│   │       ├── mapper/  # MyBatis映射文件
│   │       └── application.yml # 配置文件
│   └── test/           # 测试代码
├── sql/               # SQL脚本
├── pom.xml            # 后端依赖
└── .gitignore         # Git忽略文件
```

## 功能模块

### 1. 客户管理
- 客户信息维护
- 客户列表查询

### 2. 入库管理
- 入库单创建
- 入库单列表
- 入库单详情
- 托盘收货任务
- 入库单收货确认

### 3. 出库管理
- 出库单创建
- 出库单列表
- 出库单详情
- 托盘拣货任务
- 出库单拣货确认

### 4. 产品管理
- 产品分类管理
- 产品单位管理
- 产品SKU管理
- 产品存储类型管理
- 产品标签管理

### 5. 仓储管理
- 仓库管理
- 库区管理
- 货架管理
- 库位管理

### 6. 系统管理
- 用户管理
- 权限与角色管理

## 安装与运行

### 1. 环境要求
- JDK 17+
- Node.js 16+
- MySQL 8.0+

### 2. 数据库配置
1. 创建数据库wms
2. 执行 `sql/` 目录下的所有SQL脚本，初始化数据库表结构和数据

### 3. 后端运行
1. 配置 `src/main/resources/application.yml` 中的数据库连接信息
2. 运行 `WmsApplication.java` 启动后端服务
3. 后端服务默认运行在 `http://localhost:8080`

### 4. 前端运行
1. 进入 `frontend` 目录
2. 安装依赖：`npm install`
3. 启动开发服务器：`npm run dev`
4. 前端服务默认运行在 `http://localhost:3000`

## 构建生产版本

### 前端构建
```bash
cd frontend
npm run build
```
构建产物将生成在 `frontend/dist` 目录下。

### 后端构建
```bash
mvn clean package
```
构建产物将生成在 `target` 目录下。

## 注意事项

1. 确保数据库连接信息配置正确
2. 首次运行请先执行SQL脚本初始化数据库
3. 开发环境下，前端和后端需要分别启动
4. 生产环境下，可以将前端构建产物部署到静态资源服务器，或集成到后端项目中

## 开发规范

### 代码风格
- 后端遵循Java开发规范，使用Lombok简化代码
- 前端遵循Vue 3开发规范，使用Composition API

### 命名规范
- 类名：大驼峰命名法
- 方法名、变量名：小驼峰命名法
- 常量：全大写，下划线分隔
- 数据库表名：小写，下划线分隔

## 许可证

MIT License