WMS仓库管理系统完整使用指南：从零开始部署到实战应用

WMS仓库管理系统是一款基于.NET Core 3.1开发的开源项目，采用前后端分离架构，为企业提供完整的仓储管理解决方案。该系统集成了入库管理、出库管理、库存盘点、移库调拨等核心功能模块。

系统架构与核心模块

WMS系统采用分层架构设计，主要包含以下核心模块：

• Coldairarrow.Api：Web API接口层，提供RESTful API服务
• Coldairarrow.Business：业务逻辑层，处理核心业务流程
• Coldairarrow.Entity：数据实体层，定义数据库表结构
• Coldairarrow.Util：通用工具层，包含各种辅助工具类
• Coldairarrow.Web：前端Web界面，基于Vue.js开发
• Coldairarrow.Pad：PDA移动端应用，支持手持设备操作

环境准备与快速部署

系统环境要求

操作系统支持：

• Windows 7 SP1及以上版本
• Windows Server 2012 R2及以上版本
• CentOS 7及以上版本
• Ubuntu 16.04及以上版本
• macOS High Sierra (10.13+)及以上版本

运行环境：

• .NET Core 3.1运行时
• MySQL 5.5及以上版本（支持MSSQL/MySQL）

一键部署步骤

1. 获取项目源码

git clone https://gitcode.com/gh_mirrors/wms1/WMS

2. 数据库初始化 执行数据库脚本文件，创建系统所需的数据表结构：

docs/初始化文件/ZEQP_WMS.sql

3. 配置数据库连接 修改配置文件中的数据库连接字符串：

src/Coldairarrow.Api/appsettings.json

核心功能详解

基础资料管理

系统提供完整的仓储基础数据管理功能：

• 仓库区域管理：支持多仓库、多区域配置
• 货架货位管理：精细化货位管理，提升空间利用率
• 物料信息管理：完整的物料档案，支持分类管理
• 客户供应商管理：维护业务往来单位信息

仓库作业流程

入库管理流程：

• 收货登记 → 质量检验 → 上架存储 → 库存更新

出库管理流程：

• 订单处理 → 拣货作业 → 发货确认 → 库存扣减

库存盘点与调拨

系统支持多种盘点方式：

• 周期盘点：按设定周期进行库存盘点
• 随机盘点：随机抽查特定货位库存
• 全面盘点：全仓库范围的库存清点

系统配置详解

主要配置文件

appsettings.json：核心配置文件，包含以下关键配置项：

• 数据库连接：配置MySQL数据库连接参数
• 缓存设置：支持内存缓存和Redis缓存
• 日志配置：定义系统日志输出级别和方式
• JWT认证：配置API接口的认证参数

权限管理体系

系统采用基于角色的权限控制（RBAC）：

• 用户管理：创建和管理系统用户
• 角色管理：定义不同的操作权限
• 部门管理：按组织结构分配权限

移动端应用

PDA移动端应用支持手持设备操作：

• 入库扫描：通过条码扫描快速完成入库
• 出库拣选：移动端指导拣货作业
• 库存查询：实时查询库存信息
• 盘点作业：移动端完成库存盘点

常见问题排错

部署问题排查

1. 数据库连接失败 检查连接字符串中的服务器地址、端口、用户名和密码配置

2. API接口无法访问 确认.NET Core运行时版本和端口配置

3. 前端界面加载异常 检查Node.js版本和依赖包安装

性能优化建议

• 数据库索引优化：为常用查询字段创建索引
• 缓存策略配置：合理使用Redis缓存提升性能
• 日志级别调整：生产环境适当调整日志级别

进阶使用技巧

自定义业务规则

系统支持通过配置文件扩展业务逻辑：

• 条码规则自定义：根据企业需求定义条码生成规则
• 审批流程配置：灵活配置各类业务审批流程
• 报表模板定制：根据管理需求定制各类统计报表

系统集成方案

WMS系统提供完整的API接口，支持与企业现有系统集成：

• ERP系统集成：与财务、采购等系统数据对接
• MES系统集成：与生产制造执行系统协同工作

通过以上完整的部署和使用指南，用户可以快速掌握WMS仓库管理系统的核心功能和使用方法，实现高效的仓储管理作业。