⚖️ دوئل معماری: مزایای مونولیت ماژولار در برابر میکروسرویس‌ها

1️⃣ مهم‌ترین مزایای مونولیت ماژولار ✅

2️⃣ مقایسه نهایی: مونولیت ماژولار در برابر میکروسرویس‌ها

3️⃣حرف آخر: نقل قول طلایی 🎯

"میکروسرویس‌ها را به خاطر مزایایشان انتخاب کنید، نه به این دلیل که پایگاه کد مونولیت شما یک فاجعه است."

🔖 هشتگ‌ها:
#SoftwareArchitecture #CSharp #DotNet #Monolith #Microservices #Developer #CleanCode

🏗 سازنده‌ها (Constructors) در #C: معمار آبجکت‌های شما

1️⃣ سازنده چیست و چطور کار می‌کند؟

public class Panda
{
    string _name; // فیلد

    // این سازنده است
    public Panda(string name)
    {
        _name = name; // کد مقداردهی اولیه
    }
}

// ... نحوه استفاده
Panda p = new Panda("Petey"); // سازنده اینجا صدا زده میشه

public Panda(string name) => _name = name;
ترفند this: اگه اسم پارامتر با اسم فیلد یکی بود، می‌تونید با کلمه کلیدی this به فیلد کلاس اشاره کنید:
public Panda(string name) => this.name = name;

2️⃣ اورلودینگ و زنجیره‌ای کردن سازنده‌ها (this):

public class Wine
{
    public decimal Price;
    public int Year;

    public Wine(decimal price)
    {
        Price = price;
    }

    // این سازنده، قبل از اجرای بدنه خودش، سازنده بالایی رو صدا میزنه
    public Wine(decimal price, int year) : this(price)
    {
        Year = year;
    }
}

3️⃣ تله‌ی سازنده پیش‌فرض! ⚠️

4️⃣ ترتیب اجرا: اول فیلدها، بعد سازنده

class Player
{
    int shields = 50; // این اول اجرا میشه
    int health = 100; // این دوم اجرا میشه

    public Player()
    {
        // این سوم اجرا میشه
        Console.WriteLine("Constructor executed!");
    }
}

5️⃣ کاربرد حرفه‌ای: سازنده‌های private

public class MyApiClien
{
    // سازنده خصوصیه، پس کسی از بیرون نمی‌تونه new کنه
    private MyApiClient() { }

    // فقط از طریق این متد استاتیک میشه نمونه ساخت
    public static MyApiClient Create()
    {
        // ... منطق پیچیده برای ساخت و کانفیگ ...
        return new MyApiClient();
    }
}

🔖 هشتگ‌ها:
#CSharp #Programming #Developer #DotNet #OOP #Constructor #BestPractices

🚀 کشینگ در ASP.NET Core (قسمت ۱):

🚀 دسترسی سریع‌تر به داده‌ها:

📉 کاهش بار دیتابیس:

🧠 استفاده کمتر از CPU:

💪 مقیاس‌پذیری بیشتر:

• IMemoryCache:

• IDistributedCache:

🔖 هشتگ‌ها:
#ASPNETCore #Caching

🚀 کشینگ در ASP.NET Core (قسمت ۲):

1️⃣ قدم اول: فعال‌سازی سرویس

var builder = WebApplication.CreateBuilder(args);

// اضافه کردن سرویس کشینگ درون-حافظه‌ای
builder.Services.AddMemoryCache();

// ... بقیه تنظیمات

2️⃣ قدم دوم: الگوی پیاده‌سازی (Try-Get-Set)

app.MapGet("products/{id}", 
    (int id, IMemoryCache cache, AppDbContext context) =>
{
    // ۱. سعی می‌کنیم محصول رو از کش با کلید id بخونیم
    if (!cache.TryGetValue(id, out Product product))
    {
        // ۲. اگه تو کش نبود (Cache Miss)، از دیتابیس می‌خونیم
        product = context.Products.Find(id);

        // ۳. داده رو در کش ذخیره می‌کنیم تا دفعه بعد استفاده بشه
        // (گزینه‌های انقضا رو در بخش بعدی توضیح میدیم)
        var cacheOptions = new MemoryCacheEntryOptions()
            .SetSlidingExpiration(TimeSpan.FromMinutes(5));

        cache.Set(id, product, cacheOptions);
    }

    // ۴. داده رو (چه از کش، چه از دیتابیس) برمی‌گردونیم
    return Results.Ok(product);
});

