仓库管理系统

项目介绍

本项目是围绕「仓库管理 + 拣选路径规划仿真」场景打造的 WOASVS（Warehouse Optimization and Algorithm Simulation & Visualization System）智能仓库管理系统 UI。它不是一个从零编写的业务系统，而是以若依 RuoYi-Vue 3.9.0 前后端脚手架为底座，在 woasvs-ui 前端工程中独立扩展出 views/woasvs 业务页面组，并通过 sys_menu 动态菜单挂载进系统导航：仓库管理（数量管理 / 布局管理 / 仓库概览）、商品管理（添加 / 列表）、订单管理（生成 / 管理）、算法管理（添加 / 列表）、仿真验证（仿真验证 / 结果分析 BJ2501/BJ2502 / 拣选路径可视化）五大模块。

项目定位是「界面先行」的完整后台原型：所有业务页面均以 Element UI 组件真实实现（表格、表单校验、对话框、统计卡片、ECharts 图表、拖拽画布），业务数据以页面内 mockData 假数据驱动（如商品列表预置了 ThinkPad X1、罗技 MX Master、Cherry 机械键盘、Dell U2720Q 等商品及其仓库坐标），后端保留若依完整的 Spring Boot 框架代码与 MySQL 业务库导出脚本（含 sys_menu 业务菜单、sys_oper_log 菜单配置日志）。这种”UI 全功能可交互、后端框架就绪”的组织方式，为后续按页面逐模块对接真实服务端留下了清晰的契约。

项目架构

工程复用若依经典的多模块 Maven 结构，前后端分离：

模块	技术栈	说明
woasvs-admin	Spring Boot 2.5.15、JWT、Druid 1.2.23	启动入口与框架控制器（登录、验证码、系统管理、监控），端口 8080
woasvs-common	MyBatis、Redis Cache	公共工具：注解、异常、Excel、过滤与安全工具类
woasvs-system	MyBatis、Quartz	系统管理业务（用户/角色/菜单/字典/通知），sys_menu 驱动前端动态路由
woasvs-framework	Spring Security、Redis	安全框架、JWT 令牌、数据权限、限流与日志切面
woasvs-ui	Vue 2.6.12、Element UI 2.15.14、ECharts 5.4.0、Vuex、vue-router、axios	前端工程，业务页面集中在 src/views/woasvs，数据库为 MySQL 8.0.36

前端业务页面不使用独立 api/ 模块，而是把假数据直接定义在 Vue 组件 data() 中（如 goods/list/index.vue 的 mockData 数组），配合若依标准列表页交互（搜索表单、分页、批量操作、添加/修改对话框）完整呈现业务形态；布局设计页则在组件内自绘网格画布（scale: 100 比例尺、(startX, startY, endX, endY) 网格坐标模型）。sql/20251007-woasvs.sql 为 Navicat 全库导出，包含 sys_* 框架表、Quartz 调度表、sys_menu 中 2025-10-08 起陆续录入的 2000~2024 号业务菜单，以及菜单配置过程的完整操作日志。

核心功能

仓库布局设计（layout/one、two、three）。 为 1/2/3 号仓库分别提供独立布局画布，左侧工具栏内置元素库：标准货架（默认 4×2 大小）、支线通道、拣货台、复核台、障碍物、打包区。支持「图形化」点选网格添加与「坐标式」输入精确坐标（(startX,startY) 到 (endX,endY)）两种绘制模式，货架可拖拽调整位置与尺寸，提供保存布局、重置、导入、导出与帮助按钮；3 号仓库额外支持货架层数设置，对应”三维模型”仿真形式。

仓库概览监控（view/one、two、three）。 每个仓库页顶部展示仓库 ID/名称/面积/规格，中部为 2D 栅格图与 3D 模型双视图（带图例与逐格 title 提示），右侧面板聚合 KPI：仓库使用率、库存总量、订单数量、效率指标、今日出入库数量、活跃设备、平均拣选作业时间、路径优化，并列出设备状态、今日订单与预警信息（库存预警 5 条、设备异常 2 条等模拟数据）。

