‫معرفی Carom؛ کتابخانه تاب‌آوری بدون وابستگی برای .NET

چکیده: کتابخانه‌های تاب‌آوری (Resilience Libraries) ستون فقرات معماری‌های مدرن مبتنی بر میکروسرویس و سیستم‌های توزیع‌شده در اکوسیستم دات‌نت محسوب می‌شوند. در سال ۲۰۲۶، تغییر مدل ارائه‌ی پکیج دوتایی (Binary Distribution Model) کتابخانه‌ی شناخته‌شده‌ی Polly و افزودن لایسنس تجاری OSMF برای بسته‌های منتشرشده روی NuGet، چالش‌های حقوقی و فنی نوینی را برای سازمان‌ها و تیم‌های نرم‌افزاری ایجاد کرد. این مقاله به بررسی جامع و ارزیابی فنی کتابخانه‌ی نوظهور و سبک‌وزن Carom (تحت لایسنس MPL-2.0) به‌عنوان گزینه‌ای جایگزین می‌پردازد. در ادامه، ضمن تحلیل تفاوت‌های معماری و هم‌سنجی الگوهای کلیدی تاب‌آوری (از جمله Retry، Circuit Breaker، Bulkhead، Rate Limiting، Fallback و Hedging)، چالش‌ها و مزایای مهاجرت به این ابزار ارزیابی خواهد شد.

• لایسنس سورس‌کد تغییر نکرده است: متن سورس‌کد همچنان تحت لایسنس BSD-3-Clause باقی مانده است.
• تغییر بر روی Artifact / NuGet Package: نسخه‌ی باینری آپلودشده در مخزن عمومی nuget.org شامل شرایط تجاری (EULA) شده است. بنابراین، کدی که کلون می‌شود و کدی که از طریق دستور dotnet add package نصب می‌گردد، شرایط حقوقی یکسانی ندارند.
• ریسک انطباق سازمانی: تغییر ناگهانی شرایط یک شناسه پکیج (Package ID) موجود، تیم‌های حقوقی و مدیران فنی را ناگزیر به بازبینی تک‌تک به‌روزرسانی‌ها کرده است.

• پرداخت هزینه: برای پروژه‌های با وابستگی بالا به اکوسیستم گسترده‌ی Polly.
• استفاده از Fences: استفاده از فورک پایدار و رایگان آخرین نسخه‌ی پیش از تغییر لایسنس.
• مهاجرت به بسترهای جایگزین و نوین: استفاده از ابزارهایی مانند Carom.

• شفافیت لایسنس: منتشرشده تحت مجوز MPL-2.0؛ ساختار لایسنس در سورس‌کد و بسته NuGet کاملاً یکسان و منطبق بر استاندارد SPDX است.
• بدون وابستگی خارجی (Zero Dependencies): هسته‌ی اصلی (Carom) و بسته‌ی اکستنشن‌ها فاقد هرگونه پکیج شخص ثالث (Third-Party) هستند. حجم DLL هسته تنها ۱۹ کیلوبایت است.
• پشتیبانی گسترده از فریم‌ورک‌ها: هسته‌ی کتابخانه بر پایه‌ی netstandard2.0 است و در کنار پشتیبانی از .NET Framework و تمامی نسخه‌های مدرن دات‌نت، سازگاری کاملی با .NET 8 و .NET 10 در بسته‌های اکوسیستمی (مانند EF Core، OpenTelemetry و Health Checks) دارد.
• دقت در همگام‌سازی و زمان‌بندی: محاسبات داخلی بر مبنای ساعت یکنواخت و افزایشی (Monotonic Clock / Stopwatch.GetTimestamp) طراحی شده است؛ بنابراین پرش‌های ناشی از تصحیح زمان سیستم توسط پروتکل NTP، الگوریتم‌های Rate Limiter یا مدت‌زمان باز بودن Circuit Breaker را مختل نمی‌کند.

