1111

tjx

2025-11-05 682e7301250701c55c0f645d8de849cc4663d8e8

 CLAUDE.md

@@ -24,10 +24,12 @@

### Database Layer
- Uses **SqlSugar ORM** for data access with Oracle database
- Connection string configured in `appsettings.json`
- Two database contexts available:
  - `DbContext<T>` (MES.Service/DB/DbContext.cs:10) - Generic repository pattern
  - `SqlSugarHelper` (MES.Service/DB/SqlSugarHelper.cs:6) - Oracle-specific helper with transaction support
- Connection string configured in `appsettings.json` and loaded via `AppsettingsUtility.Settings.DataBaseConn`
- Three database access patterns available:
  - `Repository<T>` (MES.Service/DB/Repository.cs:6) - Base class for all Manager classes, extends SqlSugar's SimpleClient with Oracle configuration and transaction support via `UseTransaction()` method
  - `DbContext<T>` (MES.Service/DB/DbContext.cs:10) - Generic repository pattern for SqlServer (legacy, not actively used)
  - `SqlSugarHelper` (MES.Service/DB/SqlSugarHelper.cs:6) - Static Oracle helper with `GetInstance()` and `UseTransactionWithOracle()` methods
- **IMPORTANT**: Most services inherit from `Repository<T>`, which provides pre-configured Oracle connection and built-in transaction management

### Service Layer Structure
- **BasicData**: Core business entities (customers, items, suppliers, etc.)
@@ -38,11 +40,13 @@
  - `webApi/`: External API DTOs for ERP integration

### API Layer
- ASP.NET Core Web API with Swagger documentation
- Controllers organized by domain (BasicData, QC, Warehouse)
- Newtonsoft.Json for serialization with camelCase naming
- ASP.NET Core Web API with Swagger documentation (available in Development mode)
- Controllers organized by domain (BasicData, QC, Warehouse, FBSDB)
- Newtonsoft.Json for serialization with camelCase naming (configured in Startup.cs:46)
- CORS enabled for cross-origin requests
- Custom ActionFilter for request/response handling
- Custom ActionFilter (MESApplication/Filter/ActionFilter.cs) for global request/response logging
- All endpoints use `[HttpPost]` by convention, even for read operations
- Route pattern: `api/[controller]/[action]`

## Common Development Commands

@@ -89,19 +93,54 @@
## Important Patterns

### Repository Pattern
Most business logic follows the Manager pattern:
- Managers in `MES.Service/service/` handle business operations
- Controllers in `MESApplication/Controllers/` handle HTTP requests
- Models in `MES.Service/Modes/` represent database entities
All business logic follows the Manager pattern with inheritance-based repository access:
- **Managers** in `MES.Service/service/` inherit from `Repository<T>` and handle business operations
  - Example: `MesCustomerManager : Repository<MesCustomer>` (47 Manager classes total)
  - Managers use `UseTransaction(db => {...})` for transactional operations
  - Directly access SqlSugar methods via inherited SimpleClient functionality
- **Controllers** in `MESApplication/Controllers/` handle HTTP requests and instantiate Manager classes
  - Controllers manually create Manager instances (e.g., `new MesCustomerManager()`)
  - Use `ResponseResult` utility class for standardized API responses
  - Controllers wrap Manager calls in try-catch blocks and log to MessageCenter
- **Models** in `MES.Service/Modes/` represent database entities with SqlSugar attributes

### Service Registration
Services are manually instantiated rather than using dependency injection containers. When adding new services, follow the existing pattern in the respective Manager classes.
### Service Registration and Response Format
Services are manually instantiated rather than using dependency injection containers:
- Controllers directly instantiate Managers: `private readonly MesCustomerManager m = new();`
- Startup.cs configures `AppSettings` from appsettings.json into static `AppsettingsUtility.Settings`
- No DI container for business logic - all service creation is explicit

All API endpoints return `ResponseResult` (MES.Service/util/ResponseResult.cs:7) with structure:
```csharp
{
  status: 0,        // 0 = success, 1 = failure
  message: "OK",    // error message or "OK"
  data: object,     // response payload wrapped in ExpandoObject
  TotalCount: 0     // optional pagination count
}
```

### Error Handling
- ActionFilter handles global request/response processing
- SQL logging enabled via SqlSugar AOP for debugging
- Console output for SQL query debugging
- `ActionFilter` (MESApplication/Filter/ActionFilter.cs:13) handles global request/response processing
  - Logs all requests with headers and body parameters
  - Logs all responses with execution time
  - Catches exceptions and logs via `ErrorLog.Write()`
- SQL logging enabled via SqlSugar AOP for debugging (prints to Console)
- All Controller methods catch exceptions and return `ResponseResult.ResponseError(ex)`
- ERP integration operations logged to `MessageCenter` table with status tracking

## API Documentation

API documentation is available in the `MESApplication/Docs/` folder:
- `Spi_API.md` - SPI (Solder Paste Inspection) API documentation
- `Aoi_API.md` - AOI (Automated Optical Inspection) API documentation

## Testing

No test projects are currently configured in this solution. When adding tests, create separate test projects following .NET testing conventions.

## Key Utilities

- `AppsettingsUtility` (MES.Service/util/AppsettingsUtility.cs:6) - Loads configuration into static `Settings` property
- `ResponseResult` (MES.Service/util/ResponseResult.cs:7) - Standardized API response wrapper
- `ErrorLog` - Custom error logging utility used by ActionFilter