重构代码质量和安全性改进

啊鑫

2 天以前 36fdf1c876e5b9daa4446b9c33e9c532d725798b

重构代码质量和安全性改进

主要改进:
- 修复MessageCenterManager中SQL注入风险，使用SqlSugar安全查询
- 重构LljService.autoResult方法，拆分为多个职责单一的方法
- 改进数据模型注释和字段定义
- 添加输入验证和类型安全转换
- 统一代码注释格式和命名规范
- 新增代码审查报告和项目配置文档

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

 CLAUDE.md

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,105 @@
# 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 built with ASP.NET Core 8.0 and Oracle database. The solution consists of two main projects:

- **MESApplication**: Web API project with controllers and startup configuration
- **MES.Service**: Service layer with business logic, data models, and database operations

## 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

The project follows a layered architecture:

- **Controllers**: Located in `MESApplication/Controllers/` organized by domain (BasicData, QC, Warehouse)
- **Services**: Business logic in `MES.Service/service/` with managers for each domain
- **Models**: Data models in `MES.Service/Modes/` representing database entities
- **DTOs**: Data transfer objects in `MES.Service/Dto/` for API communication
- **Database**: Oracle database access via SqlSugar ORM in `MES.Service/DB/`

## Key Technologies

- ASP.NET Core 8.0 Web API
- Oracle Database with SqlSugar ORM
- Swagger for API documentation
- Newtonsoft.Json for JSON serialization
- CORS enabled for cross-origin requests

## Development Commands

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

# Run the application in development mode
dotnet run --project MESApplication

# Run with specific profile
dotnet run --project MESApplication --launch-profile http
```

### Development Server
- Default URL: `http://localhost:5184`
- Swagger UI: `http://localhost:5184/swagger`
- IIS Express: `http://localhost:10054`

### Database Operations
- Uses SqlSugar ORM with Oracle database
- Connection string configured in `appsettings.json`
- Database context in `MES.Service/DB/SqlSugarHelper.cs`
- SQL logging enabled in development for debugging

## Project Structure

### Domain Organization
The API is organized into several business domains:

- **BasicData**: Core master data (customers, items, suppliers, etc.)
- **QC**: Quality control processes (inspection, testing, suspension)
- **Warehouse**: Inventory management (stock, movements, receipts)
- **MessageCenter**: System notifications and messaging

### Key Patterns
- Repository pattern implemented in `MES.Service/DB/Repository.cs`
- Service layer with manager classes for each entity
- DTO pattern for API request/response objects
- Action filters for cross-cutting concerns in `MESApplication/Filter/`

## Configuration

### Database Configuration
- Oracle database connection in `appsettings.json` under `AppSettings.DataBaseConn`
- ERP integration URLs configured in `AppSettings` section

### API Configuration
- Swagger documentation enabled in development
- CORS configured to allow all origins
- JSON serialization uses camelCase naming
- XML documentation generation enabled

## Testing

Use the `MESApplication.http` file for API testing with HTTP requests.

## Development Notes

- The application uses Chinese comments and naming conventions
- Database entities follow Oracle naming conventions
- API responses follow camelCase JSON format
- All controllers inherit from base controller classes
- Transaction support available through `SqlSugarHelper.UseTransactionWithOracle()`

 CodeReviewReport.md

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,309 @@
# C# ä»£ç è´¨é‡å®¡æŸ¥æŠ¥å‘Š

## æ¦‚è¿°
本报告分析了您的MES API项目中已修改的C#文件，识别出代码质量问题并提供改进建议。

## ä¸»è¦é—®é¢˜æ€»ç»“

### ðŸ”´ ä¸¥é‡é—®é¢˜
1. **命名规范不一致** - æ··åˆä½¿ç”¨PascalCase和camelCase
2. **SQL注入风险** - å­—符串拼接构建SQL语句
3. **事务管理混乱** - ä¸ä¸€è‡´çš„事务处理模式
4. **异常处理不当** - æ•èŽ·åŽé‡æ–°æŠ›å‡ºé€šç”¨å¼‚常

### ðŸŸ¡ ä¸­ç­‰é—®é¢˜
1. **数据类型使用不当** - è¿‡åº¦ä½¿ç”¨string类型
2. **缺少输入验证** - æ–¹æ³•å‚数未验证
3. **魔法数字和字符串** - ç¡¬ç¼–码值缺少常量定义
4. **方法职责过多** - å•ä¸ªæ–¹æ³•åŒ…含多种逻辑

## è¯¦ç»†é—®é¢˜åˆ†æž

### 1. XJPageResult.cs - DTO类设计问题

**文件位置**: `MES.Service/Dto/service/XJPageResult.cs`

#### é—®é¢˜:
```csharp
public string? createUser { get; set; }    // âŒ camelCase
public string? SearchValue { get; set; }   // âœ… PascalCase
public string? startDate { get; set; }     // âŒ camelCase
```

#### å»ºè®®æ”¹è¿›:
```csharp
public string? CreateUser { get; set; }
public string? SearchValue { get; set; }
public DateTime? StartDate { get; set; }   // ä½¿ç”¨æ­£ç¡®çš„数据类型
public DateTime? EndDate { get; set; }
public bool? ArrivalFilter { get; set; }   // ä½¿ç”¨bool而不是int
```

**原因**: 
- C#属性应使用PascalCase命名规范
- æ—¥æœŸå­—段应使用DateTime而不是string
- å¸ƒå°”值应使用bool类型

### 2. MessageCenter.cs - æ•°æ®æ¨¡åž‹é—®é¢˜

**文件位置**: `MES.Service/Modes/MessageCenter.cs`

#### é—®é¢˜:
```csharp
[SugarColumn(ColumnName = "CREATE_DATE")]
public string? CreateDate { get; set; }    // âŒ æ—¥æœŸåº”为DateTime

[SugarColumn(ColumnName = "Content_Type")]  // âŒ æ•°æ®åº“列名不规范
public string? ContentType { get; set; }

[SugarColumn(IsIgnore = true)] 
public int? isShow { get; set; }           // âŒ camelCase命名
```

#### å»ºè®®æ”¹è¿›:
```csharp
[SugarColumn(ColumnName = "CREATE_DATE")]
public DateTime? CreateDate { get; set; }

[SugarColumn(ColumnName = "CONTENT_TYPE")]  // ç»Ÿä¸€å¤§å†™ä¸‹åˆ’线格式
public string? ContentType { get; set; }

[SugarColumn(IsIgnore = true)] 
public bool? IsShow { get; set; }          // æ­£ç¡®å‘½åå’Œç±»åž‹
```

### 3. MessageCenterManager.cs - æœåŠ¡å±‚问题

**文件位置**: `MES.Service/service/MessageCenterManager.cs`

#### ä¸¥é‡é—®é¢˜ - SQL注入风险:
```csharp
var sql = string.Format(
    "SELECT * FROM (SELECT \"ID\",\"TABLE_NAME\"... WHERE RowIndex BETWEEN {0} AND {1} ",
    startRow, endRow);  // âŒ å­˜åœ¨SQL注入风险
```

#### å»ºè®®æ”¹è¿›:
```csharp
public (List<MessageCenter> item, int TotalCount) GetPushFailedPage(MessageCenter query)
{
    var totalCount = IsShow(query);
    
    return Context.Queryable<MessageCenter>()
        .Where(it => it.Result == 0 && it.Seq == 1 && it.Title != null)
        .OrderByDescending(it => it.CreateDate)
        .ToPageList(query.PageIndex, query.Limit, ref totalCount);
}
```

