Merge pull request #250 from baoduy/copilot/update-documentation-for-dotnet-10

baoduy · web-flow · commit c75f2ee469ca · 2025-11-20T10:31:44.000+08:00
diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
@@ -169,7 +169,7 @@ applications using Domain-Driven Design (DDD) principles and CQRS patterns.
 - **Configuration**: Centralized configuration through `appsettings.json`, dependency injection, and options pattern
 - **Core Workflow**: Request → Endpoint → Command/Query Handler → Domain Logic → Repository → Database
 - **Extensibility Points**: Custom validators, event handlers, mapping configurations, and domain services
-- **Supported Platforms/Frameworks**: .NET 9.0+, ASP.NET Core, Entity Framework Core, FluentValidation
+- **Supported Platforms/Frameworks**: .NET 10.0+, ASP.NET Core, Entity Framework Core, FluentValidation
 
 ### Architecture Layers
 
diff --git a/.trae/rules/project_rules.md b/.trae/rules/project_rules.md
@@ -1,7 +1,7 @@
 # WIXO.FW Project Rules
 
 ## 1. Coding Standards
-- Follow .NET 9 conventions for all code.
+- Follow .NET 10 conventions for all code.
 - Use **PascalCase** for class and method names, **camelCase** for local variables and parameters.
 - Prefix interfaces with 'I' (e.g., `IService`).
 - Provide XML documentation for all public members.
@@ -39,7 +39,7 @@
 - All code and templates must be licensed under MIT License.
 
 ## 6. Build & CI
-- All projects must target .NET 9.0.
+- All projects must target .NET 10.0.
 - The solution must build without errors or warnings.
 - All tests must pass in CI before merging.
 
