From ce1292c9cf37195b6abd2699dfc5d6cb3e143c9b Mon Sep 17 00:00:00 2001
From: wanshenmean <cathay_xy@163.com>
Date: 星期日, 12 四月 2026 23:38:19 +0800
Subject: [PATCH] feat(MES): 添加MES接口相关实体和DTO JS扩展文件至JSX格式并更新配置

---
 Code/CLAUDE.md |  132 ++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 132 insertions(+), 0 deletions(-)

diff --git a/Code/CLAUDE.md b/Code/CLAUDE.md
new file mode 100644
index 0000000..6f70668
--- /dev/null
+++ b/Code/CLAUDE.md
@@ -0,0 +1,132 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## 椤圭洰姒傝堪
+
+**WIDESEA** 鏄竴涓伐涓氫粨鍌ㄨ嚜鍔ㄥ寲绯荤粺锛屽寘鍚袱涓牳蹇冨瓙绯荤粺锛�
+
+- **WCS**锛堜粨搴撴帶鍒剁郴缁燂級锛氱洿鎺ユ帶鍒跺爢鍨涙満銆佽緭閫佺嚎銆佹満鍣ㄤ汉銆佺┛姊溅绛夌墿鐞嗚澶囷紝涓� PLC 閫氫俊
+- **WMS**锛堜粨搴撶鐞嗙郴缁燂級锛氱鐞嗗簱瀛樸�佸叆搴撱�佸嚭搴撲换鍔°�佺洏鐐圭瓑涓氬姟閫昏緫
+
+涓や釜绯荤粺閫氳繃 HTTP API 浜や簰锛學MS 渚濊禆 WCS 瀹屾垚璁惧璋冨害銆�
+
+## 鏋勫缓鍛戒护
+
+```bash
+# WCS 鍚庣锛堢鍙� 9292锛�
+dotnet build WCS/WIDESEAWCS_Server/WIDESEAWCS_Server.sln
+dotnet run --project WCS/WIDESEAWCS_Server/WIDESEAWCS_Server/WIDESEAWCS_Server.csproj
+
+# WMS 鍚庣锛堢鍙� 9291锛�
+dotnet build WMS/WIDESEA_WMSServer/WIDESEA_WMSServer.sln
+dotnet run --project WMS/WIDESEA_WMSServer/WIDESEA_WMSServer/WIDESEA_WMSServer.csproj
+
+# WCS 鍓嶇
+cd WCS/WIDESEAWCS_Client && npm run serve
+
+# WMS 鍓嶇
+cd WMS/WIDESEA_WMSClient && npm run serve
+
+# S7 妯℃嫙鍣�
+cd 娴嬭瘯宸ュ叿/WIDESEAWCS_S7Simulator/WIDESEAWCS_S7Simulator.Web && npm run dev
+```
+
+## 鏋舵瀯姒傝
+
+```
+鈹屸攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�
+鈹�                        WCS (绔彛 9292)                       鈹�
+鈹�  鈹屸攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�  鈹屸攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�  鈹屸攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�  鈹�
+鈹�  鈹�   Quartz    鈹�  鈹�  Communicator 鈹�  鈹�   Redis L1+L2      鈹�  鈹�
+鈹�  鈹�   Jobs      鈹傗啋 鈹�  (PLC鍗忚)    鈹�  鈹�   Cache            鈹�  鈹�
+鈹�  鈹斺攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�  鈹斺攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�  鈹斺攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�  鈹�
+鈹�         鈫�                                                    鈹�
+鈹�  鈹屸攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�     鈹�
+鈹�  鈹�  TcpSocketServer (绔彛 2000) / WebSocket (绔彛 9296) 鈹�     鈹�
+鈹�  鈹斺攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�     鈹�
+鈹斺攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�
+                              鈫� HTTP API
+                              鈫�
+鈹屸攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�
+鈹�                        WMS (绔彛 9291)                       鈹�
+鈹�  鈹屸攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�  鈹屸攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�  鈹屸攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�  鈹�
+鈹�  鈹�   Tasks     鈹�  鈹�    Stock     鈹�  鈹�    Inbound/        鈹�  鈹�
+鈹�  鈹�   Service   鈹�  鈹�    Service   鈹�  鈹�    Outbound        鈹�  鈹�
+鈹�  鈹斺攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�  鈹斺攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�  鈹斺攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�  鈹�
+鈹斺攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�
+```
+
+## WCS 椤圭洰缁撴瀯
+
+| 椤圭洰 | 鐢ㄩ�� |
+|------|------|
+| `WIDESEAWCS_Server` | 涓� API 鍏ュ彛锛堢鍙� 9292锛� |
+| `WIDESEAWCS_Core` | 妗嗘灦锛堟暟鎹簱銆佺紦瀛樸�丏I銆佹棩蹇楋級 |
+| `WIDESEAWCS_Common` | 甯搁噺銆佹灇涓俱�丷edis 閿� |
+| `WIDESEAWCS_Model` | 瀹炰綋妯″瀷 |
+| `WIDESEAWCS_DTO` | 鏁版嵁浼犺緭瀵硅薄 |
+| `WIDESEAWCS_Communicator` | 宸ヤ笟鍗忚锛圡odbus銆丼7銆丱mron 绛夛級 |
+| `WIDESEAWCS_Tasks` | 鍚庡彴璁惧鎺у埗浣滀笟 |
+| `WIDESEAWCS_QuartzJob` | Quartz.NET 璋冨害 |
+
+**璇︾粏 WCS 瑙勮寖**锛氳 `WCS/WIDESEAWCS_Server/CLAUDE.md`
+
+## WMS 椤圭洰缁撴瀯
+
+| 椤圭洰 | 鐢ㄩ�� |
+|------|------|
+| `WIDESEA_WMSServer` | 涓� API 鍏ュ彛锛堢鍙� 9291锛� |
+| `WIDESEA_Core` | 妗嗘灦宸ュ叿 |
+| `WIDESEA_Common` | 甯搁噺銆佹灇涓� |
+| `WIDESEA_Model` | 瀹炰綋妯″瀷 |
+| `WIDESEA_*Service` | 涓氬姟閫昏緫鏈嶅姟 |
+
+## 鍏抽敭璁捐
+
+- **ORM**锛歋qlSugar锛堟敮鎸佸鏁版嵁搴擄級
+- **渚濊禆娉ㄥ叆**锛欰utofac锛岄�氳繃 `AutofacModuleRegister` 娉ㄥ唽
+- **缂撳瓨**锛歊edis L1锛堝唴瀛橈級+ L2锛圧edis锛夋贩鍚堢紦瀛�
+- **璋冨害**锛歈uartz.NET
+- **瀹炴椂閫氫俊**锛歋ignalR WebSocket
+- **璁惧鍗忚**锛氬瓨鍌ㄥ湪鏁版嵁搴� `Dt_DeviceProtocol` 琛紝闈為厤缃枃浠�
+
+## 鎶�鏈爤
+
+- **鍚庣**锛�.NET 6/8锛孉SP.NET Core锛孋# 12
+- **鍓嶇**锛歏ue 3锛孍lement Plus锛孷ite锛孭inia
+- **鏁版嵁搴�**锛歋QL Server
+- **缂撳瓨**锛歊edis
+
+## 娉ㄩ噴涓庢枃妗� (寮哄埗)
+
+- **XML 鏂囨。娉ㄩ噴**: 鎵�鏈� `public` 绫汇�佹帴鍙c�佹柟娉曘�佸睘鎬�**蹇呴』**鍖呭惈 XML 鏂囨。娉ㄩ噴 (`/// <summary>...</summary>`)锛岃В閲婂叾鐢ㄩ�斻�佸弬鏁板拰杩斿洖鍊笺��
+- **琛屽唴娉ㄩ噴**: 瀵逛簬澶嶆潅鐨勪笟鍔¢�昏緫銆佺畻娉曞疄鐜版垨闈炵洿瑙傜殑浠g爜鍧楋紝**蹇呴』**娣诲姞 `//` 琛屽唴娉ㄩ噴瑙i噴鈥滀负浠�涔堣繖涔堝仛鈥濄��
+- **TODO 鏍囪**: 濡傛灉浠g爜鏈畬鎴愭垨鏈変复鏃舵柟妗堬紝蹇呴』浣跨敤 `// TODO: 璇存槑` 鏍囪銆�
+
+## 閫氱敤瑙勮寖
+
+- **寮傛缂栫▼**: 鎵�鏈� I/O 鎿嶄綔蹇呴』浣跨敤 `async/await`銆傚簱浠g爜璇蜂娇鐢� `ConfigureAwait(false)`銆�
+
+- **鍛藉悕**:
+
+  - 鎺ュ彛浠� "I" 寮�澶� (渚嬪: `IUserService`)銆�
+  - 绫诲悕銆佹柟娉曞悕浣跨敤 **PascalCase**銆�
+  - 绉佹湁瀛楁銆佸眬閮ㄥ彉閲忎娇鐢� **camelCase**銆�
+
+- **鍛藉悕绌洪棿**: 浣跨敤 **鏂囦欢浣滅敤鍩熷懡鍚嶇┖闂�** (`namespace MyApp.Api;`)銆�
+
+- 褰撻渶瑕佸涓や釜鎴栦互涓婄殑鏁版嵁搴撴墽琛屼慨鏀�/娣诲姞鎿嶄綔骞朵繚璇佷簨鍔′竴鑷存�ф椂锛岃浣跨敤宸ヤ綔鍗曞厓绠$悊鍣紙`IUnitOfWorkManage`锛夌殑浜嬪姟鏂规硶锛�
+
+  - **鍚屾鍦烘櫙**锛氳皟鐢� `BeginTran(Func<WebResponseContent> func)`锛屼紶鍏ュ悓姝ュ鎵樸��
+  - **寮傛鍦烘櫙**锛氳皟鐢� `BeginTranAsync(Func<Task<WebResponseContent>> funcAsync)`锛屼紶鍏ュ紓姝ュ鎵樸��
+
+  **娉ㄦ剰**锛歚IUnitOfWorkManage` 闇�閫氳繃渚濊禆娉ㄥ叆锛圖I锛夎幏鍙栥�傝鏂规硶浼氳嚜鍔ㄧ鐞嗕簨鍔$殑鎻愪氦涓庡洖婊氾紝鍙渶纭繚鎵�鏈夋暟鎹簱鎿嶄綔鍦ㄤ紶鍏ョ殑濮旀墭鍐呭畬鎴愩��
+
+## 馃毇 涓ョ浜嬮」
+
+- **涓ョ** 鐢熸垚娌℃湁娉ㄩ噴鐨勪唬鐮� (灏ゅ叾鏄叕鍏辨柟娉�)銆�
+- **涓ョ** 浣跨敤 `Task.Result` 鎴� `Task.Wait()`銆�
+- **涓ョ** 鍦ㄥ紓姝ヤ笂涓嬫枃涓娇鐢� `.ToList()` (蹇呴』鐢� `.ToListAsync()`)銆�
+- **涓ョ** 鐩存帴鏆撮湶瀹炰綋 (Entity)锛屽繀椤讳娇鐢� DTO銆�
+- **涓ョ** 鎹曡幏 `Exception` 鑰屼笉璁板綍鏃ュ織銆�

--
Gitblit v1.9.3