‫طراحی سیستماتیک خصیصه‌های تاریخچه‌دار (Historized Attributes) در EF Core

• نوع میوه (Fruit): موجودیت اصلی که نام میوه را نگه می‌دارد.
• قیمت تاریخچه‌دار (FruitPrice): خصیصه‌ای که ارزش مالی و بازه زمانی اعتبار آن قیمت را ثبت می‌کند.

• ValidFrom: زمان شروع اعتبار قیمت (UTC).
• ValidTo: زمان پایان اعتبار قیمت (UTC).

public class Fruit
{
    public int Id { get; set; }
    public string Name { get; set; } = string.Empty;
    
    // Navigation Property
    public List<FruitPrice> Prices { get; set; } = new();
}

public class FruitPrice
{
    public int Id { get; set; }
    public int FruitId { get; set; }
    public decimal Value { get; set; }
    public DateTime ValidFrom { get; set; }
    public DateTime ValidTo { get; set; } // استفاده از مقدار نگهبان به جای Null

    // Navigation Property
    public Fruit? Fruit { get; set; }
}

using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Metadata.Builders;

public class FruitPriceConfiguration : IEntityTypeConfiguration<FruitPrice>
{
    public void Configure(EntityTypeBuilder<FruitPrice> builder)
    {
        builder.HasKey(fp => fp.Id);

        builder.Property(fp => fp.Value)
            .HasPrecision(18, 2);

        // تعریف ایندکس ترکیبی برای بهبود کارایی کوئری‌های زمانی
        builder.HasIndex(fp => new { fp.FruitId, fp.ValidFrom });

        // ارتباط یک به چند
        builder.HasOne(fp => fp.Fruit)
            .WithMany(f => f.Prices)
            .HasForeignKey(fp => fp.FruitId);
    }
}

var targetDate = new DateTime(2023, 6, 1, 0, 0, 0, DateTimeKind.Utc);

var priceAtTime = await context.FruitPrices
    .Where(fp => fp.FruitId == 3 
              && fp.ValidFrom <= targetDate 
              && fp.ValidTo > targetDate)
    .FirstOrDefaultAsync();

نکته فنی مهم: به عملگرها دقت کنید. برای زمان شروع از >= و برای زمان پایان از < استفاده شده است. این فرمولاسیون تضمین می‌کند که بازه‌های زمانی با هم تداخل نداشته باشند.

var now = DateTime.UtcNow;

var currentPrice = await context.FruitPrices
    .Where(fp => fp.FruitId == 3 
              && fp.ValidFrom <= now 
              && fp.ValidTo > now)
    .FirstOrDefaultAsync();

// رویکرد تک زمانه (توصیه نمی‌شود)
var price = await context.FruitPrices
    .Where(fp => fp.FruitId == 3 && fp.ValidFrom <= targetDate)
    .OrderByDescending(fp => fp.ValidFrom)
    .FirstOrDefaultAsync();

• پیچیدگی در سناریوهای نبود داده (Gaps): اگر در کل سال ۲۰۲۳ به دلیل کمبود بار، این میوه را نمی‌فروختیم و قیمتی برای آن وجود نداشت، در ساختار تک‌زمانه نمی‌توان این «نبودِ قیمت» را نشان داد؛ دیتابیس به اشتباه آخرین قیمت سال ۲۰۲۲ را برای سال ۲۰۲۳ هم معتبر می‌داند. اما در ساختار دو زمانه، کافیست برای آن بازه رکوردی ثبت نشود.
• کارایی (Performance): در کوئری‌های پیچیده‌تر یا ساب‌کوئری‌ها، رویکرد تک‌زمانه دیتابیس را مجبور به اجرای توابع محاسباتی مانند MAX یا سورتهای سنگین می‌کند، در حالی که ساختار دو زمانه با یک فیلتر بازه‌ای ساده (Between منطقی) روی ایندکس ترکیبی، به سرعت پاسخ را می‌یابد.

public class HistorizedAttribute<TValue>
{
    public int Id { get; set; }
    public int AnchorId { get; set; } // کلید خارجی به موجودیت اصلی
    public TValue Value { get; set; } = default!;
    public DateTime ValidFrom { get; set; }
    public DateTime ValidTo { get; set; } = DateTime.MaxValue; // مقدار نگهبان
}