# wms

**Repository Path**: idemo54/wms

## Basic Information

- **Project Name**: wms
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2026-01-07
- **Last Updated**: 2026-01-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Winform-WMS

## 0. 简介

- **非我原创**
- 源代码是基于 Visual Studio 2010 和 DevExpress 8.0 开发的，当前源码已经被升级到 Visual Studio 2019 和 DevExpress 18.1
- 基于 Winform，使用 DevExpress 的一个简单 WMS（仓储管理系统）
- 完整的数据库文件在 DB 文件夹中，默认的 MDF 应该是 MSSQL 2008 版本，其中 DB_MSSQL2014 文件夹中为 MSSQL 2014 的数据库文件
- 登陆用户：系统管理员：1

## 1. 界面如下

![主界面](主界面.png)

## 2. 功能概述

本项目是一个基于 Winform 的仓储管理系统，使用 DevExpress 控件库进行界面开发，支持多种数据库版本（MSSQL 2008 和 MSSQL 2014）。系统主要功能包括：

- **基础资料管理**：包括物料、供应商、客户、部门、员工等信息的维护。
- **库存业务**：支持入库、出库、调拨、盘点等常见仓储操作。
- **库存报表**：提供多种库存报表，如库存汇总、出入库明细、库存变动统计等。
- **系统管理**：包括用户权限管理、登录用户管理等功能。

## 3. 技术架构

- **开发环境**：Visual Studio 2019
- **开发框架**：Winform + DevExpress 18.1
- **数据库**：支持 MSSQL 2008 和 MSSQL 2014
- **数据访问层**：使用 ADO.NET 实现数据库操作，支持多种数据库类型（SQL Server、Oracle、Access）
- **业务逻辑层**：封装了仓储管理、物料管理、单据管理等核心业务逻辑
- **报表模块**：使用 DevExpress XtraReports 实现报表展示

## 4. 主要模块

### 4.1 登录模块
- 用户登录界面 (`frmLogin.cs`)
- 用户权限验证
- 密码修改功能 (`frmChangePassword.cs`)

### 4.2 基础资料管理
- **物料管理** (`frmMaterial.cs`, `frmMaterialAdd.cs`)
- **供应商管理** (`frmSupplier.cs`, `frmSupplierAdd.cs`)
- **客户管理** (`frmClient.cs`, `frmClientAdd.cs`)
- **部门管理** (`frmDept.cs`, `frmDeptAdd.cs`)
- **员工管理** (`frmEmployee.cs`, `frmEmployeeAdd.cs`)
- **仓库管理** (`frmDepot.cs`)
- **物料分类管理** (`frmStorageClass.cs`)

### 4.3 仓储业务
- **入库单管理** (`frmBill.cs`, `frmBillAdd.cs`)
- **出库单管理** (`frmOutDepotDetail.cs`)
- **调拨单管理** (`frmRemoveBill.cs`, `frmRemoveBillAdd.cs`)
- **盘点单管理** (`frmCheckBill.cs`, `frmCheckBillAdd.cs`)

### 4.4 报表模块
- **库存汇总报表** (`frmDepotMaterialSum.cs`)
- **出入库明细报表** (`frmInDepotDetail.cs`, `frmOutDepotDetail.cs`)
- **库存变动统计报表** (`frmDepotMaterialInOutSum.cs`)
- **物料库存状态报表** (`frmDepotMaterialStatusQty.cs`)

### 4.5 系统管理
- **用户权限管理** (`frmUserRight.cs`)
- **登录用户管理** (`frmLoginUser.cs`)
- **密码修改** (`frmChangePassword.cs`)

## 5. 数据访问层 (DAO)

数据访问层支持多种数据库类型，包括 SQL Server、Oracle 和 Access，主要类如下：

- `CommonSql.cs`：SQL Server 数据库操作类
- `CommonOracle.cs`：Oracle 数据库操作类
- `CommonOle.cs`：Access 数据库操作类
- `ICommandBuilder.cs`：命令构建器接口，用于不同数据库的适配

## 6. 业务逻辑层 (Library)

业务逻辑封装在 `StorageManageLibrary` 项目中，主要类包括：

