| 对比新文件 |
| | |
|---|
| | | # CLAUDE.md |
|---|
| | | |
|---|
| | | This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. |
|---|
| | | |
|---|
| | | ## Project Overview |
|---|
| | | |
|---|
| | | This is a Manufacturing Execution System (MES) built with .NET 8.0. The solution consists of two main projects: |
|---|
| | | |
|---|
| | | - **MES.Service**: Service layer containing business logic, data access, and DTOs |
|---|
| | | - **MESApplication**: Web API application layer with controllers and HTTP endpoints |
|---|
| | | |
|---|
| | | ## Database Environment |
|---|
| | | |
|---|
| | | Oracle Database 11g Enterprise Edition Release 11.2.0.1.0 - 64bit Production |
|---|
| | | |
|---|
| | | - PL/SQL Release 11.2.0.1.0 - Production |
|---|
| | | - CORE 11.2.0.1.0 Production |
|---|
| | | - TNS for 64-bit Windows: Version 11.2.0.1.0 - Production |
|---|
| | | - NLSRTL Version 11.2.0.1.0 - Production |
|---|
| | | |
|---|
| | | **IMPORTANT**: All code must be compatible with Oracle 11g Release 11.2.0.1.0 |
|---|
| | | |
|---|
| | | ## Architecture |
|---|
| | | |
|---|
| | | ### 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 |
|---|
| | | |
|---|
| | | ### Service Layer Structure |
|---|
| | | - **BasicData**: Core business entities (customers, items, suppliers, etc.) |
|---|
| | | - **QC**: Quality control services (PCB testing, inspections) |
|---|
| | | - **Warehouse**: Inventory management and warehouse operations |
|---|
| | | - **Dto**: Data Transfer Objects split into: |
|---|
| | | - `service/`: Internal service DTOs |
|---|
| | | - `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 |
|---|
| | | - CORS enabled for cross-origin requests |
|---|
| | | - Custom ActionFilter for request/response handling |
|---|
| | | |
|---|
| | | ## Common Development Commands |
|---|
| | | |
|---|
| | | ### Build and Run |
|---|
| | | ```bash |
|---|
| | | # Build the entire solution |
|---|
| | | dotnet build |
|---|
| | | |
|---|
| | | # Build specific project |
|---|
| | | dotnet build MESApplication/MESApplication.csproj |
|---|
| | | dotnet build MES.Service/MES.Service.csproj |
|---|
| | | |
|---|
| | | # Run the web application |
|---|
| | | dotnet run --project MESApplication |
|---|
| | | |
|---|
| | | # Run in specific configuration |
|---|
| | | dotnet run --project MESApplication --configuration Release |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | ### Development |
|---|
| | | ```bash |
|---|
| | | # Restore NuGet packages |
|---|
| | | dotnet restore |
|---|
| | | |
|---|
| | | # Clean build artifacts |
|---|
| | | dotnet clean |
|---|
| | | |
|---|
| | | # Publish for deployment |
|---|
| | | dotnet publish MESApplication -c Release -o ./publish |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | ## Key Configuration |
|---|
| | | |
|---|
| | | ### Database Connection |
|---|
| | | - Oracle database connection configured in `appsettings.json` |
|---|
| | | - Connection string: `AppSettings.DataBaseConn` |
|---|
| | | - Database type switches between Oracle (SqlSugarHelper) and SqlServer (DbContext) |
|---|
| | | |
|---|
| | | ### ERP Integration |
|---|
| | | - Test URL: `AppSettings.TestErpUrl` |
|---|
| | | - Production URL: `AppSettings.ProductionErpUrl` |
|---|
| | | - Located in `MESApplication/appsettings.json` |
|---|
| | | |
|---|
| | | ## 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 |
|---|
| | | |
|---|
| | | ### 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. |
|---|
| | | |
|---|
| | | ### Error Handling |
|---|
| | | - ActionFilter handles global request/response processing |
|---|
| | | - SQL logging enabled via SqlSugar AOP for debugging |
|---|
| | | - Console output for SQL query debugging |
|---|
| | | |
|---|
| | | ## Testing |
|---|
| | | |
|---|
| | | No test projects are currently configured in this solution. When adding tests, create separate test projects following .NET testing conventions. |
|---|