3️⃣ قدم سوم: مدیریت انقضای کش (Cache Expiration) ⏱️

🔖 هشتگ‌ها:
#ASPNETCore #Caching

🚀 کشینگ در ASP.NET Core (قسمت ۳):

1️⃣ الگوی Cache-Aside چیست؟ 🤓

2️⃣ ساخت یک ابزار حرفه‌ای: متد توسعه GetOrCreateAsync 🛠

public static class DistributedCacheExtensions
{
    // یه زمان انقضای پیش‌فرض تعریف می‌کنیم
    public static DistributedCacheEntryOptions DefaultExpiration => new()
    {
        AbsoluteExpirationRelativeToNow = TimeSpan.FromMinutes(2)
    };

    public static async Task<T> GetOrCreateAsync<T>(
        this IDistributedCache cache,
        string key,
        Func<Task<T>> factory, // تابعی که قراره داده رو از منبع اصلی بگیره
        DistributedCacheEntryOptions? options = null)
    {
        var cachedData = await cache.GetStringAsync(key);
        if (cachedData is not null)
        {
            // اگه داده تو کش بود، از JSON برش می‌گردونیم
            return JsonSerializer.Deserialize<T>(cachedData);
        }

        // اگه نبود، تابع factory رو اجرا می‌کنیم تا از منبع اصلی بگیره
        var data = await factory();

        // داده جدید رو به صورت JSON در کش ذخیره می‌کنیم
        await cache.SetStringAsync(
            key,
            JsonSerializer.Serialize(data),
            options ?? DefaultExpiration);

        return data;
    }
}

3️⃣ نحوه استفاده از ابزار جدید ✨

app.MapGet("products/{id}", 
    async (int id, IDistributedCache cache, AppDbContext context) =>
{
    // فقط کافیه متد خودمون رو صدا بزنیم!
    var product = await cache.GetOrCreateAsync($"products-{id}", async () =>
    {
        // این تابع فقط زمانی اجرا میشه که داده تو کش نباشه
        return await context.Products.FindAsync(id);
    });

    return Results.Ok(product);
});

builder.Services.AddDistributedMemoryCache();

🔖 هشتگ‌ها:
#ASPNETCore #Caching

🚀 کشینگ در ASP.NET Core (قسمت ۴):

ردیس (Redis) چیست؟ 🧠

1️⃣ قدم اول: نصب پکیج

2️⃣ قدم دوم: پیکربندی در Program.cs

var builder = WebApplication.CreateBuilder(args);

string redisConnectionString = builder.Configuration.GetConnectionString("Redis");

builder.Services.AddStackExchangeRedisCache(options =>
{
    options.Configuration = redisConnectionString;
});

string redisConnectionString = builder.Configuration.GetConnectionString("Redis");

IConnectionMultiplexer connectionMultiplexer = 
    ConnectionMultiplexer.Connect(redisConnectionString);

builder.Services.AddSingleton(connectionMultiplexer);

builder.Services.AddStackExchangeRedisCache(options =>
{
    options.ConnectionMultiplexerFactory = 
        () => Task.FromResult(connectionMultiplexer);
});

🔖 هشتگ‌ها:
#ASPNETCore #Caching #Redis

🚀 کشینگ در ASP.NET Core (قسمت ۵):

1️⃣ مشکل Cache Stampede چیست؟ 🔥

2️⃣ یک راه حل (ناقص): قفل‌گذاری با SemaphoreSlim 🔒

public static class DistributedCacheExtensions
{
    private static readonly SemaphoreSlim Semaphore = new(1, 1);
    
