CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

PadService is a .NET 8.0 MES (Manufacturing Execution System) backend service that manages barcode printing, work reporting, and data collection for factory production processes. The system provides RESTful APIs for frontend applications like mobile devices and tablets.

Development Commands

Building and Running

# Build the project
dotnet build

# Run in development mode (launches Swagger UI at http://localhost:5106)
dotnet run

# Run with specific profile
dotnet run --launch-profile http

# Publish the application
dotnet publish

Testing and Validation

# Restore packages
dotnet restore

# Check for build errors
dotnet build --verbosity normal

Architecture Overview

Core Technologies

• Framework: .NET 8.0 Web API
• ORM: SqlSugar 5.1.4.169 with Oracle database
• API Documentation: Swagger/OpenAPI
• JSON Serialization: Newtonsoft.Json with camelCase naming
• CORS: Enabled for cross-origin requests

Project Structure

Controllers/          # API controllers for different modules
├── MesInvItemBarcodesController.cs    # Barcode management
├── DeviceMetricsController.cs         # Device metrics
├── MesOrderSelectController.cs        # Work order management
└── ...

Services/             # Business logic managers
├── MesInvItemBarcodesManager.cs       # Core barcode operations
├── WomdaaManager.cs                   # Work order management
└── ...

Entites/             # Data models
├── DbModels/        # Database entity models
└── Dto/            # Data transfer objects

DB/                  # Data access layer
├── Repository.cs    # Generic repository with SqlSugar
└── RepositoryNoEntity.cs

util/               # Utility classes
├── AppSettings.cs   # Configuration model
├── ResponseResult.cs # API response wrapper
└── ...

Database Architecture

• Database: Oracle with SqlSugar ORM
• Connection: Configured via AppSettings.DataBaseConn
• Key Tables:
• MES_INV_ITEM_BARCODES: Barcode information
• MES_REPORTING: Work reporting records
• WOMDAA: Work order master data
• MES_NUMERICAL: Data collection from devices
• MES_ANCHORS: Work order anchor points (initial values)
• MES_QA_ITEMS_DETECT_02: Quality inspection records

Core Business Logic

Barcode Management (MesInvItemBarcodesManager)

The central module handles:
- Barcode generation with uniqueness validation
- Print quantity validation against work orders
- Work order status verification (must be "开工" - started)
- Quality inspection status verification
- Integration with work reporting system

Key Data Flow: Barcode Printing (AddItemToBarcodes)

1. Validate work order status and quality inspection status
2. Check print quantity doesn't exceed work order quantity
3. Generate unique barcodes
4. Create barcode records and work reporting entries
5. Update work order completion quantities

Repository Pattern

• Generic Repository<T> base class extends SqlSugar's SimpleClient<T>
• Provides transaction support via UseTransaction method
• Common pagination support via CommonPage methods
• SQL logging enabled in development

Configuration

• Settings: Managed via AppSettings class and appsettings.json
• Database: Oracle connection string in AppSettings.DataBaseConn
• Environment: Development mode enables Swagger UI at /swagger
• CORS: Configured to allow all origins, headers, and standard HTTP methods

API Conventions

• RESTful API design with standard HTTP methods
• Swagger documentation available in development
• JSON responses with camelCase property naming
• Date format: "yyyy-MM-dd HH:mm:ss"
• CORS enabled for cross-platform access

Development Notes

• Language: Comments and documentation are in Chinese
• Error Handling: Exceptions thrown for business rule violations
• Logging: SQL queries logged to console in development
• Transactions: Business operations wrapped in database transactions where needed
• Validation: Extensive validation for work order status, quantities, and business rules