‫بهینه‌سازی تجربه کار با GitHub Copilot در VSCode

• شرح کلی پروژه: توضیح دهید که پروژه در مورد چیست، چه اهدافی را دنبال می‌کند و از چه بخش‌های اصلی تشکیل شده است. برای مثال، در یک پروژه .NET، می‌توانید مشخص کنید که آیا با یک برنامه تحت وب ASP.NET Core، یک سرویس Worker، یک برنامه دسکتاپ WPF یا Maui، یا یک کتابخانه کلاس سر و کار دارید.
• الگوهای معماری و ساختاری: اگر از الگوهای خاصی مانند Domain-Driven Design (DDD)، CQRS، یا معماری چندلایه (N-Tier Architecture) استفاده می‌کنید، به آن‌ها اشاره کنید. همچنین، نحوه ساختاربندی کد، مانند قراردادهای نام‌گذاری یا سازماندهی پوشه‌ها را شرح دهید.
• ترجیحات کدنویسی: مشخص کنید که تیم شما چه سبک کدنویسی را ترجیح می‌دهد. به عنوان مثال، در یک پروژه C#، می‌توانید تأکید کنید که:
• همیشه از برنامه‌نویسی ناهمگام (Asynchronous Programming) با async/await برای عملیات ورودی/خروجی (I/O-bound operations) استفاده شود.
• تزریق وابستگی (Dependency Injection) برای سرویس‌ها به درستی پیاده‌سازی شود.
• در صورت امکان، از آخرین ویژگی‌های زبان C# و فریم‌ورک .NET (مثلاً .NET 8 یا نسخه‌های جدیدتر) استفاده گردد.
• در استفاده از LINQ، سینتکس کوئری (Query Syntax) بر سینتکس متد (Method Syntax) ارجحیت دارد یا بالعکس.
• اشتباهات رایج یا الگوهای نامطلوب: اگر متوجه شده‌اید که Copilot به طور مکرر پیشنهادهایی ارائه می‌دهد که با استانداردهای پروژه شما همخوانی ندارد (مثلاً استفاده از کلاس‌های استاتیک به جای سرویس‌های تزریق شده، یا ایجاد فیلدهای عمومی به جای خصوصیات Properties با Getter/Setter)، می‌توانید این موارد را در copilot-instructions.md گوشزد کنید تا از تکرار آن‌ها جلوگیری شود.

• کلاس DbContext در Entity Framework Core: این کلاس قلب تپنده EF Core است و تعریف موجودیت‌ها (Entities)، روابط بین آن‌ها، و پیکربندی اتصال به پایگاه داده را در خود جای داده است.
• فایل‌های مدل (Model) یا موجودیت (Entity): کلاس‌هایی که ساختار جداول پایگاه داده شما را منعکس می‌کنند.
• فایل‌های DTO (Data Transfer Object): کلاس‌هایی که برای انتقال داده بین لایه‌های مختلف برنامه استفاده می‌شوند.
• فایل‌های تعریف سرویس‌های کلیدی یا واسط‌ها (Interfaces).

"github.copilot.chat.extendedContext": {
    "include": [
        "src/MyProject.Data/MyDbContext.cs",
        "src/MyProject.Core/Models/**/*.cs", // شامل تمام فایل‌های cs در پوشه Models و زیرپوشه‌های آن
        "docs/architecture-overview.md" // حتی یک فایل Markdown با توضیحات معماری
    ]
}

# Project Overview
This is a race management platform built using ASP.NET Core 8 Web API and Entity Framework Core for data access.

# Coding Standards
- Use `async/await` for all I/O-bound operations.
- Services should be registered for Dependency Injection in `Program.cs`.
- Follow SOLID principles.
- Prefer LINQ Query Syntax for complex queries.
- All public APIs must be documented using XML documentation comments.

# Common Pitfalls to Avoid
- Do not use `DateTime.Now`; use a time abstraction service for testability.
- Avoid returning `IEnumerable<T>` from API controllers; use `ActionResult<IEnumerable<T>>` or `IAsyncEnumerable<T>`.

"github.copilot.chat.extendedContext": { // نام تنظیم بر اساس مستندات Copilot
    "include": [
        "src/RaceManagement.Data/RaceManagementDbContext.cs"
    ]
}

"Create a C# service class named FundraiserService with an interface IFundraiserService. It should include methods to get a fundraiser by its ID and get all fundraisers for a specific race ID. Use RaceManagementDbContext for data access and ensure methods are asynchronous."