From d01295c254063b3349a86a4474e04a62b284bd19 Mon Sep 17 00:00:00 2001
From: wanshenmean <cathay_xy@163.com>
Date: 星期二, 24 三月 2026 16:26:07 +0800
Subject: [PATCH] 一些配置
---
Code/WMS/CLAUDE.md | 187 ++++++++++++++++++++++++++++++++++++++++++++++
1 files changed, 187 insertions(+), 0 deletions(-)
diff --git a/Code/WMS/CLAUDE.md b/Code/WMS/CLAUDE.md
new file mode 100644
index 0000000..7208508
--- /dev/null
+++ b/Code/WMS/CLAUDE.md
@@ -0,0 +1,187 @@
+# CLAUDE.md
+
+姝ゆ枃浠朵负 Claude Code (claude.ai/code) 鎻愪緵鍦ㄦ浠ｇ爜搴撲腑宸ヤ綔鐨勬寚瀵笺��
+
+## 椤圭洰姒傝堪
+
+杩欐槸涓�涓� WMS锛堜粨搴撶鐞嗙郴缁燂級锛屽悗绔噰鐢� ASP.NET Core 6.0锛屽墠绔噰鐢� Vue 3銆傜郴缁熺鐞嗕粨搴撹繍钀ワ紝鍖呮嫭鍏ュ簱銆佸嚭搴撱�佸簱瀛樸�佷换鍔″拰鍩虹涓绘暟鎹��
+
+```
+WMS/
+鈹溾攢鈹� WIDESEA_WMSServer/ # 鍚庣 (ASP.NET Core 6.0)
+鈹� 鈹溾攢鈹� WIDESEA_WMSServer/ # 涓� API 椤圭洰
+鈹� 鈹溾攢鈹� WIDESEA_Core/ # 鏍稿績妗嗘灦锛堝熀纭�鎺у埗鍣ㄣ�佹湇鍔°�佷粨鍌級
+鈹� 鈹溾攢鈹� WIDESEA_Model/ # 鎸夐鍩熺粍缁囩殑鏁版嵁妯″瀷
+鈹� 鈹溾攢鈹� WIDESEA_*Service/ # 鏈嶅姟瀹炵幇锛圔asic銆両nbound銆丱utbound銆丼tock 绛夛級
+鈹� 鈹溾攢鈹� WIDESEA_I*Service/ # 鏈嶅姟鎺ュ彛
+鈹� 鈹溾攢鈹� WIDESEA_DTO/ # 鏁版嵁浼犺緭瀵硅薄
+鈹� 鈹斺攢鈹� WIDESEA_Common/ # 鍏叡宸ュ叿绫�
+鈹斺攢鈹� WIDESEA_WMSClient/ # 鍓嶇 (Vue 3 + Vite)
+ 鈹溾攢鈹� src/api/ # HTTP 瀹㈡埛绔拰 API 璋冪敤
+ 鈹溾攢鈹� src/components/basic/ # 鍙鐢ㄧ粍浠讹紙ViewGrid銆乂olForm銆乂olTable锛�
+ 鈹溾攢鈹� src/extension/ # 涓庡悗绔尮閰嶇殑棰嗗煙鐗瑰畾閰嶇疆
+ 鈹溾攢鈹� src/views/ # Vue 椤甸潰缁勪欢
+ 鈹溾攢鈹� src/router/ # Vue Router 閰嶇疆
+ 鈹斺攢鈹� src/store/ # Vuex 鐘舵�佺鐞�
+```
+
+## 寮�鍙戝懡浠�
+
+### 鍚庣 (ASP.NET Core)
+```bash
+# 鏋勫缓瑙ｅ喅鏂规
+cd WIDESEA_WMSServer
+dotnet build WIDESEA_WMSServer.sln
+
+# 杩愯鏈嶅姟鍣紙榛樿绔彛锛�9291锛�
+cd WIDESEA_WMSServer/WIDESEA_WMSServer
+dotnet run
+
+# 杩樺師鍖�
+dotnet restore
+
+# 浣跨敤鐗瑰畾閰嶇疆杩愯
+dotnet run --configuration Release
+```
+
+### 鍓嶇 (Vue 3 + Vite)
+```bash
+cd WIDESEA_WMSClient
+
+# 瀹夎渚濊禆锛堜娇鐢� yarn锛�
+yarn install
+
+# 寮�鍙戞湇鍔″櫒锛堢鍙� 8080锛�
+yarn dev
+
+# 鐢熶骇鏋勫缓
+yarn build
+
+# 棰勮鐢熶骇鏋勫缓
+yarn preview
+
+# 杩愯鍗曞厓娴嬭瘯
+yarn test:unit
+
+# 浠ｇ爜妫�鏌�
+yarn lint
+```
+
+## 鏋舵瀯
+
+### 鍚庣鏋舵瀯
+
+**閲囩敤娓呮磥鏋舵瀯鍘熷垯鐨勫垎灞傛灦鏋勶細**
+
+- **鎺у埗鍣�** (`WIDESEA_WMSServer/Controllers/`)锛氱户鎵胯嚜 `ApiBaseController<TService, TEntity>`锛岃嚜鍔ㄦ彁渚� CRUD 绔偣銆傞鍩熺壒瀹氭帶鍒跺櫒鎸夋枃浠跺す缁勭粐锛圔asic銆両nbound銆丱utbound銆丼tock銆丼ystem銆乀askInfo 绛夛級銆�
+
+- **鏈嶅姟灞�** (`WIDESEA_*Service/`)锛氫笟鍔￠�昏緫灞傘�傛湇鍔＄户鎵胯嚜 `ServiceBase<T, TEntity>` 骞跺疄鐜� `WIDESEA_I*Service/` 涓殑棰嗗煙鎺ュ彛銆傞�氳繃 Autofac DI 娉ㄥ唽銆�
+
+- **浠撳偍灞�** (`WIDESEA_Core/BaseRepository/`)锛氫娇鐢� SqlSugar ORM 鐨勬暟鎹闂眰銆傛硾鍨� `IRepository<T>` 鍜� `RepositoryBase<T>` 鎻愪緵閫氱敤 CRUD 鎿嶄綔銆�
+
+- **妯″瀷** (`WIDESEA_Model/Models/`)锛氭寜棰嗗煙缁勭粐锛圔asic銆丆heck銆両nbound銆丱utbound銆丼tock銆丼ystem銆乀askInfo銆丷ecord銆丆onfig銆丄pprovalFlow锛夈�傛ā鍨嬬户鎵胯嚜 `BaseEntity` 鎴� `BaseWarehouseEntity`銆�
+
+- **DTO** (`WIDESEA_DTO/`)锛欰PI 璇锋眰/鍝嶅簲鐨勬暟鎹紶杈撳璞★紝鎸夐鍩熺粍缁囥��
+
+**鍏抽敭鍩虹璁炬柦缁勪欢锛�**
+- `WIDESEA_Core/BaseController/ApiBaseController.cs`锛氬叿鏈夎嚜鍔� CRUD 璺敱鐨勫熀纭�鎺у埗鍣�
+- `WIDESEA_Core/BaseServices/IService.cs`锛氬熀纭�鏈嶅姟鎺ュ彛
+- `WIDESEA_Core/Extensions/AutofacModuleRegister.cs`锛欰utofac DI 娉ㄥ唽
+- `WIDESEA_Core/DB/`锛歋qlSugar 鏁版嵁搴撻厤缃�
+- `WIDESEA_Core/Authorization/`锛欽WT 韬唤楠岃瘉
+- `WIDESEA_Core/Filter/`锛氬叏灞�寮傚父澶勭悊鍜屾搷浣滆繃婊ゅ櫒
+
+### 鍓嶇鏋舵瀯
+
+**甯︽湁鑷畾涔夌粍浠舵鏋剁殑 Vue 3 缁勫悎寮� API锛�**
+
+- **ViewGrid 缁勪欢** (`src/components/basic/ViewGrid/`)锛氭牳蹇冭〃鏍�/缃戞牸缁勪欢锛屽鐞嗘暟鎹樉绀恒�佸垎椤点�佹悳绱㈠拰 CRUD 鎿嶄綔銆傞�氳繃鎵╁睍鏂囦欢楂樺害鍙厤缃��
+
+- **鎵╁睍鏂囦欢** (`src/extension/`)锛氶厤缃瘡涓疄浣撶殑 ViewGrid 琛屼负鐨� JavaScript 鏂囦欢銆傚畠浠畾涔夎〃鏍煎垪銆佽〃鍗曞瓧娈点�佹悳绱㈡潯浠跺拰鑷畾涔夋搷浣溿�傛ā寮忥細`src/extension/{domain}/{entityName}.js` 鍖归厤鍚庣鎺у埗鍣ㄣ��
+
+- **API 灞�** (`src/api/`)锛氬皝瑁� Axios 鐨� HTTP 瀹㈡埛绔紝鍏锋湁韬唤楠岃瘉鍜岄敊璇鐞嗘嫤鎴櫒銆�
+
+- **璺敱鍣�** (`src/router/index.js`)锛氬甫鏈夊搱甯屾ā寮忋�佽韩浠介獙璇佸畧鍗拰浠� `viewGird.js` 鍔ㄦ�佽矾鐢卞姞杞界殑 Vue Router銆�
+
+**鍏抽敭鍓嶇妯″紡锛�**
+- 鎵╁睍鏂囦欢锛堝 `src/extension/basic/materielInfo.js`锛夊畾涔夎〃澶淬�佽〃鍗曞瓧娈靛拰鑷畾涔変笟鍔￠�昏緫
+- `src/views/` 涓殑瑙嗗浘寰堢簿绠�锛屽ぇ澶氫娇鐢ㄧ敱鎵╁睍閰嶇疆鐨� ViewGrid 缁勪欢
+- Vuex 瀛樺偍绠＄悊韬唤楠岃瘉鐘舵�佸拰鍔犺浇鎸囩ず鍣�
+
+## 閰嶇疆
+
+### 鍚庣閰嶇疆
+
+`WIDESEA_WMSServer/WIDESEA_WMSServer/appsettings.json` 涓殑鍏抽敭璁剧疆锛�
+- `urls`锛氭湇鍔″櫒绔彛锛堥粯璁わ細`http://*:9291`锛�
+- `ConnectionString`锛歋QL Server 鏁版嵁搴撹繛鎺�
+- `MainDB`锛氫富鏁版嵁搴撳悕绉�
+- `Cors`锛氬墠绔簮澶寸殑 CORS 绛栫暐
+- `WebSocketPort`锛氬疄鏃舵洿鏂扮殑 WebSocket 绔彛锛堥粯璁わ細9296锛�
+- `AutoOutboundTask`锛氳嚜鍔ㄥ嚭搴撴搷浣滅殑鍚庡彴浠诲姟閰嶇疆
+
+### 鍓嶇閰嶇疆
+
+- `vite.config.js`锛歏ite 鏋勫缓閰嶇疆锛宍@` 鍒悕鎸囧悜 `src/`
+- 鏈嶅姟鍣ㄩ粯璁よ繍琛屽湪绔彛 8080
+- 鍩轰簬鍝堝笇鐨勮矾鐢憋紙`createWebHashHistory`锛�
+
+## 浠ｇ爜绾﹀畾
+
+### 鍚庣
+
+1. **鍛藉悕瑙勮寖**锛�
+ - 鎺у埗鍣細`{Entity}Controller.cs`
+ - 鏈嶅姟锛歚{Entity}Service.cs`锛堝疄鐜� `I{Entity}Service`锛�
+ - 妯″瀷锛歚Dt_{EntityName}.cs`锛堟暟鎹簱瀹炰綋浣跨敤 `Dt_` 鍓嶇紑锛�
+ - API 璺敱锛歚api/{ControllerName}`
+
+2. **鏈嶅姟娉ㄥ唽**锛氬疄鐜� `IDependency` 鐨勬湇鍔′細閫氳繃 Autofac 浠庢墍鏈夐」鐩▼搴忛泦涓嚜鍔ㄦ敞鍐屻��
+
+3. **鎺у埗鍣ㄦā寮�**锛氬ぇ澶氭暟鎺у埗鍣ㄧ户鎵胯嚜 `ApiBaseController<TService, TEntity>`锛屽彧闇�瑕佹瀯閫犲嚱鏁般�傛牴鎹渶瑕佹坊鍔犺嚜瀹氫箟鎿嶄綔銆�
+
+4. **鍝嶅簲鏍煎紡**锛歚WebResponseContent` 鍖呰鍣紝鍖呭惈 `Status`锛堝竷灏斿�硷級鍜� `Data` 灞炴�с��
+
+### 鍓嶇
+
+1. **鎵╁睍鏂囦欢妯″紡**锛氬浜庢瘡涓悗绔疄浣擄紝鍦� `src/extension/{domain}/{entity}.js` 鍒涘缓鎵╁睍鏂囦欢锛屽寘鍚細
+ - 琛ㄦ牸鍒楀畾涔�
+ - 琛ㄥ崟瀛楁閰嶇疆
+ - 鑷畾涔� URL 妯″紡
+ - 涓氬姟閫昏緫閽╁瓙
+
+2. **缁勪欢鍛藉悕**锛歏ue 缁勪欢浣跨敤 PascalCase锛屽敖鍙兘鍖归厤鍚庣瀹炰綋鍚嶇О銆�
+
+3. **API 璋冪敤**锛氫娇鐢ㄥ叏灞� `this.http` 瀵硅薄杩涜 HTTP 璇锋眰銆�
+
+## 娣诲姞鏂板姛鑳�
+
+### 鍚庣
+1. 鍦� `WIDESEA_Model/Models/{Domain}/` 涓垱寤烘ā鍨�
+2. 鍦� `WIDESEA_I{Domain}Service/` 涓垱寤烘湇鍔℃帴鍙�
+3. 鍦� `WIDESEA_{Domain}Service/` 涓垱寤烘湇鍔″疄鐜�
+4. 鍦� `WIDESEA_WMSServer/Controllers/{Domain}/` 涓垱寤烘帶鍒跺櫒锛岀户鎵胯嚜 `ApiBaseController<TService, TEntity>`
+5. 鏈嶅姟閫氳繃 `IDependency` 鎺ュ彛鑷姩娉ㄥ唽
+
+### 鍓嶇
+1. 鍦� `src/extension/{domain}/{entity}.js` 鍒涘缓鎵╁睍鏂囦欢
+2. 濡傞渶鑷畾涔� UI锛屽湪 `src/views/{domain}/{entity}.vue` 鍒涘缓鍙�夎鍥剧粍浠�
+3. 濡傞渶瑕侊紝娣诲姞璺敱閰嶇疆
+4. ViewGrid 缁勪欢閰嶅悎鎵╁睍閰嶇疆鍙嚜鍔ㄥ鐞嗗ぇ澶氭暟 CRUD 鎿嶄綔
+
+## 鏁版嵁搴�
+
+- **ORM**锛歋qlSugar
+- **鏁版嵁搴�**锛歋QL Server
+- **杩炴帴瀛楃涓�**锛氬湪 `appsettings.json` 涓厤缃�
+- **杩佺Щ**锛氶�氳繃 SqlSugar 鐨� Code First 鏂瑰紡澶勭悊
+
+## 瀹炴椂鍔熻兘
+
+- SignalR 鐢ㄤ簬鏈嶅姟鍣ㄥ拰瀹㈡埛绔箣闂寸殑瀹炴椂鏇存柊
+- WebSocket 鏈嶅姟鍣ㄥ湪鍗曠嫭绔彛锛堝彲鍦� `appsettings.json` 涓厤缃級
+- 鍓嶇 SignalR 瀹㈡埛绔泦鎴愬湪 `src/main.js` 涓�
+
+## API 鏂囨。
+
+杩愯鍚庣鏈嶅姟鍣ㄦ椂鍙敤 Swagger UI锛堟煡鐪� `/swagger` 绔偣锛夈��
--
Gitblit v1.9.3