    public static async Task<T> GetOrCreateAsync<T>(
        this IDistributedCache cache, string key, Func<Task<T>> factory)
    {
        var cachedData = await cache.GetStringAsync(key);
        if (cachedData is not null) return JsonSerializer.Deserialize<T>(cachedData);

        try
        {
            await Semaphore.WaitAsync(); // منتظر قفل بمون
            
            // دوباره کش رو چک کن، شاید درخواست قبلی پرش کرده باشه
            cachedData = await cache.GetStringAsync(key);
            if (cachedData is not null) return JsonSerializer.Deserialize<T>(cachedData);
            
            // اگه هنوز خالی بود، از دیتابیس بگیر و کش رو پر کن
            var data = await factory();
            await cache.SetStringAsync(key, JsonSerializer.Serialize(data), ...);
            return data;
        }
        finally
        {
            Semaphore.Release(); // قفل رو آزاد کن
        }
    }
}

3️⃣ آینده کشینگ: HybridCache در 9 Net. ✨

🔖 هشتگ‌ها:
#ASPNETCore #Caching

✨ ساخت آبجکت مثل یک حرفه‌ای: قدرت Object Initializers در #C

public class Bunny
{
    public string Name;
    public bool LikesCarrots;
    public bool LikesHumans;

    public Bunny() {}
    public Bunny(string n) => Name = n;
}

Bunny b1 = new Bunny();
b1.Name = "Bo";
b1.LikesCarrots = true;
b1.LikesHumans = false;

Bunny b2 = new Bunny 
{ 
    Name = "Bo", 
    LikesCarrots = true, 
    LikesHumans = false 
};

Bunny b3 = new Bunny("Bo") 
{ 
    LikesCarrots = true, 
    LikesHumans = false 
};

🔖 هشتگ‌ها:
#CSharp #Programming #Developer #DotNet #OOP #CleanCode #BestPractices

🔬 کالبدشکافی آبجکت‌ها با Deconstructors در #C

public class Rectangle
{
    public readonly float Width, Height;

    public Rectangle(float width, float height)
    {
        Width = width;
        Height = height;
    }

    // این متد Deconstructor ماست
    public void Deconstruct(out float width, out float height)
    {
        width = Width;
        height = Height;
    }
}

var rect = new Rectangle(3, 4);

// جادو اینجا اتفاق میفته!
// این خط، متد Deconstruct رو صدا میزنه
(float width, float height) = rect;

Console.WriteLine($"Width: {width}, Height: {height}"); // خروجی: Width: 3, Height: 4
این سینتکس، کد شما رو به شدت تمیز و بیانگر می‌کنه.

// کامپایلر خودش نوع‌ها رو تشخیص میده
var (width, height) = rect;

// ما اینجا فقط به ارتفاع نیاز داریم
var (_, height) = rect;

float w, h;
(w, h) = rect;

🔖 هشتگ‌ها:
#CSharp #Programming #Developer #DotNet #ModernCSharp #CleanCode #BestPractices

🏷 فیلترهای کوئری نام‌دار در EF 10 (چندین فیلتر کوئری برای هر انتیتی)

با EF 10، این وضعیت تغییر می‌کند. ✨

🔎فیلترهای کوئری (Query Filters) چه هستند؟

modelBuilder.Entity<Order>()
    .HasQueryFilter(order => !order.IsDeleted);

استفاده از چندین فیلتر کوئری ✅

modelBuilder.Entity<Order>()
    .HasQueryFilter(order => !order.IsDeleted && order.TenantId == tenantId);

modelBuilder.Entity<Order>()
    .HasQueryFilter("SoftDeletionFilter", order => !order.IsDeleted)
    .HasQueryFilter("TenantFilter", order => order.TenantId == tenantId);

// تمام سفارشات (شامل حذف شده‌های منطقی) برای مستأجر فعلی را برمی‌گرداند
var allOrders = await context.Orders
    .IgnoreQueryFilters(["SoftDeletionFilter"])
    .ToListAsync();