// --- رویکرد Polly v8 ---
var pipeline = new ResiliencePipelineBuilder()
    .AddRetry(new RetryStrategyOptions
    {
        MaxRetryAttempts = 3,
        Delay = TimeSpan.FromMilliseconds(100),
        BackoffType = DelayBackoffType.Exponential,
        UseJitter = true
    })
    .Build();

var result = await pipeline.ExecuteAsync(async ct => await api.CallAsync(ct));

// --- رویکرد معادل در Carom ---
var result = await Carom.ShotAsync(() => api.CallAsync(), retries: 3);

// پیاده‌سازی در Carom
var bounce = Bounce.Times(5).WithTimeout(TimeSpan.FromSeconds(30));
var data = await Carom.ShotAsync(() => apiClient.FetchAsync(), bounce);

نکته‌ی فنی: در Carom، سازوکار Timeout به‌درستی بر روی فراخوانی‌های ناهمگام (Async) و از طریق لغو ساختاریافته اعمال می‌گردد. متدهای همگام (Synchronous) فاقد مکانیزم لغو اجباری هستند.

// --- رویکرد Polly v8 ---
var pollyBreaker = new ResiliencePipelineBuilder()
    .AddCircuitBreaker(new CircuitBreakerStrategyOptions
    {
        FailureRatio = 0.5,
        MinimumThroughput = 10,
        BreakDuration = TimeSpan.FromSeconds(30)
    })
    .Build();

// --- رویکرد معادل در Carom ---
var cushion = Cushion.ForService("payment-api")
    .OpenAfter(failures: 5, within: 10)
    .HalfOpenAfter(TimeSpan.FromSeconds(30));

var payment = await CaromCushionExtensions.ShotAsync(
    () => paymentApi.Charge(),
    cushion);

مزیت معماری: در صورت باز بودن مدار (Open State)، سیستم بلافاصله با خطا برمی‌گردد (Fail-Fast) و درخواست‌های بیهوده وارد چرخه‌ی Retry نخواهند شد.

var dbCompartment = Compartment.ForResource("database")
    .WithMaxConcurrency(10) // حداکثر هم‌زمانی مجاز
    .WithQueueDepth(5)      // حداکثر ظرفیت صف انتظار
    .Build();

var rows = await CaromCompartmentExtensions.ShotAsync(
    () => db.QueryAsync(sql), 
    dbCompartment);

var throttle = Throttle.ForService("external-api")
    .WithRate(100, TimeSpan.FromSeconds(1)) // ۱۰۰ درخواست در ثانیه
    .WithBurst(20)                          // تحمل ۲۰ درخواست مازاد لحظه‌ای
    .Build();

var result = await CaromThrottleExtensions.ShotAsync(
    () => api.CallAsync(), 
    throttle);

var config = await new Func<Task<AppConfig>>(() => configService.LoadAsync())
    .PocketAsync(AppConfig.Default);

var config = Masse.WithAttempts(3)
    .After(TimeSpan.FromMilliseconds(500))
    .When(r => IsStale(r));

var result = await CaromMasseExtensions.ShotWithHedgingAsync(
    ct => ReadReplica(ct), 
    config);

• چه زمانی در Polly بمانیم؟ اگر در سازمان شما تنظیمات پیچیده‌ی تزریق وابستگی (DI)، آزمون‌های آشوب (Chaos Engineering) و تله‌متری سازمانی گسترده وجود دارد و پرداخت هزینه‌ی ماهانه مانعی ایجاد نمی‌کند، پایداری و بلوغ ده‌ساله‌ی Polly گزینه‌ی مناسبی است.
• چه زمانی به Carom مهاجرت کنیم؟ اگر کاربرد شما شامل سناریوهای رایج (چند الگوی Retry، کلید خودکار و کنترل هم‌زمانی) است، کاهش حجم وابستگی‌ها، سادگی کدنویسی، عملکرد بهینه‌ی بدون قفل و رهایی از ابهامات حقوقی لایسنس برای شما اولویت دارد، مهاجرت به Carom می‌تواند در کمترین زمان ممکن انجام پذیرد.

dotnet add package Carom
dotnet add package Carom.Extensions