# 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) API application built with .NET 8, consisting of:
- **MESApplication**: Main Web API project with controllers and middleware
- **MES.Service**: Service layer containing business logic, data models, and database operations

The system manages manufacturing operations including quality control (QC), warehouse management, inventory tracking, PLM integration, and ERP connectivity.

## Development Commands

### Build and Run
```bash
# Build the solution
dotnet build MESApplication.sln

# Run the API (from MESApplication directory)
cd MESApplication
dotnet run

# Run with specific environment
dotnet run --environment Development
```

### Development Server
- API runs on: `http://localhost:5184`
- Swagger UI available at: `http://localhost:5184/swagger`
- IIS Express: `http://localhost:10054`

### Project Structure Commands
```bash
# Restore NuGet packages
dotnet restore

# Clean build artifacts
dotnet clean

# Build specific project
dotnet build MESApplication/MESApplication.csproj
dotnet build MES.Service/MES.Service.csproj
```

## Architecture

### Database Layer
- **ORM**: SqlSugar for Oracle database connectivity
- **Database**: Oracle (connection configured in appsettings.json)
- **Patterns**: Repository pattern with generic DbContext<T> and specific managers
- **Key Classes**:
  - `SqlSugarHelper.cs`: Database connection and transaction management
  - `DbContext<T>.cs`: Generic repository for CRUD operations
  - `Repository.cs`: Base repository implementation

### Service Layer (MES.Service)
Organized by business domains:
- **BasicData/**: Core master data (customers, suppliers, items, departments)
- **QC/**: Quality control operations (inspections, testing, suspensions)  
- **Warehouse/**: Inventory management (stock, moves, receipts, shipments)
- **PLM/**: Product lifecycle management integration
- **SpotCheck/**: Equipment maintenance and spot checking

### API Layer (MESApplication)
- **Controllers/**: REST endpoints organized by domain (matching service structure)
- **Filter/**: Action filters for logging and error handling
- **Authentication**: Not implemented (anonymous access)
- **Serialization**: Newtonsoft.Json with camelCase naming

### Key Configuration
- **Database**: Oracle connection string in `AppSettings.DataBaseConn`
- **CORS**: Enabled for all origins during development
- **Swagger**: Auto-generated API documentation with XML comments
- **Logging**: Console logging with SQL query debugging enabled

### External Integrations
- **Kingdee ERP**: Via WebService (configured URLs in AppSettings)
- **PLM System**: Document and BOM management
- **Real-time Inventory**: HTTP client for inventory queries

### Domain Models
Major entity categories:
- **Inventory**: `MesInvItem*` classes for stock management
- **Quality**: `MesQa*` classes for quality control processes
- **Manufacturing**: `Wom*` classes for work orders
- **Purchasing**: `Purd*` classes for procurement
- **Sales**: `SalesOrder*` classes for order management

### Data Transfer Objects (DTOs)
- **service/**: Internal service communication DTOs
- **webApi/**: External API integration DTOs (ERP, PLM)
- **base/**: Common DTOs (pagination, login, settings)

## Testing and Quality

### Testing Commands
```bash
# No automated tests currently configured
# Manual testing via Swagger UI at http://localhost:5184/swagger
```

### Common Development Tasks

#### Adding New API Endpoints
1. Create model class in `MES.Service/Modes/`
2. Create service manager in `MES.Service/service/[Domain]/`
3. Create controller in `MESApplication/Controllers/[Domain]/`
4. Register dependencies in `Startup.cs` if needed

#### Working with Database
- All database operations use SqlSugar ORM with Oracle
- Transaction support via `SqlSugarHelper.UseTransactionWithOracle()`
- SQL queries are logged to console during development
- Connection string configured in `appsettings.json`

#### External System Integration
- **ERP Integration**: Kingdee WebService calls configured in AppSettings
- **PLM Integration**: Document management via HTTP clients
- **Real-time Inventory**: Dedicated service for inventory queries

### Key Files to Understand
- `MES.Service/DB/SqlSugarHelper.cs`: Database connection management
- `MES.Service/DB/DbContext.cs`: Generic repository pattern
- `MES.Service/util/AppsettingsUtility.cs`: Configuration access
- `MESApplication/Startup.cs`: Application configuration and DI setup
- `MESApplication/Filter/ActionFilter.cs`: Request/response logging

### Dependencies and Packages
- **SqlSugarCore**: ORM for Oracle database operations
- **Newtonsoft.Json**: JSON serialization with camelCase naming
- **Swashbuckle.AspNetCore**: API documentation generation
- **Oracle.EntityFrameworkCore**: Oracle database connectivity
- **Kingdee.CDP.WebApi.SDK**: ERP system integration (local DLL)

### Configuration Management
- Environment-specific settings in `appsettings.json` and `appsettings.Development.json`
- Database connection in `AppSettings.DataBaseConn`
- ERP URLs in `AppSettings.TestErpUrl` and `AppSettings.ProductionErpUrl`
- CORS enabled for all origins in development mode