商品与订单管理（goods、order）。 商品添加页按仓库选择、基本信息（名称/编码/类型 A/B/C/D）、物理属性（长宽高与自动体积）、商业属性（品牌/供应商/规格型号）、存储配置（存储位置/数量）分组录入并带表单校验；商品列表页提供统计概览（新增 124、减少 23、类型 4、总量 856）与商品类型、仓库分布两个 ECharts 图表，支持按仓库、类型、名称组合搜索。订单页支持手动、模板、位置三种生成模式选择商品并生成订单，订单列表按订单 ID/仓库/执行状态（待处理/执行中/已完成/已取消）与创建时间范围检索，顶部展示本周订单等统计卡片。

算法管理与仿真验证（algorithm、check）。 算法添加支持 Python/MATLAB 语言选择、源码手动输入或文件导入、版本信息、算法描述与参数配置（含参数示例）；算法列表展示算法语言分布、参数数量分布图表，并提供算法详情与「修改算法参数」对话框。仿真验证页按「实验编号（默认自动生成）→ 实验环境配置（仓库选择、订单选择）→ 算法选择（目标算法、版本）→ 仿真形式（二维栅格地图/三维模型）」流程组织；结果分析页（BJ2501/BJ2502）展示基础信息、参数信息（种群大小、迭代次数、A/C 计算公式，对应 WOA 鲸鱼优化算法）、测试结果与对比算法，用 ECharts 渲染 S 形路径策略与传统路径对比、适应度收敛曲线、稳定性对比与结果统计；「拣选路径可视化」页则提供 30×30 地图的单作业单目标路径规划，可调种群数量（10-200）、迭代次数（100-1000）、概率阈值 P0 与起终点坐标。

功能截图

暂无运行截图。

快速上手

1. 初始化数据库：在 MySQL 8 中执行 sql/20251007-woasvs.sql（Navicat 全库导出，含框架表、Quartz 表、业务菜单 2000~2024 号与操作日志），默认账号 admin 已具备全部菜单权限。

2. 启动后端框架：修改 woasvs-admin/src/main/resources/application.yml 与 application-druid.yml 中的数据源、Redis 配置后执行：

mvn clean package -DskipTests
java -jar woasvs-admin/target/woasvs-admin.jar

3. 启动前端：在 woasvs-ui 目录执行 npm install && npm run dev（Vue CLI 4），前端代理后端 8080 端口，登录后即可在侧边栏看到仓库管理、商品管理、订单管理、算法管理、仿真验证五个业务菜单。

4. 体验流程：进入「布局管理→1号仓库」拖拽添加货架并保存布局 → 「仓库概览」查看 KPI 与 2D/3D 视图 → 「商品管理」新增商品、生成订单 → 「算法管理」录入 WOA 算法源码与参数 → 「仿真验证」配置仓库/订单/算法提交仿真，进入 BJ2501 结果页查看路径对比与收敛曲线，或在「拣选路径可视化」调整种群与迭代参数观察路径规划结果。

总结

这个项目展示了基于若依脚手架快速落地”仓库管理 + 算法仿真”类后台 UI 的典型做法：业务侧把仓库布局、商品、订单、算法、仿真五个域拆成独立页面组，每页都按若依规范实现了搜索、列表、表单校验、统计卡片与图表等可交互细节——特别是布局设计页的网格画布（双绘制模式 + 元素库 + 拖拽）和结果分析页的 S 形路径/收敛曲线可视化，把”仿真结果”做成了直观可演示的界面；数据侧则以 mockData 假数据先行，配合 sys_menu 动态菜单与后端框架同步导出，实现了”界面完整、后端待接”的平滑演进路径。对想在若依/Vue 生态里快速产出高保真业务原型、或准备从 UI 原型反推后端接口设计的开发者，本项目的页面组织、菜单挂载方式与仿真类页面的可视化写法都值得参考。