# learning

**Repository Path**: Ling-me/learning

## Basic Information

- **Project Name**: learning
- **Description**: 基于 Spring Boot + MyBatis-Plus 的WMS仓储管理系统后端
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2026-06-11
- **Last Updated**: 2026-06-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WMS仓储管理系统后端

## 📖 项目简介

本项目是基于 **Spring Boot + MyBatis-Plus** 技术栈搭建的Maven多模块仓储管理平台后端服务，采用DDD分层架构拆分，父工程统一管理依赖版本。集成JWT鉴权、Knife4j接口文档、Excel导入导出、定时任务、文件存储等通用后端能力，可快速迭代仓储出入库、库存盘点、业务单据管理等核心功能，适合仓储类业务系统快速开发。

---

## 🛠️ 技术栈

### 核心依赖

- ORM持久层：MyBatis\-Plus 3\.5\.7（简化单表CRUD，内置通用Mapper、分页插件）

- 接口文档：Knife4j 4\.1\.0（OpenAPI3规范在线接口调试文档）

- 工具类：Hutool、Guava、Commons\-Lang3、Fastjson2

- 权限认证：JJWT 0\.9\.1（Token签发、解析、过期校验）

- 文件处理：EasyExcel（大数据量Excel导入导出）、simplemagic（文件类型校验）

- 云服务：阿里云OSS SDK（对象存储，文件上传下载）

- 其他：Lombok代码简化、Jackson时间序列化适配

---

## 📂 项目模块结构

父工程统一管理版本与依赖，子模块各司其职，完全解耦，符合DDD领域驱动设计思想

```plaintext
learning  # 父工程
├── admin        # 控制层模块：接收前端请求、接口路由、拦截器、日志切面
├── domain       # 数据库实体模块：存放与数据库表一一对应的Entity实体类
├── service      # 业务层模块：核心业务逻辑、事务控制、业务流程编排、业务规则校验
├── repository   # 数据访问层模块：Mapper接口、SQL操作、数据库交互
├── core         # 公共核心模块：自定义异常、统一返回体、DTO、VO、枚举、常量、自定义注解、自定义工具、SSE会话注册、全局配置
├── runner       # 项目启动预处理模块：用于初始化通用缓存
└── job          # 定时任务模块：异步定时任务、周期任务调度
```

---

## 🔗 前端工程指引

本后端配套独立前端项目，基于**vue3-element-admin**开源项目进行的二次开发，前后端分离协同工作：
- 🖥️ 前端仓库地址：  
  **gitee** ***(推荐)***: [`https://gitee.com/Ling-me/learning-admin`](https://gitee.com/Ling-me/learning-admin)  
  **github**: [`https://github.com/Ling2712/learning-admin`](https://github.com/Ling2712/learning-admin)
- 📱 前端技术栈：Vue3 + Vite + TypeScript + Element-Plus

> 💡 说明：后端仅提供接口服务，页面交互请查阅前端项目文档。
---

## 💻 开发环境

1. JDK 1\.8

2. Maven 3\.8\.8

3. MySQL 8\.0

4. Redis 5\.0

5. 开发工具：IDEA 2026

---

## 🚀 项目启动

主启动入口：**admin模块** 下主启动类

定时任务启动入口，**job模块** 下主启动类

---

## 📦 项目打包与部署

### 打包命令

```bash
mvn clean package -Pprd -DskipTests=true
```

### Jar包运行部署

```bash
# 输出启动日志至server.log
nohup java -Dspring.profiles.active=prd -jar learning-admin.jar > server.log 2>&1 
```

---

## ✨ 项目业务介绍

适配中小制造工厂仓储管理业务场景，一共划分6大核心业务模块，内置单据编号自动生成、批次管理、SSE实时通知等底层业务规则，无复杂审核流程，各业务模块如下：

### 1\. 系统管理模块

系统后台权限与参数配置模块，包含用户管理、角色管理、菜单权限配置、字典管理、系统参数配置。系统预设三类角色：超级管理员、仓库管理员、仓储操作员，不同角色分配不同菜单及接口权限。

### 2\. 基础资料模块

仓储系统基础数据维护模块，为所有出入库、库存业务提供前置基础数据，包含5个子功能页面：仓库管理、物料分类管理、物料档案、供应商管理、客户管理。负责维护系统静态基础数据，保证后续业务单据可正常创建。

### 3\. 入库管理模块

统一管理所有仓库入库业务，包含2个核心业务页面：采购入库管理、生产退料入库、入库记录查询。支持采购原料入库、生产剩余物料退料入库，自动生成单据编号与物料批次号。

### 4\. 出库管理模块

统一管理所有仓库出库业务，包含成品出库、生产领料出库两大出库场景。支持业务出库单据新增与审核，出库时校验库存余量，避免超量出库，出库完成后自动扣减库存。

### 5\. 库存管理模块

仓库库存核心管理模块，包含库存查询、库存调拨、库存盘点、库存调整功能。查看当前仓库物料批次库存数据，支持仓库之间物料调拨、定期库存盘点修正账面库存，保障系统库存数据和实际仓库库存一致。

### 6\. 报表管理模块

仓储数据统计报表模块，基于历史出入库、库存数据，生成物料收发报表、库存台账报表等，支持多条件筛选、报表导出，方便管理人员查看仓库整体运营数据、复盘仓储业务流水。

---

## 📜 开源说明 & 协议
1. 本后端代码为个人独立研发。
2. 项目整体遵循 **MIT 开源协议**，详见根目录 `LICENSE` 文件。
3. 项目仅供学习、交流使用，禁止用于违规商业用途。

---

<p align="center"><em>技术交流 · 问题反馈</em></p>
<p><em>本项目为个人实战项目，若在运行、使用中遇到问题，或是有代码优化思路，欢迎一起交流学习。</em></p>
<table align="center">
  <tr>
    <td align="center">
      <img src="assets/wx.jpg" height="180" alt="联系作者微信"><br>
      <sub>联系作者微信</sub>
    </td>
  </tr>
</table>