public static class OrderFilters
{
    public const string SoftDelete = nameof(SoftDelete);
    public const string Tenant = nameof(Tenant);
}

modelBuilder.Entity<Order>()
    .HasQueryFilter(OrderFilters.SoftDelete, order => !order.IsDeleted)
    .HasQueryFilter(OrderFilters.Tenant, order => order.TenantId == tenantId);

public static IQueryable<Order> IncludeSoftDeleted(this IQueryable<Order> query)
    => query.IgnoreQueryFilters([OrderFilters.SoftDelete]);

🔖 هشتگ‌ها:
#CSharp #Programming #Developer #DotNet #EntityFrameWork #EF

🏢 معماری چند-مستأجره (Multi-Tenancy) با EF Core (قسمت ۱):

🧠 ایزوله‌سازی منطقی (Logical Isolation):

🏬 ایزوله‌سازی فیزیکی (Physical Isolation):

public sealed class TenantProvider
{
    private const string TenantIdHeaderName = "X-TenantId";
    private readonly IHttpContextAccessor _httpContextAccessor;

    public TenantProvider(IHttpContextAccessor httpContextAccessor)
    {
        _httpContextAccessor = httpContextAccessor;
    }

    public string TenantId => _httpContextAccessor
        .HttpContext?
        .Request
        .Headers[TenantIdHeaderName];
}

💡نکته: راه‌های امن‌تر دیگری هم برای گرفتن TenantId وجود داره مثل JWT Claim یا API Key.

public class OrdersDbContext : DbContext
{
    private readonly string _tenantId;

    public OrdersDbContext(
        DbContextOptions<OrdersDbContext> options,
        TenantProvider tenantProvider)
        : base(options)
    {
        // TenantId رو از TenantProvider می‌گیریم
        _tenantId = tenantProvider.TenantId;
    }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        // این فیلتر به صورت خودکار به تمام کوئری‌های انتیتی Order اضافه میشه
        modelBuilder
            .Entity<Order>()
            .HasQueryFilter(o => o.TenantId == _tenantId);
    }
}

🔖 هشتگ‌ها:
#CSharp #ASPNETCore #DotNet #MultiTenancy #EntityFrameworkCore #SoftwareArchitecture #Backend

🏢 معماری چند-مستأجره با EF Core (قسمت ۲):

"Tenants": [
    { "Id": "tenant-1", "ConnectionString": "Host=tenant1.db;Database=db1" },
    { "Id": "tenant-2", "ConnectionString": "Host=tenant2.db;Database=db2" }
]

public sealed class TenantProvider
{
    // ... (Properties for HttpContextAccessor and TenantSettings)

    public TenantProvider(
        IHttpContextAccessor httpContextAccessor,
        IOptions<TenantSettings> tenantsOptions)
    {
        // ...
        _tenantSettings = tenantsOptions.Value;
    }

    public string TenantId => /* ... gets tenantId from header ... */;

    public string GetConnectionString()
    {
        return _tenantSettings.Tenants
            .Single(t => t.Id == TenantId).ConnectionString;
    }
}

builder.Services.AddDbContext<OrdersDbContext>((serviceProvider, options) =>
{
    // TenantProvider رو از DI میگیریم
    var tenantProvider = serviceProvider.GetRequiredService<TenantProvider>();

    // Connection String مخصوص مستأجر فعلی رو میگیریم
    var connectionString = tenantProvider.GetConnectionString();

    // و DbContext رو با اون کانفیگ می‌کنیم
    options.UseSqlServer(connectionString);
});

🤔 حرف حساب و تجربه شمابا این دو روش

🔖 هشتگ‌ها:
#CSharp #ASPNETCore #DotNet #MultiTenancy #EntityFrameworkCore #SoftwareArchitecture #Backend

🔐 ذخیره‌سازی امن اسرار برنامه در محیط توسعه در ASP.NET Core

متغیرهای محیطی (Environment variables) 🌍

⚠️ هشدار

ابزار Secret Manager 🕵️‍♂️

⚠️ هشدار

نحوه کار ابزار Secret Manager 🪄

