蓝宝PC前端
blame | 历史 | 补丁 | 提交 | 提交对比 | 忽略空白
cnf
2025-11-27 8c3ce2841882164d380faaee3cc7f8a32d36a3b1 
 README.md


@@ -1,4 +1,508 @@


## LB_MesClient


# LanBMes MES Client (G-MES V2.0)




蓝宝PC前端


<div align="center">




**蓝宝制造执行系统 (MES) Windows 客户端**




[![.NET Framework](https://img.shields.io/badge/.NET%20Framework-4.8-blue.svg)](https://dotnet.microsoft.com/download/dotnet-framework/net48)


[![DevExpress](https://img.shields.io/badge/DevExpress-v22.2-orange.svg)](https://www.devexpress.com/)


[![License](https://img.shields.io/badge/license-Proprietary-red.svg)]()




*为制造车间提供全面的生产执行、仓储管理、质量控制和报表分析能力*




[功能特性](#功能特性) • [快速开始](#快速开始) • [项目结构](#项目结构) • [文档](#文档) • [技术栈](#技术栈)




</div>




---




## 📋 目录




- [项目简介](#项目简介)


- [功能特性](#功能特性)


- [快速开始](#快速开始)


- [项目结构](#项目结构)


- [核心模块](#核心模块)


- [技术栈](#技术栈)


- [开发指南](#开发指南)


- [部署说明](#部署说明)


- [文档](#文档)


- [常见问题](#常见问题)




---




## 🎯 项目简介




**LanBMes MES Client** 是一款基于 .NET Framework 4.8 和 DevExpress WinForms 构建的企业级制造执行系统(MES)桌面应用程序。该系统为制造车间提供完整的数字化解决方案,涵盖生产计划、工单管理、生产执行、质量控制、仓储物流等核心业务流程。




### 核心优势




- 🎨 **现代化界面** - 基于 DevExpress FluentDesign 的直观用户体验


- ⚡ **高度集成** - 与后端 REST API 无缝对接,支持 Oracle/SQL Server 双数据库


- 🔧 **灵活扩展** - 150+ 可复用业务控件,快速构建新功能


- 🔐 **权限管理** - 基于角色的细粒度权限控制


- 📱 **多终端支持** - PC 桌面端 + 手持 PDA 端协同作业


- 🏭 **工业集成** - 支持 Modbus TCP/RTU 设备通信




### 适用场景




- ✅ 离散制造业 (电子、机械、汽车零部件等)


- ✅ 需要精细化车间管理的制造企业


- ✅ 多工序流程管理与质量追溯


- ✅ 仓储物流与条码管理


- ✅ 生产数据采集与实时监控




---




## ✨ 功能特性




### 🏭 生产管理




- **工单管理** - 生产任务下达、排产调整、进度追踪


- **生产执行** - 工序开工、数据采集、流程卡管理


- **返工维修** - 不良品返工流程与维修记录




### 📦 仓储物流




- **出库管理** - 生产领料、补料、退货、其他出库


- **入库管理** - 到货入库、退库、杂项入库


- **库存操作** - 调拨、盘点、条码生成与打印


- **PDA 作业** - 手持终端扫码理货与移动作业




### ✅ 质量管理




- **IPQC 制程检验** - 首件检验、巡检作业


- **FQC 成品终检** - 成品质量检验与异常处理


- **IQC 来料质检** - 来料抽检、AQL 抽样方案


- **缺陷追踪** - 缺陷代码、检验项目、质量标准维护




### 📊 基础数据




- **主数据管理** - 客户、供应商、物料、产线、员工、部门


- **工装设备** - 夹具工装台账、计量设备、点检任务


- **条码管理** - 条码批量生成、打印模板设置




### 📈 报表分析




- **报表设计** - FastReport/DevExpress 可视化报表设计器


- **自定义报表** - 灵活的数据源配置与报表引擎




### ⚙️ 系统管理




- **用户权限** - 用户、角色、菜单权限、操作权限


- **系统配置** - 菜单结构、组织架构、单号规则、系统日志




---




## 🚀 快速开始




### 前置要求




确保您的开发环境满足以下要求:




- ✅ **操作系统**: Windows 10/11 或 Windows Server 2016+


- ✅ **开发工具**: Visual Studio 2022 (推荐) 或 Visual Studio 2019


- ✅ **.NET Framework**: 4.8 SDK


- ✅ **DevExpress**: v22.2+ 许可证


- ✅ **版本控制**: Git




### 克隆仓库




```bash


git clone <repository_url>


cd LB_MesClient/DevApp


```




### 还原依赖




```bash


# 使用 NuGet 还原包


nuget restore GsDevSolution.sln




# 或在 Visual Studio 中:


# 右键解决方案 → 还原 NuGet 程序包


```




### 配置后端 API




编辑 `Gs.DevApp\App.config`,修改后端 API 地址:




```xml


<add key="WebApiUrl" value="http://your-api-server:port/" />


```




### 构建与运行




```bash


# 命令行构建


msbuild GsDevSolution.sln /p:Configuration=Debug /p:Platform="Any CPU"




# 运行程序


Gs.DevApp\bin\Debug\Gs.DevApp.exe


```




**或者在 Visual Studio 中**:




1. 打开 `GsDevSolution.sln`


2. 设置 `Gs.DevApp` 为启动项目


3. 按 `F5` 开始调试




---




## 📁 项目结构




```


GsDevSolution/


│


├── Gs.DevApp/                          # 主客户端应用程序


│   ├── DevFrm/                         # 业务窗体 (18个领域模块)


│   │   ├── BasicData/                  # 基础数据 (客户/供应商/物料/产线)


│   │   ├── Work/                       # 生产执行 (开工/数据采集/返工)


│   │   ├── WOM/                        # 工单管理 (任务下达/排产)


│   │   ├── QC/                         # 质量管理通用模块


│   │   ├── IPQC/                       # 制程检验 (首件/巡检)


│   │   ├── FQC/                        # 成品终检


│   │   ├── RkQC/                       # 来料质检


│   │   ├── Ck/                         # 出库管理


│   │   ├── Rk/                         # 入库管理


│   │   ├── Warehouse/                  # 仓库操作


│   │   ├── Sales/                      # 销售订单


│   │   ├── WW/                         # 委外管理


│   │   ├── Rpt/                        # 报表设计


│   │   ├── Sys/                        # 系统设置


│   │   ├── User/                       # 用户权限


│   │   ├── JJGZ/                       # 夹具工装


│   │   ├── BarCode/                    # 条码管理


│   │   └── PDA/                        # 手持终端


│   ├── Entity/                         # 数据传输对象 (DTO)


│   ├── ToolBox/                        # 公共工具类库


│   │   ├── UtilityHelper.cs            # HTTP请求、JSON解析、Grid初始化


│   │   ├── LogHelper.cs                # 日志记录


│   │   ├── MsgHelper.cs                # 消息提示


│   │   └── ModbusHelper.cs             # Modbus通信


│   ├── UserControl/                    # 可复用控件库 (150+)


│   │   ├── UcToolBarMenu.cs            # CRUD工具栏


│   │   ├── UcPageBar.cs                # 分页控件


│   │   ├── UcLook*.cs                  # 60+ 数据查找控件


│   │   └── Toast.cs                    # Toast提示


│   ├── Resources/                      # 资源文件


│   ├── App.config                      # 应用配置


│   └── Program.cs                      # 应用入口


│


├── Gs.WeightIqc/                       # IQC 来料称重客户端


├── Gs.WeightLine/                      # 产线称重客户端


├── Gs.Setup/                           # 安装程序项目 (.vdproj)


└── packages/                           # NuGet 包缓存




总计:


- 150+ 业务窗体


- 150+ 可复用控件


- 18 个业务领域模块


```




---




## 🧩 核心模块




### 1️⃣ 基础数据管理 (BasicData)




维护系统运行所需的主数据,包括客户、供应商、物料、产线、员工、部门等核心基础数据。




**关键窗体**: `Frm_Customer`, `Frm_Supplier`, `Frm_MesItems`, `Frm_MesWorkshopLine`




### 2️⃣ 生产执行 (Work)




支持工序开工、数据采集、流程卡管理、返工维修等生产现场作业。支持 Modbus 设备实时数据采集。




**关键窗体**: `Frm_WorkStart`, `Frm_WorkProcesses`, `Frm_Work01~09`, `Frm_Repair`




### 3️⃣ 质量管理 (QC/IPQC/FQC/RkQC)




提供多级质量检验体系,包括制程检验 (IPQC)、成品终检 (FQC)、来料质检 (IQC/RkQC),支持 AQL 抽样方案与缺陷追踪。




**关键窗体**: `Frm_ShouJian`, `Frm_XunJian`, `Frm_Fqc`, `Frm_Cqfa`




### 4️⃣ 仓储管理 (Ck/Rk/Warehouse)




覆盖出入库全流程,支持生产领料、补料、到货入库、退库、调拨、盘点等操作,集成条码管理。




**关键窗体**: `Frm_MesInvItemOut_SCLL`, `Frm_MesInvItemArn`, `Frm_MesDbck`, `Frm_ArrivalBarcode`




### 5️⃣ 工单管理 (WOM)




生产任务下达、工单排产、进度追踪、工单状态管理。




### 6️⃣ 报表中心 (Rpt)




支持 FastReport 和 DevExpress 报表,提供可视化报表设计器与自定义报表引擎。




**关键窗体**: `EasyRptDesign`, `EasyRptEdt`




---




## 🔧 技术栈




### 核心框架与库




| 技术 | 版本 | 用途 |


|------|------|------|


| **.NET Framework** | 4.8 | 应用基础框架 |


| **C# WinForms** | - | 桌面应用开发 |


| **DevExpress** | v22.2.3 | UI组件库 (FluentDesign, XtraGrid, XtraTab, XtraBars) |




### 第三方组件




| 组件 | 版本 | 用途 |


|------|------|------|


| **CefSharp** | 109.1.110 | 嵌入式 Chromium 浏览器 |


| **AutoUpdater.NET** | 1.9.2 | 自动软件更新 |


| **NModbus** | 3.0.81 | 工业设备通信 (Modbus TCP/RTU) |


| **Newtonsoft.Json** | 13.0.3 | JSON 序列化 |


| **System.Text.Json** | 8.0.4 | 现代 JSON 支持 |


| **Oracle.ManagedDataAccess** | 最新 | Oracle 数据库访问 |


| **System.Data.SqlClient** | 最新 | SQL Server 数据库访问 |




### 架构模式




```


┌─────────────────────────────────────┐


│     UI Layer (DevExpress WinForms)  │  ← 用户交互层


├─────────────────────────────────────┤


│  Business Logic (ToolBox + Forms)   │  ← 业务逻辑层


├─────────────────────────────────────┤


│   REST API (HTTP/JSON)              │  ← 通信层


├─────────────────────────────────────┤


│   Backend API Server                │  ← 服务端 (别处项目)


├─────────────────────────────────────┤


│   Data Layer (Oracle/SQL Server)    │  ← 数据持久化层


└─────────────────────────────────────┘


```




---




## 📚 开发指南




### 核心设计模式




#### 1. HTTP 请求集中化




所有 API 调用统一使用 `UtilityHelper.HttpPost()`:




```csharp


string result = UtilityHelper.HttpPost(


    "BasicData/Customer/GetListPage",  // API路径


    "GetListPage",                      // 方法名


    jsonParam,                          // JSON参数


    true                                // 显示加载框


);




dynamic dy = UtilityHelper.ReturnToDynamic(result);


if (dy.code == 200) {


    // 处理数据


}


```




#### 2. 动态窗体加载 (反射)




通过反射实现菜单驱动的窗体动态加载:




```csharp


Form form = (Form)Assembly.GetExecutingAssembly()


    .CreateInstance("Gs.DevApp.DevFrm.BasicData.Frm_Customer");


```




**优势**: 菜单结构完全由后端控制,无需修改代码即可调整菜单。




#### 3. 可复用控件优先




项目提供 150+ 可复用控件,新功能开发应优先使用:




```csharp


// 使用标准 CRUD 工具栏


UcToolBarMenu toolBar = new UcToolBarMenu();


toolBar.AddClick += BtnAdd_Click;




// 使用分页控件


UcPageBar pageBar = new UcPageBar();


pageBar.PageChanged += LoadData;




// 使用数据查找控件


UcLookCustomer lookCustomer = new UcLookCustomer();


lookCustomer.ShowDialog();


```




### 开发规范




#### 命名规范




| 类型 | 规则 | 示例 |


|------|------|------|


| 主窗体 | `Frm_{业务名}` | `Frm_Customer.cs` |


| 编辑窗体 | `Frm_{业务名}Edit` | `Frm_CustomerEdit.cs` |


| 对话框 | `Dlg_{业务名}` | `Dlg_SelectCustomer.cs` |


| 用户控件 | `Uc{功能名}` | `UcToolBarMenu.cs` |




#### 异常处理规范




```csharp


try {


    string result = UtilityHelper.HttpPost(...);


    dynamic dy = UtilityHelper.ReturnToDynamic(result);




    if (dy.code == 200) {


        // 成功处理


    } else {


        MsgHelper.ShowError(dy.msg.ToString());


        LogHelper.WriteLog($"API Error: {dy.msg}", LogHelper.LogType.Error);


    }


} catch (Exception ex) {


    MsgHelper.ShowError($"操作失败: {ex.Message}");


    LogHelper.WriteLog($"Exception: {ex}", LogHelper.LogType.Error);


}


```




#### 日志记录规范




```csharp


// 关键操作前后记录日志


LogHelper.WriteLog($"开始保存客户数据: {customerId}", LogHelper.LogType.Info);




// 日志位置: logs/{yyyy-MM-dd}.log


```




### 添加新模块




1. 在 `DevFrm/` 下创建新目录


2. 创建主窗体 (继承 `XtraForm`)


3. 使用 `UtilityHelper.HttpPost()` 调用 API


4. 复用 `UserControl/` 中的控件


5. 在后端添加对应菜单项




---




## 🚢 部署说明




### 构建 Release 版本




```bash


# 清理并重新构建


msbuild Gs.DevApp\Gs.DevApp.csproj /t:Clean


msbuild Gs.DevApp\Gs.DevApp.csproj /t:Rebuild /p:Configuration=Release /p:Platform="Any CPU"


```




### 配置清单




部署前需修改 `Gs.DevApp.exe.config`:




- ✅ 修改 `WebApiUrl` 为生产环境 API 地址


- ✅ 配置 `IsAutoUpdater` 和 `AutoUpdaterXml`


- ✅ 确保 `x86/` 和 `x64/` 目录完整 (CefSharp 依赖)




### 使用安装程序




1. 打开 `Gs.Setup\Gs.Setup.vdproj`


2. 配置版本号和产品信息


3. 生成 MSI 安装包


4. 输出: `Gs.Setup\Release\Gs.Setup.msi`




### 自动更新




编辑 `AutoUpdater.xml`:




```xml


<?xml version="1.0" encoding="utf-8"?>


<update>


  <version>0.2.0.0</version>


  <url>http://your-server/updates/Gs.DevApp_v0.2.0.0.zip</url>


  <changelog><![CDATA[<h3>更新内容</h3>...]]></changelog>


  <mandatory>false</mandatory>


</update>


```




---




## 📖 文档




### 完整文档




- 📘 **[HELP.md](HELP.md)** - 完整的项目帮助指南 (中文,1400+ 行)


- 📗 **[CLAUDE.md](CLAUDE.md)** - Claude Code AI 辅助开发指南


- 📙 **[DEVFRM_GUIDE.md](DEVFRM_GUIDE.md)** - DevFrm 模块详细指南 (如存在)


- 📕 **[ANALYSIS_REPORT.md](ANALYSIS_REPORT.md)** - 架构分析报告 (如存在)




### 快速链接




- [项目概览](HELP.md#1-项目概览)


- [构建与运行](HELP.md#5-构建与运行)


- [功能模块详解](HELP.md#6-devfrm-功能模块详解)


- [架构与设计模式](HELP.md#7-架构与设计模式)


- [配置说明](HELP.md#9-配置说明)


- [开发规范](HELP.md#11-开发规范与最佳实践)


- [常见问题](HELP.md#12-常见问题与故障排查)




---




## ❓ 常见问题




### Q: DevExpress 组件找不到?




**A**: 确保已安装 DevExpress v22.2 并配置 NuGet 源:




```


工具 → NuGet 包管理器 → 程序包管理器设置 → 程序包源


添加: https://nuget.devexpress.com/<your_feed_key>/api


```




### Q: CefSharp 加载失败?




**A**: 确保输出目录包含 `x86/` 和 `x64/` 子目录及其内容。




### Q: 无法连接到 API 服务器?




**A**: 检查 `App.config` 中的 `WebApiUrl` 配置,确保后端 API 服务正常运行。




### Q: 如何调试多个实例?




**A**: 在 `Program.cs` 中注释单实例检查代码:




```csharp


// Process[] MyProcesses = Process.GetProcessesByName("Gs.DevApp");


// if (MyProcesses.Length > 1) { MyProcesses[0].Kill(); }


```




### Q: 日志文件在哪里?




**A**: 日志位置: `logs/{yyyy-MM-dd}.log` (应用程序目录下)




---




## 📜 许可证




本项目为专有软件,未经授权不得复制、分发或修改。




---




## 🤝 贡献与支持




如需技术支持或报告问题,请联系开发团队。




---




## 📊 项目统计




- **总代码行数**: 约 100,000+ 行


- **业务窗体**: 150+ 个


- **可复用控件**: 150+ 个


- **业务领域**: 18 个模块


- **支持数据库**: Oracle + SQL Server


- **开发周期**: 持续迭代中




---




<div align="center">




**G-MES V2.0** - 智能制造,数字未来




*最后更新: 2025-10-16*




</div>