#### å…¶ä»–问题:
```csharp
// âŒ ç¡¬ç¼–码的魔法数字
entity.Result = 0;
entity.DealWith = 0;
entity.Status = 1;

// âŒ å­—符串格式化日期
entity.CreateDate = DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss");
```

#### å»ºè®®æ”¹è¿›:
```csharp
// âœ… ä½¿ç”¨å¸¸é‡
public static class MessageStatus 
{
    public const short Failed = 0;
    public const short Success = 1;
    public const short Pending = 0;
    public const short Processed = 1;
}

// âœ… ä½¿ç”¨DateTime类型
entity.CreateDate = DateTime.Now;
```

### 4. LljService.cs - ä¸šåŠ¡é€»è¾‘问题

**文件位置**: `MES.Service/service/QC/LljService.cs`

#### ä¸¥é‡é—®é¢˜:
```csharp
public (List<LtsLlj> item, int TotalCount) GetPage(XJPageResult queryObj)
{
    if (queryObj.createUser.IsNullOrEmpty()) return ([], 0);  // âŒ æ— è¾“入验证
    
    var id = Convert.ToDecimal(queryObj.id);  // âŒ å¯èƒ½æŠ›å‡ºå¼‚常
}
```

#### å»ºè®®æ”¹è¿›:
```csharp
public (List<LtsLlj> item, int TotalCount) GetPage(XJPageResult queryObj)
{
    // âœ… è¾“入验证
    if (queryObj == null)
        throw new ArgumentNullException(nameof(queryObj));
        
    if (string.IsNullOrEmpty(queryObj.CreateUser))
        return (new List<LtsLlj>(), 0);
    
    // âœ… å®‰å…¨çš„类型转换
    if (!decimal.TryParse(queryObj.Id, out var id))
        id = 0;
}
```

#### å¤æ‚方法问题:
```csharp
// âŒ autoResult方法过于复杂(100+行)，包含多种职责
private int autoResult(MesQaItemsDetectDetail12 detail)
{
    // æŸ¥è¯¢æ£€éªŒé¡¹ç›®
    // è®¡ç®—检验结果  
    // æ›´æ–°æ£€éªŒçŠ¶æ€
    // æ›´æ–°æ£€éªŒå•çŠ¶æ€
    // ä¸šåŠ¡é€»è¾‘判断
    // æ•°æ®åº“æ›´æ–°
}
```

#### å»ºè®®æ”¹è¿›:
```csharp
// âœ… æ‹†åˆ†ä¸ºå¤šä¸ªèŒè´£å•ä¸€çš„方法
public int ProcessInspectionResult(MesQaItemsDetectDetail12 detail)
{
    var inspectionItem = GetInspectionItem(detail.MainId);
    var inspectionCounts = CalculateInspectionCounts(detail.MainId);
    var result = DetermineInspectionResult(inspectionCounts, inspectionItem);
    
    UpdateInspectionDetail(detail, result, inspectionCounts);
    
    if (IsInspectionComplete(detail.ReleaseNo))
    {
        UpdateInspectionOrder(detail);
    }
    
    return 1;
}
```

### 5. MessageCenterController.cs - æŽ§åˆ¶å™¨é—®é¢˜

**文件位置**: `MESApplication/Controllers/Base/MessageCenterController.cs`

#### é—®é¢˜:
```csharp
// âŒ é‡å¤çš„异常处理模式
[HttpPost("ResetUpdate")]
public ResponseResult ResetUpdate([FromBody] MessageCenter data)
{
    try
    {
        dynamic resultInfos = new ExpandoObject();  // âŒ ä½¿ç”¨dynamic
        resultInfos.tbBillList = m.ResetUpdate(data);
        return new ResponseResult { status = 0, message = "OK", data = resultInfos };
    }
    catch (Exception ex)
    {
        return ResponseResult.ResponseError(ex);  // âŒ é‡å¤ä»£ç 
    }
}
```

#### å»ºè®®æ”¹è¿›:
```csharp
// âœ… ä½¿ç”¨å¼ºç±»åž‹å“åº”和基类方法
[HttpPost("ResetUpdate")]
public ResponseResult ResetUpdate([FromBody] MessageCenter data)
{
    return ExecuteWithErrorHandling(() => 
    {
        var result = m.ResetUpdate(data);
        return CreateSuccessResponse(result);
    });
}

// âœ… åŸºç±»æ–¹æ³•å‡å°‘重复代码
protected ResponseResult ExecuteWithErrorHandling<T>(Func<T> action)
{
    try
    {
        var result = action();
        return CreateSuccessResponse(result);
    }
    catch (Exception ex)
    {
        return ResponseResult.ResponseError(ex);
    }
}
```

## æ”¹è¿›å»ºè®®ä¼˜å…ˆçº§

### ðŸ”¥ ç«‹å³ä¿®å¤ (高优先级)
1. **修复SQL注入风险** - MessageCenterManager.cs:20-22
2. **统一命名规范** - æ‰€æœ‰å±žæ€§ä½¿ç”¨PascalCase
3. **安全的类型转换** - æ·»åŠ TryParse验证

### âš¡ å°½å¿«ä¿®å¤ (中优先级)  
1. **正确的数据类型** - æ—¥æœŸä½¿ç”¨DateTime，布尔值使用bool
2. **输入验证** - æ‰€æœ‰å…¬å…±æ–¹æ³•æ·»åŠ å‚数验证
3. **常量定义** - æ›¿æ¢é­”法数字和字符串

### ðŸ’¡ é€æ­¥æ”¹è¿› (低优先级)
1. **方法重构** - æ‹†åˆ†å¤æ‚方法
2. **统一异常处理** - ä½¿ç”¨åŸºç±»æ–¹æ³•å‡å°‘重复
3. **强类型化** - é¿å…ä½¿ç”¨dynamic和ExpandoObject

## ä»£ç è§„范建议

### å‘½åè§„范
```csharp
// âœ… æ­£ç¡®çš„命名
public class MessageCenter           // PascalCase for classes
{
    public string TableName { get; set; }     // PascalCase for properties
    public DateTime CreateDate { get; set; }   // PascalCase for properties
    
    private readonly string _connectionString; // camelCase with underscore for private fields
    
    public void ProcessMessage() { }           // PascalCase for methods
}
```

### ç±»åž‹å®‰å…¨
```csharp
// âœ… ä½¿ç”¨æ­£ç¡®çš„数据类型
public class InspectionDto
{
    public DateTime? StartDate { get; set; }   // è€Œä¸æ˜¯ string
    public bool IsCompleted { get; set; }      // è€Œä¸æ˜¯ int
    public decimal Quantity { get; set; }      // è€Œä¸æ˜¯ string
}
```

### å¼‚常处理
```csharp
// âœ… å…·ä½“的异常处理
public decimal ParseId(string idString)
{
    if (string.IsNullOrEmpty(idString))
        throw new ArgumentException("ID cannot be null or empty", nameof(idString));
        
    if (!decimal.TryParse(idString, out var id))
        throw new FormatException($"Invalid ID format: {idString}");
        
    return id;
}
```

## æ€»ç»“

您的代码整体结构良好，但在以下几个方面需要改进：

1. **命名规范一致性** - ä¸¥æ ¼éµå¾ªC#命名约定
2. **类型安全** - ä½¿ç”¨é€‚当的数据类型
3. **安全性** - é¿å…SQL注入和输入验证
4. **可维护性** - å‡å°‘代码重复，拆分复杂方法

