From 5707781039b9d902ce1d2d6727fba65bbab14574 Mon Sep 17 00:00:00 2001
From: 啊鑫 <t2856754968@163.com>
Date: 星期六, 13 九月 2025 17:02:06 +0800
Subject: [PATCH] 异常单回滚

---
 WebApi/CLAUDE.md |   44 ++++++++++++++++++++++++++++----------------
 1 files changed, 28 insertions(+), 16 deletions(-)

diff --git a/WebApi/CLAUDE.md b/WebApi/CLAUDE.md
index a9dd5f0..15fb77b 100644
--- a/WebApi/CLAUDE.md
+++ b/WebApi/CLAUDE.md
@@ -16,14 +16,15 @@
 - **Business Modules**:
   - **Gs.BaseInfo**: Basic information management (items, customers, suppliers, staff, etc.)
   - **Gs.Warehouse**: Inventory and warehouse management
-  - **Gs.QC** / **GS.QC**: Quality control functionality
+  - **GS.QC**: Quality control functionality
   - **Gs.Sys**: System administration and user management
   - **Gs.Report**: Reporting functionality
   - **Gs.Wom**: Work order management
   - **Gs.Sales**: Sales management
   - **Gs.Pda**: Mobile/handheld device support
-  - **Gs.QiTaCk** / **Gs.QiTaRk**: Additional business modules
-  - **Gs.Ww**: Additional functionality
+  - **Gs.QiTaCk** / **Gs.QiTaRk**: Additional business modules (鍏跺畠鍑哄簱/鍏跺畠鍏ュ簱)
+  - **Gs.Ww**: Outsourcing management (濮斿)
+  - **Gs.JJGZ**: Piece-rate wage management (璁′欢宸ヨ祫)
 
 ## Development Commands
 
@@ -33,7 +34,7 @@
 - Build specific project: `dotnet build Gs.ProjectName/Gs.ProjectName.csproj`
 
 ### Development Server
-- The API runs on `http://localhost:5263` (or `http://localhost:37005` via IIS Express)
+- The API runs on default ports (check launchSettings.json for specific ports)
 - Swagger UI is available at `/swagger` endpoint
 - CORS is configured to allow all origins for development
 
@@ -42,7 +43,7 @@
 ### Custom API Framework
 The solution uses a custom API framework built in `Gs.Toolbox`:
 - Custom dependency injection with lifecycle attributes (`ITransient`, `IScope`, `ISingleton`)
-- Custom controller convention and routing
+- Custom controller convention via `CustomApplicationModelConvention`
 - API grouping for Swagger documentation via `ApiGroupAttribute`
 - Custom authorization with `ApiAuthorizeAttribute`
 
@@ -58,26 +59,37 @@
 - Custom JSON serialization with Newtonsoft.Json
 
 ### Key Components
-- **CustomContractResolver**: Custom JSON property naming
-- **ResponseResult**: Standardized API response format
+- **CustomContractResolver**: Custom JSON property naming (converts to camelCase)
+- **ReturnDto<T>**: Standardized API response format with RtnCode, RtnData, RtnMsg
+- **PageList<T>** and **PageQuery**: Pagination support
 - **ExcelHelper**: Excel import/export functionality
 - **LogHelper**: Logging utilities
 - **DbHelperSQL**: Additional database utilities
 
+### Framework Features
+- Custom controller discovery via `CustomControllerFeatureProvider`
+- Module system with `IModule` interface for extensibility
+- Dependency injection container with custom lifecycle management
+- API grouping system for organized Swagger documentation
+
 ## Business Domains
 
-The system handles typical MES functionality:
-- Base information (items, customers, suppliers, departments, staff)
-- Quality control and inspection
-- Warehouse and inventory management
-- Work order management
-- Reporting and analytics
-- Mobile device integration
+The system handles typical MES functionality organized by API groups:
+- Base information (BaseInfo): Items, customers, suppliers, departments, staff
+- Quality control (QC): Inspection projects and quality management
+- Warehouse (PerMission): Inventory and warehouse operations
+- Work orders (WOM): Manufacturing execution
+- ERP integration (ErpMes): Data exchange with ERP systems
+- Reporting (Report/Rport): Various business reports
+- Mobile support (PDA): Handheld device operations
+- Additional modules: Sales (XS), Outsourcing (WW), etc.
 
 ## Development Notes
 
-- All projects target .NET 8.0
+- All projects target .NET 8.0 (except Gs.Toolbox which targets .NET 6.0)
 - Nullable reference types are enabled
 - The system uses a Chinese interface (comments and some naming in Chinese)
 - Custom API framework provides dependency injection and controller conventions
-- Swagger documentation is automatically generated with XML comments
\ No newline at end of file
+- Swagger documentation is automatically generated with XML comments from Services folder
+- Response format follows ReturnDto pattern with standardized error codes
+- File upload/download paths are configured and served as static files
\ No newline at end of file

--
Gitblit v1.9.3