cnf
7 天以前 aebd2d642e19ce9ccb253c671b239e7ed9fc91c6
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
- 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