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