建议按照优先级逐步改进，从安全问题开始，然后是命名规范，最后是代码结构优化。

 MES.Service/Dto/service/XJPageResult.cs

@@ -9,5 +9,35 @@

    public string? id { get; set; }

    /// <summary>
    ///     æœç´¢æ¡ä»¶ï¼Œå®žé™…用户输入的内容
    /// </summary>
    public string? SearchValue { get; set; }

    /// <summary>
    ///     ä¸‹æ‹‰æ¡†æœç´¢æ¡ä»¶
    /// </summary>
    public string? SelectedIndex { get; set; }

    /// <summary>
    ///     æœå…¨éƒ¨ï¼Œæˆ–者当前用户（默认0，当前用户，1：全部）
    /// </summary>
    public string? UserIndex { get; set; }

    /// <summary>
    ///     å¼€å§‹æ—¶é—´
    /// </summary>
    public string? startDate { get; set; }

    /// <summary>
    ///     ç»“束时间
    /// </summary>
    public string? endDate { get; set; }

    /// <summary>
    ///     çŠ¶æ€ï¼ˆåˆæ ¼ or ä¸åˆæ ¼ï¼‰
    /// </summary>
    public string? state { get; set; }
    
    public int? arrivalFilter { get; set; }
}

 MES.Service/Modes/MesQaIqc.cs

@@ -3,17 +3,11 @@
namespace MES.Service.Modes;

/// <summary>
///     æ•°æ®æºå¯¼å…¥
///     IQC检验项目视图
/// </summary>
[SugarTable("Mes_Qa_Iqc")]
[SugarTable("MES_QA_IQC")]
public class MesQaIqc
{
    /// <summary>
    ///     æŽ¥æ”¶æ°´å¹³
    /// </summary>
    [SugarColumn(ColumnName = "ITEM_NO")]
    public string? ItemNo { get; set; }

    /// <summary>
    ///     æŽ¥æ”¶æ°´å¹³
    /// </summary>
@@ -48,7 +42,7 @@
    ///     æ ‡å‡†
    /// </summary>
    [SugarColumn(ColumnName = "FSTAND")]
    public decimal? Fstand { get; set; }
    public string? Fstand { get; set; }

    /// <summary>
    ///     ä¸Šé™
@@ -69,17 +63,32 @@
    public string? FspecRequ { get; set; }

    /// <summary>
    ///     æ˜¯å¦å¯ç”¨
    /// </summary>
    [SugarColumn(ColumnName = "ISENABLED")]
    public short? Isenabled { get; set; }

    /// <summary>
    ///     AQL是否可用
    /// </summary>
    [SugarColumn(ColumnName = "EE")]
    public short? Ee { get; set; }

    /// <summary>
    ///     åˆ†ç±»
    /// </summary>
    [SugarColumn(ColumnName = "FTYPE")]
    public string? Ftype { get; set; }

    /// <summary>
    ///     ç‰©æ–™ç¼–码
    /// </summary>
    [SugarColumn(ColumnName = "ITEM_NO")]
    public string? ItemNo { get; set; }

    /// <summary>
    ///     ç‰©æ–™ID
    /// </summary>
    [SugarColumn(ColumnName = "ITEM_ID")]
    public string? ItemId { get; set; }
}

 MES.Service/Modes/MesQaItemsDetectDetail5.cs

@@ -9,7 +9,8 @@
public class MesQaItemsDetectDetail5
{
    /// <summary>
    /// </summary>
    ///  
    ///</summary>
    [SugarColumn(ColumnName = "ID", IsPrimaryKey = true)]
    public decimal Id { get; set; }


 MES.Service/Modes/MessageCenter.cs

@@ -1,11 +1,12 @@
using SqlSugar;
using MES.Service.Dto.@base;
using SqlSugar;

namespace MES.Service.Modes;

/// <summary>
/// </summary>
[SugarTable("MESSAGE_CENTER")]
public class MessageCenter
public class MessageCenter : Page
{
    /// <summary>
    ///     å¯¹åº”序列SEQ_MSG
@@ -15,120 +16,124 @@
    public decimal? Id { get; set; }

    /// <summary>
    ///     è¡¨å/视图名
    /// </summary>
    /// è¡¨å/视图名 
    ///</summary>
    [SugarColumn(ColumnName = "TABLE_NAME")]
    public string? TableName { get; set; }

    /// <summary>
    ///     è¯·æ±‚地址
    /// </summary>
    /// è¯·æ±‚地址 
    ///</summary>
    [SugarColumn(ColumnName = "URL")]
    public string? Url { get; set; }

    /// <summary>
    ///     è¯·æ±‚方式
    /// </summary>
    /// è¯·æ±‚方式 
    ///</summary>
    [SugarColumn(ColumnName = "METHOD")]
    public string? Method { get; set; }

    /// <summary>
    ///     è¯·æ±‚内容
    /// </summary>
    [SugarColumn(ColumnName = "DATA")]
    public string? Data { get; set; }

    /// <summary>
    ///     æ˜¯å¦æˆåŠŸ  0表示失败  1 è¡¨ç¤ºæˆåŠŸ
    /// </summary>
    /// æ˜¯å¦æˆåŠŸ  0表示失败  1 è¡¨ç¤ºæˆåŠŸ 
    ///</summary>
    [SugarColumn(ColumnName = "RESULT")]
    public short? Result { get; set; }

    /// <summary>
    ///     è¿”回的JSON
    /// </summary>
    /// è¿”回的JSON 
    ///</summary>
    [SugarColumn(ColumnName = "RESULT_DATA")]
    public string? ResultData { get; set; }

    /// <summary>
    ///     çŠ¶æ€  0表示未推送  1 è¡¨ç¤ºå·²æŽ¨é€
    /// </summary>
    /// çŠ¶æ€  0表示未推送  1 è¡¨ç¤ºå·²æŽ¨é€ 
    ///</summary>
    [SugarColumn(ColumnName = "STATUS")]
    public short? Status { get; set; }

    /// <summary>
    ///     åˆ›å»ºäºº
    /// </summary>
    /// åˆ›å»ºäºº 
    ///</summary>
    [SugarColumn(ColumnName = "CREATE_BY")]
    public string? CreateBy { get; set; }

    /// <summary>
    ///     åˆ›å»ºæ—¶é—´
    /// </summary>
    /// åˆ›å»ºæ—¶é—´ 
    ///</summary>
    [SugarColumn(ColumnName = "CREATE_DATE")]
    public string? CreateDate { get; set; }

    /// <summary>
    ///     ä¸šåŠ¡æ ‡é¢˜
    /// </summary>
    /// ä¸šåŠ¡æ ‡é¢˜ 
    ///</summary>
    [SugarColumn(ColumnName = "TITLE")]
    public string? Title { get; set; }

    /// <summary>
    ///     é¡µé¢åç§°
    /// </summary>
    /// é¡µé¢åç§° 
    ///</summary>
    [SugarColumn(ColumnName = "PAGE_NAME")]
    public string? PageName { get; set; }

    /// <summary>
    ///     æ˜¯å¦å¤„理，0表示未处理 1表示已处理
    /// </summary>
    /// æ˜¯å¦å¤„理，0表示未处理 1表示已处理 
    ///</summary>
    [SugarColumn(ColumnName = "DEAL_WITH")]
    public short? DealWith { get; set; }

    /// <summary>
    ///     æ‰¹æ¬¡
    /// </summary>
    /// æ‰¹æ¬¡id 
    ///</summary>
    [SugarColumn(ColumnName = "PID")]
    public int? Pid { get; set; }

    public decimal? Pid { get; set; }

