景裕机械公司库存管理信息系统

一套面向中小型机械制造企业的库存管理（WMS）信息系统，基于 RuoYi 3.9.1 二次开发，前后端分离架构。系统覆盖商品信息、入库、出库、库存查询、供应商、盘点、用户权限等核心业务，已支持线上部署。

• 🌐 线上演示：https://project.zxbdwy.online/stock-system/
• 🔑 默认账号：admin / admin123（验证码为简单数学运算式）

📌 本文件为 online 版本 —— 所有截图引用自 minio.zxbdwy.online 图床，可直接发布到 GitHub / Gitee / 在线博客等无法访问本地 docs/images/ 的场景。本地版请见 README.md。

---

目录

• 一、系统概览
• 二、功能截图
• 三、技术选型
• 四、项目结构
• 五、核心业务模块
• 六、本地启动
• 七、生产部署
• 八、数据库设计
• 九、文档资料

---

一、系统概览

景裕机械公司库存管理信息系统（StockControlSystem）是为机械制造行业量身打造的仓储与库存管控平台，主要解决企业内部物料编码混乱、入出库无凭证、库存不准、盘点低效等痛点。系统采用 Spring Boot + Vue 3 前后端分离架构，部署轻量、可扩展性强。

核心特性

• 📦 物料分类树 + 多属性档案，支持图纸、规格、单位换算等机械行业特性
• 🚚 采购入库 / 销售出库 / 退货 / 调拨 全流程单据闭环
• 🔍 多维库存查询：仓库、货位、批次号、可用量、冻结量
• 🏷️ 盘点单管理（全盘 / 抽盘），支持差异处理
• 👥 RBAC 权限模型：用户、角色、菜单、部门、岗位细粒度授权
• 🔒 JWT Token 鉴权 + 验证码登录 + 密码错误锁定
• 📊 操作日志、登录日志、在线用户监控、服务器监控

---

二、功能截图

以下截图均截取自线上环境 https://project.zxbdwy.online/stock-system/，托管于 minio.zxbdwy.online。

1. 登录页

2. 首页 / 工作台

3. 商品信息管理（物料分类）

列表页：

新增 / 修改 物料分类：

4. 入库管理

列表页：

新增入库单（含明细行内编辑）：

入库单详情（查看）：

5. 出库管理

列表页：

新增出库单（按批次扣减）：

出库单详情（查看）：

6. 库存查询

库存查询为只读视图，仅提供导出功能，无新增/修改弹窗。

7. 供应商管理

列表页：

新增 / 修改 供应商：

8. 盘点单管理

列表页：

新增盘点单（全盘 / 抽盘 + 明细）：

9. 用户管理（系统管理）

列表页：

新增用户（部门 / 岗位 / 角色 联动）：

10. 菜单管理（系统管理）

列表页：

新增菜单（目录 / 菜单 / 按钮 三类）：

---

三、技术选型

后端

前端

---

四、项目结构

景裕机械公司库存管理信息系统/
├── StockControlSystem/                  # 后端 Maven 多模块工程
│   ├── stock-admin/                     # Web 入口（Controller + 启动类 + 配置）
│   ├── stock-common/                    # 通用工具 / 常量 / 注解 / 异常
│   ├── stock-framework/                 # 框架核心：安全、AOP、拦截器、Mybatis 配置
│   ├── stock-generator/                 # 代码生成器
│   ├── stock-quartz/                    # 定时任务模块
│   ├── stock-system/                    # 系统管理（用户/角色/菜单/字典/部门/岗位/日志）
│   ├── stock-wms/                       # ★ 核心业务：仓储与库存（WMS）
│   ├── sql/                             # 数据库初始化脚本
│   └── pom.xml
├── StockControlSystem-Vue/              # 前端 Vue3 + Vite 工程
│   ├── src/
│   │   ├── api/                         # 后端接口封装
│   │   ├── views/                       # 页面视图
│   │   ├── components/                  # 通用组件
│   │   ├── router/                      # 路由配置
│   │   ├── store/                       # Pinia Store
│   │   └── utils/                       # 工具函数
│   ├── vite.config.js
│   └── package.json
├── docs/                                # 项目文档
│   ├── images/                          # README 截图
│   ├── 代码设计.md
│   └── 数据库物理结构设计.md
├── README.md                            # 本地版（引用 docs/images/）
└── README-online.md                     # 线上版（引用 MinIO 图床）

后端业务模块 stock-wms

com.stock.wms
├── domain/             # 实体类（16 张表对应的领域对象）
│   ├── WmsWarehouse              # 仓库
│   ├── WmsLocation               # 货位
│   ├── WmsMaterialCategory       # 物料分类
│   ├── WmsMaterialInfo           # 物料档案
│   ├── WmsMaterialSupplier       # 物料-供应商关联
│   ├── WmsMaterialAttachment     # 物料附件（图纸等）
│   ├── WmsSupplier               # 供应商
│   ├── WmsInboundOrder / Detail  # 入库单 / 明细
│   ├── WmsOutboundOrder / Detail # 出库单 / 明细
│   ├── WmsReturnOrder / Detail   # 退货单 / 明细
│   ├── WmsCheckOrder / Detail    # 盘点单 / 明细
│   └── WmsStock                  # 库存余量
├── mapper/             # MyBatis Mapper 接口
└── service/            # 业务接口与实现

---

五、核心业务模块

---

六、本地启动

1. 环境要求

2. 数据库初始化

# 创建库
mysql -uroot -p -e "CREATE DATABASE stock DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"

# 创建账号（与 application-druid.yml 对应）
mysql -uroot -p -e "CREATE USER 'stock'@'%' IDENTIFIED BY 'stock123'; GRANT ALL ON stock.* TO 'stock'@'%'; FLUSH PRIVILEGES;"

# 导入脚本
mysql -ustock -pstock123 stock < StockControlSystem/sql/stock_localhost-2026_05_14_22_12_33-dump.sql

3. 后端启动

cd StockControlSystem
# 修改 stock-admin/src/main/resources/application-druid.yml 中的数据库与 Redis 连接
mvn clean package -DskipTests
java -jar stock-admin/target/stock-admin.jar
# 启动后接口前缀 http://localhost:8801

4. 前端启动

cd StockControlSystem-Vue
pnpm install   # 或 npm install
pnpm dev       # 默认监听 80 端口
# 访问 http://localhost

5. 默认账号

---

七、生产部署

1. 后端打包

cd StockControlSystem
mvn clean package -P prod -DskipTests
# 产物：stock-admin/target/stock-admin.jar

通过 systemd 或 PM2 + java -jar 方式守护启动：

nohup java -Xms512m -Xmx1024m -jar stock-admin.jar \
  --spring.profiles.active=druid \
  > stock-admin.log 2>&1 &

2. 前端打包

cd StockControlSystem-Vue
pnpm build:prod
# 产物：dist/  ，base 路径为 /stock-system/

Nginx 配置参考：

server {
    listen 443 ssl http2;
    server_name project.zxbdwy.online;

    location /stock-system/ {
        alias /var/www/stock-system/;
        index index.html;
        try_files $uri $uri/ /stock-system/index.html;
    }
}

# 接口子域：将 /stock-system 前缀转发到后端 8801
server {
    listen 443 ssl http2;
    server_name api.zxbdwy.online;

    location /stock-system/ {
        proxy_pass http://127.0.0.1:8801/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

---

八、数据库设计

系统共约 16 张业务表 + 16 张 RuoYi 系统表，业务核心表：