From 5ccc809772be51781f9258e5b2c5cfaff4164aa1 Mon Sep 17 00:00:00 2001
From: tjx <t2856754968@163.com>
Date: 星期日, 12 十月 2025 16:52:50 +0800
Subject: [PATCH] 更新文档

---
 README.md |   40 ++++++++++++++++++++++++++++++++++++++--
 1 files changed, 38 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index b642478..664ee40 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,40 @@
-## LW_PdaService
+# LW_PdaService
 
-榫欏穽PDA鍚庣
+钃濆疂 MES PDA 鍚庣鏈嶅姟锛屽熀浜� ASP.NET Core Web API锛屼负 PDA 缁堢鎻愪緵浠撳偍銆佽川妫�銆佸伐鍗曠瓑涓氬姟鎺ュ彛銆傞」鐩噰鐢� SqlSugar 璁块棶 SQL Server锛屽苟閫氳繃缁熶竴鍝嶅簲缁撴瀯 `ResponseResult` 杩斿洖鏁版嵁銆�
+
+## 鍔熻兘姒傝
+- Warehouse锛氬簱瀛樻煡璇€�佸嚭鍏ュ簱銆佽皟鎷ㄤ笌鏉＄爜杩芥函 API銆�
+- QC锛欼PQC銆侀噺妫�璁板綍绛夎川妫�娴佺▼鎺ュ彛銆�
+- Wom锛氬伐鍗曘�佺敓浜ф姤宸ュ強宸ュ簭杩涘害绠＄悊銆�
+- Auth/Login锛氳处鍙疯璇併�佹秷鎭笌鏉冮檺鐩稿叧鍩虹鑳藉姏銆�
+
+## 鎶�鏈爤
+- .NET 8 / ASP.NET Core Web API銆�
+- SqlSugarCore 杩涜 ORM 涓庢暟鎹簱鎿嶄綔锛宍DbHelperSQL` 灏佽閮ㄥ垎瀛樺偍杩囩▼璋冪敤銆�
+- Swashbuckle 鎻愪緵 Swagger 鏂囨。锛孨ewtonsoft.Json 璐熻矗搴忓垪鍖栥��
+
+## 蹇�熷紑濮�
+1. 瀹夎 [.NET 8 SDK](https://dotnet.microsoft.com/download) 涓� SQL Server锛堟垨鍏煎瀹炰緥锛夈��
+2. 澶嶅埗 `appsettings.Development.json`锛屽～鍏ョ幆澧冨疄闄呯殑 `AppSettings`锛氭祴璇曚笌鐢熶骇 ERP 鍦板潃銆乣DataBaseConn` 杩炴帴涓层�傚缓璁湪鏈湴浣跨敤 `dotnet user-secrets` 闅愯棌鏁忔劅淇℃伅銆�
+3. 鍦ㄤ粨搴撴牴鐩綍鎵ц锛�
+   ```powershell
+   dotnet restore
+   dotnet build NewPdaSqlServer.csproj -c Debug
+   dotnet run --project NewPdaSqlServer.csproj --launch-profile Development
+   ```
+4. 璁块棶 `https://localhost:5001/swagger`锛堟垨鍚姩鏃ュ織涓殑绔彛锛夋煡鐪嬫帴鍙ｈ鏄庛��
+
+## 鐩綍缁撴瀯閫熻
+- `Controllers/`锛氭寜涓氬姟鍩熷垝鍒嗙殑 Web API 鎺у埗鍣紝`Controllers/base` 瀛樻斁鍏辩敤鏌ヨ銆�
+- `service/`锛氫笌鎺у埗鍣ㄥ悓鍚嶇殑涓氬姟灞傦紝灏佽 SqlSugar 鏌ヨ涓庝簨鍔°��
+- `Dto/`锛氳姹�/鍝嶅簲鏁版嵁浼犺緭瀵硅薄锛宍entity/` 涓烘暟鎹簱瀹炰綋銆�
+- `util/`锛氬叕鐢ㄥ伐鍏凤紙閰嶇疆銆佹棩蹇椼�佺紪鍙风敓鎴愮瓑锛夛紱`Config/` 缁存姢澶栭儴绯荤粺閰嶇疆銆�
+- `Program.cs`銆乣Startup.cs`锛氬簲鐢ㄥ惎鍔ㄥ叆鍙ｄ笌渚濊禆娉ㄥ叆銆丼wagger銆丆ORS 绛夌绾块厤缃��
+
+## 寮�鍙戝懡浠�
+- `dotnet test`锛堝緟寤虹珛娴嬭瘯椤圭洰锛夎繍琛岃嚜鍔ㄥ寲娴嬭瘯銆�
+- `dotnet publish -c Release -o bin/Publish/net8.0` 鐢熸垚閮ㄧ讲鍖呫��
+
+## 鏇村璧勬枡
+- `AGENTS.md`锛氳础鐚寚鍗楋紝鍖呭惈浠ｇ爜椋庢牸銆佹彁娴嬨�丳R 瑕佹眰绛夎鏄庛��
 

--
Gitblit v1.9.3