- `BillManage.cs`：单据管理类，处理入库、出库、调拨等业务逻辑
- `MaterialManage.cs`：物料管理类
- `DepotManage.cs`：仓库管理类
- `SupplierManage.cs`：供应商管理类
- `ClientManage.cs`：客户管理类
- `EmployeeManage.cs`：员工管理类
- `DeptManage.cs`：部门管理类
- `StorageClassManage.cs`：物料分类管理类
- `UserRightManage.cs`：用户权限管理类

## 7. 报表模块

报表使用 DevExpress XtraReports 实现，主要报表类如下：

- `XtraReportBillE.cs`：入库单打印报表
- `XtraReportBillI.cs`：出库单打印报表
- `XtraReportDepotMaterialInOutSum.cs`：库存变动汇总报表
- `XtraReportRemoveBill.cs`：调拨单打印报表

## 8. 安装与部署

### 8.1 数据库配置

1. 数据库文件位于 `DB` 文件夹中
2. 根据使用的 SQL Server 版本选择合适的数据库文件（MSSQL 2008 或 MSSQL 2014）
3. 在 SQL Server 中附加数据库文件（`.mdf` 和 `.ldf`）

### 8.2 修改连接字符串

在 `App.config` 文件中配置数据库连接字符串：

```xml
<connectionStrings>
  <add name="StorageManage.Properties.Settings.ConnectionString"
       connectionString="Data Source=.;Initial Catalog=Storehouse;Integrated Security=True"
       providerName="System.Data.SqlClient" />
</connectionStrings>
```

根据实际数据库类型和路径修改连接字符串。

### 8.3 编译与运行

1. 使用 Visual Studio 2019 打开 `StorageManage.sln` 解决方案
2. 选择合适的启动项目（通常是 `StorageManage`）
3. 编译并运行项目

## 9. 使用说明

### 9.1 登录系统

- 打开系统后，输入用户名和密码进行登录
- 默认管理员用户：1（密码需根据实际情况输入）

### 9.2 基础资料维护

- **物料管理**：添加、编辑、删除物料信息
- **供应商管理**：维护供应商信息
- **客户管理**：维护客户信息
- **仓库管理**：设置仓库信息
- **物料分类**：维护物料分类树

### 9.3 仓储业务操作

- **入库单**：新增、编辑、删除入库单据
- **出库单**：新增、编辑、删除出库单据
- **调拨单**：处理仓库之间的物料调拨
- **盘点单**：进行库存盘点操作

### 9.4 报表查询

- **库存汇总**：查看各仓库的库存情况
- **出入库明细**：查询物料的出入库记录
- **库存变动统计**：查看物料的库存变化趋势
- **物料库存状态**：查看特定物料的库存状态

### 9.5 系统管理

- **用户权限管理**：设置用户操作权限
- **登录用户管理**：添加、编辑、删除系统用户
- **密码修改**：修改当前用户登录密码

## 10. 开发与扩展

### 10.1 添加新功能

1. 在 `StorageManage` 项目中添加新的窗体（Form）
2. 在 `frmStorageMain.cs` 中添加菜单项和导航栏项
3. 在 `StorageManageLibrary` 中添加对应的业务逻辑类
4. 在 `DAO` 层添加数据库访问逻辑

### 10.2 支持更多数据库

当前系统支持 SQL Server、Oracle 和 Access 数据库。如需支持更多数据库类型，可在 `DAO` 项目中添加新的数据库访问类，并实现 `CommonInterface` 接口。

### 10.3 报表定制

报表使用 DevExpress XtraReports 设计，可通过以下步骤定制报表：

1. 打开 `.repx` 报表文件
2. 使用 DevExpress 报表设计器修改布局
3. 调整数据绑定逻辑（如需要）

## 11. 注意事项

- 系统默认使用 SQL Server 数据库，如需使用其他数据库，请修改连接字符串并确保 DAO 层支持
- 数据库文件默认使用 MSSQL 2008，如使用 MSSQL 2014，请选择对应的数据库文件
- 系统权限管理较为简单，如需更复杂的权限控制，可扩展 `UserRightManage.cs` 类

## 12. 贡献指南

欢迎贡献代码！请遵循以下步骤：

1. Fork 本项目
2. 创建新分支 (`git checkout -b feature/your-feature`)
3. 提交更改 (`git commit -am 'Add some feature'`)
4. 推送分支 (`git push origin feature/your-feature`)
5. 创建 Pull Request

## 13. 许可证

本项目采用 [MIT 许可证](https://opensource.org/licenses/MIT)，详情请查看项目中的 `LICENSE` 文件。