فعال کردن ذخیره‌سازی اسرار
از طریق CLI: ❯

تنظیم یک سرّ ✍️

دسترسی به یک سرّ 📖

var builder = WebApplication.CreateBuilder(args);
var movieApiKey = builder.Configuration["Movies:ServiceApiKey"];
var app = builder.Build();

app.MapGet("/", () => movieApiKey);

app.Run();

public class IndexModel : PageModel
{
    private readonly IConfiguration _config;

    public IndexModel(IConfiguration config)
    {
        _config = config;
    }

    public void OnGet()
    {
        var moviesApiKey = _config["Movies:ServiceApiKey"];
        // ...
    }
}

مپ کردن اسرار به یک POCO 🔗

{
  "Movies:ConnectionString": "Server=(localdb)\\mssqllocaldb;Database=Movie-1;Trusted_Connection=True;MultipleActiveResultSets=true",
  "Movies:ServiceApiKey": "12345"
}

var moviesConfig = 
    Configuration.GetSection("Movies").Get<MovieSettings>();
var _moviesApiKey = moviesConfig.ServiceApiKey;

public class MovieSettings
{
    public string ConnectionString { get; set; }
    public string ServiceApiKey { get; set; }
}

جایگزینی رشته با اسرار 🛠️

using System.Data.SqlClient;

var builder = WebApplication.CreateBuilder(args);

var conStrBuilder = new SqlConnectionStringBuilder(
        builder.Configuration.GetConnectionString("Movies"));
conStrBuilder.Password = builder.Configuration["DbPassword"];
var connection = conStrBuilder.ConnectionString;

var app = builder.Build();
app.MapGet("/", () => connection);
app.Run();

📑 دستورات CLI

Install-Package Microsoft.Extensions.Configuration
Install-Package Microsoft.Extensions.Configuration.UserSecrets

dotnet add package Microsoft.Extensions.Configuration
dotnet add package Microsoft.Extensions.Configuration.UserSecrets

using Microsoft.Extensions.Configuration;

class Program
{
    static void Main(string[] args)
    {
        IConfigurationRoot config = new ConfigurationBuilder()
            .AddUserSecrets<Program>()
            .Build();

        Console.WriteLine(config["AppSecret"]);
    }
}

#programming_memes
#fun

🚀 چرا Connection String رو مستقیم تو appsettings.json نگذاریم؟

dotnet add package Azure.Extensions.AspNetCore.Configuration.Secrets
dotnet add package Azure.Identity

<PropertyGroup>
  <UserSecretsId>{GUID}</UserSecretsId>
</PropertyGroup>

dotnet user-secrets set "DbConnection" "Server=.;Database=Test;User Id=sa;Password=1234"

az group create --name "MyGroup" --location "westeurope"
az keyvault create --name "myvault123" --resource-group "MyGroup" --location "westeurope"

az keyvault secret set --vault-name "myvault123" --name "DbConnection" --value "Server=sql.example.com;Database=Prod;..."

builder.Configuration.AddAzureKeyVault(
    new Uri($"https://{builder.Configuration["KeyVaultName"]}.vault.azure.net/"),
    new ClientCertificateCredential(
        builder.Configuration["AzureADDirectoryId"],
        builder.Configuration["AzureADApplicationId"],
        x509Certificate));

builder.Configuration.AddAzureKeyVault(
    new Uri($"https://{builder.Configuration["KeyVaultName"]}.vault.azure.net/"),
    new DefaultAzureCredential());

📌 بهترین نکات امنیتی

🔖 هشتگ‌ها:
#CSharp #ASPNetCore #Azure #KeyVault #CodeSafety #MicrosoftAzure #ConnectionString

📌الگوی Saga چی هست و چرا بهش نیاز داریم؟
[Saga distributed transactions pattern]

📍زمینه و مشکل (Context and problem)

⚖️تراکنش‌ها باید به اصول ACID پایبند باشند:

🏗چالش‌ها در معماری‌های مایکروسرویس
(Challenges in microservices architectures)