# warehouse

**Repository Path**: mmkj/warehouse

## Basic Information

- **Project Name**: warehouse
- **Description**: 🎉 本系统是一款面向小型仓库的进销存管理系统，帮助仓库人员高效完成采购入库、销售出库、退货及库存查询等核心业务。

📊 首页数据看板实时展示商品总数、库存预警、今日进销概况等关键指标，快速掌握运营状态。

✨ 系统支持客户、供应商、商品分类及档案管理，完整覆盖进货、进货退货、销售、销售退货全流程……
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 6
- **Created**: 2026-05-27
- **Last Updated**: 2026-05-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 仓库管理系统

前后端分离的仓库管理系统，适用于小型仓库的进销存管理。

## 项目简介

---

🎉 本系统是一款面向小型仓库的进销存管理系统，帮助仓库人员高效完成采购入库、销售出库、退货及库存查询等核心业务。

📊 首页数据看板实时展示商品总数、库存预警、今日进销概况等关键指标，快速掌握运营状态。

✨ 系统支持客户、供应商、商品分类及档案管理，完整覆盖进货、进货退货、销售、销售退货全流程。

📈 内置进销金额、商品及利润三大分析报表，支持按今天、本周、本月、本季度、本年或自定义时间范围进行多维度查询与图表展示。

🔐 同时具备完善的权限管理功能，支持用户、角色、部门、菜单灵活配置。

🚀 采用主流技术架构开发，具备良好的可维护性与可扩展性。

> **📢 免费开源声明**：本项目完全免费开源，任何人都可以自由使用、学习和修改，但**禁止直接出售本软件**。详见 [LICENSE](LICENSE) 文件。

## 💻 技术栈

| 端 | 技术 |
|---|---|
| 🖥️ 后端 | Spring Boot 3.5.5 + Java 21 + MyBatis-Plus + SA-Token + MySQL |
| 🌐 前端 | Vue 3 + TypeScript + Element Plus + Vite + ECharts |

## 🎯 功能模块

### ⚙️ 系统管理
- 👥 用户管理、角色管理、部门管理
- 📋 菜单管理、权限管理（RBAC）
- 📢 公告管理、登录日志、缓存管理
- 👤 个人信息、修改密码

### 📦 业务管理
- **📁 基础数据**：客户管理、供应商管理、商品分类、商品管理
- **📥 进货管理**：商品入库，记录进货价格、数量、供应商
- **↩️ 退货管理**：进货退货
- **📤 销售管理**：商品出库，记录销售价格、数量、客户
- **🔄 销售退货**：销售退货

### 📊 报表统计
- **💰 进销金额分析**：按时间段统计进货/销售金额趋势（柱状图）
- **📦 进销商品分析**：按时间段统计商品明细（柱状图 + 表格，支持分页）
- **💹 利润分析**：按时间段对比销售额、进货成本，计算毛利润和毛利率（柱状图 + 折线图）
- 📅 所有报表支持：今天、昨天、本周、本月、本季、本年、自定义日期范围

### 🏠 首页看板
- 📦 商品总数、库存预警数、今日进货、今日销售
- 📝 最近操作日志
- ⚠️ 库存预警商品列表

## 🔑 默认账号

| 用户名 | 密码 | 角色 |
|---|---|---|
| admin | 123456 | 超级管理员 |

## 📸 功能截图

### 🏠 首页
![首页](./img/首页.png)

### ⚙️ 系统管理
![系统管理](./img/系统管理.png)

### 📁 基础数据管理
| 客户管理 | 供应商管理 |
|:---:|:---:|
| ![客户管理](./img/客户管理.png) | ![供应商管理](./img/供应商管理.png) |

| 商品分类 | 商品管理 |
|:---:|:---:|
| ![商品分类](./img/商品分类.png) | ![商品管理](./img/商品管理.png) |

### 📥 进货管理
| 商品进货 | 商品退货 |
|:---:|:---:|
| ![进货管理-商品进货](./img/进货管理-商品进货.png) | ![进货管理-商品退货](./img/进货管理-商品退货.png) |

### 📤 销售管理
| 商品销售 | 商品退货 |
|:---:|:---:|
| ![销售管理-商品销售](./img/销售管理-商品销售.png) | ![销售管理-商品退货](./img/销售管理-商品退货.png) |

### 📊 报表统计
| 进销金额分析 | 进销商品分析 | 利润分析 |
|:---:|:---:|:---:|
| ![报表统计-进销金额分析](./img/报表统计-进销金额分析.png) | ![报表统计-进销商品分析](./img/报表统计-进销商品分析.png) | ![报表统计-利润分析](./img/报表统计-利润分析.png) |

## 🚀 快速开始

### 📋 环境要求
- ☕ JDK 21+
- 📦 Maven 3.6+
- 🗄️ MySQL 5.7+
- 🟢 Node.js 16+

### 🗄️ 数据库初始化
```bash
mysql -u root -p
CREATE DATABASE warehouse DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
EXIT;
mysql -u root -p warehouse < warehouse.sql
```

### 🖥️ 后端启动
```bash
mvn clean package
mvn spring-boot:run
# 或
java -jar target/warehouse-0.0.1-SNAPSHOT.jar
```
后端运行在 `http://localhost:8888`

### 🌐 前端启动
```bash
cd warehouse-frontend
npm install
npm run dev
```
前端运行在 `http://localhost:5173`，自动代理 `/api/*` 到后端。

### 📦 生产构建
```bash
cd warehouse-frontend
npm run build
# 产物在 warehouse-frontend/dist/
```


## 📄 许可证

本项目采用 MIT 许可证，详见 [LICENSE](LICENSE) 文件。

**使用说明：**
- ✅ **免费使用**：任何人可以免费使用本软件
- ✅ **学习研究**：可用于学习、研究和个人项目
- ✅ **修改使用**：允许自行修改后使用
- ❌ **禁止出售**：不得将本软件（包括修改版本）直接作为商品出售

欢迎 Star、Fork 和提交 Pull Request！