From 06e404fe295d6433246cd95cef5eb04797b4f8bd Mon Sep 17 00:00:00 2001
From: kyy <3283105747@qq.com>
Date: 星期四, 11 十二月 2025 10:37:31 +0800
Subject: [PATCH] 1、克重逻辑修改
---
DevApp/HELP.md | 1716 ++++++++++++++++++++++++++++++++++++++++++++++++----------
1 files changed, 1,400 insertions(+), 316 deletions(-)
diff --git a/DevApp/HELP.md b/DevApp/HELP.md
index 4b18a0a..a64b2d4 100644
--- a/DevApp/HELP.md
+++ b/DevApp/HELP.md
@@ -1,390 +1,1474 @@
-# 钃濆疂MES绯荤粺浠ｇ爜缁撴瀯璇︾粏璇存槑
+# 钃濆疂 MES 瀹㈡埛绔府鍔╂寚鍗� (G-MES V2.0)
-## 椤圭洰姒傝堪
+> **LanBMes MES Client** 鏄熀浜� .NET Framework 4.8 鍜� DevExpress WinForms 鏋勫缓鐨勪紒涓氱骇鍒堕�犳墽琛岀郴缁�(MES)妗岄潰搴旂敤绋嬪簭,涓哄埗閫犺溅闂存彁渚涘叏闈㈢殑鐢熶骇鎵ц銆佷粨鍌ㄧ鐞嗐�佽川閲忔帶鍒跺拰鎶ヨ〃鍒嗘瀽鑳藉姏銆�
-钃濆疂PC鍓嶇 (LanBao PC Frontend) 鏄竴涓熀浜� .NET Framework 4.8 鐨勫埗閫犳墽琛岀郴缁� (MES) 瀹㈡埛绔簲鐢ㄧ▼搴忥紝閲囩敤 Windows Forms 鎶�鏈爤鍜� DevExpress UI 缁勪欢搴擄紝鎻愪緵瀹屾暣鐨勫埗閫犱笟鍔＄鐞嗗姛鑳姐��
+## 鐩綍
-## 鎶�鏈爤
+- [1. 椤圭洰姒傝](#1-椤圭洰姒傝)
+- [2. 瑙ｅ喅鏂规缁撴瀯](#2-瑙ｅ喅鏂规缁撴瀯)
+- [3. 鏍稿績鎶�鏈爤](#3-鏍稿績鎶�鏈爤)
+- [4. 寮�鍙戠幆澧冮厤缃甝(#4-寮�鍙戠幆澧冮厤缃�)
+- [5. 鏋勫缓涓庤繍琛宂(#5-鏋勫缓涓庤繍琛�)
+- [6. DevFrm 鍔熻兘妯″潡璇﹁В](#6-devfrm-鍔熻兘妯″潡璇﹁В)
+- [7. 鏋舵瀯涓庤璁℃ā寮廬(#7-鏋舵瀯涓庤璁℃ā寮�)
+- [8. 宸ュ叿绫讳笌鍏叡缁勪欢](#8-宸ュ叿绫讳笌鍏叡缁勪欢)
+- [9. 閰嶇疆璇存槑](#9-閰嶇疆璇存槑)
+- [10. 閮ㄧ讲鎸囧崡](#10-閮ㄧ讲鎸囧崡)
+- [11. 寮�鍙戣鑼冧笌鏈�浣冲疄璺礭(#11-寮�鍙戣鑼冧笌鏈�浣冲疄璺�)
+- [12. 甯歌闂涓庢晠闅滄帓鏌(#12-甯歌闂涓庢晠闅滄帓鏌�)
-- **.NET Framework 4.8** - 鏍稿績搴旂敤妗嗘灦
-- **DevExpress v22.2/v129.0** - 涓昏UI缁勪欢搴�
-- **C# Windows Forms** - 妗岄潰搴旂敤绋嬪簭妗嗘灦锛孧DI鎺ュ彛璁捐
-- **Oracle Database** - 鏁版嵁鎸佷箙鍖� (Oracle.ManagedDataAccess 23.6.0)
-- **CefSharp 109.1.110/129.0** - 宓屽叆寮廤eb娴忚鍣�
-- **WebView2** - 鐜颁唬Web瑙嗗浘闆嗘垚
-- **Newtonsoft.Json 13.0.3** - JSON搴忓垪鍖�
-- **AutoUpdater.NET** - 鑷姩搴旂敤绋嬪簭鏇存柊
-- **NModbus 3.0.81** - 宸ヤ笟閫氫俊鍗忚
-- **FastReport** - 鎶ヨ〃鐢熸垚绯荤粺
+---
-## 椤圭洰鏋舵瀯缁撴瀯
+## 1. 椤圭洰姒傝
-### 椤剁骇鐩綍缁撴瀯
+### 1.1 鍩烘湰淇℃伅
+
+| 椤圭洰 | 璇存槑 |
+|------|------|
+| **瑙ｅ喅鏂规鍚嶇О** | `GsDevSolution.sln` |
+| **浜у搧鍚嶇О** | G-MES V2.0 |
+| **涓昏鐢ㄩ��** | 闈㈠悜鍒堕�犵幇鍦虹殑 MES Windows 瀹㈡埛绔� |
+| **鏍稿績搴旂敤** | `Gs.DevApp` (涓诲鎴风) |
+| **杈呭姪搴旂敤** | `Gs.WeightIqc` (IQC绉伴噸), `Gs.WeightLine` (浜х嚎绉伴噸) |
+| **寮�鍙戠幆澧�** | Visual Studio 2022+ |
+| **鐩爣妗嗘灦** | .NET Framework 4.8 |
+| **鏋勫缓骞冲彴** | Any CPU |
+
+### 1.2 鏍稿績鐗规��
+
+- 鉁� **鐜颁唬鍖� UI**: 鍩轰簬 DevExpress v22.2 鐨� FluentDesign 鐣岄潰
+- 鉁� **鍔ㄦ�佸姞杞�**: 閫氳繃鍙嶅皠鏈哄埗瀹炵幇鑿滃崟鍜岀獥浣撶殑鍔ㄦ�佸姞杞�
+- 鉁� **鏉冮檺鎺у埗**: 鍩轰簬瑙掕壊鐨勮彍鍗曟潈闄愬拰鎿嶄綔鏉冮檺绠＄悊
+- 鉁� **鍙鐢ㄧ粍浠�**: 150+ 涓氬姟鎺т欢,鎻愰珮寮�鍙戞晥鐜�
+- 鉁� **澶氭暟鎹簱鏀寔**: 鍏煎 Oracle 鍜� SQL Server
+- 鉁� **鑷姩鏇存柊**: 闆嗘垚 AutoUpdater.NET 瀹炵幇鑷姩鍗囩骇
+- 鉁� **宓屽叆寮忔祻瑙堝櫒**: CefSharp 鏀寔 H5 椤甸潰闆嗘垚
+- 鉁� **宸ヤ笟閫氫俊**: NModbus 鏀寔 Modbus TCP/RTU 璁惧閫氫俊
+- 鉁� **闆嗕腑寮忔棩蹇�**: 缁熶竴鐨勬棩蹇楄褰曞拰閿欒杩借釜鏈哄埗
+
+### 1.3 涓氬姟瑕嗙洊鑼冨洿
```
-DevApp/
-鈹溾攢鈹� Gs.DevApp/ # 涓诲簲鐢ㄧ▼搴忛」鐩�
-鈹� 鈹溾攢鈹� DevFrm/ # 涓氬姟鍔熻兘妯″潡绐椾綋
-鈹� 鈹溾攢鈹� Entity/ # 鏁版嵁瀹炰綋绫�
-鈹� 鈹溾攢鈹� ToolBox/ # 宸ュ叿绫诲拰杈呭姪鍑芥暟
-鈹� 鈹溾攢鈹� UserControl/ # 鑷畾涔夌敤鎴锋帶浠�
-鈹� 鈹溾攢鈹� Properties/ # 椤圭洰灞炴��
-鈹� 鈹溾攢鈹� Resources/ # 璧勬簮鏂囦欢
-鈹� 鈹溾攢鈹� bin/ # 缂栬瘧杈撳嚭鐩綍
-鈹� 鈹斺攢鈹� obj/ # 缂栬瘧涓存椂鏂囦欢
-鈹溾攢鈹� Gs.WeightIqc/ # IQC绉伴噸妫�娴嬫ā鍧�
-鈹溾攢鈹� Gs.WeightLine/ # 鐢熶骇绾跨О閲嶆ā鍧�
-鈹溾攢鈹� Gs.Setup/ # 瀹夎绋嬪簭椤圭洰
-鈹斺攢鈹� packages/ # NuGet鍖呯鐞嗙洰褰�
+鍩虹鏁版嵁绠＄悊 鈫� 鐢熶骇璁″垝 鈫� 宸ュ崟绠＄悊 鈫� 鐢熶骇鎵ц 鈫� 璐ㄩ噺妫�楠� 鈫� 浠撳偍鐗╂祦 鈫� 鎶ヨ〃鍒嗘瀽
+ 鈫� 鈫� 鈫� 鈫� 鈫� 鈫� 鈫�
+ 瀹㈡埛/渚涘簲鍟� 鎺掍骇璋冩暣 浠诲姟涓嬭揪 宸ュ簭寮�宸� 澶氱骇璐ㄦ 鍑哄叆搴撶鐞� FastReport
+ 鐗╂枡涓绘暟鎹� 浜х嚎鍒嗛厤 娴佺▼鍗� 鏁版嵁閲囬泦 缂洪櫡杩借釜 搴撳瓨璋冩嫧 缁熻鍒嗘瀽
+ 宸ヨ璁惧 璧勬簮鍗忚皟 杩涘害杩借釜 杩斿伐缁翠慨 AQL鎶芥牱 鏉＄爜绠＄悊 鑷畾涔夋姤琛�
```
-### 搴旂敤绋嬪簭鍏ュ彛鐐�
+---
-- **Program.cs** - 搴旂敤绋嬪簭涓诲叆鍙ｏ紝鍗曞疄渚嬬鐞嗭紝CefSharp鍒濆鍖�
-- **DevFrm/FrmLogin.cs** - 鐧诲綍绐椾綋锛岃嚜鍔ㄦ洿鏂板櫒闆嗘垚
-- **DevFrm/FrmMain.cs** - 涓籑DI绐椾綋锛孌evExpress FluentDesign鐣岄潰
+## 2. 瑙ｅ喅鏂规缁撴瀯
-## 鏍稿績涓氬姟妯″潡璇﹁В (DevFrm/)
+### 2.1 椤圭洰缁勬垚
-### 1. 鍩虹鏁版嵁绠＄悊 (BasicData/)
-**鍔熻兘锛�** 绯荤粺鍩虹涓绘暟鎹淮鎶ゅ拰绠＄悊
+```
+GsDevSolution/
+鈹溾攢鈹� Gs.DevApp/ 銆愪富瀹㈡埛绔」鐩��
+鈹� 鈹溾攢鈹� DevFrm/ - 18涓笟鍔￠鍩熸ā鍧� (150+ 绐椾綋)
+鈹� 鈹� 鈹溾攢鈹� BasicData/ - 鍩虹鏁版嵁 (瀹㈡埛/渚涘簲鍟�/鐗╂枡/浜х嚎)
+鈹� 鈹� 鈹溾攢鈹� Work/ - 鐢熶骇鎵ц (寮�宸�/鏁版嵁閲囬泦/杩斿伐)
+鈹� 鈹� 鈹溾攢鈹� WOM/ - 宸ュ崟绠＄悊 (浠诲姟涓嬭揪/鎺掍骇)
+鈹� 鈹� 鈹溾攢鈹� QC/ - 璐ㄩ噺绠＄悊閫氱敤妯″潡
+鈹� 鈹� 鈹溾攢鈹� IPQC/ - 鍒剁▼妫�楠� (棣栦欢/宸℃)
+鈹� 鈹� 鈹溾攢鈹� FQC/ - 鎴愬搧缁堟
+鈹� 鈹� 鈹溾攢鈹� RkQC/ - 鏉ユ枡璐ㄦ
+鈹� 鈹� 鈹溾攢鈹� Ck/ - 鍑哄簱绠＄悊 (棰嗘枡/琛ユ枡/閫�璐�)
+鈹� 鈹� 鈹溾攢鈹� Rk/ - 鍏ュ簱绠＄悊 (鏉ユ枡/閫�搴�/鍏朵粬)
+鈹� 鈹� 鈹溾攢鈹� Warehouse/ - 浠撳簱鎿嶄綔 (璋冩嫧/鐩樼偣/鏉＄爜)
+鈹� 鈹� 鈹溾攢鈹� Sales/ - 閿�鍞鍗曚笌鍙戣揣
+鈹� 鈹� 鈹溾攢鈹� WW/ - 濮斿绠＄悊
+鈹� 鈹� 鈹溾攢鈹� Rpt/ - 鎶ヨ〃璁捐涓庢墽琛�
+鈹� 鈹� 鈹溾攢鈹� Sys/ - 绯荤粺璁剧疆 (鑿滃崟/缁勭粐/鍗曞彿瑙勫垯)
+鈹� 鈹� 鈹溾攢鈹� User/ - 鐢ㄦ埛涓庢潈闄愮鐞�
+鈹� 鈹� 鈹溾攢鈹� JJGZ/ - 澶瑰叿宸ヨ涓庤澶囧彴璐�
+鈹� 鈹� 鈹溾攢鈹� BarCode/ - 鏉＄爜鐢熸垚涓庢墦鍗�
+鈹� 鈹� 鈹斺攢鈹� PDA/ - 鎵嬫寔缁堢鐣岄潰
+鈹� 鈹溾攢鈹� Entity/ - 鏁版嵁浼犺緭瀵硅薄 (DTO)
+鈹� 鈹溾攢鈹� ToolBox/ - 鍏叡宸ュ叿绫�
+鈹� 鈹溾攢鈹� UserControl/ - 鍙鐢ㄦ帶浠跺簱 (150+)
+鈹� 鈹溾攢鈹� Resources/ - 璧勬簮鏂囦欢 (鍥炬爣/鍥剧墖)
+鈹� 鈹溾攢鈹� App.config - 搴旂敤閰嶇疆鏂囦欢
+鈹� 鈹斺攢鈹� Program.cs - 搴旂敤绋嬪簭鍏ュ彛
+鈹溾攢鈹� Gs.WeightIqc/ 銆怚QC 绉伴噸瀹㈡埛绔��
+鈹溾攢鈹� Gs.WeightLine/ 銆愪骇绾跨О閲嶅鎴风銆�
+鈹溾攢鈹� Gs.Setup/ 銆愬畨瑁呯▼搴忛」鐩��(.vdproj)
+鈹斺攢鈹� packages/ 銆怤uGet 鍖呯洰褰曘��
+```
-**涓昏妯″潡锛�**
-- `Frm_Customer.cs` - 瀹㈡埛淇℃伅绠＄悊
-- `Frm_Supplier.cs` - 渚涘簲鍟嗕俊鎭鐞�
-- `Frm_SupplierSrm.cs` - SRM渚涘簲鍟嗗叧绯荤鐞�
-- `Frm_MesItems.cs` - 鐗╂枡涓绘暟鎹鐞�
+### 2.2 鏍稿績鐩綍璇﹁В
+
+#### DevFrm/ - 涓氬姟绐椾綋
+
+鎵�鏈変笟鍔＄獥浣撴寜棰嗗煙鍒掑垎,姣忎釜瀛愮洰褰曞寘鍚棰嗗煙鐨勬墍鏈夎〃鍗曞拰瀵硅瘽妗嗐��
+
+**鍛藉悕瑙勮寖**: `Frm_{涓氬姟鍚嶇О}.cs` 鎴� `Frm_{涓氬姟鍚嶇О}_{瀛愮被鍨媫.cs`
+
+#### Entity/ - 鏁版嵁妯″瀷
+
+| 鏂囦欢 | 璇存槑 |
+|------|------|
+| `LoginInfoModel.cs` | 鐧诲綍鐢ㄦ埛淇℃伅妯″瀷 |
+| `PageQueryModel.cs` | 鍒嗛〉鏌ヨ閫氱敤妯″瀷 |
+| `ReturnModel.cs` | API 杩斿洖缁撴灉灏佽 |
+
+#### ToolBox/ - 宸ュ叿绫诲簱
+
+| 鏂囦欢 | 璇存槑 |
+|------|------|
+| `UtilityHelper.cs` | **鏍稿績宸ュ叿绫�**: HTTP璇锋眰銆丣SON瑙ｆ瀽銆丟rid鍒濆鍖栫瓑 |
+| `LogHelper.cs` | 鏃ュ織璁板綍宸ュ叿 (鍐欏叆 `logs/{yyyy-MM-dd}.log`) |
+| `MsgHelper.cs` | 缁熶竴娑堟伅鎻愮ず灏佽 (鍩轰簬 DevExpress) |
+| `UpdateParentEventArgs.cs` | 绐椾綋闂翠簨浠堕�氫俊鏈哄埗 |
+| `ModbusHelper.cs` | Modbus 璁惧閫氫俊灏佽 |
+
+#### UserControl/ - 鍙鐢ㄦ帶浠�
+
+| 鎺т欢绫诲瀷 | 绀轰緥 | 璇存槑 |
+|----------|------|------|
+| **宸ュ叿鏍�** | `UcToolBarMenu.cs` | 鏍囧噯CRUD鎿嶄綔鏍� |
+| **鍒嗛〉** | `UcPageBar.cs` | 鍒嗛〉鎺т欢 |
+| **閫夋嫨鍣�** | `UcDictionarySelect.cs` | 鏁版嵁瀛楀吀涓嬫媺妗� |
+| **鏌ユ壘鎺т欢** | `UcLookCustomer.cs`<br>`UcLookItems.cs`<br>`UcLookWarehouse.cs` | 60+ 鏁版嵁鏌ユ壘瀵硅瘽妗�<br>(瀹㈡埛/鐗╂枡/浠撳簱绛�) |
+| **閫氱煡** | `Toast.cs` | 杞婚噺绾ф彁绀烘 |
+
+---
+
+## 3. 鏍稿績鎶�鏈爤
+
+### 3.1 涓昏渚濊禆
+
+| 鎶�鏈�/搴� | 鐗堟湰 | 鐢ㄩ�� |
+|---------|------|------|
+| **.NET Framework** | 4.8 | 搴旂敤鍩虹妗嗘灦 |
+| **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 鏁版嵁搴撹闂� |
+
+### 3.2 DevExpress 鏍稿績缁勪欢
+
+```csharp
+// FluentDesign 涓荤晫闈�
+DevExpress.XtraBars.FluentDesignSystem.FluentDesignForm
+
+// 鏁版嵁琛ㄦ牸
+DevExpress.XtraGrid.GridControl
+DevExpress.XtraGrid.Views.Grid.GridView
+
+// 鏍囩椤�
+DevExpress.XtraTab.XtraTabControl
+
+// 瀵艰埅鑿滃崟
+DevExpress.XtraNavBar.NavBarControl
+
+// 绛夊緟瀵硅瘽妗�
+DevExpress.XtraWaitForm.WaitDialogForm
+```
+
+---
+
+## 4. 寮�鍙戠幆澧冮厤缃�
+
+### 4.1 鍓嶇疆瑕佹眰
+
+- 鉁� Windows 10/11 鎴� Windows Server 2016+
+- 鉁� Visual Studio 2022 (鎺ㄨ崘) 鎴� Visual Studio 2019
+- 鉁� .NET Framework 4.8 SDK
+- 鉁� DevExpress v22.2+ 璁稿彲璇� (闇�閰嶇疆 NuGet 婧�)
+- 鉁� Git (鐗堟湰鎺у埗)
+
+### 4.2 鍏嬮殕涓庤繕鍘�
+
+```bash
+# 鍏嬮殕浠ｇ爜搴�
+cd E:\LanBMes
+git clone <repository_url> LB_MesClient
+
+# 杩涘叆瑙ｅ喅鏂规鐩綍
+cd LB_MesClient\DevApp
+
+# 杩樺師 NuGet 鍖�
+nuget restore GsDevSolution.sln
+
+# 鎴栧湪 Visual Studio 涓�:
+# 鍙抽敭瑙ｅ喅鏂规 鈫� 杩樺師 NuGet 绋嬪簭鍖�
+```
+
+### 4.3 閰嶇疆 DevExpress
+
+纭繚宸插畨瑁� DevExpress v22.2 骞堕厤缃� NuGet 婧�:
+
+```
+宸ュ叿 鈫� NuGet 鍖呯鐞嗗櫒 鈫� 绋嬪簭鍖呯鐞嗗櫒璁剧疆 鈫� 绋嬪簭鍖呮簮
+娣诲姞婧�: https://nuget.devexpress.com/<your_feed_key>/api
+```
+
+### 4.4 閰嶇疆鍚庣 API
+
+缂栬緫 `Gs.DevApp\App.config`:
+
+```xml
+<add key="WebApiUrl" value="http://192.168.0.51:8081/" />
+```
+
+淇敼涓哄疄闄呯殑鍚庣 API 鍦板潃銆�
+
+---
+
+## 5. 鏋勫缓涓庤繍琛�
+
+### 5.1 鍛戒护琛屾瀯寤�
+
+```bash
+# Debug 鏋勫缓 (鎺ㄨ崘寮�鍙戜娇鐢�)
+cd E:\LanBMes\LB_MesClient\DevApp
+msbuild GsDevSolution.sln /p:Configuration=Debug /p:Platform="Any CPU"
+
+# Release 鏋勫缓 (鐢ㄤ簬鍙戝竷)
+msbuild GsDevSolution.sln /p:Configuration=Release /p:Platform="Any CPU"
+
+# 浠呮瀯寤轰富椤圭洰
+msbuild Gs.DevApp\Gs.DevApp.csproj /t:Rebuild /p:Configuration=Debug
+```
+
+### 5.2 Visual Studio 杩愯
+
+1. **鎵撳紑瑙ｅ喅鏂规**: 鍙屽嚮 `GsDevSolution.sln`
+2. **璁剧疆鍚姩椤圭洰**: 鍙抽敭 `Gs.DevApp` 鈫� 璁句负鍚姩椤圭洰
+3. **杩愯**: 鎸� `F5` 鎴栫偣鍑� "寮�濮嬭皟璇�"
+
+### 5.3 鐩存帴杩愯
+
+```bash
+# Debug 鐗堟湰
+Gs.DevApp\bin\Debug\Gs.DevApp.exe
+
+# Release 鐗堟湰
+Gs.DevApp\bin\Release\Gs.DevApp.exe
+```
+
+### 5.4 璋冭瘯鎶�宸�
+
+**绂佺敤鍗曞疄渚嬮檺鍒�** (鍏佽鍚屾椂杩愯澶氫釜瀹炰緥鐢ㄤ簬娴嬭瘯):
+
+鍦� `Program.cs` 涓敞閲婁互涓嬩唬鐮�:
+
+```csharp
+// Process[] MyProcesses = Process.GetProcessesByName("Gs.DevApp");
+// if (MyProcesses.Length > 1)
+// {
+// MyProcesses[0].Kill();
+// }
+```
+
+---
+
+## 6. DevFrm 鍔熻兘妯″潡璇﹁В
+
+### 6.1 鐧诲綍涓庝富妗嗘灦
+
+#### Program.cs - 搴旂敤绋嬪簭鍏ュ彛
+
+```csharp
+[STAThread]
+static void Main()
+{
+ // 1. 鍗曞疄渚嬫鏌� (闃叉閲嶅杩愯)
+ Process[] MyProcesses = Process.GetProcessesByName("Gs.DevApp");
+ if (MyProcesses.Length > 1) {
+ MyProcesses[0].Kill();
+ }
+
+ // 2. 鍚敤瑙嗚鏍峰紡
+ Application.EnableVisualStyles();
+ Application.SetCompatibleTextRenderingDefault(false);
+
+ // 3. 鍚姩鐧诲綍娴佺▼
+ _startLogin();
+}
+```
+
+#### FrmLogin.cs - 鐧诲綍绐椾綋
+
+**鏍稿績鍔熻兘**:
+- 鑷姩鏇存柊妫�鏌� (AutoUpdater.NET)
+- 鐢ㄦ埛韬唤楠岃瘉 (璋冪敤 `User/UserLogin` API)
+- 璁颁綇鐢ㄦ埛鍚�/瀵嗙爜
+- 瀛椾綋璁剧疆鎸佷箙鍖� (娉ㄥ唽琛�)
+
+**鍏抽敭浠ｇ爜**:
+
+```csharp
+// 鐧诲綍楠岃瘉
+string result = UtilityHelper.HttpPost("User/UserLogin", "UserLogin", jsonParam);
+dynamic dy = UtilityHelper.ReturnToDynamic(result);
+
+if (dy.code == 200) {
+ LoginInfoModel.CurrentUser = JsonConvert.DeserializeObject<LoginInfoModel>(dy.data.ToString());
+ this.DialogResult = DialogResult.OK;
+}
+```
+
+#### FrmMain.cs - 涓荤獥浣�
+
+**鏍稿績鑱岃矗**:
+1. 鍔犺浇鐢ㄦ埛鑿滃崟缁撴瀯 (`User/GetUserLoginInfo`)
+2. 鏋勫缓 AccordionControl 瀵艰埅鑿滃崟
+3. 鍔ㄦ�佸姞杞界獥浣� (閫氳繃鍙嶅皠)
+4. 绠＄悊 TabPage 鐢熷懡鍛ㄦ湡
+5. 缁勭粐鍒囨崲
+6. 鍏ㄥ眬浜嬩欢澶勭悊
+
+**鍔ㄦ�佺獥浣撳姞杞�**:
+
+```csharp
+// 閫氳繃鍛藉悕绌洪棿鍔ㄦ�佸垱寤虹獥浣撳疄渚�
+Form newForm = (Form)Assembly.GetExecutingAssembly()
+ .CreateInstance("Gs.DevApp.DevFrm.BasicData.Frm_Customer");
+
+// 宓屽叆鍒� TabPage
+newForm.FormBorderStyle = FormBorderStyle.None;
+newForm.TopLevel = false;
+newForm.Dock = DockStyle.Fill;
+xtraTabPage.Controls.Add(newForm);
+newForm.Show();
+```
+
+**TabPage 缂撳瓨** (闃叉閲嶅鎵撳紑):
+
+```csharp
+if (tabPageDict.ContainsKey(formName)) {
+ xtraTabControl.SelectedTabPage = tabPageDict[formName];
+ return;
+}
+```
+
+---
+
+### 6.2 鍩虹鏁版嵁鍩� (BasicData/)
+
+#### 瀹㈡埛绠＄悊 - Frm_Customer.cs
+
+- 瀹㈡埛涓绘暟鎹淮鎶�
+- 鏀寔鍒嗛〉鏌ヨ
+- 浣跨敤 `UcToolBarMenu` 瀹炵幇澧炲垹鏀规煡
+- 浣跨敤 `UcPageBar` 瀹炵幇鍒嗛〉
+
+#### 渚涘簲鍟嗙鐞�
+
+- `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` - 閮ㄩ棬淇℃伅绠＄悊
-### 2. 浠撳簱鍑哄簱妯″潡 (Ck/)
-**鍔熻兘锛�** 浠撳簱鍑哄簱涓氬姟娴佺▼绠＄悊锛屽寘鍚悇绉嶅嚭搴撶被鍨�
+#### 浜х嚎绠＄悊 - Frm_MesWorkshopLine.cs
-**涓昏妯″潡锛�**
-- `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` - 楠屾敹閫�璐х鐞�
+- 杞﹂棿浜х嚎閰嶇疆
+- 宸ヤ綔涓績瀹氫箟
-### 3. 浠撳簱鍏ュ簱妯″潡 (Rk/)
-**鍔熻兘锛�** 浠撳簱鍏ュ簱涓氬姟娴佺▼绠＄悊
+#### 鍏朵粬涓绘暟鎹�
-**涓昏妯″潡锛�**
-- `Frm_MesItemTbl.cs` - 鏉愭枡鍏ュ簱鍙拌处
-- `Frm_MesItemTbl_RK.cs` - 鍏ュ簱鍗曟嵁澶勭悊
-- `Frm_MesItemTblShow.cs` - 鍏ュ簱淇℃伅灞曠ず
-- `Frm_MesItemQtrk.cs` / `Frm_MesItemQtrkDj.cs` - 鍏朵粬鍏ュ簱鐢宠/鍗曟嵁
-- `Frm_MesInvItemArn.cs` - 鍒拌揣鍏ュ簱绠＄悊
-- `Frm_MesInvItemIns.cs` - 妫�楠屽叆搴撶鐞�
+- `Frm_Staff.cs` - 鍛樺伐淇℃伅
+- `Frm_Department.cs` - 閮ㄩ棬缁勭粐
-### 4. 璐ㄩ噺鎺у埗妯″潡
+---
-#### 4.1 FQC (Final Quality Control) - 鏈�缁堣川閲忔帶鍒�
-**鍔熻兘锛�** 鎴愬搧鍑鸿揣鍓嶆渶缁堣川閲忔楠�
-- `Frm_Fqc.cs` - FQC妫�楠屼富鐣岄潰
-- `Frm_FqcDetect01.cs` - FQC妫�娴嬫祦绋�
-- `Frm_FQCItem.cs` - FQC妫�楠岄」鐩鐞�
+### 6.3 浠撳偍绠＄悊鍩�
-#### 4.2 IPQC (In-Process Quality Control) - 杩囩▼璐ㄩ噺鎺у埗
-**鍔熻兘锛�** 鐢熶骇杩囩▼涓殑璐ㄩ噺妫�楠屽拰鐩戞帶
-- `Frm_ShouJian.cs` - 棣栦欢妫�楠�
-- `Frm_ShouJianDetect01.cs` - 棣栦欢妫�娴嬫祦绋�
-- `Frm_ShouJianDetect01H5.cs` - 棣栦欢妫�娴婬5鐗堟湰
-- `Frm_XunJian.cs` - 宸℃绠＄悊
-- `Frm_XunJianDetect01.cs` - 宸℃妫�娴嬫祦绋�
-- `Frm_XunJianDetect01Show.cs` - 宸℃缁撴灉灞曠ず
+#### 鍑哄簱绠＄悊 (Ck/)
-#### 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` - 鎶芥鐢宠
+| 绐椾綋 | 鍔熻兘 |
+|------|------|
+| `Frm_MesInvItemOut_SCLL.cs` | 鐢熶骇棰嗘枡鍑哄簱 |
+| `Frm_MesItemBl.cs` | 琛ユ枡鍑哄簱 |
+| `Frm_MesCgthSq.cs` | 閲囪喘閫�璐х敵璇� |
+| `Frm_MesItemQtck.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` - 绯荤粺鏌ヨ閰嶇疆
+#### 鍏ュ簱绠＄悊 (Rk/)
-### 5. 宸ュ崟绠＄悊妯″潡 (WOM/)
-**鍔熻兘锛�** 鐢熶骇宸ュ崟鍏ㄧ敓鍛藉懆鏈熺鐞�
+| 绐椾綋 | 鍔熻兘 |
+|------|------|
+| `Frm_MesInvItemArn.cs` | 鍒拌揣鍏ュ簱 |
+| `Frm_MesItemTbl.cs` | 鏉愭枡鍏ュ簱鍙拌处 |
+| `Frm_MesItemQtrk.cs` | 鍏朵粬鍏ュ簱 |
-**涓昏妯″潡锛�**
-- `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` - 鍙嶅啿澶勭悊
+#### 浠撳簱鎿嶄綔 (Warehouse/)
-### 6. 鐢熶骇浣滀笟妯″潡 (Work/)
-**鍔熻兘锛�** 杞﹂棿鐢熶骇浣滀笟鎵ц鍜岀鐞�
+| 绐椾綋 | 鍔熻兘 |
+|------|------|
+| `Frm_MesDbck.cs` | 璋冩嫧鍑哄簱 |
+| `Frm_MesRohIn.cs` | 鍘熸潗鍏ュ簱 |
+| `Frm_ArrivalBarcode.cs` | 鍒拌揣鏉＄爜鐢熸垚 |
+| `Frm_InitialBarcode.cs` | 鍒濆鏉＄爜缁存姢 |
-**涓昏妯″潡锛�**
-- `Frm_WorkStart.cs` - 鐢熶骇寮�宸�
-- `Frm_Work01.cs` - 鐢熶骇浣滀笟涓荤晫闈�
-- `Frm_Work09.cs` - 鐢熶骇浣滀笟娴佺▼9
-- `Frm_WorkProcesses.cs` - 宸ュ簭浣滀笟绠＄悊
-- `Frm_WorkTechnique.cs` - 宸ヨ壓鎶�鏈鐞�
-- `Frm_WorkTechniqueShow.cs` - 宸ヨ壓鎶�鏈睍绀�
-- `Frm_Repair.cs` - 杩斾慨浣滀笟绠＄悊
+#### 鎵嬫寔缁堢 (PDA/)
-### 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/)
-**鍔熻兘锛�** 浠撳簱缁煎悎绠＄悊鍔熻兘
+### 6.4 璐ㄩ噺绠＄悊鍩�
-**涓昏妯″潡锛�**
-- `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` - 鍘熸潗鏂欏叆搴�
+#### QC/ - 璐ㄩ噺閫氱敤妯″潡
-### 9. 閿�鍞鐞嗘ā鍧� (Sales/)
-**鍔熻兘锛�** 閿�鍞鍗曞拰鍙戣揣绠＄悊
+- 缂洪櫡浠ｇ爜缁存姢 (`DefectCode*.cs`)
+- 妫�楠岄」鐩缃� (`Frm_MesQaItemsDetect01.cs`)
+- AQL 鎶芥牱鏂规 (`Frm_MesQmAql1.cs`)
+- 璐ㄩ噺鏍囧噯瀹氫箟
-**涓昏妯″潡锛�**
-- `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` - 閫�璐ч�氱煡鍏宠仈閫夋嫨
+#### IPQC/ - 鍒剁▼妫�楠�
-### 10. 鏉＄爜绠＄悊妯″潡 (BarCode/)
-**鍔熻兘锛�** 鏉＄爜鐢熸垚銆佹墦鍗板拰绠＄悊
+| 绐椾綋 | 鍔熻兘 |
+|------|------|
+| `Frm_ShouJian.cs` | 棣栦欢妫�楠� |
+| `Frm_XunJian.cs` | 宸℃浣滀笟 |
+| H5 妫�楠岀晫闈� | 绉诲姩绔楠� |
-**涓昏妯″潡锛�**
-- `Frm_BoxCode.cs` - 绠辩爜绠＄悊
-- `SelectBoxDaa.cs` - 閫夋嫨绠辨。妗�
-- `SelectBoxItem.cs` - 閫夋嫨绠遍」鐩�
+#### FQC/ - 鎴愬搧缁堟
-### 11. PDA绉诲姩璁惧妯″潡 (PDA/)
-**鍔熻兘锛�** 绉诲姩璁惧闆嗘垚鍜岀敤鎴风粦瀹�
+| 绐椾綋 | 鍔熻兘 |
+|------|------|
+| `Frm_Fqc.cs` | 鎴愬搧妫�楠屼富鐣岄潰 |
+| `Frm_FqcDetect01.cs` | 妫�楠屾暟鎹綍鍏� |
+| `MesFqcExceptional.cs` | 寮傚父澶勭悊 |
-**涓昏妯″潡锛�**
-- `Frm_UserBind.cs` - 鐢ㄦ埛缁戝畾
-- `Frm_UserBindLst.cs` - 鐢ㄦ埛缁戝畾鍒楄〃
-- `Frm_AreaBind.cs` - 鍖哄煙缁戝畾
+#### RkQC/ - 鏉ユ枡璐ㄦ
-### 12. 璁′欢宸ヨ祫妯″潡 (JJGZ/)
-**鍔熻兘锛�** 鍛樺伐璁′欢宸ヨ祫璁＄畻鍜岀鐞�
+| 绐椾綋 | 鍔熻兘 |
+|------|------|
+| `Frm_Cqfa.cs` | 鎶芥鏂规 |
+| `Frm_CqfaItems.cs` | 妫�楠岄」閰嶇疆 |
+| `Frm_QtrkDetect01.cs` | 鏉ユ枡妫�楠� |
+| `Frm_WwrkDetect01.cs` | 濮斿鏉ユ枡妫�楠� |
-**涓昏妯″潡锛�**
-- `Frm_MesJJSalary.cs` - 璁′欢宸ヨ祫绠＄悊
-- `Frm_MesJSSalary.cs` - 璁℃椂宸ヨ祫绠＄悊
-- `Frm_MesJjgzSchedule.cs` - 宸ヨ祫鎺掔彮绠＄悊
-- `Frm_MesTimeType.cs` - 鏃堕棿绫诲瀷绠＄悊
-- `Frm_MesAttanCon.cs` - 鑰冨嫟缁熻
-- `Frm_MesDeToLine.cs` - 鍛樺伐鍒嗙嚎绠＄悊
-- `Frm_MESJJERRORJS.cs` - 璁′欢閿欒鏍℃
+---
-### 13. 鎶ヨ〃妯″潡 (Rpt/)
-**鍔熻兘锛�** 鎶ヨ〃鏌ヨ鍜岀敓鎴�
+### 6.5 鍒堕�犳墽琛屽煙 (Work/)
-**涓昏妯″潡锛�**
-- `Frm_MesQL.cs` - MES鏌ヨ鎶ヨ〃
+#### 宸ュ簭浣滀笟
-### 14. 绯荤粺绠＄悊妯″潡 (Sys/)
-**鍔熻兘锛�** 绯荤粺閰嶇疆鍜岀鐞嗗姛鑳�
+| 绐椾綋 | 鍔熻兘 |
+|------|------|
+| `Frm_WorkStart.cs` | 宸ュ簭寮�宸� |
+| `Frm_WorkProcesses.cs` | 娴佺▼鍗＄鐞� |
+| `Frm_Work01.cs` ~ `Frm_Work09.cs` | 鍚勫伐绔欐暟鎹噰闆� |
+| `Frm_Repair.cs` | 杩斿伐缁翠慨 |
-**涓昏妯″潡锛�**
-- `Frm_Config.cs` - 绯荤粺閰嶇疆
-- `Frm_MesSysPageview.cs` - 绯荤粺椤甸潰瑙嗗浘
-- `Frm_PrintInfo.cs` - 鎵撳嵃淇℃伅绠＄悊
-- `Frm_PrintUser.cs` - 鎵撳嵃鐢ㄦ埛绠＄悊
+#### 鐗规畩鍔熻兘
-### 15. 鐢ㄦ埛绠＄悊妯″潡 (User/)
-**鍔熻兘锛�** 鐢ㄦ埛鏉冮檺鍜岃鑹茬鐞�
-- 鍖呭惈鐢ㄦ埛璁よ瘉銆佹巿鏉冦�佽鑹茬鐞嗙瓑鍔熻兘
+- **Modbus 璁惧閫氫俊**: 鏀寔瀹炴椂璇诲彇宸ヤ笟璁惧鏁版嵁
+- **SQL Server 鐩磋繛**: 閮ㄥ垎宸ョ珯鐩存帴涓� SQL Server 浜や簰
+- **瀹炴椂鐩戞帶**: 宸ョ珯鐘舵�佸疄鏃跺睍绀�
-## 鏀拺妯″潡璇﹁В
+---
-### Entity/ - 鏁版嵁瀹炰綋灞�
-**鍔熻兘锛�** 瀹氫箟鏁版嵁浼犺緭瀵硅薄鍜屼笟鍔″疄浣�
+### 6.6 宸ュ崟绠＄悊鍩� (WOM/)
-**鏍稿績绫伙細**
-- `LoginInfoModel.cs` - 鐧诲綍鐢ㄦ埛淇℃伅绠＄悊锛屽崟渚嬫ā寮忓疄鐜�
-- `ReturnModel.cs` - API杩斿洖缁撴灉缁熶竴灏佽
-- `PageQueryModel.cs` - 鍒嗛〉鏌ヨ妯″瀷
-- `XlsOutModel.cs` - Excel瀵煎嚭妯″瀷
+- 鐢熶骇浠诲姟涓嬭揪
+- 宸ュ崟鎺掍骇璋冩暣
+- 宸ュ崟杩涘害杩借釜
+- 宸ュ崟鐘舵�佺鐞�
-### ToolBox/ - 宸ュ叿绫诲簱
-**鍔熻兘锛�** 鎻愪緵閫氱敤宸ュ叿鍑芥暟鍜屽府鍔╃被
+---
-**鏍稿績绫伙細**
-- `UtilityHelper.cs` - 閫氱敤宸ュ叿绫伙紝鍖呭惈UI鎿嶄綔銆丠TTP閫氫俊銆佹暟鎹鐞嗙瓑
-- `LogHelper.cs` - 鏃ュ織璁板綍宸ュ叿锛屾敮鎸佽皟璇曞拰閿欒鏃ュ織
-- `MsgHelper.cs` - 娑堟伅鎻愮ず宸ュ叿锛屾爣鍑嗗寲鐢ㄦ埛浜や簰
-- `UpdateParentEventArgs.cs` - 鐖剁獥浣撴洿鏂颁簨浠跺弬鏁�
+### 6.7 閿�鍞鐞嗗煙 (Sales/)
-### 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` - 鎵撳嵃鏌ユ壘鎺т欢
+### 6.8 濮斿绠＄悊鍩� (WW/)
-#### 閫夋嫨鎺т欢绯诲垪 (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` - 鍗曟鎵撳嵃鎸夐挳鎺т欢
+### 6.9 鎶ヨ〃鍩� (Rpt/)
-#### 灞曠ず鍜屽竷灞�鎺т欢
-- `ShowLogcs.cs` - 鏃ュ織灞曠ず鎺т欢
-- `ShowFilter.cs` - 杩囨护鍣ㄥ睍绀烘帶浠�
-- `ShowRptWizard.cs` - 鎶ヨ〃鍚戝灞曠ず鎺т欢
-- `ShowUp.cs` - 涓婁紶灞曠ず鎺т欢
-- `showLayOut.cs` - 甯冨眬灞曠ず鎺т欢
-- `Toast.cs` - 娑堟伅鎻愮ず鎺т欢
-- `CopyXls.cs` - Excel澶嶅埗鎺т欢
+| 绐椾綋 | 鍔熻兘 |
+|------|------|
+| `EasyRptDesign.cs` | 鎶ヨ〃璁捐鍣� |
+| `EasyRptEdt.cs` | 鎶ヨ〃缂栬緫 |
+| `SysHelp.cs` | 鎶ヨ〃甯姪 |
-## 杈呭姪椤圭洰
+**鏀寔鎶�鏈�**:
+- FastReport
+- DevExpress Reports
+- 鑷畾涔夋姤琛ㄥ紩鎿�
-### Gs.WeightIqc/ - IQC绉伴噸妫�娴�
-**鍔熻兘锛�** IQC璐ㄩ噺妫�楠屼腑鐨勭О閲嶅姛鑳芥ā鍧�
-- 涓撻棬鐢ㄤ簬鏉ユ枡妫�楠岃繃绋嬩腑鐨勯噸閲忔娴�
-- 鏀寔鐢靛瓙绉よ澶囬泦鎴�
+---
-### Gs.WeightLine/ - 鐢熶骇绾跨О閲�
-**鍔熻兘锛�** 鐢熶骇绾垮疄鏃剁О閲嶇洃鎺�
-- 鐢熶骇杩囩▼涓殑閲嶉噺鐩戞帶
-- 鏀寔澶氱绉伴噸璁惧鍗忚
+### 6.10 绯荤粺绠＄悊鍩� (Sys/)
-### Gs.Setup/ - 瀹夎绋嬪簭
-**鍔熻兘锛�** 搴旂敤绋嬪簭瀹夎鍖呭埗浣�
-- ClickOnce閮ㄧ讲鏀寔
-- 鑷姩鏇存柊閰嶇疆
+| 绐椾綋 | 鍔熻兘 |
+|------|------|
+| `SysMenu.cs` | 鑿滃崟缁撴瀯缁存姢 |
+| `Organization.cs` | 缁勭粐鏋舵瀯绠＄悊 |
+| `DocNoRule.cs` | 鍗曞彿瑙勫垯閰嶇疆 |
+| `SysLog.cs` | 绯荤粺鏃ュ織鏌ヨ |
+| `Frm_Config.cs` | 绯荤粺閰嶇疆 |
-## 鏁版嵁璁块棶鍜岄�氫俊
+---
-### 鏁版嵁搴撹繛鎺�
-- 浣跨敤Oracle.ManagedDataAccess 23.6.0杩炴帴Oracle鏁版嵁搴�
-- 閫氳繃WebAPI鍚庣鏈嶅姟杩涜鏁版嵁璁块棶
-- 鏀寔杩炴帴瀛楃涓插姩鎬侀厤缃�
+### 6.11 鐢ㄦ埛涓庢潈闄愬煙 (User/)
-### HTTP閫氫俊
-- 鍩轰簬UtilityHelper绫诲疄鐜癏TTP瀹㈡埛绔姛鑳�
-- 浣跨敤Newtonsoft.Json杩涜鏁版嵁搴忓垪鍖�
-- 鏀寔RESTful API璋冪敤
+| 绐椾綋 | 鍔熻兘 |
+|------|------|
+| `User.cs` | 鐢ㄦ埛绠＄悊 |
+| `Role.cs` | 瑙掕壊绠＄悊 |
+| `RoleSelectAction.cs` | 瑙掕壊鎺堟潈 |
+| `UserSetPwd.cs` | 瀵嗙爜鍙樻洿 |
-### 宸ヤ笟閫氫俊
-- 闆嗘垚NModbus 3.0.81鏀寔宸ヤ笟璁惧閫氫俊
-- 鏀寔Modbus鍗忚鐨凱LC璁惧闆嗘垚
+**鏉冮檺妯″瀷**:
+```
+鐢ㄦ埛 鈫� 瑙掕壊 鈫� 鑿滃崟鏉冮檺 + 鎿嶄綔鏉冮檺
+```
-## 鐣岄潰鍜岀敤鎴蜂綋楠�
+---
-### DevExpress闆嗘垚
-- 浣跨敤DevExpress LookAndFeel瀹炵幇缁熶竴涓婚
-- FluentDesign鐜颁唬鍖栫晫闈㈤鏍�
-- 涓板瘜鐨勭綉鏍兼帶浠跺拰鏁版嵁灞曠ず缁勪欢
+### 6.12 澶瑰叿宸ヨ鍩� (JJGZ/)
-### Web闆嗘垚
-- CefSharp宓屽叆寮忔祻瑙堝櫒鏀寔
-- WebView2鐜颁唬Web瑙嗗浘
-- 鏀寔H5椤甸潰闆嗘垚锛堝妫�娴嬬晫闈級
+- 澶瑰叿宸ヨ鍙拌处
+- 璁￠噺璁惧绠＄悊
+- 鐐规浠诲姟涓庤褰�
+- 璁惧缁存姢璁″垝
-## 閮ㄧ讲鍜屾洿鏂�
+---
-### 鑷姩鏇存柊
-- 闆嗘垚AutoUpdater.NET瀹炵幇鑷姩鏇存柊
-- 鏀寔鐗堟湰妫�娴嬪拰澧為噺鏇存柊
-- 閰嶇疆鍖栨洿鏂版湇鍔″櫒鍦板潃
+### 6.13 鏉＄爜绠＄悊鍩� (BarCode/)
-### 閰嶇疆绠＄悊
-- App.config閰嶇疆鏂囦欢绠＄悊
-- 鏀寔WebAPI鍦板潃銆佹棩蹇楄矾寰勭瓑鍏抽敭閰嶇疆
-- 鐢熶骇鍜屾祴璇曠幆澧冮殧绂�
+| 绐椾綋 | 鍔熻兘 |
+|------|------|
+| `Frm_BarcodePrint.cs` | 鏉＄爜鎵归噺鎵撳嵃 |
+| `Frm_BarcodeTemplate.cs` | 鎵撳嵃妯℃澘璁剧疆 |
-## 寮�鍙戣鑼冨缓璁�
+---
-1. **妯″潡鍖栧紑鍙�**锛氶伒寰幇鏈夌殑鎸変笟鍔″姛鑳藉垝鍒嗙殑鐩綍缁撴瀯
-2. **浠ｇ爜澶嶇敤**锛氬厖鍒嗗埄鐢║serControl涓殑鑷畾涔夋帶浠�
-3. **缁熶竴瑙勮寖**锛氫娇鐢║tilityHelper銆丩ogHelper绛夊伐鍏风被淇濇寔浠ｇ爜涓�鑷存��
-4. **鐣岄潰椋庢牸**锛氶伒寰狣evExpress璁捐瑙勮寖锛屼繚鎸佺晫闈竴鑷存��
-5. **閿欒澶勭悊**锛氱粺涓�浣跨敤LogHelper璁板綍鏃ュ織锛孧sgHelper鏄剧ず鐢ㄦ埛娑堟伅
-6. **鏁版嵁璁块棶**锛氶�氳繃WebAPI杩涜鏁版嵁鎿嶄綔锛岄伩鍏嶇洿鎺ユ暟鎹簱璁块棶
+## 7. 鏋舵瀯涓庤璁℃ā寮�
-杩欎釜MES绯荤粺鎻愪緵浜嗗畬鏁寸殑鍒堕�犳墽琛岀鐞嗗姛鑳斤紝浠庡熀纭�鏁版嵁绠＄悊鍒扮敓浜ф墽琛岋紝浠庤川閲忔帶鍒跺埌浠撳簱绠＄悊锛屽舰鎴愪簡瀹屾暣鐨勫埗閫犱笟鍔￠棴鐜�傜郴缁熸灦鏋勬竻鏅帮紝妯″潡鑱岃矗鏄庣‘锛屼负鍒堕�犱紒涓氭彁渚涗簡寮哄ぇ鐨勪俊鎭寲鏀拺骞冲彴銆�
\ No newline at end of file
+### 7.1 澶氬眰鏋舵瀯
+
+```
+鈹屸攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�
+鈹� UI Layer (WinForms) 鈹�
+鈹� DevExpress FluentDesign + 150+ 鎺т欢 鈹�
+鈹斺攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�
+ 鈹� HTTP/JSON REST API
+鈹屸攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈻尖攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�
+鈹� Business Logic Layer (Client) 鈹�
+鈹� 绐椾綋閫昏緫 + ToolBox 宸ュ叿绫� + 鍔ㄦ�佸姞杞� 鈹�
+鈹斺攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�
+ 鈹�
+鈹屸攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈻尖攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�
+鈹� Backend REST API (鍒椤圭洰) 鈹�
+鈹� 韬唤楠岃瘉 + 鑿滃崟 + 涓氬姟閫昏緫 + 鏁版嵁璁块棶 鈹�
+鈹斺攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�
+ 鈹�
+鈹屸攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈻尖攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�
+鈹� Data Layer 鈹�
+鈹� Oracle / SQL Server 鈹�
+鈹斺攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�
+```
+
+### 7.2 鏍稿績璁捐妯″紡
+
+#### 妯″紡 1: HTTP 璇锋眰闆嗕腑鍖�
+
+**鎵�鏈� API 璋冪敤缁熶竴浣跨敤 `UtilityHelper.HttpPost()`**:
+
+```csharp
+public static string HttpPost(string url, string method, string param, bool isLoading = true)
+{
+ // 1. 鎷兼帴瀹屾暣 URL (WebApiUrl + url)
+ // 2. 娣诲姞 Bearer Token 璁よ瘉澶�
+ // 3. 鏄剧ず Loading 瀵硅瘽妗� (鍙��)
+ // 4. 鍙戦�� POST 璇锋眰
+ // 5. 杩斿洖 JSON 瀛楃涓�
+ // 6. 瓒呮椂鏃堕棿: 150 绉�
+}
+```
+
+**浣跨敤绀轰緥**:
+
+```csharp
+string jsonParam = JsonConvert.SerializeObject(new {
+ pageIndex = 1,
+ pageSize = 50
+});
+
+string result = UtilityHelper.HttpPost(
+ "BasicData/Customer/GetListPage", // 鐩稿璺緞
+ "GetListPage", // 鏂规硶鍚�
+ jsonParam, // JSON 鍙傛暟
+ true // 鏄剧ず鍔犺浇妗�
+);
+
+dynamic dy = UtilityHelper.ReturnToDynamic(result);
+if (dy.code == 200) {
+ // 澶勭悊鏁版嵁
+}
+```
+
+#### 妯″紡 2: 鍔ㄦ�佺獥浣撳姞杞� (鍙嶅皠)
+
+```csharp
+// 鍦� FrmMain.cs 涓�
+private void LoadForm(string namespacePath)
+{
+ // 閫氳繃鍛藉悕绌洪棿璺緞鍒涘缓绐椾綋瀹炰緥
+ string fullName = $"Gs.DevApp.DevFrm.{namespacePath}";
+ Form form = (Form)Assembly.GetExecutingAssembly().CreateInstance(fullName);
+
+ if (form != null)
+ {
+ // 閰嶇疆涓哄瓙绐椾綋
+ form.FormBorderStyle = FormBorderStyle.None;
+ form.TopLevel = false;
+ form.Dock = DockStyle.Fill;
+
+ // 娣诲姞鍒� TabPage
+ XtraTabPage tabPage = new XtraTabPage();
+ tabPage.Text = form.Text;
+ tabPage.Controls.Add(form);
+ xtraTabControl.TabPages.Add(tabPage);
+ xtraTabControl.SelectedTabPage = tabPage;
+
+ form.Show();
+ }
+}
+```
+
+**濂藉**:
+- 鑿滃崟缁撴瀯瀹屽叏鐢卞悗绔帶鍒�
+- 鏃犻渶淇敼浠ｇ爜鍗冲彲璋冩暣鑿滃崟
+- 鏀寔鍔ㄦ�佹潈闄愭帶鍒�
+
+#### 妯″紡 3: TabPage 缂撳瓨鏈哄埗
+
+```csharp
+// 闃叉閲嶅鎵撳紑鍚屼竴绐椾綋
+private Dictionary<string, XtraTabPage> tabPageDict = new Dictionary<string, XtraTabPage>();
+
+private void OpenForm(string formName)
+{
+ if (tabPageDict.ContainsKey(formName))
+ {
+ // 宸插瓨鍦�,婵�娲荤幇鏈� Tab
+ xtraTabControl.SelectedTabPage = tabPageDict[formName];
+ }
+ else
+ {
+ // 鏂板缓 Tab
+ XtraTabPage newPage = CreateNewTabPage(formName);
+ tabPageDict[formName] = newPage;
+ }
+}
+```
+
+#### 妯″紡 4: 鐖跺瓙绐椾綋浜嬩欢閫氫俊
+
+**瀛愮獥浣撹Е鍙戠埗绐椾綋鍒锋柊**:
+
+```csharp
+// 鍦ㄥ瓙绐椾綋涓�
+UpdateParentEventArgs args = new UpdateParentEventArgs(this, "Refresh");
+// 瑙﹀彂浜嬩欢,閫氱煡鐖剁獥浣�
+
+// 鍦ㄧ埗绐椾綋涓�
+private void ChildForm_UpdateParent(object sender, UpdateParentEventArgs e)
+{
+ if (e.Action == "Refresh")
+ {
+ LoadData(); // 鍒锋柊鏁版嵁
+ }
+}
+```
+
+#### 妯″紡 5: 鏍囧噯 CRUD 绐椾綋妯℃澘
+
+**鍏稿瀷绐椾綋缁撴瀯**:
+
+```csharp
+public partial class Frm_Customer : DevExpress.XtraEditors.XtraForm
+{
+ private UcToolBarMenu ucToolBar; // 宸ュ叿鏍� (澧炲垹鏀规煡)
+ private UcPageBar ucPageBar; // 鍒嗛〉鎺т欢
+ private GridControl gridControl; // 鏁版嵁琛ㄦ牸
+
+ private void InitializeForm()
+ {
+ // 1. 鍒濆鍖栧伐鍏锋爮
+ ucToolBar.AddClick += BtnAdd_Click;
+ ucToolBar.EditClick += BtnEdit_Click;
+ ucToolBar.DeleteClick += BtnDelete_Click;
+ ucToolBar.RefreshClick += BtnRefresh_Click;
+
+ // 2. 鍒濆鍖栧垎椤�
+ ucPageBar.PageChanged += LoadData;
+
+ // 3. 鍔犺浇鏁版嵁
+ LoadData();
+ }
+
+ private void LoadData()
+ {
+ string jsonParam = JsonConvert.SerializeObject(new {
+ pageIndex = ucPageBar.CurrentPage,
+ pageSize = ucPageBar.PageSize
+ });
+
+ string result = UtilityHelper.HttpPost(
+ "BasicData/Customer/GetListPage",
+ "GetListPage",
+ jsonParam
+ );
+
+ dynamic dy = UtilityHelper.ReturnToDynamic(result);
+ if (dy.code == 200)
+ {
+ gridControl.DataSource = dy.data;
+ ucPageBar.TotalRecords = dy.totalCount;
+ }
+ }
+}
+```
+
+---
+
+## 8. 宸ュ叿绫讳笌鍏叡缁勪欢
+
+### 8.1 UtilityHelper.cs - 鏍稿績宸ュ叿绫�
+
+#### HTTP 璇锋眰
+
+```csharp
+// 鏍囧噯 POST 璇锋眰
+string result = UtilityHelper.HttpPost(
+ "User/UserLogin", // 鐩稿璺緞
+ "UserLogin", // 鏂规硶鍚�
+ jsonParam, // JSON 鍙傛暟
+ true // 鏄剧ず鍔犺浇妗�
+);
+```
+
+#### JSON 瑙ｆ瀽
+
+```csharp
+// 瑙ｆ瀽涓� dynamic 瀵硅薄
+dynamic dy = UtilityHelper.ReturnToDynamic(result);
+
+// 瑙ｆ瀽涓哄垎椤垫暟鎹〃
+DataTable dt = UtilityHelper.ReturnToTablePage(result);
+```
+
+#### Grid 鍒濆鍖�
+
+```csharp
+// 鍒濆鍖栬〃鏍兼帶浠�
+UtilityHelper.InitGridControl(
+ gridControl,
+ gridView,
+ columns, // 鍒楀畾涔�
+ dataSource, // 鏁版嵁婧�
+ allowEdit: false,
+ allowDelete: false
+);
+```
+
+### 8.2 LogHelper.cs - 鏃ュ織宸ュ叿
+
+```csharp
+// 璁板綍淇℃伅鏃ュ織
+LogHelper.WriteLog("鐢ㄦ埛鐧诲綍鎴愬姛", LogHelper.LogType.Info);
+
+// 璁板綍閿欒鏃ュ織
+LogHelper.WriteLog($"API 璋冪敤澶辫触: {ex.Message}", LogHelper.LogType.Error);
+
+// 璁板綍璀﹀憡
+LogHelper.WriteLog("鏁版嵁寮傚父,浣跨敤榛樿鍊�", LogHelper.LogType.Warning);
+```
+
+**鏃ュ織鏂囦欢浣嶇疆**: `logs/{yyyy-MM-dd}.log`
+
+### 8.3 MsgHelper.cs - 娑堟伅鎻愮ず
+
+```csharp
+// 鎴愬姛鎻愮ず
+MsgHelper.ShowSuccess("鎿嶄綔鎴愬姛!");
+
+// 閿欒鎻愮ず
+MsgHelper.ShowError("鎿嶄綔澶辫触,璇烽噸璇�!");
+
+// 璀﹀憡鎻愮ず
+MsgHelper.ShowWarning("鏁版嵁涓嶅畬鏁�!");
+
+// 纭瀵硅瘽妗�
+if (MsgHelper.ShowConfirm("纭畾瑕佸垹闄ゅ悧?") == DialogResult.Yes)
+{
+ // 鎵ц鍒犻櫎
+}
+```
+
+### 8.4 Toast.cs - 杞婚噺鎻愮ず
+
+```csharp
+// 鏄剧ず 3 绉掓彁绀�
+Toast.Show("淇濆瓨鎴愬姛", 3);
+
+// 鏄剧ず鑷畾涔夋椂闀�
+Toast.Show("鏁版嵁宸叉洿鏂�", 5); // 5 绉�
+```
+
+### 8.5 鍙鐢ㄦ帶浠�
+
+#### UcToolBarMenu - 宸ュ叿鏍忔帶浠�
+
+```csharp
+UcToolBarMenu toolBar = new UcToolBarMenu();
+toolBar.AddClick += (s, e) => { /* 鏂板 */ };
+toolBar.EditClick += (s, e) => { /* 缂栬緫 */ };
+toolBar.DeleteClick += (s, e) => { /* 鍒犻櫎 */ };
+toolBar.RefreshClick += (s, e) => { /* 鍒锋柊 */ };
+toolBar.ExportClick += (s, e) => { /* 瀵煎嚭 */ };
+```
+
+#### UcPageBar - 鍒嗛〉鎺т欢
+
+```csharp
+UcPageBar pageBar = new UcPageBar();
+pageBar.PageSize = 50;
+pageBar.TotalRecords = 1000;
+pageBar.PageChanged += (s, e) => {
+ LoadData(pageBar.CurrentPage, pageBar.PageSize);
+};
+```
+
+#### UcDictionarySelect - 鏁版嵁瀛楀吀涓嬫媺
+
+```csharp
+UcDictionarySelect cmbStatus = new UcDictionarySelect();
+cmbStatus.DictionaryType = "OrderStatus"; // 瀛楀吀绫诲瀷
+cmbStatus.LoadData();
+```
+
+#### UcLook* - 鏁版嵁鏌ユ壘鎺т欢
+
+**60+ 鏌ユ壘鎺т欢,瑕嗙洊鎵�鏈変富鏁版嵁**:
+
+```csharp
+// 瀹㈡埛鏌ユ壘
+UcLookCustomer lookCustomer = new UcLookCustomer();
+lookCustomer.ShowDialog();
+string customerId = lookCustomer.SelectedId;
+string customerName = lookCustomer.SelectedName;
+
+// 鐗╂枡鏌ユ壘
+UcLookItems lookItems = new UcLookItems();
+lookItems.ShowDialog();
+string itemId = lookItems.SelectedId;
+
+// 浠撳簱鏌ユ壘
+UcLookWarehouse lookWarehouse = new UcLookWarehouse();
+lookWarehouse.ShowDialog();
+```
+
+---
+
+## 9. 閰嶇疆璇存槑
+
+### 9.1 App.config 鍏抽敭閰嶇疆
+
+**浣嶇疆**: `Gs.DevApp\App.config` (杩愯鏃朵负 `Gs.DevApp.exe.config`)
+
+#### 鏍稿績閰嶇疆椤�
+
+```xml
+<appSettings>
+ <!-- 鍚庣 API 鍦板潃 (蹇呴』閰嶇疆) -->
+ <add key="WebApiUrl" value="http://192.168.0.51:8081/" />
+
+ <!-- 浜у搧鍚嶇О -->
+ <add key="ProductName" value="G-MES V2.0" />
+
+ <!-- 鐗堟湰鍙� -->
+ <add key="Version" value="0.1" />
+
+ <!-- 鏃ュ織鐩綍 (鐩稿璺緞鎴栫粷瀵硅矾寰�) -->
+ <add key="LogPath" value="logs" />
+
+ <!-- 鍒嗛〉澶у皬 -->
+ <add key="PageSize" value="50" />
+
+ <!-- 鍚敤鑷姩鏇存柊 (0=绂佺敤, 1=鍚敤) -->
+ <add key="IsAutoUpdater" value="0" />
+
+ <!-- 鑷姩鏇存柊閰嶇疆鏂囦欢 URL -->
+ <add key="AutoUpdaterXml" value="http://192.168.0.51:8086/AutoUpdater/AutoUpdater.xml" />
+
+ <!-- Toast 鎻愮ず妗嗘樉绀烘椂闀� (绉�) -->
+ <add key="ToastSeconds" value="5" />
+
+ <!-- 姘存瓒呮椂鏃堕棿 (绉�) -->
+ <add key="AsyncSeconds" value="2" />
+
+ <!-- 鏄惁鍚敤姘存鍙婂伐浣嶇爜鍔熻兘 (0=绂佺敤, 1=鍚敤) -->
+ <add key="IsWater" value="0" />
+
+ <!-- IQC 绉伴噸璇诲彇瓒呮椂 (姣) -->
+ <add key="IqcGetWeight" value="3000" />
+
+ <!-- 瀹氭椂閭欢鍙戦�侀棿闅� (姣) -->
+ <add key="TimingMailInterval" value="10000" />
+</appSettings>
+```
+
+### 9.2 鐢ㄦ埛璁剧疆 (鑷姩淇濆瓨)
+
+```xml
+<userSettings>
+ <Gs.DevApp.Properties.Settings>
+ <!-- 鐢ㄦ埛鍚� (璁颁綇瀵嗙爜鍔熻兘) -->
+ <setting name="userName" serializeAs="String">
+ <value />
+ </setting>
+
+ <!-- 瀵嗙爜 (鍔犲瘑瀛樺偍) -->
+ <setting name="userPwd" serializeAs="String">
+ <value />
+ </setting>
+
+ <!-- 璁颁綇瀵嗙爜 -->
+ <setting name="remember" serializeAs="String">
+ <value>False</value>
+ </setting>
+
+ <!-- 瀛椾綋璁剧疆 -->
+ <setting name="fontSizeName" serializeAs="String">
+ <value>瀹嬩綋,10</value>
+ </setting>
+
+ <!-- 鏄惁鍚敤绉伴噸鍔熻兘 -->
+ <setting name="isWeight" serializeAs="String">
+ <value>False</value>
+ </setting>
+ </Gs.DevApp.Properties.Settings>
+</userSettings>
+```
+
+### 9.3 閮ㄧ讲鍓嶅繀鏀归厤缃�
+
+**寮�鍙戠幆澧� 鈫� 鐢熶骇鐜**:
+
+| 閰嶇疆椤� | 寮�鍙戠幆澧� | 鐢熶骇鐜 |
+|--------|----------|----------|
+| `WebApiUrl` | `http://192.168.0.51:8081/` | `http://your-server:port/` |
+| `IsAutoUpdater` | `0` (绂佺敤) | `1` (鍚敤) |
+| `AutoUpdaterXml` | 鍐呯綉鍦板潃 | 鐢熶骇鐜 URL |
+| `LogPath` | `logs` | 寤鸿浣跨敤鍏叡鐩綍 |
+
+---
+
+## 10. 閮ㄧ讲鎸囧崡
+
+### 10.1 鏋勫缓 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"
+```
+
+### 10.2 鍙戝竷鐩綍缁撴瀯
+
+```
+Gs.DevApp.exe # 涓荤▼搴�
+Gs.DevApp.exe.config # 閰嶇疆鏂囦欢 (蹇呴』淇敼)
+DevExpress.*.dll # DevExpress 缁勪欢
+CefSharp.*.dll # CefSharp 缁勪欢
+AutoUpdater.NET.dll # 鑷姩鏇存柊缁勪欢
+Newtonsoft.Json.dll # JSON 搴�
+Oracle.ManagedDataAccess.dll # Oracle 椹卞姩
+x86/ # CefSharp x86 鏈湴搴� (蹇呴』)
+x64/ # CefSharp x64 鏈湴搴� (蹇呴』)
+locales/ # CefSharp 璇█鍖�
+logs/ # 鏃ュ織鐩綍 (杩愯鏃跺垱寤�)
+```
+
+### 10.3 浣跨敤瀹夎绋嬪簭
+
+1. 鎵撳紑 `Gs.Setup\Gs.Setup.vdproj`
+2. 閰嶇疆瀹夎绋嬪簭灞炴��:
+ - **ProductName**: G-MES V2.0
+ - **Manufacturer**: 钃濆疂
+ - **Version**: 涓� App.config 淇濇寔涓�鑷�
+3. 鍙抽敭椤圭洰 鈫� 鐢熸垚
+4. 杈撳嚭: `Gs.Setup\Release\Gs.Setup.msi`
+
+### 10.4 鑷姩鏇存柊閰嶇疆
+
+#### 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>鐗堟湰 0.2.0.0 鏇存柊鍐呭</h3>
+ <ul>
+ <li>鏂板锛氭潯鐮佹壒閲忔墦鍗板姛鑳�</li>
+ <li>浼樺寲锛氫粨搴撳嚭鍏ュ簱娴佺▼</li>
+ <li>淇锛氳川妫�鏁版嵁淇濆瓨澶辫触闂</li>
+ </ul>
+ ]]>
+ </changelog>
+ <mandatory>false</mandatory>
+</update>
+```
+
+#### 鍚敤鑷姩鏇存柊
+
+鍦� `App.config` 涓�:
+
+```xml
+<add key="IsAutoUpdater" value="1" />
+<add key="AutoUpdaterXml" value="http://your-server/updates/AutoUpdater.xml" />
+```
+
+### 10.5 閮ㄧ讲妫�鏌ユ竻鍗�
+
+- [ ] 淇敼 `WebApiUrl` 涓虹敓浜х幆澧冨湴鍧�
+- [ ] 妫�鏌� `IsAutoUpdater` 閰嶇疆
+- [ ] 纭繚 `x86/` 鍜� `x64/` 鐩綍瀹屾暣
+- [ ] 娴嬭瘯鏁版嵁搴撹繛鎺�
+- [ ] 楠岃瘉鏃ュ織鐩綍鍐欐潈闄�
+- [ ] 娴嬭瘯鑷姩鏇存柊鍔熻兘
+- [ ] 妫�鏌� DevExpress 璁稿彲璇�
+- [ ] 澶囦唤閰嶇疆鏂囦欢
+
+---
+
+## 11. 寮�鍙戣鑼冧笌鏈�浣冲疄璺�
+
+### 11.1 浠ｇ爜缁勭粐瑙勮寖
+
+#### 鏂板妯″潡
+
+```
+DevFrm/
+鈹斺攢鈹� YourModule/ # 鏂版ā鍧楃洰褰�
+ 鈹溾攢鈹� Frm_Main.cs # 涓荤獥浣�
+ 鈹溾攢鈹� Frm_Edit.cs # 缂栬緫绐椾綋
+ 鈹溾攢鈹� Dlg_Select.cs # 閫夋嫨瀵硅瘽妗�
+ 鈹斺攢鈹� Models/ # 鏈湴妯″瀷 (鍙��)
+```
+
+#### 鍛藉悕瑙勮寖
+
+| 绫诲瀷 | 鍛藉悕瑙勫垯 | 绀轰緥 |
+|------|----------|------|
+| 涓荤獥浣� | `Frm_{涓氬姟鍚峿` | `Frm_Customer.cs` |
+| 缂栬緫绐椾綋 | `Frm_{涓氬姟鍚峿Edit` | `Frm_CustomerEdit.cs` |
+| 瀵硅瘽妗� | `Dlg_{涓氬姟鍚峿` | `Dlg_SelectCustomer.cs` |
+| 鐢ㄦ埛鎺т欢 | `Uc{鍔熻兘鍚峿` | `UcToolBarMenu.cs` |
+
+### 11.2 API 璋冪敤瑙勮寖
+
+#### 鉁� 姝ｇ‘鍋氭硶
+
+```csharp
+// 浣跨敤 UtilityHelper.HttpPost
+string jsonParam = JsonConvert.SerializeObject(new {
+ id = customerId
+});
+
+string result = UtilityHelper.HttpPost(
+ "BasicData/Customer/GetById",
+ "GetById",
+ jsonParam
+);
+
+dynamic dy = UtilityHelper.ReturnToDynamic(result);
+if (dy.code == 200)
+{
+ // 澶勭悊鏁版嵁
+}
+else
+{
+ MsgHelper.ShowError(dy.msg.ToString());
+ LogHelper.WriteLog($"API Error: {dy.msg}", LogHelper.LogType.Error);
+}
+```
+
+#### 鉂� 閿欒鍋氭硶
+
+```csharp
+// 涓嶈鐩存帴浣跨敤 HttpClient銆乄ebRequest 绛�
+// 涓嶈璺宠繃閿欒澶勭悊
+// 涓嶈蹇界暐鏃ュ織璁板綍
+```
+
+### 11.3 寮傚父澶勭悊瑙勮寖
+
+```csharp
+try
+{
+ // 涓氬姟閫昏緫
+ string result = UtilityHelper.HttpPost(...);
+ dynamic dy = UtilityHelper.ReturnToDynamic(result);
+
+ if (dy.code == 200)
+ {
+ // 鎴愬姛澶勭悊
+ }
+ else
+ {
+ // API 杩斿洖閿欒
+ MsgHelper.ShowError(dy.msg.ToString());
+ LogHelper.WriteLog($"API Error: {dy.msg}", LogHelper.LogType.Error);
+ }
+}
+catch (Exception ex)
+{
+ // 鎹曡幏寮傚父
+ MsgHelper.ShowError($"鎿嶄綔澶辫触: {ex.Message}");
+ LogHelper.WriteLog($"Exception in {MethodName}: {ex}", LogHelper.LogType.Error);
+}
+```
+
+### 11.4 UI 鏇存柊瑙勮寖
+
+#### 闀挎椂闂存搷浣滀娇鐢ㄥ悗鍙扮嚎绋�
+
+```csharp
+// 浣跨敤 BackgroundWorker
+BackgroundWorker worker = new BackgroundWorker();
+worker.DoWork += (s, e) => {
+ // 鑰楁椂鎿嶄綔
+ e.Result = PerformLongOperation();
+};
+worker.RunWorkerCompleted += (s, e) => {
+ // UI 鏇存柊
+ UpdateUI(e.Result);
+};
+worker.RunWorkerAsync();
+```
+
+#### 閬垮厤 UI 闃诲
+
+```csharp
+// 鉂� 闃诲 UI 绾跨▼
+Thread.Sleep(5000);
+
+// 鉁� 浣跨敤瀹氭椂鍣ㄦ垨寮傛
+Timer timer = new Timer();
+timer.Interval = 5000;
+timer.Tick += (s, e) => {
+ timer.Stop();
+ // 鎵ц鎿嶄綔
+};
+timer.Start();
+```
+
+### 11.5 鎺т欢澶嶇敤瑙勮寖
+
+#### 浼樺厛浣跨敤鐜版湁鎺т欢
+
+```csharp
+// 鉁� 浣跨敤 UcLookCustomer
+UcLookCustomer lookCustomer = new UcLookCustomer();
+if (lookCustomer.ShowDialog() == DialogResult.OK)
+{
+ txtCustomerId.Text = lookCustomer.SelectedId;
+ txtCustomerName.Text = lookCustomer.SelectedName;
+}
+
+// 鉂� 涓嶈鑷繁鍐欓�夋嫨瀵硅瘽妗�
+// 宸叉湁 60+ UcLook* 鎺т欢鍙敤
+```
+
+### 11.6 鏃ュ織璁板綍瑙勮寖
+
+```csharp
+// 鍏抽敭鎿嶄綔鍓嶅悗璁板綍鏃ュ織
+LogHelper.WriteLog($"寮�濮嬩繚瀛樺鎴锋暟鎹�: {customerId}", LogHelper.LogType.Info);
+
+try
+{
+ string result = UtilityHelper.HttpPost(...);
+ LogHelper.WriteLog($"淇濆瓨鎴愬姛: {customerId}", LogHelper.LogType.Info);
+}
+catch (Exception ex)
+{
+ LogHelper.WriteLog($"淇濆瓨澶辫触: {ex.Message}", LogHelper.LogType.Error);
+}
+```
+
+### 11.7 閰嶇疆绠＄悊瑙勮寖
+
+```csharp
+// 鉁� 浠庨厤缃枃浠惰鍙�
+string apiUrl = ConfigurationManager.AppSettings["WebApiUrl"];
+int pageSize = int.Parse(ConfigurationManager.AppSettings["PageSize"]);
+
+// 鉂� 涓嶈纭紪鐮�
+// string apiUrl = "http://192.168.0.51:8081/";
+```
+
+---
+
+## 12. 甯歌闂涓庢晠闅滄帓鏌�
+
+### 12.1 鏋勫缓澶辫触
+
+#### 闂: DevExpress 缁勪欢鎵句笉鍒�
+
+**鍘熷洜**: DevExpress 鏈畨瑁呮垨 NuGet 婧愭湭閰嶇疆
+
+**瑙ｅ喅鏂规**:
+
+1. 瀹夎 DevExpress v22.2
+2. 閰嶇疆 NuGet 婧�:
+ ```
+ 宸ュ叿 鈫� NuGet 鍖呯鐞嗗櫒 鈫� 绋嬪簭鍖呯鐞嗗櫒璁剧疆 鈫� 绋嬪簭鍖呮簮
+ 娣诲姞: https://nuget.devexpress.com/<your_feed_key>/api
+ ```
+3. 杩樺師 NuGet 鍖�:
+ ```bash
+ nuget restore GsDevSolution.sln
+ ```
+
+#### 闂: CefSharp 鏈湴搴撳姞杞藉け璐�
+
+**鍘熷洜**: `x86/` 鎴� `x64/` 鐩綍缂哄け
+
+**瑙ｅ喅鏂规**:
+
+纭繚杈撳嚭鐩綍鍖呭惈:
+```
+x86/
+ libcef.dll
+ chrome_elf.dll
+ ...
+x64/
+ libcef.dll
+ chrome_elf.dll
+ ...
+```
+
+### 12.2 杩愯鏃堕敊璇�
+
+#### 闂: "鏃犳硶杩炴帴鍒� API 鏈嶅姟鍣�"
+
+**鎺掓煡姝ラ**:
+
+1. 妫�鏌� `App.config` 涓殑 `WebApiUrl`
+2. 浣跨敤娴忚鍣ㄨ闂� API 鍦板潃
+3. 妫�鏌ョ綉缁滆繛鎺�
+4. 鏌ョ湅鏃ュ織鏂囦欢 `logs/{yyyy-MM-dd}.log`
+
+#### 闂: "鐧诲綍澶辫触"
+
+**鎺掓煡姝ラ**:
+
+1. 妫�鏌ョ敤鎴峰悕瀵嗙爜鏄惁姝ｇ‘
+2. 妫�鏌ュ悗绔� API 鏄惁姝ｅ父
+3. 鏌ョ湅鏃ュ織鏂囦欢涓殑閿欒淇℃伅
+4. 妫�鏌ユ暟鎹簱杩炴帴
+
+#### 闂: "绐椾綋鍔犺浇澶辫触"
+
+**鍘熷洜**: 鍙嶅皠鍒涘缓绐椾綋澶辫触
+
+**鎺掓煡姝ラ**:
+
+1. 妫�鏌ュ懡鍚嶇┖闂存槸鍚︽纭�
+2. 妫�鏌ョ獥浣撶被鏄惁涓� public
+3. 妫�鏌ョ獥浣撴槸鍚︽湁鏃犲弬鏋勯�犲嚱鏁�
+4. 鏌ョ湅鏃ュ織涓殑寮傚父鍫嗘爤
+
+### 12.3 鎬ц兘闂
+
+#### 闂: Grid 鍔犺浇鎱�
+
+**浼樺寲鏂规**:
+
+1. 鍚敤鍒嗛〉 (浣跨敤 `UcPageBar`)
+2. 鍑忓皯鍒楁暟
+3. 绂佺敤涓嶅繀瑕佺殑 Grid 鐗规��
+4. 浣跨敤铏氭嫙妯″紡 (澶ф暟鎹噺鏃�)
+
+```csharp
+gridView.OptionsView.ColumnAutoWidth = false;
+gridView.BestFitColumns();
+```
+
+#### 闂: API 璇锋眰瓒呮椂
+
+**瑙ｅ喅鏂规**:
+
+1. 妫�鏌ョ綉缁滅姸鍐�
+2. 浼樺寲鍚庣鏌ヨ
+3. 澧炲姞瓒呮椂鏃堕棿 (淇敼 `UtilityHelper.cs` 涓殑瓒呮椂璁剧疆)
+
+### 12.4 鏃ュ織鐩稿叧
+
+#### 鏌ョ湅鏃ュ織
+
+**浣嶇疆**: `logs/{yyyy-MM-dd}.log`
+
+**鏃ュ織绾у埆**:
+- `[Info]` - 淇℃伅
+- `[Warning]` - 璀﹀憡
+- `[Error]` - 閿欒
+
+#### 鏃ュ織鍐欏叆澶辫触
+
+**鍘熷洜**: 鏃犲啓鏉冮檺
+
+**瑙ｅ喅鏂规**:
+
+1. 浠ョ鐞嗗憳韬唤杩愯
+2. 淇敼 `LogPath` 涓哄叕鍏辩洰褰�
+3. 璧嬩簣搴旂敤鐩綍鍐欐潈闄�
+
+### 12.5 鏁版嵁搴撹繛鎺ラ棶棰�
+
+#### Oracle 杩炴帴澶辫触
+
+**妫�鏌�**:
+- Oracle.ManagedDataAccess.dll 鏄惁瀛樺湪
+- 杩炴帴瀛楃涓叉槸鍚︽纭�
+- 缃戠粶鏄惁鍙揪
+
+#### SQL Server 杩炴帴澶辫触
+
+**妫�鏌�**:
+- SQL Server 鏄惁鍚敤 TCP/IP
+- 绔彛鏄惁寮�鏀� (榛樿 1433)
+- 闃茬伀澧欒鍒�
+
+### 12.6 鑷姩鏇存柊闂
+
+#### 鏇存柊妫�鏌ュけ璐�
+
+**鎺掓煡**:
+
+1. 妫�鏌� `AutoUpdaterXml` URL 鏄惁鍙闂�
+2. 妫�鏌� XML 鏍煎紡鏄惁姝ｇ‘
+3. 妫�鏌ョ綉缁滆繛鎺�
+4. 鏌ョ湅鏃ュ織鏂囦欢
+
+#### 鏇存柊涓嬭浇澶辫触
+
+**鎺掓煡**:
+
+1. 妫�鏌ユ洿鏂板寘 URL 鏄惁鏈夋晥
+2. 妫�鏌ョ鐩樼┖闂�
+3. 妫�鏌ュ啓鏉冮檺
+
+---
+
+## 闄勫綍 A: 鍚庣 API 绔偣
+
+### 璁よ瘉涓庣敤鎴�
+
+| 绔偣 | 璇存槑 |
+|------|------|
+| `User/UserLogin` | 鐢ㄦ埛鐧诲綍 |
+| `User/GetUserLoginInfo` | 鑾峰彇鐢ㄦ埛淇℃伅鍜岃彍鍗� |
+| `User/SetUserOrg` | 鍒囨崲缁勭粐 |
+
+### 缁勭粐涓庤彍鍗�
+
+| 绔偣 | 璇存槑 |
+|------|------|
+| `Organization/GetListPage` | 鑾峰彇缁勭粐鍒楄〃 |
+| `MenuAction/GetModelByNameSpace` | 鏍规嵁鍛藉悕绌洪棿鑾峰彇绐椾綋淇℃伅 |
+
+### 閫氱敤鍒楄〃鏌ヨ
+
+**妯″紡**: `{Module}/{Entity}/GetListPage`
+
+绀轰緥:
+- `BasicData/Customer/GetListPage` - 瀹㈡埛鍒楄〃
+- `BasicData/Items/GetListPage` - 鐗╂枡鍒楄〃
+- `Warehouse/Inventory/GetListPage` - 搴撳瓨鍒楄〃
+
+---
+
+## 闄勫綍 B: 蹇�熷弬鑰�
+
+### 甯哥敤鍛戒护
+
+```bash
+# 杩樺師 NuGet 鍖�
+nuget restore GsDevSolution.sln
+
+# Debug 鏋勫缓
+msbuild GsDevSolution.sln /p:Configuration=Debug
+
+# Release 鏋勫缓
+msbuild GsDevSolution.sln /p:Configuration=Release
+
+# 杩愯绋嬪簭
+Gs.DevApp\bin\Debug\Gs.DevApp.exe
+```
+
+### 甯哥敤浠ｇ爜鐗囨
+
+```csharp
+// API 璋冪敤
+string result = UtilityHelper.HttpPost("Module/Action", "Action", jsonParam);
+dynamic dy = UtilityHelper.ReturnToDynamic(result);
+
+// 娑堟伅鎻愮ず
+MsgHelper.ShowSuccess("鎿嶄綔鎴愬姛");
+MsgHelper.ShowError("鎿嶄綔澶辫触");
+
+// 鏃ュ織璁板綍
+LogHelper.WriteLog("娑堟伅鍐呭", LogHelper.LogType.Info);
+
+// Toast 鎻愮ず
+Toast.Show("鎻愮ず鍐呭", 3);
+```
+
+---
+
+## 闄勫綍 C: 鐩稿叧鏂囨。
+
+- **CLAUDE.md** - Claude Code AI 杈呭姪寮�鍙戞寚鍗�
+- **DEVFRM_GUIDE.md** - DevFrm 妯″潡璇︾粏鎸囧崡
+- **ANALYSIS_REPORT.md** - 鏋舵瀯鍒嗘瀽鎶ュ憡
+- **DevFrm璇︾粏鍒嗘瀽.md** - 妯″潡鍒嗘瀽 (涓枃)
+
+---
+
+## 鑱旂郴涓庢敮鎸�
+
+濡傞渶鎶�鏈敮鎸佹垨鎶ュ憡闂,璇疯仈绯诲紑鍙戝洟闃熴��
+
+**鏈�鍚庢洿鏂�**: 2025-10-16
+
+---
+
+*鏈枃妗ｉ殢椤圭洰鎸佺画鏇存柊,寤鸿瀹氭湡鏌ョ湅鏈�鏂扮増鏈��*
--
Gitblit v1.9.3