diff --git a/README.md b/README.md
@@ -1,7 +1,7 @@
 # DKNet Framework
 
 [![codecov](https://codecov.io/github/baoduy/DKNet/graph/badge.svg?token=xtNN7AtB1O)](https://codecov.io/github/baoduy/DKNet)
-[![.NET](https://img.shields.io/badge/.NET-9.0-blue)](https://dotnet.microsoft.com/)
+[![.NET](https://img.shields.io/badge/.NET-10.0-blue)](https://dotnet.microsoft.com/)
 [![GitHub release](https://img.shields.io/github/release/baoduy/DKNet.svg)](https://github.com/baoduy/DKNet/releases)
 [![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
 [![NuGet](https://img.shields.io/nuget/v/DKNet.Fw.Extensions)](https://www.nuget.org/packages/DKNet.Fw.Extensions/)
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
@@ -32,7 +32,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Data authorization and tenant-aware filtering
 - Blob storage abstractions for Azure, AWS S3, and local storage
 - Comprehensive testing strategy with 99% coverage goals
-- .NET 9.0 support across all packages
+- .NET 10.0 support across all packages with C# 14 language features
 
 ### Core Framework (DKNet.Fw.Extensions)
 - Added comprehensive extension methods for types, properties, and enums
@@ -124,7 +124,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 This represents a complete rewrite of the framework with focus on:
 
 1. **Architecture**: Migration to Domain-Driven Design and Onion Architecture
-2. **Technology**: Upgrade to .NET 9.0 with modern C# features
+2. **Technology**: Upgrade to .NET 10.0 with C# 14 language features
 3. **Patterns**: Introduction of CQRS, Event Sourcing, and Repository patterns
 4. **Testing**: Comprehensive test coverage with modern testing approaches
 5. **Documentation**: Complete documentation overhaul with practical examples
diff --git a/docs/Configuration.md b/docs/Configuration.md
@@ -228,8 +228,8 @@ public class Product : AggregateRoot, ITenantEntity
 ### Local Development Setup
 
 ```bash
-# Install .NET 9.0 SDK
-./src/dotnet-install.sh --version 9.0.100
+# Install .NET 10.0 SDK
+./src/dotnet-install.sh --version 10.0.100
 
 # Restore packages
 cd src
@@ -260,12 +260,12 @@ dotnet run --environment Development
 ### Docker Development
 
 ```dockerfile
-FROM mcr.microsoft.com/dotnet/aspnet:9.0 AS base
+FROM mcr.microsoft.com/dotnet/aspnet:10.0 AS base
 WORKDIR /app
 EXPOSE 80
 EXPOSE 443
 
-FROM mcr.microsoft.com/dotnet/sdk:9.0 AS build
+FROM mcr.microsoft.com/dotnet/sdk:10.0 AS build
 WORKDIR /src
 COPY ["*.csproj", "./"]
 RUN dotnet restore
diff --git a/docs/Contributing.md b/docs/Contributing.md
@@ -22,9 +22,9 @@ This project adheres to the [Microsoft Open Source Code of Conduct](https://open
 
 ### Prerequisites
 
-- .NET 9.0 SDK or later
+- .NET 10.0 SDK or later
 - Git
-- Visual Studio 2022, Visual Studio Code, or JetBrains Rider (recommended)
+- Visual Studio 2022 (17.13+), Visual Studio Code, or JetBrains Rider (recommended)
 - SQL Server or SQL Server LocalDB (for integration tests)
 
 ### Fork and Clone
@@ -44,10 +44,10 @@ This project adheres to the [Microsoft Open Source Code of Conduct](https://open
 
 ### Initial Setup
 
-1. **Install .NET 9.0 SDK**:
+1. **Install .NET 10.0 SDK**:
    ```bash
    # Use the provided script
-   ./src/dotnet-install.sh --version 9.0.100
+   ./src/dotnet-install.sh --version 10.0.100
    ```
 
 2. **Restore NuGet packages**:
@@ -64,19 +64,19 @@ This project adheres to the [Microsoft Open Source Code of Conduct](https://open
 ### IDE Configuration
 
 #### Visual Studio 2022
-- Install the latest version with .NET 9.0 support
+- Install version 17.13 or later with .NET 10.0 support
 - Recommended extensions:
   - CodeMaid (code cleanup)
   - SonarLint (code quality)
   - Meziantou.Analyzer (already included in projects)
 
 #### Visual Studio Code
-- Install the C# extension
+- Install the C# extension (with .NET 10 SDK support)
 - Install the .NET Core Test Explorer extension
 - Configure EditorConfig support
 
 #### JetBrains Rider
-- Use the latest version with .NET 9.0 support
+- Use the latest version with .NET 10.0 support
 - Enable EditorConfig support
 - Configure code style according to `.editorconfig`
 
@@ -136,7 +136,7 @@ dotnet test --configuration Release
 
 Follow the [DKNet Coding Guidelines](.github/copilot-instructions.md) and Microsoft .NET guidelines:
 
-- Use C# 12.0+ language features appropriately
+- Use C# 14.0 language features appropriately
 - Follow `.editorconfig` rules
 - Write self-documenting code with meaningful names
 - Add XML documentation for all public APIs
diff --git a/docs/FAQ.md b/docs/FAQ.md
@@ -23,7 +23,7 @@ DKNet is a comprehensive .NET framework designed to enhance enterprise applicati
 
 ### Which .NET versions are supported?
 
-DKNet Framework requires **.NET 9.0** or later. All packages are built and tested against .NET 9.0.
+DKNet Framework requires **.NET 10.0** or later. All packages are built and tested against .NET 10.0.
 
 ### Is DKNet Framework free to use?
 
diff --git a/docs/Getting-Started.md b/docs/Getting-Started.md
@@ -4,8 +4,8 @@ Welcome to DKNet Framework! This guide will help you get started with the compre
 
 ## 📋 Prerequisites
 
-- **.NET 9.0 SDK** or later
-- **Visual Studio 2022**, **Visual Studio Code**, or **JetBrains Rider**
+- **.NET 10.0 SDK** or later
+- **Visual Studio 2022** (17.13+), **Visual Studio Code**, or **JetBrains Rider**
 - **SQL Server** or **SQL Server LocalDB** (for EF Core features)
 - Basic understanding of **Domain-Driven Design** concepts
 
@@ -91,6 +91,14 @@ DKNet follows the **Onion Architecture** pattern with clear separation of concer
 🗄️ Infrastructure Layer (Data Access, External Services)
 ```
 
+### Modern Language Features
+
+DKNet leverages the latest **C# 14** features for improved performance and developer experience:
+- **Params collections** for flexible method parameters
+- **Enhanced pattern matching** for cleaner business logic
+- **Primary constructors** in domain entities for concise code
+- **Lock object improvements** for better concurrency
+
 ## 📚 Next Steps
 
 1. **[Choose Your Components](README.md)** - Review available packages
diff --git a/docs/Migration-Guide.md b/docs/Migration-Guide.md
@@ -21,7 +21,7 @@ This is a **major architectural migration** from legacy packages to the new Doma
 
 #### Key Changes
 - **Architecture**: Complete shift to DDD/Onion Architecture
-- **Technology**: Upgrade to .NET 9.0
+- **Technology**: Upgrade to .NET 10.0 with C# 14 features
 - **Patterns**: Introduction of CQRS, Repository patterns, Domain Events
 - **Testing**: New testing strategy with TestContainers
 
@@ -51,31 +51,66 @@ dotnet list package --include-transitive | grep DKNet
 
 ## 📦 Version-Specific Migrations
 
-### Upgrading to .NET 9.0
+### Upgrading to .NET 10.0
 
 **Prerequisites**
 ```bash
-# Install .NET 9.0 SDK
-./src/dotnet-install.sh --version 9.0.100
+# Install .NET 10.0 SDK
+./src/dotnet-install.sh --version 10.0.100
 
 # Update global.json
 {
   "sdk": {
-    "version": "9.0.100"
+    "version": "10.0.100"
   }
 }
 ```
 
 **Project Files**
 ```xml
 <!-- Update target framework -->
-<TargetFramework>net9.0</TargetFramework>
+<TargetFramework>net10.0</TargetFramework>
 
 <!-- Update package references -->
-<PackageReference Include="Microsoft.EntityFrameworkCore" Version="9.0.0" />
+<PackageReference Include="Microsoft.EntityFrameworkCore" Version="10.0.0" />
 <PackageReference Include="Microsoft.AspNetCore.App" />
 ```
 
+**C# 14 Language Features**
+
+Take advantage of new C# 14 features in your code:
+
+```csharp
+// Params collections - more efficient parameter passing
+public static void ProcessItems(params ReadOnlySpan<string> items)
+{
+    foreach (var item in items)
+    {
+        // Process item
+    }
+}
+
+// Enhanced pattern matching
+public decimal CalculateDiscount(Order order) => order switch
+{
+    { Total: > 1000, IsPremium: true } => 0.20m,
+    { Total: > 500 } => 0.10m,
+    { ItemCount: > 10 } => 0.05m,
+    _ => 0m
+};
+
+// Lock object improvements - better performance
+private readonly Lock _lock = new();
+
+public void SafeOperation()
+{
+    lock (_lock)
+    {
+        // Thread-safe operations
+    }
+}
+```
+
 ### Entity Framework Core Migration
 
 **Before (Legacy)**
diff --git a/docs/Services/DKNet.Svc.PdfGenerators.md b/docs/Services/DKNet.Svc.PdfGenerators.md
@@ -1,7 +1,7 @@
 # DKNet.Svc.PdfGenerators
 
 A comprehensive PDF generation toolkit that combines HTML, Markdown, and Razor-friendly templates with
-PuppeteerSharp-driven rendering. The package targets .NET 9.0 and focuses on documentation, reporting, and
+PuppeteerSharp-driven rendering. The package targets .NET 10.0 and focuses on documentation, reporting, and
 knowledge-base publishing scenarios.
 
 ## 🧰 Feature Set
diff --git a/src/CONFIGURATION_SUMMARY.md b/src/CONFIGURATION_SUMMARY.md
@@ -117,7 +117,7 @@ Test entity projects (like DKNet.EfCore.DtoEntities) can opt out of documentatio
 
 ---
 
-**Last Updated:** October 29, 2025
-**Configuration Version:** 1.0
-**Status:** In Progress
+**Last Updated:** November 20, 2025
+**Configuration Version:** 1.1
+**Status:** Active
 
diff --git a/src/memory-bank/AI_IMPROVEMENTS_SUMMARY.md b/src/memory-bank/AI_IMPROVEMENTS_SUMMARY.md
@@ -235,8 +235,8 @@ public static class TypeExtensions
 - Zero warnings policy enforced
 
 #### 2. Technology Stack
-- .NET 9 with C# 13
-- EF Core 9.0
+- .NET 10 with C# 14
+- EF Core 10.0
 - xUnit, Shouldly, TestContainers.MsSql
 - LinqKit, System.Linq.Dynamic.Core
 - Bogus for test data
diff --git a/src/memory-bank/MEMORY_BANK_COMPLETE.md b/src/memory-bank/MEMORY_BANK_COMPLETE.md
@@ -120,8 +120,8 @@ memory-bank/
 
 ### 4. Technical Context (techContext.md)
 **1200+ words** explaining:
-- .NET 9 & C# 13 features
-- EF Core 9 configuration
+- .NET 10 & C# 14 features
+- EF Core 10 configuration
 - Testing frameworks (xUnit, TestContainers)
 - Build & analyzer setup
 - Performance guidelines
diff --git a/src/memory-bank/README.md b/src/memory-bank/README.md
@@ -34,7 +34,7 @@ This directory contains comprehensive documentation to help AI Copilot and devel
    - Core features
 
 5. **[techContext.md](techContext.md)** - Technology stack
-   - .NET 9, C# 13, EF Core 9
+   - .NET 10, C# 14, EF Core 10
    - Testing frameworks
    - Build configuration
    - Architecture constraints
diff --git a/src/memory-bank/UPDATE_SUMMARY.md b/src/memory-bank/UPDATE_SUMMARY.md
@@ -30,7 +30,7 @@
 ### 2. Tech Context Expansion
 **Before**: Empty template  
 **After**: Complete technical documentation:
-- Technology stack (.NET 9, EF Core 9, xUnit, TestContainers)
+- Technology stack (.NET 10, EF Core 10, xUnit, TestContainers)
 - Build and code quality configuration
 - Architecture constraints
 - Performance guidelines
@@ -129,8 +129,8 @@ Developer-friendly quick reference:
 - [x] Performance optimization patterns
 
 ### Technology Stack
-- [x] .NET 9 and C# 13 features
-- [x] Entity Framework Core 9
+- [x] .NET 10 and C# 14 features
+- [x] Entity Framework Core 10
 - [x] xUnit testing framework
 - [x] TestContainers for integration testing
 - [x] LinqKit for expression composition
diff --git a/src/memory-bank/memory-bank-instructions.md b/src/memory-bank/memory-bank-instructions.md
@@ -18,7 +18,7 @@ This document defines how GitHub Copilot maintains project memory and context ac
   * [ ] Read `copilot-quick-reference.md` (Quick patterns & snippets)
   * [ ] Read `systemPatterns.md` (Specification Pattern, Repository, etc.)
   * [ ] Read `copilot-rules.md` (Complete coding standards - 8000+ words)
-  * [ ] Read `techContext.md` (.NET 9, EF Core 9, TestContainers)
+  * [ ] Read `techContext.md` (.NET 10, EF Core 10, TestContainers)
   * [ ] Read `productContext.md` (DKNet Framework purpose & features)
   * [ ] Read `progress-detailed.md` (Roadmap & metrics)
   * [ ] Read any additional context files in `/memory-bank/`
diff --git a/src/memory-bank/techContext.md b/src/memory-bank/techContext.md
@@ -3,15 +3,23 @@
 ## Technology Stack
 
 ### Core Framework
-- **.NET 9.0**: Latest LTS version with C# 13 language features
-- **C# Language Version**: Latest (13.0)
+- **.NET 10.0**: Latest version with C# 14 language features
+- **C# Language Version**: Latest (14.0)
 - **Nullable Reference Types**: Enabled globally (`<Nullable>enable</Nullable>`)
 - **LangVersion**: `latest` for all projects
 
+#### C# 14 Features in Use
+- **Params collections**: Enhanced params support for span and collection types
+- **Improved overload resolution**: More precise method resolution with better performance
+- **Enhanced pattern matching**: Additional pattern matching capabilities
+- **Lock object improvements**: More efficient locking mechanisms
+- **Inline arrays enhancements**: Better performance for fixed-size buffers
+- **Primary constructors**: Simplified constructor syntax (already leveraged in domain entities)
+
 ### Key Dependencies
 
 #### EF Core Stack
-- **Microsoft.EntityFrameworkCore**: 9.0.0
+- **Microsoft.EntityFrameworkCore**: 10.0.0
 - **Microsoft.EntityFrameworkCore.SqlServer**: SQL Server provider
 - **Microsoft.EntityFrameworkCore.Relational**: Base for relational providers
 - **LinqKit.Microsoft.EntityFrameworkCore**: Expression composition and dynamic queries
@@ -61,9 +69,9 @@
 ### Development Tools & Constraints
 
 #### IDE Support
-- **JetBrains Rider**: Primary IDE (ReSharper settings included)
-- **Visual Studio 2022**: Full support
-- **Visual Studio Code**: With C# extension
+- **JetBrains Rider**: Primary IDE (ReSharper settings included) - Latest version with .NET 10 support
+- **Visual Studio 2022**: Full support - Version 17.13 or later recommended for .NET 10
+- **Visual Studio Code**: With C# extension and .NET 10 SDK
 
 #### Version Control
 - **Git**: Primary VCS
@@ -106,7 +114,7 @@
 - Audit logging for compliance requirements
 
 ### Platform Targets
-- **Runtime**: .NET 9.0+
+- **Runtime**: .NET 10.0+
 - **OS**: Cross-platform (Windows, Linux, macOS)
 - **Databases**: SQL Server (primary), potentially other EF Core providers
 - **Containers**: Docker support via TestContainers and Aspire
