| | |
|---|
| | | # 蓝宝MES系统代码结构详细说明 |
|---|
| | | # 蓝宝 MES 客户端帮助指南 |
|---|
| | | |
|---|
| | | ## 项目概述 |
|---|
| | | ## 1. 项目概览 |
|---|
| | | - **解决方案名称**：`GsDevSolution.sln` |
|---|
| | | - **主要用途**：面向制造现场的 MES Windows 客户端，覆盖生产、仓储、质检、系统配置等业务。 |
|---|
| | | - **核心应用**：`Gs.DevApp`（DevExpress WinForms 客户端），辅以称重采集站点与安装程序。 |
|---|
| | | |
|---|
| | | 蓝宝PC前端 (LanBao PC Frontend) 是一个基于 .NET Framework 4.8 的制造执行系统 (MES) 客户端应用程序，采用 Windows Forms 技术栈和 DevExpress UI 组件库，提供完整的制造业务管理功能。 |
|---|
| | | ## 2. 解决方案结构 |
|---|
| | | |
|---|
| | | ## 技术栈 |
|---|
| | | | 目录 | 说明 | |
|---|
| | | | --- | --- | |
|---|
| | | | `Gs.DevApp/` | 主客户端项目，包含全部业务窗体、工具库、资源及配置。 | |
|---|
| | | | ├─ `DevFrm/` | 业务窗体，按领域划分（`BasicData/` 基础数据、`Work/` 制程、`QC/` 质检、`Sys/` 系统设置等）。 | |
|---|
| | | | ├─ `Entity/` | DTO 与通用模型（如 `PageQueryModel`、`ReturnModel`）。 | |
|---|
| | | | ├─ `ToolBox/` | 公共工具类（HTTP、日志、Modbus、对话框包装等）。 | |
|---|
| | | | ├─ `UserControl/` | 可复用控件（工具栏、分页、数据字典、查询选择器等）。 | |
|---|
| | | | `Gs.WeightIqc/` | IQC 来料称重客户端，负责串口/Modbus 采集与上传。 | |
|---|
| | | | `Gs.WeightLine/` | 产线称重客户端，支持多条线体切换与实时监控。 | |
|---|
| | | | `Gs.Setup/` | Visual Studio Installer 项目（`.vdproj`），用于打包发布。 | |
|---|
| | | | `packages/` | NuGet 缓存目录，包含 DevExpress、CefSharp、NModbus、System.* 依赖。 | |
|---|
| | | |
|---|
| | | - **.NET Framework 4.8** - 核心应用框架 |
|---|
| | | - **DevExpress v22.2/v129.0** - 主要UI组件库 |
|---|
| | | - **C# Windows Forms** - 桌面应用程序框架，MDI接口设计 |
|---|
| | | - **Oracle Database** - 数据持久化 (Oracle.ManagedDataAccess 23.6.0) |
|---|
| | | - **CefSharp 109.1.110/129.0** - 嵌入式Web浏览器 |
|---|
| | | - **WebView2** - 现代Web视图集成 |
|---|
| | | - **Newtonsoft.Json 13.0.3** - JSON序列化 |
|---|
| | | - **AutoUpdater.NET** - 自动应用程序更新 |
|---|
| | | - **NModbus 3.0.81** - 工业通信协议 |
|---|
| | | - **FastReport** - 报表生成系统 |
|---|
| | | ## 3. 核心技术栈 |
|---|
| | | - **.NET Framework 4.8 / C# WinForms**：应用基础框架。 |
|---|
| | | - **DevExpress v22.2**：UI 组件（FluentDesign、XtraGrid、XtraTab、WaitDialog 等）。 |
|---|
| | | - **CefSharp 109 + AutoUpdater.NET**：嵌入式浏览器与可选的自动更新能力。 |
|---|
| | | - **NModbus、SerialPort**：工业设备通信，涵盖 TCP 与 RTU。 |
|---|
| | | - **Newtonsoft.Json、ConfigurationManager**：API 数据解析与配置读取。 |
|---|
| | | - **Oracle.ManagedDataAccess、System.Data.SqlClient**：按场景访问 Oracle 或 SQL Server。 |
|---|
| | | |
|---|
| | | ## 项目架构结构 |
|---|
| | | ## 4. DevFrm 功能模块详解 |
|---|
| | | |
|---|
| | | ### 顶级目录结构 |
|---|
| | | ### 4.1 登录与主框架 |
|---|
| | | - `Program.cs`：单实例守护、CefSharp 初始化、启动登录流程。 |
|---|
| | | - `FrmLogin`：自动更新（AutoUpdater.NET）、字体加载、账号记忆、调用 `User/UserLogin`。 |
|---|
| | | - `FrmMain`：DevExpress FluentDesign 主界面，负责菜单树加载（`User/GetUserLoginInfo`）、页签生命周期、组织切换、底部状态栏及窗口间事件传递。 |
|---|
| | | |
|---|
| | | ``` |
|---|
| | | DevApp/ |
|---|
| | | ├── Gs.DevApp/ # 主应用程序项目 |
|---|
| | | │ ├── DevFrm/ # 业务功能模块窗体 |
|---|
| | | │ ├── Entity/ # 数据实体类 |
|---|
| | | │ ├── ToolBox/ # 工具类和辅助函数 |
|---|
| | | │ ├── UserControl/ # 自定义用户控件 |
|---|
| | | │ ├── Properties/ # 项目属性 |
|---|
| | | │ ├── Resources/ # 资源文件 |
|---|
| | | │ ├── bin/ # 编译输出目录 |
|---|
| | | │ └── obj/ # 编译临时文件 |
|---|
| | | ├── Gs.WeightIqc/ # IQC称重检测模块 |
|---|
| | | ├── Gs.WeightLine/ # 生产线称重模块 |
|---|
| | | ├── Gs.Setup/ # 安装程序项目 |
|---|
| | | └── packages/ # NuGet包管理目录 |
|---|
| | | ``` |
|---|
| | | ### 4.2 基础数据域 |
|---|
| | | - **`BasicData/`**：维护系统主数据。典型窗体包括 `Frm_Customer`（客户）、`Frm_Supplier` & `Frm_SupplierSrm`（供应商与 SRM 关系）、`Frm_MesItems`/`Frm_MesItemsShow`（物料）、`Frm_MesWorkshopLine`（产线）、`Frm_Staff`、`Frm_Department` 等。 |
|---|
| | | - **`BarCode/`**：条码批量生成、打印模板设置，常见窗体如 `Frm_BarcodePrint`, `Frm_BarcodeTemplate`。 |
|---|
| | | - **`JJGZ/`**：夹具工装及设备点检相关主数据，维护工装台账、点检项目。 |
|---|
| | | |
|---|
| | | ### 应用程序入口点 |
|---|
| | | ### 4.3 仓储管理域 |
|---|
| | | - **`Ck/`（出库）**：覆盖材料、补料、其他、退货、委外等出库流程；如 `Frm_MesItemBl`（补料出库）、`Frm_MesCgthSq`（采购退货申请）、`Frm_MesInvItemOut_SCLL`（生产领料出库）。 |
|---|
| | | - **`Rk/`（入库）**：来料、退库及杂项入库；如 `Frm_MesInvItemArn`（到货入库）、`Frm_MesItemTbl`（材料入库台账）、`Frm_MesItemQtrk`（其他入库）。 |
|---|
| | | - **`Warehouse/`**：库内操作与条码维护；包含 `Frm_MesDbck`（调拨出库）、`Frm_MesRohIn`（原材入库）、`Frm_ArrivalBarcode`、`Frm_InitialBarcode` 等条码处理。 |
|---|
| | | - **`PDA/`**：与手持设备交互的简化界面，提供扫码、理货、盘点等现场动作。 |
|---|
| | | |
|---|
| | | - **Program.cs** - 应用程序主入口，单实例管理，CefSharp初始化 |
|---|
| | | - **DevFrm/FrmLogin.cs** - 登录窗体，自动更新器集成 |
|---|
| | | - **DevFrm/FrmMain.cs** - 主MDI窗体，DevExpress FluentDesign界面 |
|---|
| | | ### 4.4 质量管理域 |
|---|
| | | - **`QC/`**：质量通用模块与字典维护，含缺陷代码（`DefectCode*.cs`）、检验项目（`Frm_MesQaItemsDetect01`）、AQL 抽样设置（`Frm_MesQmAql1`）等，并提供 `Models/` DTO。 |
|---|
| | | - **`IPQC/`**：制程过程检验，如 `Frm_ShouJian`（首件）、`Frm_XunJian`（巡检）、H5 检验界面等。 |
|---|
| | | - **`FQC/`**：成品终检，包括 `Frm_Fqc`、`Frm_FqcDetect01`、异常处理 `MesFqcExceptional`。 |
|---|
| | | - **`RkQC/`**：来料质检，提供 `Frm_Cqfa`（抽检方案）、`Frm_CqfaItems`、`Frm_QtrkDetect01`、`Frm_WwrkDetect01` 等。 |
|---|
| | | - **`WW/`**：委外质量管理，如委外检验、异常回传。 |
|---|
| | | |
|---|
| | | ## 核心业务模块详解 (DevFrm/) |
|---|
| | | ### 4.5 制造执行域 |
|---|
| | | - **`Work/`**：制程作业核心，如 `Frm_WorkStart`（工序开工）、`Frm_WorkProcesses`（流程卡控）、`Frm_Work01/09`（工站数据采集，含 Modbus、SQLServer 交互）、`Frm_Repair`（返工维修）等。 |
|---|
| | | - **`WOM/`**：工单管理，负责生产任务下达、排产调整、工单追踪。 |
|---|
| | | |
|---|
| | | ### 1. 基础数据管理 (BasicData/) |
|---|
| | | **功能：** 系统基础主数据维护和管理 |
|---|
| | | ### 4.6 销售、报表与统计 |
|---|
| | | - **`Sales/`**：销售订单、发货、退货等前端业务。 |
|---|
| | | - **`Rpt/`**：报表中心，包含 FastReport/DevExpress 报表设计、运行、数据源配置，如 `EasyRptDesign`, `EasyRptEdt`, `SysHelp` 等。 |
|---|
| | | |
|---|
| | | **主要模块：** |
|---|
| | | - `Frm_Customer.cs` - 客户信息管理 |
|---|
| | | - `Frm_Supplier.cs` - 供应商信息管理 |
|---|
| | | - `Frm_SupplierSrm.cs` - SRM供应商关系管理 |
|---|
| | | - `Frm_MesItems.cs` - 物料主数据管理 |
|---|
| | | - `Frm_MesItemsShow.cs` - 物料信息展示 |
|---|
| | | - `Frm_MesItemType.cs` - 物料分类管理 |
|---|
| | | - `Frm_MesUnit.cs` - 计量单位管理 |
|---|
| | | - `Frm_MesDepot.cs` - 仓库信息管理 |
|---|
| | | - `Frm_MesWorkshopLine.cs` - 车间生产线配置 |
|---|
| | | - `Frm_Staff.cs` - 员工信息管理 |
|---|
| | | - `Frm_Department.cs` - 部门信息管理 |
|---|
| | | ### 4.7 系统与权限 |
|---|
| | | - **`Sys/`**：系统设置与后台管理。功能包括 `SysMenu`（菜单结构）、`Organization`（组织树）、`DocNoRule`（单号规则）、`SysLog`、`SysHelp`、`Frm_Config` 等。 |
|---|
| | | - **`User/`**：用户、角色、角色授权、密码变更等，如 `User`, `Role`, `RoleSelectAction`, `UserSetPwd`。 |
|---|
| | | |
|---|
| | | ### 2. 仓库出库模块 (Ck/) |
|---|
| | | **功能：** 仓库出库业务流程管理，包含各种出库类型 |
|---|
| | | ### 4.8 其它支持域 |
|---|
| | | - `JJGZ/`：夹具工装、计量设备台账与点检任务，为质量与维护模块提供基础数据。 |
|---|
| | | - `WW/`：委外协同作业及质检闭环，衔接外协流程。 |
|---|
| | | - `PDA/`：手持终端界面集，用于仓储、生产、质检场景的扫码作业。 |
|---|
| | | - 根目录下的 `FrmMain`、`FrmLogin`、`XtraForm*` 等窗体提供通用示例或调试入口，可作为新模块参考模板。 |
|---|
| | | |
|---|
| | | **主要模块：** |
|---|
| | | - `Frm_MesItemCl.cs` / `Frm_MesItemClDj.cs` - 材料出库申请/单据 |
|---|
| | | - `Frm_MesItemBl.cs` / `Frm_MesItemBlDJ.cs` - 补料出库申请/单据 |
|---|
| | | - `Frm_MesItemQt.cs` / `Frm_MesItemQtDj.cs` - 其他出库申请/单据 |
|---|
| | | - `Frm_MesCgthSq.cs` / `Frm_MesCgthSqDj.cs` - 采购退货申请/单据 |
|---|
| | | - `Frm_MesSctkSq.cs` / `Frm_MesSctkSqDj.cs` - 生产退库申请/单据 |
|---|
| | | - `Frm_MesInvItemOut_SCLL.cs` - 生产领料出库 |
|---|
| | | - `Frm_MesYanTui.cs` - 验收退货管理 |
|---|
| | | ## 5. 工具、控件与公共能力 |
|---|
| | | - `ToolBox/UtilityHelper`：封装 `HttpPost`、JSON 解析（`ReturnToDynamic/ReturnToTablePage`）、资源加载、Grid 初始化、过滤条件描述等。 |
|---|
| | | - `ToolBox/LogHelper`：按日期写入 `logs/{yyyy-MM-dd}.log`；GUI 层统一通过 `MsgHelper` 提示。 |
|---|
| | | - `ToolBox/UpdateParentEventArgs`：用于子窗体与主窗体之间的事件通信。 |
|---|
| | | - `UserControl/`：`UcToolBarMenu`、`UcPageBar`、`UcDictionarySelect`、`UcLook*` 等控件提升复用性；`Toast` 用于轻量提示。 |
|---|
| | | |
|---|
| | | ### 3. 仓库入库模块 (Rk/) |
|---|
| | | **功能：** 仓库入库业务流程管理 |
|---|
| | | ## 6. 辅助项目说明 |
|---|
| | | - **Gs.WeightIqc**：定时读取串口称重数据，通过 `WorkWeight/EditModel` API 上报；含线程管理、串口配置、日志记录。 |
|---|
| | | - **Gs.WeightLine**：类似 IQC，但支持线体下拉选择、双计时器刷新以及更多界面交互。 |
|---|
| | | - **Gs.Setup**：生成安装包或 ClickOnce 部署所需的安装工程，与 Release 构建输出配套。 |
|---|
| | | |
|---|
| | | **主要模块：** |
|---|
| | | - `Frm_MesItemTbl.cs` - 材料入库台账 |
|---|
| | | - `Frm_MesItemTbl_RK.cs` - 入库单据处理 |
|---|
| | | - `Frm_MesItemTblShow.cs` - 入库信息展示 |
|---|
| | | - `Frm_MesItemQtrk.cs` / `Frm_MesItemQtrkDj.cs` - 其他入库申请/单据 |
|---|
| | | - `Frm_MesInvItemArn.cs` - 到货入库管理 |
|---|
| | | - `Frm_MesInvItemIns.cs` - 检验入库管理 |
|---|
| | | ## 7. 配置与环境 |
|---|
| | | - 主配置文件：`Gs.DevApp/App.config`（运行期读取 `Gs.DevApp.exe.config`）。 |
|---|
| | | - 关键键值：`WebApiUrl`、`ProductName`、`Version`、`IsAutoUpdater`、`AutoUpdaterXml`、`LogPath`、`AsyncSeconds`、`TimingMailInterval` 等。 |
|---|
| | | - 设备与数据库地址默认指向内网 IP（如 `192.168.0.51`、`192.168.60.51`），部署前需按环境调整。 |
|---|
| | | - 称重模块使用串口参数（波特率、端口号）及 Modbus 站号/寄存器配置；建议将硬编码路径抽离到配置或后台参数表。 |
|---|
| | | - 日志默认写入应用目录下 `logs/`；请确保客户端具备写权限或改为公共数据目录。 |
|---|
| | | |
|---|
| | | ### 4. 质量控制模块 |
|---|
| | | ## 8. 构建与部署 |
|---|
| | | - 调试构建：`msbuild GsDevSolution.sln /p:Configuration=Debug` |
|---|
| | | - 发布构建：`msbuild .\Gs.DevApp\Gs.DevApp.csproj /t:Rebuild /p:Configuration=Release` |
|---|
| | | - 可执行文件位于 `bin\{Configuration}\`；发布时需携带 DevExpress、CefSharp 依赖及 `x86/x64` 子目录。 |
|---|
| | | - 安装包：在 Release 构建后打开 `Gs.Setup/Gs.Setup.vdproj` 导出 MSI/EXE。 |
|---|
| | | - 自动更新：若启用 `IsAutoUpdater=1`，需要部署 `AutoUpdaterXml` 指向的更新描述文件与安装包。 |
|---|
| | | |
|---|
| | | #### 4.1 FQC (Final Quality Control) - 最终质量控制 |
|---|
| | | **功能：** 成品出货前最终质量检验 |
|---|
| | | - `Frm_Fqc.cs` - FQC检验主界面 |
|---|
| | | - `Frm_FqcDetect01.cs` - FQC检测流程 |
|---|
| | | - `Frm_FQCItem.cs` - FQC检验项目管理 |
|---|
| | | ## 9. 开发与调试建议 |
|---|
| | | - 遵循现有目录划分，新增功能优先放置于相应业务子目录。 |
|---|
| | | - 复用 `ToolBox`、`UserControl` 中的公共能力，避免重复实现 HTTP、日志、分页、选择器等逻辑。 |
|---|
| | | - 关键 API 调用前后记录日志，异常时使用 `MsgHelper` 展示友好信息，并在后台日志附带上下文（工站、条码、用户等）。 |
|---|
| | | - 在涉及硬件或长耗时操作时，使用后台线程/异步模式，避免阻塞 UI；替换 `Thread.Abort` 为取消标记可提升稳定性。 |
|---|
| | | - 建议建立手工测试清单：登录、菜单加载、核心业务流程、称重上传、报表打印等。 |
|---|
| | | - 明文凭据和环境 IP 应迁移至安全配置或环境变量，提交前注意脱敏。 |
|---|
| | | |
|---|
| | | #### 4.2 IPQC (In-Process Quality Control) - 过程质量控制 |
|---|
| | | **功能：** 生产过程中的质量检验和监控 |
|---|
| | | - `Frm_ShouJian.cs` - 首件检验 |
|---|
| | | - `Frm_ShouJianDetect01.cs` - 首件检测流程 |
|---|
| | | - `Frm_ShouJianDetect01H5.cs` - 首件检测H5版本 |
|---|
| | | - `Frm_XunJian.cs` - 巡检管理 |
|---|
| | | - `Frm_XunJianDetect01.cs` - 巡检检测流程 |
|---|
| | | - `Frm_XunJianDetect01Show.cs` - 巡检结果展示 |
|---|
| | | |
|---|
| | | #### 4.3 RkQC (Receiving Quality Control) - 来料质量控制 |
|---|
| | | **功能：** 来料和入库物料质量检验 |
|---|
| | | - `Frm_RkDetect01.cs` - 来料检验 |
|---|
| | | - `Frm_CqDetect01.cs` - 抽检检验 |
|---|
| | | - `Frm_QtrkDetect01.cs` - 其他入库检验 |
|---|
| | | - `Frm_WwrkDetect01.cs` - 完工入库检验 |
|---|
| | | - `Frm_ShouTuoDetect01.cs` - 委托加工检验 |
|---|
| | | - `Frm_Cqfa.cs` - 抽检方案管理 |
|---|
| | | - `Frm_CqfaItems.cs` - 抽检项目配置 |
|---|
| | | - `Frm_Cqsq.cs` - 抽检申请 |
|---|
| | | |
|---|
| | | #### 4.4 QC - 质量控制通用模块 |
|---|
| | | **功能：** 质量管理通用功能和配置 |
|---|
| | | - `Frm_MesQaMj.cs` - 质量检验模板 |
|---|
| | | - `Frm_MesQaItemsDetect01.cs` - 检验项目检测 |
|---|
| | | - `Frm_MesQaItemsDetect01Input.cs` - 检验数据录入 |
|---|
| | | - `Frm_MesQmCheckitemDt.cs` - 检验项目明细 |
|---|
| | | - `Frm_MesQmAql1.cs` - AQL抽样标准 |
|---|
| | | - `Frm_MesDefectCodeShow.cs` - 缺陷代码展示 |
|---|
| | | - `Frm_IQCLookups.cs` - IQC查询界面 |
|---|
| | | - `Frm_MesSysLookups.cs` - 系统查询配置 |
|---|
| | | |
|---|
| | | ### 5. 工单管理模块 (WOM/) |
|---|
| | | **功能：** 生产工单全生命周期管理 |
|---|
| | | |
|---|
| | | **主要模块：** |
|---|
| | | - `Frm_MesWorkProd.cs` - 生产工单管理 |
|---|
| | | - `Frm_MesProcGx.cs` - 工艺流程管理 |
|---|
| | | - `Frm_MesProcGx0.cs` - 工艺流程基础版 |
|---|
| | | - `Frm_MesProcGxShow.cs` - 工艺流程展示 |
|---|
| | | - `Frm_Womdaa.cs` - 工单档案管理 |
|---|
| | | - `Frm_Womdaahb.cs` - 工单档案汇总 |
|---|
| | | - `Frm_WomdaaNbz.cs` - 工单档案内部转移 |
|---|
| | | - `Frm_Womcaa.cs` - 工单成本分析 |
|---|
| | | - `Frm_Wompba.cs` - 工单派工管理 |
|---|
| | | - `Frm_WompbaGx.cs` - 工单派工工序 |
|---|
| | | - `Frm_WomFanGong.cs` - 返工单管理 |
|---|
| | | - `Frm_MesScrkDj.cs` - 生产入库单据 |
|---|
| | | - `Frm_MesScrksqDj.cs` - 生产入库申请单据 |
|---|
| | | - `FrmAutoRk.cs` - 自动入库 |
|---|
| | | - `FrmBackFlash.cs` - 反冲处理 |
|---|
| | | |
|---|
| | | ### 6. 生产作业模块 (Work/) |
|---|
| | | **功能：** 车间生产作业执行和管理 |
|---|
| | | |
|---|
| | | **主要模块：** |
|---|
| | | - `Frm_WorkStart.cs` - 生产开工 |
|---|
| | | - `Frm_Work01.cs` - 生产作业主界面 |
|---|
| | | - `Frm_Work09.cs` - 生产作业流程9 |
|---|
| | | - `Frm_WorkProcesses.cs` - 工序作业管理 |
|---|
| | | - `Frm_WorkTechnique.cs` - 工艺技术管理 |
|---|
| | | - `Frm_WorkTechniqueShow.cs` - 工艺技术展示 |
|---|
| | | - `Frm_Repair.cs` - 返修作业管理 |
|---|
| | | |
|---|
| | | ### 7. 车间管理模块 (WW/) |
|---|
| | | **功能：** 车间现场作业和生产调度 |
|---|
| | | |
|---|
| | | **主要模块：** |
|---|
| | | - `Frm_WwBl.cs` / `Frm_WwBlDj.cs` - 车间补料申请/单据 |
|---|
| | | - `Frm_WwCl.cs` / `Frm_WwClDj.cs` - 车间领料申请/单据 |
|---|
| | | - `Frm_WwTbl.cs` / `Frm_WwTblDj.cs` - 车间台账/单据 |
|---|
| | | - `Frm_WwLlDj.cs` - 车间领料单据 |
|---|
| | | - `Frm_WwPc.cs` - 车间排产管理 |
|---|
| | | - `Frm_WwGd.cs` - 车间工单管理 |
|---|
| | | - `Frm_ProductionOrder.cs` - 生产订单管理 |
|---|
| | | |
|---|
| | | ### 8. 仓库管理模块 (Warehouse/) |
|---|
| | | **功能：** 仓库综合管理功能 |
|---|
| | | |
|---|
| | | **主要模块：** |
|---|
| | | - `Frm_InitialBarcode.cs` - 初始条码管理 |
|---|
| | | - `Frm_ArrivalBarcode.cs` - 到货条码管理 |
|---|
| | | - `Frm_MesShouTuo.cs` / `Frm_MesShouTuoDj.cs` - 委托加工申请/单据 |
|---|
| | | - `Frm_MesShouTui.cs` / `Frm_MesShouTuiDj.cs` - 委托退货申请/单据 |
|---|
| | | - `Frm_MesDbck.cs` / `Frm_MesDbckDj.cs` - 调拨出库申请/单据 |
|---|
| | | - `Frm_MesRohIn.cs` - 原材料入库 |
|---|
| | | |
|---|
| | | ### 9. 销售管理模块 (Sales/) |
|---|
| | | **功能：** 销售订单和发货管理 |
|---|
| | | |
|---|
| | | **主要模块：** |
|---|
| | | - `Frm_SalesOrder.cs` - 销售订单管理 |
|---|
| | | - `Frm_SalesDeliver.cs` / `Frm_SalesDeliverDj.cs` - 销售发货申请/单据 |
|---|
| | | - `Frm_SalesDeliverSelect.cs` - 发货单选择 |
|---|
| | | - `Frm_SalesReturnNotice.cs` / `Frm_SalesReturnNoticeDj.cs` - 销售退货通知申请/单据 |
|---|
| | | - `Frm_SalesReturnNoticeSelect.cs` - 退货通知选择 |
|---|
| | | - `Frm_SalesReturnNoticeSelect2.cs` - 退货通知选择2 |
|---|
| | | - `Frm_SalesReturnNoticeSelectLink.cs` - 退货通知关联选择 |
|---|
| | | |
|---|
| | | ### 10. 条码管理模块 (BarCode/) |
|---|
| | | **功能：** 条码生成、打印和管理 |
|---|
| | | |
|---|
| | | **主要模块：** |
|---|
| | | - `Frm_BoxCode.cs` - 箱码管理 |
|---|
| | | - `SelectBoxDaa.cs` - 选择箱档案 |
|---|
| | | - `SelectBoxItem.cs` - 选择箱项目 |
|---|
| | | |
|---|
| | | ### 11. PDA移动设备模块 (PDA/) |
|---|
| | | **功能：** 移动设备集成和用户绑定 |
|---|
| | | |
|---|
| | | **主要模块：** |
|---|
| | | - `Frm_UserBind.cs` - 用户绑定 |
|---|
| | | - `Frm_UserBindLst.cs` - 用户绑定列表 |
|---|
| | | - `Frm_AreaBind.cs` - 区域绑定 |
|---|
| | | |
|---|
| | | ### 12. 计件工资模块 (JJGZ/) |
|---|
| | | **功能：** 员工计件工资计算和管理 |
|---|
| | | |
|---|
| | | **主要模块：** |
|---|
| | | - `Frm_MesJJSalary.cs` - 计件工资管理 |
|---|
| | | - `Frm_MesJSSalary.cs` - 计时工资管理 |
|---|
| | | - `Frm_MesJjgzSchedule.cs` - 工资排班管理 |
|---|
| | | - `Frm_MesTimeType.cs` - 时间类型管理 |
|---|
| | | - `Frm_MesAttanCon.cs` - 考勤统计 |
|---|
| | | - `Frm_MesDeToLine.cs` - 员工分线管理 |
|---|
| | | - `Frm_MESJJERRORJS.cs` - 计件错误校正 |
|---|
| | | |
|---|
| | | ### 13. 报表模块 (Rpt/) |
|---|
| | | **功能：** 报表查询和生成 |
|---|
| | | |
|---|
| | | **主要模块：** |
|---|
| | | - `Frm_MesQL.cs` - MES查询报表 |
|---|
| | | |
|---|
| | | ### 14. 系统管理模块 (Sys/) |
|---|
| | | **功能：** 系统配置和管理功能 |
|---|
| | | |
|---|
| | | **主要模块：** |
|---|
| | | - `Frm_Config.cs` - 系统配置 |
|---|
| | | - `Frm_MesSysPageview.cs` - 系统页面视图 |
|---|
| | | - `Frm_PrintInfo.cs` - 打印信息管理 |
|---|
| | | - `Frm_PrintUser.cs` - 打印用户管理 |
|---|
| | | |
|---|
| | | ### 15. 用户管理模块 (User/) |
|---|
| | | **功能：** 用户权限和角色管理 |
|---|
| | | - 包含用户认证、授权、角色管理等功能 |
|---|
| | | |
|---|
| | | ## 支撑模块详解 |
|---|
| | | |
|---|
| | | ### Entity/ - 数据实体层 |
|---|
| | | **功能：** 定义数据传输对象和业务实体 |
|---|
| | | |
|---|
| | | **核心类：** |
|---|
| | | - `LoginInfoModel.cs` - 登录用户信息管理，单例模式实现 |
|---|
| | | - `ReturnModel.cs` - API返回结果统一封装 |
|---|
| | | - `PageQueryModel.cs` - 分页查询模型 |
|---|
| | | - `XlsOutModel.cs` - Excel导出模型 |
|---|
| | | |
|---|
| | | ### ToolBox/ - 工具类库 |
|---|
| | | **功能：** 提供通用工具函数和帮助类 |
|---|
| | | |
|---|
| | | **核心类：** |
|---|
| | | - `UtilityHelper.cs` - 通用工具类，包含UI操作、HTTP通信、数据处理等 |
|---|
| | | - `LogHelper.cs` - 日志记录工具，支持调试和错误日志 |
|---|
| | | - `MsgHelper.cs` - 消息提示工具，标准化用户交互 |
|---|
| | | - `UpdateParentEventArgs.cs` - 父窗体更新事件参数 |
|---|
| | | |
|---|
| | | ### UserControl/ - 自定义控件库 |
|---|
| | | **功能：** 可复用的用户界面控件 |
|---|
| | | |
|---|
| | | **主要控件分类：** |
|---|
| | | |
|---|
| | | #### 查找控件系列 (UcLook*.cs) |
|---|
| | | - `UcLookCustomer.cs` - 客户查找控件 |
|---|
| | | - `UcLookSupplier.cs` - 供应商查找控件 |
|---|
| | | - `UcLookItems.cs` - 物料查找控件 |
|---|
| | | - `UcLookStaff.cs` - 员工查找控件 |
|---|
| | | - `UcLookDepartment.cs` - 部门查找控件 |
|---|
| | | - `UcLookOrg.cs` - 组织查找控件 |
|---|
| | | - `UcLookUnit.cs` - 单位查找控件 |
|---|
| | | - `UcLookUser.cs` - 用户查找控件 |
|---|
| | | - `UcLookWorkshop.cs` - 车间查找控件 |
|---|
| | | - `UcLookWorkline.cs` - 生产线查找控件 |
|---|
| | | - `UcLookGx.cs` - 工序查找控件 |
|---|
| | | - `UcLookKw.cs` - 库位查找控件 |
|---|
| | | - `UcLookCk.cs` - 仓库查找控件 |
|---|
| | | - `UcLookWwgd.cs` - 车间工单查找控件 |
|---|
| | | - `UcLookDaa.cs` - 档案查找控件 |
|---|
| | | - `UcLookHuoZhu.cs` - 货主查找控件 |
|---|
| | | - `UcLookSales.cs` - 销售查找控件 |
|---|
| | | - `UcLookPrint.cs` - 打印查找控件 |
|---|
| | | |
|---|
| | | #### 选择控件系列 (Select*.cs) |
|---|
| | | - `SelectCw.cs` - 仓位选择控件 |
|---|
| | | - `SelectFont.cs` - 字体选择控件 |
|---|
| | | - `SelectHz.cs` - 货主选择控件 |
|---|
| | | - `SelectOrg.cs` - 组织选择控件 |
|---|
| | | - `SelectKw.cs` - 库位选择控件 |
|---|
| | | - `SelectCk.cs` - 仓库选择控件 |
|---|
| | | - `SelectDaa.cs` - 档案选择控件 |
|---|
| | | - `SelectCgMx.cs` - 采购明细选择控件 |
|---|
| | | - `SelectMesCgthSq.cs` - 采购退货申请选择控件 |
|---|
| | | - `SelectMesCgthSqLink.cs` - 采购退货申请关联选择控件 |
|---|
| | | - `SelectSrm.cs` - SRM选择控件 |
|---|
| | | - `SelectDeleteBar.cs` - 删除条码选择控件 |
|---|
| | | |
|---|
| | | #### 通用功能控件 |
|---|
| | | - `UcPageBar.cs` - 分页导航控件 |
|---|
| | | - `UcDictionary.cs` - 数据字典控件 |
|---|
| | | - `UcDictionaryComBox.cs` - 数据字典下拉控件 |
|---|
| | | - `UcDictionarySelect.cs` - 数据字典选择控件 |
|---|
| | | - `UcCheckFlow.cs` - 审核流程控件 |
|---|
| | | - `UcToolBarMenu.cs` - 工具栏菜单控件 |
|---|
| | | |
|---|
| | | #### 文件和打印控件 |
|---|
| | | - `UCUpFile.cs` - 文件上传控件 |
|---|
| | | - `UCUpFileList.cs` - 文件上传列表控件 |
|---|
| | | - `ShowFile.cs` - 文件展示控件 |
|---|
| | | - `UcBtnPrint.cs` - 打印按钮控件 |
|---|
| | | - `UcBtnPrintOne.cs` - 单次打印按钮控件 |
|---|
| | | |
|---|
| | | #### 展示和布局控件 |
|---|
| | | - `ShowLogcs.cs` - 日志展示控件 |
|---|
| | | - `ShowFilter.cs` - 过滤器展示控件 |
|---|
| | | - `ShowRptWizard.cs` - 报表向导展示控件 |
|---|
| | | - `ShowUp.cs` - 上传展示控件 |
|---|
| | | - `showLayOut.cs` - 布局展示控件 |
|---|
| | | - `Toast.cs` - 消息提示控件 |
|---|
| | | - `CopyXls.cs` - Excel复制控件 |
|---|
| | | |
|---|
| | | ## 辅助项目 |
|---|
| | | |
|---|
| | | ### Gs.WeightIqc/ - IQC称重检测 |
|---|
| | | **功能：** IQC质量检验中的称重功能模块 |
|---|
| | | - 专门用于来料检验过程中的重量检测 |
|---|
| | | - 支持电子秤设备集成 |
|---|
| | | |
|---|
| | | ### Gs.WeightLine/ - 生产线称重 |
|---|
| | | **功能：** 生产线实时称重监控 |
|---|
| | | - 生产过程中的重量监控 |
|---|
| | | - 支持多种称重设备协议 |
|---|
| | | |
|---|
| | | ### Gs.Setup/ - 安装程序 |
|---|
| | | **功能：** 应用程序安装包制作 |
|---|
| | | - ClickOnce部署支持 |
|---|
| | | - 自动更新配置 |
|---|
| | | |
|---|
| | | ## 数据访问和通信 |
|---|
| | | |
|---|
| | | ### 数据库连接 |
|---|
| | | - 使用Oracle.ManagedDataAccess 23.6.0连接Oracle数据库 |
|---|
| | | - 通过WebAPI后端服务进行数据访问 |
|---|
| | | - 支持连接字符串动态配置 |
|---|
| | | |
|---|
| | | ### HTTP通信 |
|---|
| | | - 基于UtilityHelper类实现HTTP客户端功能 |
|---|
| | | - 使用Newtonsoft.Json进行数据序列化 |
|---|
| | | - 支持RESTful API调用 |
|---|
| | | |
|---|
| | | ### 工业通信 |
|---|
| | | - 集成NModbus 3.0.81支持工业设备通信 |
|---|
| | | - 支持Modbus协议的PLC设备集成 |
|---|
| | | |
|---|
| | | ## 界面和用户体验 |
|---|
| | | |
|---|
| | | ### DevExpress集成 |
|---|
| | | - 使用DevExpress LookAndFeel实现统一主题 |
|---|
| | | - FluentDesign现代化界面风格 |
|---|
| | | - 丰富的网格控件和数据展示组件 |
|---|
| | | |
|---|
| | | ### Web集成 |
|---|
| | | - CefSharp嵌入式浏览器支持 |
|---|
| | | - WebView2现代Web视图 |
|---|
| | | - 支持H5页面集成（如检测界面） |
|---|
| | | |
|---|
| | | ## 部署和更新 |
|---|
| | | |
|---|
| | | ### 自动更新 |
|---|
| | | - 集成AutoUpdater.NET实现自动更新 |
|---|
| | | - 支持版本检测和增量更新 |
|---|
| | | - 配置化更新服务器地址 |
|---|
| | | |
|---|
| | | ### 配置管理 |
|---|
| | | - App.config配置文件管理 |
|---|
| | | - 支持WebAPI地址、日志路径等关键配置 |
|---|
| | | - 生产和测试环境隔离 |
|---|
| | | |
|---|
| | | ## 开发规范建议 |
|---|
| | | |
|---|
| | | 1. **模块化开发**：遵循现有的按业务功能划分的目录结构 |
|---|
| | | 2. **代码复用**：充分利用UserControl中的自定义控件 |
|---|
| | | 3. **统一规范**：使用UtilityHelper、LogHelper等工具类保持代码一致性 |
|---|
| | | 4. **界面风格**：遵循DevExpress设计规范，保持界面一致性 |
|---|
| | | 5. **错误处理**：统一使用LogHelper记录日志，MsgHelper显示用户消息 |
|---|
| | | 6. **数据访问**：通过WebAPI进行数据操作，避免直接数据库访问 |
|---|
| | | |
|---|
| | | 这个MES系统提供了完整的制造执行管理功能，从基础数据管理到生产执行，从质量控制到仓库管理，形成了完整的制造业务闭环。系统架构清晰，模块职责明确，为制造企业提供了强大的信息化支撑平台。 |
|---|
| | | --- |
|---|
| | | 如需进一步扩展或培训，可基于本指南快速定位模块入口、核心配置以及构建流程。欢迎根据实际业务持续补充。*** |
|---|