    /// <summary>
    ///     æ‰§è¡Œé¡ºåº
    /// </summary>
    /// æ‰§è¡Œé¡ºåº 
    ///</summary>
    [SugarColumn(ColumnName = "SEQ")]
    public short? Seq { get; set; }

    /// <summary>
    ///     é¡µé¢è·¯å¾„
    /// </summary>
    /// é¡µé¢è·¯å¾„ 
    ///</summary>
    [SugarColumn(ColumnName = "ROUTE")]
    public string? Route { get; set; }

    /// <summary>
    ///     å‚数类型
    /// </summary>
    [SugarColumn(ColumnName = "Content_Type")]
    ///  å®žé™…请求的数据
    ///</summary>
    [SugarColumn(ColumnName = "DATA")]
    public string? Data { get; set; }

    /// <summary>
    /// å‚数类型 
    ///</summary>
    [SugarColumn(ColumnName = "CONTENT_TYPE")]
    public string? ContentType { get; set; }

    //
    /// <summary>
    ///     æ˜¯å¦æ˜¯æ¶ˆæ¯  0为推送失败 1为消息,默认为0
    /// </summary>
    [SugarColumn(ColumnName = "is_message")]
    /// æ˜¯å¦æ˜¯æ¶ˆæ¯  0为推送失败 1为消息 
    ///</summary>
    [SugarColumn(ColumnName = "IS_MESSAGE")]
    public short? IsMessage { get; set; }

    /// <summary>
    ///     æœ€åŽä¸€æ¬¡ä¿®æ”¹äºº
    /// </summary>
    /// ä¿®æ”¹æ—¶é—´ 
    ///</summary>
    [SugarColumn(ColumnName = "UPDATE_DATE")]
    public string? UpdateDate { get; set; }

    /// <summary>
    /// ä¿®æ”¹äºº 
    ///</summary>
    [SugarColumn(ColumnName = "UPDATE_BY")]
    public string? UpdateBy { get; set; }

    /// <summary>
    ///     æœ€åŽä¸€æ¬¡ä¿®æ”¹æ—¶é—´
    /// </summary>
    [SugarColumn(ColumnName = "UPDATE_DATE")]
    public string? UpdateDate { get; set; }
    /// æœªè½¬ç json 
    ///</summary>
    [SugarColumn(ColumnName = "DATA_INSERTED")]
    public string? DataInserted { get; set; }


    [SugarColumn(IsIgnore = true)] public int? isShow { get; set; }

