‫معیارهای کد (Code Metrics) و پیکربندی

• ۲۰ تا ۱۰۰ (سبز): نگهداری خوب
• ۱۰ تا ۱۹ (زرد): نگهداری متوسط
• ۰ تا ۹ (قرمز): نگهداری سخت

• عرف عمومی: زیر ۱۰ عالی، ۱۰ تا ۲۰ متوسط، بالای ۲۰ نیازمند بازبینی.

قانون طلایی: متریک‌ها "سیگنال" هستند، نه "حکم دادگاه". آن‌ها به شما می‌گویند "اینجا را نگاه کن"، نمی‌گویند "اینجا را عوض کن".

# Code metrics configuration
[*.cs]

# تنظیم پیچیدگی سایکلماتیک روی ۲۵ (به جای ۱۵ پیش‌فرض)
dotnet_diagnostic.CA1502.severity = warning
dotnet_code_quality.CA1502.cyclomatic_complexity = 25

# نادیده گرفتن پیچیدگی در کدهای تولید شده (Generated Code)
[**/Generated/**.cs]
dotnet_diagnostic.CA1502.severity = none

<PropertyGroup>
  <EnableNETAnalyzers>true</EnableNETAnalyzers>
  <AnalysisLevel>latest</AnalysisLevel>
  
  <WarningsAsErrors>CA1502;CA1505</WarningsAsErrors>
</PropertyGroup>

public async Task<OrderResult> ProcessOrderAsync(OrderRequest request)
{
    // پیچیدگی: ۱۸ (اما کاملاً خطی و خوانا)
    if (request == null) throw ...;
    if (!await ValidateUser(request)) return ...;
    if (!await CheckInventory(request)) return ...;
    if (!await ProcessPayment(request)) return ...;
    // ... مراحل بعدی
    return OrderResult.Success();
}

public int CalculateDiscount(Customer c, Order o)
{
    // پیچیدگی: ۳ (از نظر ابزار عالی است!)
    return (c.Tier == "Gold" && o.Total > 1000) ? 20 :
           (c.Tier == "Silver" && o.Total > 500) ? 10 : 0;
}

"وقتی یک معیار تبدیل به هدف شود، دیگر معیار خوبی نیست."

هدف شما "کد قابل نگهداری" است، نه "پیچیدگی زیر ۱۰".

• اگر کدی دارید که پیچیده است اما دلیل موجهی دارد، آن را سرکوب (Suppress) کنید اما حتماً دلیل را کامنت کنید. این کار به توسعه‌دهنده بعدی می‌گوید: "من حواسم به پیچیدگی بود، اما عمداً این مدل را انتخاب کردم."

// Justification: Orchestration logic needs to be linear for readability.
[SuppressMessage("Microsoft.Maintainability", "CA1502:AvoidExcessiveComplexity")]
public void ComplexOrchestrator() { ... }

• به جای اینکه بگویید "همه متدها باید زیر ۱۵ باشند"، بگویید "میانگین پیچیدگی پروژه نباید نسبت به ماه قبل بدتر شود". این رویکرد (Ratchet) بسیار سالم‌تر است.

• اگر ابزار خطایی گرفت، در جلسه Code Review درباره آن صحبت کنید. اگر تیم موافق بود که کد خواناست، تنظیمات ابزار را برای آن مورد نادیده بگیرید. اجازه ندهید ربات‌ها جایگزین تفکر مهندسی شوند.