 MES.Service/service/MessageCenterManager.cs

@@ -8,17 +8,45 @@
{
    //当前类已经继承了 Repository å¢žã€åˆ ã€æŸ¥ã€æ”¹çš„方法

    public List<MessageCenter> GetPushFailedPage(MessageCenter query)
    public (List<MessageCenter> item, int TotalCount) GetPushFailedPage(
        MessageCenter query)
    {
        var totalCount = IsShow(query);

        // ä½¿ç”¨SqlSugar的安全查询方法，避免SQL注入风险
        var messageCenters = Db.Queryable<MessageCenter>()
            .Where(it => it.Result == 0 && it.Seq == 1 && it.Title != null)
            .OrderByDescending(it => it.CreateDate)
            .ToPageList(query.PageIndex, query.Limit, ref totalCount);

        return (messageCenters, totalCount);
    }

    //查看是否有未处理的消息
    public int IsShow(MessageCenter query)
    {
        return Context.Queryable<MessageCenter>()
            .Where(it =>
                it.Result == 0 && it.Status == 1 &&
                it.Seq == 1 && it.Title != null)
            .WhereIF(query.isShow == 1, it => it.DealWith == 0)
            .OrderByDescending(it => it.CreateDate)
            .ToPageList(1, 20);
            .Count();
    }


    //将消息设置为已读的
    public int UpdateRead(MessageCenter query)
    {
        return Db.Updateable<MessageCenter>()
            .SetColumns(s => s.DealWith == 1)
            .SetColumns(s => s.UpdateBy == query.UpdateBy)
            .SetColumns(s =>
                s.UpdateDate == DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss"))
            .Where(s => s.Id == query.Id)
            .ExecuteCommand();
    }


    public int save(MessageCenter entity)
    {
        entity.CreateDate = DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss");

 MES.Service/service/QC/LljService.cs

@@ -14,11 +14,19 @@
{
    public (List<LtsLlj> item, int TotalCount) GetPage(XJPageResult queryObj)
    {
        if (queryObj == null)
            throw new ArgumentNullException(nameof(queryObj));

        if (string.IsNullOrEmpty(queryObj.createUser))
            return (new List<LtsLlj>(), 0);

        if (queryObj.createUser.IsNullOrEmpty()) return ([], 0);

        var db = SqlSugarHelper.GetInstance();

        var id = Convert.ToDecimal(queryObj.id);
        //安全的类型转换
        if (!decimal.TryParse(queryObj.id, out var id))
            id = 0;

        var totalCount = 0;

@@ -37,13 +45,26 @@

            //加筛选条件,根据供应商，物料编码，物料名称搜索
            //.WhereIF(queryObj.SearchValue!=null && queryObj.SearchValue!="", (a) => a.SuppName == queryObj.SearchValue|| a.ItemName == queryObj.SearchValue || a.ItemNo == queryObj.SearchValue )
            .WhereIF(!string.IsNullOrEmpty(queryObj.SearchValue),
                a => a.SuppName.ToLower()
                         .Contains(queryObj.SearchValue.ToLower())
                     || a.ItemName.ToLower()
                         .Contains(queryObj.SearchValue.ToLower())
                     || a.ItemNo.ToLower()
                         .Contains(queryObj.SearchValue.ToLower()))
            .WhereIF(
                queryObj.SelectedIndex == "0" &&
                !string.IsNullOrEmpty(queryObj.SearchValue),
                a => (a.ItemNo.ToLower()
                    .Contains(queryObj.SearchValue.ToLower())))
            .WhereIF(
                queryObj.SelectedIndex == "1" &&
                !string.IsNullOrEmpty(queryObj.SearchValue),
                a => (a.ItemName.ToLower()
                    .Contains(queryObj.SearchValue.ToLower())))
            .WhereIF(
                queryObj.SelectedIndex == "2" &&
                !string.IsNullOrEmpty(queryObj.SearchValue),
                a => (a.SuppName.ToLower()
                    .Contains(queryObj.SearchValue.ToLower())))
            .WhereIF(queryObj.result == "已完成",
                a => (a.IqcDate >= queryObj.startDate.ToDateTime() &&
                      a.IqcDate <= queryObj.endDate.ToDateTime().AddDays(1)))
            .WhereIF(queryObj.result == "已完成" && queryObj.state != "所有状态",
                a => a.FcheckResu == queryObj.state)
            .OrderByDescending(a => a.Id)
            .ToPageList(queryObj.PageIndex, queryObj.Limit, ref totalCount);

@@ -74,7 +95,7 @@
    //                 FcheckItem = b.FcheckItem,
    //                 FdownAllow = b.FdownAllow,
    //                 FcheckLevel = b.Frequency,
    //                 Fstand = b.Fstand,
    //                 Fstand = decimal.Parse(b.Fstand),
    //                 FupAllow = b.FupAllow,
    //                 SampleSizeNo = b.SampleSizeNo,
    //                 FenterQty = 0,
@@ -248,9 +269,10 @@
    {
        var db = SqlSugarHelper.GetInstance();

        return db.Queryable<MesQaItemsDetectDetail5, MesQaItemsDetectDetail12>(
                (a, b) =>
                    new JoinQueryInfos(JoinType.Left, a.Id == b.MainId))
        return db
            .Queryable<MesQaItemsDetectDetail5,
                MesQaItemsDetectDetail12>((a, b) =>
                new JoinQueryInfos(JoinType.Left, a.Id == b.MainId))
            .Where((a, b) => a.ReleaseNo == releaseNo)
            // .WhereIF(id > 0, (a, b) => a.Id == id)
            .GroupBy((a, b) => new
@@ -325,96 +347,193 @@
    }


    /// <summary>
    /// è‡ªåŠ¨å¤„理检验结果的主方法
    /// </summary>
    private int autoResult(MesQaItemsDetectDetail12 detail)
    {
        var db = SqlSugarHelper.GetInstance();
        // èŽ·å–检验项目信息
        var inspectionItem = GetInspectionItem(detail.MainId);
        if (inspectionItem == null) return 0;

        // Single æ²¡æœ‰æŸ¥è¯¢åˆ°ç»“果时返回Null，如果结果大于1条会抛出错误
        var QsItemOqcItem = db.Queryable<MesQaItemsDetectDetail5>()
            .Single(s => s.Id == detail.MainId);

        if (QsItemOqcItem == null) return 0;

        //查询这个检验项目下的检验结果
        var count = db.Queryable<MesQaItemsDetectDetail12>()
            .Where(s => s.MainId == detail.MainId).Count();

        // èŽ·å–检验计数信息
        var inspectionCounts = GetInspectionCounts(detail.MainId);
        
        // æ›´æ–°æ£€éªŒæ˜Žç»†
        updateDetail5(detail);
        var result = "";

        //检验实际结果不等于应该检验的个数时直接推出
        if (QsItemOqcItem.CheckQyt != count) return 0;
        // æ£€æŸ¥æ˜¯å¦æ£€éªŒå®Œæˆ
        if (!IsInspectionItemComplete(inspectionItem, inspectionCounts.TotalCount))
            return 0;

        //合格的有多少个
        // ç¡®å®šæ£€éªŒç»“æžœ
        var itemResult = DetermineInspectionItemResult(inspectionCounts, inspectionItem);
        
        // æ›´æ–°æ£€éªŒé¡¹ç›®ç»“æžœ
        var updateResult = UpdateInspectionItemResult(detail.MainId, itemResult, inspectionCounts.TotalCount);

        // æ£€æŸ¥æ•´ä¸ªæ£€éªŒå•æ˜¯å¦å®Œæˆ
        if (IsInspectionOrderComplete(detail.ReleaseNo))
        {
            ProcessCompleteInspectionOrder(detail);
        }

        return updateResult;
    }

    /// <summary>
    /// èŽ·å–检验项目信息
    /// </summary>
    private MesQaItemsDetectDetail5? GetInspectionItem(decimal? mainId)
    {
        var db = SqlSugarHelper.GetInstance();
        return db.Queryable<MesQaItemsDetectDetail5>()
            .Single(s => s.Id == mainId);
    }

    /// <summary>
    /// èŽ·å–检验计数信息
    /// </summary>
    private (int TotalCount, int PassCount, int FailCount) GetInspectionCounts(decimal? mainId)
    {
        var db = SqlSugarHelper.GetInstance();
        
        var totalCount = db.Queryable<MesQaItemsDetectDetail12>()
            .Where(s => s.MainId == mainId).Count();
            
        var passCount = db.Queryable<MesQaItemsDetectDetail12>()
            .Where(s => s.MainId == detail.MainId && s.Fstand == "√").Count();
        //不合格的有多少个
        var noCount = db.Queryable<MesQaItemsDetectDetail12>()
            .Where(s => s.MainId == detail.MainId && s.Fstand == "×").Count();
            .Where(s => s.MainId == mainId && s.Fstand == "√").Count();
            
        var failCount = db.Queryable<MesQaItemsDetectDetail12>()
            .Where(s => s.MainId == mainId && s.Fstand == "×").Count();

        if (count == passCount)
            result = "合格";
        //else if (count - passCount < QsItemOqcItem.FreQty) 
        //    result = "不合格";
        else if (noCount >= QsItemOqcItem.FreQty)
            result = "不合格";
        var useTransactionWithOracle = SqlSugarHelper.UseTransactionWithOracle(
            db =>
            {
                var commit = 0;
                commit += db.Updateable<MesQaItemsDetectDetail5>()
                    .SetColumns(s => s.FcheckResu == result)
                    .SetColumns(s => s.FenterQty == count)
                    .Where(s => s.Id == detail.MainId)
                    .ExecuteCommand();
        return (totalCount, passCount, failCount);
    }

                return commit;
            });
    /// <summary>
    /// æ£€æŸ¥æ£€éªŒé¡¹ç›®æ˜¯å¦å®Œæˆ
    /// </summary>
    private bool IsInspectionItemComplete(MesQaItemsDetectDetail5 inspectionItem, int actualCount)
    {
        return inspectionItem.CheckQyt == actualCount;
    }

        var isNull = db.Queryable<MesQaItemsDetectDetail5>()
            .Where(s => s.ReleaseNo == detail.ReleaseNo && s.FcheckResu == null)
    /// <summary>
    /// ç¡®å®šæ£€éªŒé¡¹ç›®ç»“æžœ
    /// </summary>
    private string DetermineInspectionItemResult((int TotalCount, int PassCount, int FailCount) counts, 
        MesQaItemsDetectDetail5 inspectionItem)
    {
        if (counts.TotalCount == counts.PassCount)
            return "合格";
        else if (counts.FailCount >= inspectionItem.FreQty)
            return "不合格";
        else
            return string.Empty; // æœªå®ŒæˆçŠ¶æ€
    }

    /// <summary>
    /// æ›´æ–°æ£€éªŒé¡¹ç›®ç»“æžœ
    /// </summary>
    private int UpdateInspectionItemResult(decimal? mainId, string result, int count)
    {
        return SqlSugarHelper.UseTransactionWithOracle(db =>
        {
            return db.Updateable<MesQaItemsDetectDetail5>()
                .SetColumns(s => s.FcheckResu == result)
                .SetColumns(s => s.FenterQty == count)
                .Where(s => s.Id == mainId)
                .ExecuteCommand();
        });
    }

    /// <summary>
    /// æ£€æŸ¥æ•´ä¸ªæ£€éªŒå•æ˜¯å¦å®Œæˆ
    /// </summary>
    private bool IsInspectionOrderComplete(string? releaseNo)
    {
        var db = SqlSugarHelper.GetInstance();
        
        // æ£€æŸ¥æ˜¯å¦è¿˜æœ‰æœªå®Œæˆçš„检验项目
        var incompleteCount = db.Queryable<MesQaItemsDetectDetail5>()
            .Where(s => s.ReleaseNo == releaseNo && s.FcheckResu == null)
            .Count();

        if (isNull > 0) return 1;
        return incompleteCount == 0;
    }

    /// <summary>
    /// å¤„理完成的检验单
    /// </summary>
    private void ProcessCompleteInspectionOrder(MesQaItemsDetectDetail12 detail)
    {
        var db = SqlSugarHelper.GetInstance();
        
        // èŽ·å–检验单下的所有检验项目
        var inspectionCounts = GetInspectionOrderCounts(detail.ReleaseNo);
        
        // ç¡®å®šæ•´ä¸ªæ£€éªŒå•çš„结果
        var orderResult = DetermineInspectionOrderResult(inspectionCounts);
        
        // èŽ·å–用户信息
        var sysUser = GetUserInfo(detail.CreateBy);
        
        // æ›´æ–°æ£€éªŒå•ç»“æžœ
        UpdateInspectionOrderResult(detail.ReleaseNo, orderResult, sysUser?.Fname, detail.CreateBy);
    }

        //获取检验单的检验项目的个数
        var sum = db.Queryable<MesQaItemsDetectDetail5>()
            .Where(s => s.ReleaseNo == detail.ReleaseNo).Count();

        if (sum == 0) return 1;

        //获取检验单下的合格的检验项目个数
        var icount = db.Queryable<MesQaItemsDetectDetail5>()
            .Where(s => s.ReleaseNo == detail.ReleaseNo && s.FcheckResu == "合格")
    /// <summary>
    /// èŽ·å–检验单统计信息
    /// </summary>
    private (int TotalItems, int PassedItems) GetInspectionOrderCounts(string? releaseNo)
    {
        var db = SqlSugarHelper.GetInstance();
        
        var totalItems = db.Queryable<MesQaItemsDetectDetail5>()
            .Where(s => s.ReleaseNo == releaseNo).Count();
            
        var passedItems = db.Queryable<MesQaItemsDetectDetail5>()
            .Where(s => s.ReleaseNo == releaseNo && s.FcheckResu == "合格")
            .Count();

        var FcheckResu = "不合格";
        return (totalItems, passedItems);
    }

        //实际个数等于理论个数时对检验单进行判定
        if (sum == icount)
            //合格的检验结果等于总检验数视为合格
            FcheckResu = "合格";
    /// <summary>
    /// ç¡®å®šæ£€éªŒå•ç»“æžœ
    /// </summary>
    private string DetermineInspectionOrderResult((int TotalItems, int PassedItems) counts)
    {
        // æ‰€æœ‰æ£€éªŒé¡¹ç›®éƒ½åˆæ ¼æ—¶ï¼Œæ•´ä¸ªæ£€éªŒå•æ‰åˆæ ¼
        return counts.TotalItems == counts.PassedItems ? "合格" : "不合格";
    }

        var sysUser = db.Queryable<SysUser>()
            .Where(s => s.Fcode == detail.CreateBy).First();
    /// <summary>
    /// èŽ·å–用户信息
    /// </summary>
    private SysUser? GetUserInfo(string? userCode)
    {
        var db = SqlSugarHelper.GetInstance();
        return db.Queryable<SysUser>()
            .Where(s => s.Fcode == userCode).First();
    }

    /// <summary>
    /// æ›´æ–°æ£€éªŒå•ç»“æžœ
    /// </summary>
    private void UpdateInspectionOrderResult(string? releaseNo, string result, string? checkedBy, string? updatedBy)
    {
        SqlSugarHelper.UseTransactionWithOracle(db =>
        {
            return db.Updateable<MesQaItemsDetect01>()
                .SetColumns(s => s.FcheckResu == FcheckResu)
                .SetColumns(s => s.FcheckResu == result)
                .SetColumns(s => s.FcheckDate == DateTime.Now)
                .SetColumns(s => s.FcheckBy == sysUser.Fname)
                .SetColumns(s => s.LastupdateBy == detail.CreateBy)
                .SetColumns(s => s.FcheckBy == checkedBy)
                .SetColumns(s => s.LastupdateBy == updatedBy)
                .SetColumns(s => s.LastupdateDate == DateTime.Now)
                .Where(s => s.ReleaseNo == detail.ReleaseNo)
                .Where(s => s.ReleaseNo == releaseNo)
                .ExecuteCommand();
        });
        //  if (FcheckResu.Equals("不合格"))
        //自动生成入库检异常对策
        ///     saveDetect02(detail.Id, detail.CreateBy);

        return useTransactionWithOracle;
    }
    /*  public int saveDetect02(decimal? gid, string? createBy)
     {

 MESApplication/Controllers/Base/MessageCenterController.cs

@@ -109,7 +109,51 @@
        try
        {
            dynamic resultInfos = new ExpandoObject();
            resultInfos.tbBillList = m.GetPushFailedPage(query);
            var (item, totalCount) = m.GetPushFailedPage(query);
            resultInfos.tbBillList = item;
            return new ResponseResult
            {
                status = 0,
                message = "OK",
                data = resultInfos,
                TotalCount = totalCount
            };
        }
        catch (Exception ex)
        {
            return ResponseResult.ResponseError(ex);
        }
    }

    //IsShow
    [HttpPost("IsShow")]
    public ResponseResult IsShow(MessageCenter query)
    {
        try
        {
            dynamic resultInfos = new ExpandoObject();
            resultInfos.tbBillList = m.IsShow(query);
            return new ResponseResult
            {
                status = 0,
                message = "OK",
                data = resultInfos
            };
        }
        catch (Exception ex)
        {
            return ResponseResult.ResponseError(ex);
        }
    }

    //UpdateRead
    [HttpPost("UpdateRead")]
    public ResponseResult UpdateRead(MessageCenter query)
    {
        try
        {
            dynamic resultInfos = new ExpandoObject();
            resultInfos.tbBillList = m.UpdateRead(query);
            return new ResponseResult
            {
                status = 0,

 MESApplication/README.md

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,302 @@
# XG_MES项目结构与功能分析文档

## é¡¹ç›®æ¦‚è¿°

XG_MES是一个基于ASP.NET Core 8.0构建的制造执行系统(MES)，采用分层架构设计，使用Oracle 11g数据库，通过SqlSugar ORM进行数据访问。系统覆盖了从订单管理到生产执行、质量控制、仓储管理的完整制造业务流程。

## æŠ€æœ¯æž¶æž„

### æ ¸å¿ƒæŠ€æœ¯æ ˆ
- **.NET 8.0** - ä¸»è¦å¼€å‘框架
- **ASP.NET Core Web API** - API服务框架
- **Oracle 11g Release 11.2.0.1.0** - æ•°æ®åº“系统
- **SqlSugar ORM** - å¯¹è±¡å…³ç³»æ˜ å°„框架
- **Swagger** - API文档生成
- **Newtonsoft.Json** - JSON序列化

### è§£å†³æ–¹æ¡ˆç»“æž„
```
XG_MES_API/
├── MESApplication/          # Web API项目
│   â”œâ”€â”€ Controllers/         # API控制器
│   â”œâ”€â”€ Filter/             # è¿‡æ»¤å™¨
│   â”œâ”€â”€ Properties/         # é¡¹ç›®å±žæ€§
│   â”œâ”€â”€ Program.cs          # åº”用程序入口
│   â””── Startup.cs          # æœåŠ¡é…ç½®
└── MES.Service/            # ä¸šåŠ¡é€»è¾‘层
    â”œâ”€â”€ DB/                 # æ•°æ®è®¿é—®å±‚
    â”œâ”€â”€ Dto/                # æ•°æ®ä¼ è¾“对象
    â”œâ”€â”€ Modes/              # æ•°æ®æ¨¡åž‹
    â”œâ”€â”€ service/            # ä¸šåŠ¡æœåŠ¡
    â””── util/               # å·¥å…·ç±»
```

## ä¸šåŠ¡æ¨¡å—详细分析

### 1. åŸºç¡€ç®¡ç†æ¨¡å—

**主要功能：**
- ç”¨æˆ·è®¤è¯ä¸Žæƒé™ç®¡ç†
- ç³»ç»Ÿæ¶ˆæ¯ä¸­å¿ƒ
- åŸºç¡€æ•°æ®ç»´æŠ¤

**核心控制器：**
- `LoginController` - ç”¨æˆ·ç™»å½•ã€å¯†ç é‡ç½®ã€æƒé™èŽ·å–
- `MessageCenterController` - æ¶ˆæ¯æŽ¨é€ã€çŠ¶æ€ç®¡ç†
- `DemoController` - ç³»ç»Ÿæ¼”示功能

**业务服务：**
- `LoginService` - ç”¨æˆ·èº«ä»½éªŒè¯ï¼Œæ”¯æŒè‡ªå®šä¹‰åŠ å¯†ç®—法
- `MessageCenterManager` - æ¶ˆæ¯ä¸­å¿ƒç®¡ç†ï¼Œæ”¯æŒæŽ¨é€å¤±è´¥é‡è¯•
- `SysUserService` - ç”¨æˆ·æƒé™æŸ¥è¯¢ï¼Œè°ƒç”¨å­˜å‚¨è¿‡ç¨‹èŽ·å–权限数据

### 2. åŸºç¡€æ•°æ®ç®¡ç†æ¨¡å—

**主要功能：**
- ç‰©æ–™ä¸»æ•°æ®ç®¡ç†
- å®¢æˆ·ä¾›åº”商信息维护
- äººå‘˜ç»„织架构管理
- ä»“库库位管理

**核心控制器：**
- `MesItemsController` - ç‰©æ–™ä¿¡æ¯ç®¡ç†ï¼Œæ”¯æŒERP同步
- `MesCustomerController` - å®¢æˆ·ä¿¡æ¯ç®¡ç†
- `MesSupplierController` - ä¾›åº”商信息管理
- `MesStaffController` - å‘˜å·¥ä¿¡æ¯ç®¡ç†
- `MesDepotsController` - ä»“库信息管理
- `OrganizeController` - ç»„织架构管理

**业务服务：**
- `MesItemsManager` - ç‰©æ–™ä¸»æ•°æ®ç®¡ç†ï¼Œæ”¯æŒæ‰¹é‡æ“ä½œå’ŒERP同步
- `OrganizeManager` - ç»„织架构管理，支持层级结构
- `MesCustomerManager` - å®¢æˆ·ä¿¡æ¯ç®¡ç†ï¼Œæ”¯æŒçŠ¶æ€æŽ§åˆ¶

**数据模型：**
- `MesItems` - ç‰©æ–™ä¸»æ•°æ®ï¼Œæ”¯æŒå¤šå•ä½ã€å¤šç¼–码、ERP集成
- `MesCustomer` - å®¢æˆ·ä¿¡æ¯ï¼ŒåŒ…含批次管理配置
- `MesSupplier` - ä¾›åº”商信息，支持多组织权限控制
- `Organize` - ç»„织架构，支持层级管理

### 3. ç”Ÿäº§è®¢å•ç®¡ç†æ¨¡å—

**主要功能：**
- é”€å”®è®¢å•ç®¡ç†
- ç”Ÿäº§è®¡åˆ’调度
- å·¥å•æ‰§è¡Œç®¡ç†
- å‘货出库管理

**核心控制器：**
- `SalesOrderController` - é”€å”®è®¢å•ç®¡ç†
- `ProductionOrderController` - ç”Ÿäº§è®¢å•ç®¡ç†
- `WomcaaController` - å·¥å•ä¸»è¡¨ç®¡ç†
- `SalesDeliveryNoticeController` - é”€å”®å‘货通知

**业务服务：**
- `ProductionOrderManager` - ç”Ÿäº§è®¢å•ç®¡ç†ï¼Œæ”¯æŒä¸»å­è¡¨å…³è”
- `SalesOrderManager` - é”€å”®è®¢å•ç®¡ç†ï¼Œæ”¯æŒå®Œæ•´ç”Ÿå‘½å‘¨æœŸ
- `WomcaaManager` - å·¥å•ç®¡ç†ï¼Œä¸ŽERP系统集成

**数据模型：**
- `SalesOrder` - é”€å”®è®¢å•ä¸»è¡¨ï¼Œæ”¯æŒè®¢å•çŠ¶æ€æµè½¬
- `ProductionOrder` - ç”Ÿäº§è®¢å•ä¸»è¡¨ï¼Œæ”¯æŒå§”外生产
- `Womcaa` - å·¥å•è¡¨ï¼Œæ”¯æŒç”Ÿäº§çŠ¶æ€ç®¡ç†
- `MesProductionNotice` - ç”Ÿäº§é€šçŸ¥å•

### 4. è´¨é‡æŽ§åˆ¶æ¨¡å—

**主要功能：**
- æ¥æ–™æ£€éªŒç®¡ç†
- ç”Ÿäº§å·¡æ£€æŽ§åˆ¶
- å…¥åº“质量检验
- é¦–件检验确认
- ä¸åˆæ ¼å“å¤„理

**核心控制器：**
- `LljController` - æ¥æ–™æ£€éªŒç®¡ç†
- `XJController` - å·¡æ£€ç®¡ç†
- `RKJController` - å…¥åº“检验
- `SJController` - é¦–件检验
- `SuspendController` - æš‚停管理

**业务服务：**
- `LljService` - æ¥æ–™æ£€éªŒæœåŠ¡ï¼Œå®žçŽ°å®Œæ•´AQL抽样检验标准
- `XJService` - å·¡æ£€æœåŠ¡ï¼Œæ”¯æŒç”Ÿäº§çº¿å®žæ—¶è´¨é‡ç›‘控
- `SJService` - é¦–件检验服务，支持图片上传和标准对比
- `BaseService` - QC基础服务，支持Base64图片处理

**数据模型：**
- `MesQa` - æ£€éªŒé¡¹ç›®ä¸»è¡¨
- `MesQaItem` - æ£€éªŒé¡¹ç›®æ˜Žç»†
- `QsItemIpiReq` - IQC检验申请
- `QsItemOqcReq` - OQC检验申请
- `MesQualityStandard` - è´¨é‡æ ‡å‡†
- `MesQmAql1/2/3` - AQL检验标准

### 5. ä»“储管理模块

**主要功能：**
- åº“存实时管理
- å‡ºå…¥åº“单据处理
- åº“存移动和调整
- æ¡ç è¿½æº¯ç®¡ç†
- åº“位精确管理

**核心控制器：**
- `MesInvItemStocksController` - åº“存管理
- `MesInvItemOutsController` - å‡ºåº“单管理
- `MesInvItemMovesController` - åº“存移动
- `MesInvItemBarcodesController` - æ¡ç ç®¡ç†
- `MesDepotSectionsController` - åº“位管理

**业务服务：**
- `MesInvItemOutsManager` - å‡ºåº“管理，支持条码扫描和审核流程
- `MesInvItemMovesManager` - åº“存调拨，实现完整的出入库流程
- `MesInvItemStocksManager` - åº“存管理，基础CRUD操作

**数据模型：**
- `MesInvItemStocks` - ç‰©æ–™åº“存表，支持多维度库存管理
- `MesInvItemOuts` - ç‰©æ–™å‡ºåº“主表，支持多种出库类型
- `MesInvItemMoves` - ç‰©æ–™ç§»åº“主表，支持仓库间调拨
- `MesInvItemBarcodes` - ç‰©æ–™æ¡ç è¡¨ï¼Œæ”¯æŒå®Œæ•´è¿½æº¯é“¾
- `MesDepots` - ä»“库主数据，支持多种仓库类型

### 6. é‡‡è´­ç®¡ç†æ¨¡å—

**主要功能：**
- åŽŸææ–™é‡‡è´­å…¥åº“
- é€è´§å•å¤„理
- é‡‡è´­æ¡ç ç®¡ç†
- ä¾›åº”商送货跟踪

**核心控制器：**
- `MesRohInController` - åŽŸææ–™å…¥åº“管理
- `MesDeliveryNoteController` - é€è´§å•ç®¡ç†
- `PurdhbController` - é‡‡è´­æ”¶è´§

**业务服务：**
- `MesRohInManager` - åŽŸææ–™å…¥åº“管理
- `MesDeliveryNoteManager` - é€è´§å•ç®¡ç†
- `PurdhbManager` - é‡‡è´­æ”¶è´§ç®¡ç†

**数据模型：**
- `MesRohIn` - æ”¶æ–™æ•°æ®ä¸»è¡¨
- `MesDeliveryNote` - é€è´§å•ä¸»è¡¨
- `Purdhb` - é‡‡è´­åˆ°è´§å•è¡¨èº«

## ç³»ç»Ÿé›†æˆæž¶æž„

### ERP系统集成
- **GetErpParametersServer** - ERP集成参数管理
- **HTTP集成模式** - åŸºäºŽHTTP请求的异步消息推送
- **业务场景支持** - é‡‡è´­å…¥åº“、采购退货、生产领料等多种业务

### æ•°æ®åŒæ­¥æœºåˆ¶
- **MessageCenter** - æ¶ˆæ¯ä¸­å¿ƒï¼Œè®°å½•æ‰€æœ‰å¤–部系统接口调用
- **失败重试** - æ”¯æŒæ¶ˆæ¯æŽ¨é€å¤±è´¥åŽçš„重试机制
- **状态跟踪** - å®Œæ•´çš„数据同步状态追踪

## å…³é”®ä¸šåŠ¡æµç¨‹

### 1. è®¢å•åˆ°äº¤ä»˜æµç¨‹
```
销售订单 â†’ ç”Ÿäº§è®¢å• â†’ å·¥å•æ‰§è¡Œ â†’ è´¨é‡æ£€éªŒ â†’ å‡ºåº“发货
```

### 2. é‡‡è´­åˆ°å…¥åº“流程
```
采购订单 â†’ ä¾›åº”商送货 â†’ æ¥æ–™æ£€éªŒ â†’ å…¥åº“上架
```

### 3. ç”Ÿäº§æ‰§è¡Œæµç¨‹
```
工单下达 â†’ åŽŸæ–™å‡ºåº“ â†’ ç”Ÿäº§åŠ å·¥ â†’ å·¡æ£€è´¨æŽ§ â†’ æˆå“å…¥åº“
```

### 4. è´¨é‡ç®¡æŽ§æµç¨‹
```
来料检验 â†’ é¦–件检验 â†’ ç”Ÿäº§å·¡æ£€ â†’ å…¥åº“检验 â†’ ä¸åˆæ ¼å¤„理
```

## æ•°æ®åº“设计特点

### 1. ä¸»é”®ç­–ç•¥
- å¤§éƒ¨åˆ†è¡¨ä½¿ç”¨Oracle序列生成数字主键
- å…³é”®ä¸šåŠ¡è¡¨ä½¿ç”¨GUID主键（如生产订单）

### 2. å®¡è®¡å­—段标准化
每个业务表都包含标准审计字段：
- `CREATE_BY`, `CREATE_DATE` - åˆ›å»ºä¿¡æ¯
- `LASTUPDATE_BY`, `LASTUPDATE_DATE` - æ›´æ–°ä¿¡æ¯
- `CREATE_ORG`, `USE_ORG` - ç»„织权限控制

### 3. ERP集成设计
- `FDOCUMENTSTATUS` - ERP单据状态同步
- å„种ERP_ID字段 - ä¸ŽERP系统主键映射
- SAP相关字段 - SAP系统集成支持

### 4. çŠ¶æ€ç®¡ç†æ¨¡å¼
- ä½¿ç”¨æ•°å­—代码表示业务状态
- æ”¯æŒå®¡æ ¸æµç¨‹ï¼ˆåˆ¶å•â†’审核→过账）
- ç¦ç”¨çŠ¶æ€ç®¡ç†è€Œéžç‰©ç†åˆ é™¤

### 5. å¤šç»„织支持
通过`CREATE_ORG`和`USE_ORG`字段实现多组织数据隔离和权限控制

## æŠ€æœ¯ç‰¹ç‚¹

### 1. ç»Ÿä¸€çš„数据访问层
- æ‰€æœ‰Manager类继承Repository基类
- æä¾›æ ‡å‡†CRUD操作
- æ”¯æŒäº‹åŠ¡ç®¡ç†

### 2. æ¡ç æŠ€æœ¯åº”用
- å¹¿æ³›ä½¿ç”¨æ¡ç æ‰«æè¿›è¡Œä¸šåŠ¡æ“ä½œéªŒè¯
- æ”¯æŒå¤šç§æ¡ç ç±»åž‹ï¼ˆå®¢æˆ·ã€ä¾›åº”商、内部）
- å®Œæ•´çš„追溯链管理

### 3. è´¨é‡ç®¡ç†
- å®žçŽ°å®Œæ•´çš„AQL抽样检验标准
- æ”¯æŒå¤šå±‚次质量检验控制
- å›¾ç‰‡ä¸Šä¼ å’Œæ£€éªŒæ ‡å‡†å¯¹æ¯”

### 4. å®žæ—¶æ•°æ®å¤„理
- åº“存实时更新
- ç”Ÿäº§çŠ¶æ€å®žæ—¶è·Ÿè¸ª
- è´¨é‡æ•°æ®å®žæ—¶åé¦ˆ

## ç³»ç»Ÿä¼˜åŠ¿

1. **业务完整性** - è¦†ç›–MES系统的核心业务领域
2. **数据一致性** - é€šè¿‡äº‹åŠ¡å’Œå­˜å‚¨è¿‡ç¨‹ç¡®ä¿æ•°æ®å‡†ç¡®æ€§
3. **可扩展性** - æ¸…晰的模块划分便于功能扩展
4. **集成能力** - ä¸ŽERP系统深度集成，实现数据同步
5. **质量管控** - å®Œæ•´çš„质量检验流程保证产品质量
6. **实时性** - æ¡ç æ‰«æå’Œå®žæ—¶æ•°æ®å¤„理提高操作效率
7. **多组织支持** - æ”¯æŒå¤šå·¥åŽ‚、多组织的管理模式

## å¼€å‘指南

### å¸¸ç”¨å¼€å‘命令
```bash
# ç¼–译整个解决方案
dotnet build MESApplication.sln

# è¿è¡Œåº”用程序
dotnet run --project MESApplication

# è®¿é—®Swagger文档
http://localhost:5184/swagger
```

### æ•°æ®åº“连接
- è¿žæŽ¥å­—符串配置在 `appsettings.json` çš„ `AppSettings.DataBaseConn`
- ä½¿ç”¨SqlSugar ORM进行数据访问
- æ”¯æŒSQL日志记录便于调试

### å¼€å‘规范
- æ‰€æœ‰Manager类继承Repository基类
- ä½¿ç”¨DTO模式进行数据传输
- ç»Ÿä¸€çš„ResponseResult返回格式
- æ”¯æŒæ‰¹é‡æ“ä½œå’Œäº‹åŠ¡å¤„理

本文档为XG_MES项目的完整结构与功能分析，涵盖了系统的技术架构、业务模块、数据模型和关键流程，为项目的后续开发和维护提供重要参考。